Documentación de la billetera

Un nodo Ergo proporciona una billetera integrada para almacenar claves privadas y firmar transacciones. Lo siguiente describe cómo configurar y proteger su billetera Ergo.

La billetera utiliza el estándar BIP39 para generar una semilla a partir de una frase mnemotécnica, que luego se utiliza para generar las claves privadas de acuerdo con el estándar BIP32 (Billeteras Determinísticas Jerárquicas). Puede usar su propia frase mnemotécnica compuesta por las palabras de una de estas listas de palabras si lo desea.
Las longitudes de frase permitidas son 12, 15, 18, 21, 24 que representan respectivamente, 128, 160, 192, 224, 256 bits de seguridad. Para inicializar una billetera con una mnemotécnica así, debe usar el punto final de la API wallet/restore.
Sin embargo, es mucho más seguro usar la mnemotécnica generada por la billetera.

En esta etapa, todas las interacciones con la billetera solo se pueden realizar a través de la API REST del nodo. Asegúrese de haber configurado una clave API en su nodo antes de realizar los siguientes pasos.

Configurando la billetera

La billetera se configura a través del archivo de configuración del nodo. A continuación se presentan los parámetros de configuración que vale la pena tener en cuenta al configurar la billetera por primera vez:

• ergo.wallet.seedStrengthBits - Longitud en bits de una semilla en caso de que sea generada por el nodo. Nota: cuanto más fuerte sea la semilla, más larga será la longitud de la frase mnemotécnica. Opciones: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Directorio donde se almacenará el secreto en forma encriptada
• ergo.wallet.mnemonicPhraseLanguage - Idioma que se utilizará en la frase mnemotécnica. Opciones: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

Usando la billetera por primera vez

La billetera necesita ser inicializada a través de la API REST al ejecutar el nodo por primera vez. Aquí hay dos opciones disponibles:

1. Inicializarla desde cero (la semilla será generada por el nodo) haciendo una solicitud POST a /wallet/init con datos body: {"pass": "123", "mnemonicPass": "abc"}. No olvide guardar la frase mnemotécnica con la que responde el nodo. (Nota: El parámetro mnemonicPass en el cuerpo de la solicitud es opcional y se utiliza para proteger la frase mnemotécnica).
2. Restaurar la billetera a partir de una semilla existente. Tendrá que proporcionar su frase mnemotécnica al usar esta opción. Esto se hace haciendo una solicitud POST a /wallet/restore con datos body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Nota: el campo mnemonicPass es requerido solo en caso de que su frase mnemotécnica estuviera protegida por una contraseña adicional en la creación).

Desbloqueando la billetera

Después de la inicialización y antes de cada uso, la billetera necesita ser desbloqueada haciendo una solicitud POST a /wallet/unlock con datos body: {"pass": "123"}. (Nota: use la contraseña que eligió en la etapa de inicialización)

Debe realizar este paso cada vez que se reinicie el nodo o se bloquee la billetera.
En particular, la billetera debe estar desbloqueada para las siguientes operaciones:

• Usar el minero interno
• Firmar transacciones
• Rastrear cajas

Bloqueando la billetera

Una billetera se bloquea automáticamente después de un tiempo, lo que significa que todos los secretos actualmente cargados se eliminan de la memoria. También puede usar la API REST para bloquear la billetera haciendo una solicitud GET a /wallet/lock.
Se recomienda bloquear la billetera cuando no esté en uso.
Después de bloquear, necesitará desbloquear la billetera para usarla nuevamente.

Gestionando claves

Una billetera implementa BIP32 ("Billeteras determinísticas jerárquicas"). Cuando se inicializa la billetera, se crea la única clave raíz.
Para derivar un par de claves adicionales correspondientes a una ruta de derivación específica (método: POST, cuerpo de la solicitud: {"derivationPath": "m/1/2"}) se puede usar la ruta de API /wallet/deriveKey.
Para simplemente crear un par de claves adicionales, use una ruta de API /wallet/deriveNextKey (método: GET).