Introducción al SDK de Go
Primeros Pasos
El SDK de ULedger es un framework para construir aplicaciones blockchain. Escrito en Go, este SDK se utiliza para desarrollar aplicaciones dentro del ecosistema ULedger y sirve como una herramienta poderosa para interactuar con una red blockchain de ULedger. Permite crear y gestionar billeteras, así como firmar, enviar y consultar transactions; bloques y actividad de billeteras.
Al integrar el SDK en las aplicaciones Go, se accede a las características criptográficas y de privacidad de ULedger. Esto incluye cifrado robusto que admite post-cuántico, cifrado, prueba de conocimiento cero y Cross-Merkleization.
Preparación de un entorno de desarrollo en Go
Esta guía configura un entorno de desarrollo completo en Go para empezar a construir con el Go SDK de ULedger. Al terminar, se tendrá Go instalado, un proyecto inicializado con el SDK y un programa que se conecta a un node.
Requisitos previos
Se necesita una computadora con macOS, Linux o Windows, familiaridad básica con la línea de comandos y acceso a internet para descargar dependencias. El SDK requiere Go 1.24.1 o superior. No se requiere experiencia previa con Go, aunque es recomendable tener conocimientos básicos de programación.
Paso 1: Instalar Go
Go se distribuye como un único binario. Se debe descargar la última versión estable para el sistema operativo desde go.dev/dl e instalarla.
- macOS y Linux: se ejecuta el instalador, o se extrae el archivo y se siguen las instrucciones de la página de descarga.
- Windows: se ejecuta el instalador
.msiy se sigue el asistente de configuración.
Para verificar la instalación, se abre una terminal y se ejecuta:
go version
La salida debería ser similar a la siguiente, aunque la versión y la plataforma serán distintas en cada equipo:
go version go1.24.1 darwin/arm64
Si aparece un número de versión, Go está instalado.
Paso 2: Entender el workspace de Go
Los proyectos modernos de Go usan módulos de Go, por lo que no es necesario colocar el código en un GOPATH especial. Cada proyecto vive en su propia carpeta y gestiona sus dependencias de forma independiente.
Paso 3: Crear un nuevo proyecto de Go
Se crea un directorio para la aplicación y se inicializa un módulo de Go dentro de él:
mkdir my-uledger-blockchain-app
cd my-uledger-blockchain-app
go mod init github.com/your-org/my-uledger-blockchain-app
El último comando crea un archivo go.mod, que registra todas las dependencias del proyecto.
Paso 4: Instalar el SDK
Se usa go get para agregar el SDK al proyecto:
go get github.com/ULedgerInc/go-sdk
Go descarga el SDK, resuelve sus dependencias y actualiza los archivos go.mod y go.sum.
Paso 5: Crear la primera aplicación
Se crea un archivo main.go y se agrega el siguiente código, que carga una billetera desde un archivo o la crea en la primera ejecución, y luego abre una sesión de transacciones con un node:
:::warning Reemplazar la URL de ejemplo del node
El ejemplo usa https://your-node-url como marcador de posición. Se debe reemplazar por la URL del node al que se desea conectar, por ejemplo un node de la red local. Se debe usar la URL base del node, sin barra final y sin ruta.
:::
package main
import (
"fmt"
"github.com/ULedgerInc/go-sdk/pkg/crypto"
"github.com/ULedgerInc/go-sdk/pkg/transaction"
"github.com/ULedgerInc/go-sdk/pkg/wallet"
)
const (
nodeURL = "https://your-node-url"
walletFilePath = "my-wallet.ukey"
)
func loadOrCreateWallet() (*wallet.UL_Wallet, error) {
// Se intenta cargar primero una billetera existente
loaded, err := wallet.LoadFromFile(walletFilePath, "")
if err == nil {
fmt.Println("Wallet loaded from", walletFilePath)
return &loaded, nil
}
// De lo contrario, se crea una nueva
w, mnemonic, err := wallet.GenerateNewWallet(
"", // passphrase (opcional)
crypto.KeyTypeSecp256k1, // tipo de clave
"", // parent (vacío para una billetera raíz)
map[string]wallet.UL_AuthPermission{}, // auth groups
wallet.DefaultEntropy, // por defecto Entropy256
)
if err != nil {
return nil, fmt.Errorf("generate wallet: %w", err)
}
// Guardar la clave privada en un archivo sirve para una primera ejecución, no para producción
if err := w.SaveToFile(walletFilePath, "", true); err != nil {
return nil, fmt.Errorf("save wallet: %w", err)
}
fmt.Println("New wallet created and saved to", walletFilePath)
fmt.Println("Mnemonic (store it safely):", mnemonic)
return &w, nil
}
func main() {
fmt.Println("ULedger development environment with the Go SDK")
w, err := loadOrCreateWallet()
if err != nil {
fmt.Printf("Error loading or creating the wallet: %v\n", err)
return
}
fmt.Println("Wallet address:", w.Address)
// NewUL_TransactionSession consulta al node su estado de salud y sus blockchains
if _, err := transaction.NewUL_TransactionSession(nodeURL, *w); err != nil {
fmt.Printf("Error creating the transaction session: %v\n", err)
return
}
fmt.Println("Transaction session created and connected to the node")
}
Luego se ordenan las dependencias:
go mod tidy
No se deben codificar datos sensibles en el código de producción, como las URL de los nodes o las claves de las billeteras. Se recomienda leerlos desde variables de entorno.
Paso 6: Ejecutar la aplicación
Se ejecuta el programa:
go run main.go
En la primera ejecución se crea la billetera y se imprimen su mnemónico y su dirección, y después se conecta al node, por lo que la salida debería verse así:
ULedger development environment with the Go SDK
New wallet created and saved to my-wallet.ukey
Mnemonic (store it safely): ...
Wallet address: ...
Transaction session created and connected to the node
En las siguientes ejecuciones se carga my-wallet.ukey y se omite el paso de creación.
Herramientas recomendadas
Visual Studio Code con la extensión oficial de Go ofrece formato, linting y depuración listos para usar, mientras que golangci-lint es un complemento opcional útil para verificaciones más estrictas.
Problemas comunes
go: command not found
Se debe verificar que Go esté en el PATH del sistema, abrir una nueva terminal y ejecutar go version otra vez.
Errores de dependencias
Se ejecuta go mod tidy para resolver las dependencias faltantes o desactualizadas, y luego se vuelve a ejecutar el programa.
La sesión de transacciones no logra conectarse
La sesión consulta el estado de salud y las blockchains del node al crearse, por lo que se debe comprobar que la URL del node sea correcta y accesible desde el equipo.
Próximos pasos
Continuar con Crear una Billetera y luego con Registrar y Crear Transacciones.