Documentazione del portafoglio

Un nodo Ergo fornisce un portafoglio integrato per memorizzare chiavi private e firmare transazioni. Di seguito viene descritto come configurare e proteggere il tuo portafoglio Ergo.

Il portafoglio utilizza lo standard BIP39 per generare un seed da una frase mnemonica, che viene poi utilizzata per generare le chiavi private secondo lo standard BIP32 (Portafogli Deterministici Gerarchici). Puoi utilizzare la tua frase mnemonica composta dalle parole di uno di questi elenchi di parole se lo desideri.
Le lunghezze delle frasi consentite sono 12, 15, 18, 21, 24 che rappresentano rispettivamente 128, 160, 192, 224, 256 bit di sicurezza. Per inizializzare un portafoglio con una tale mnemonica, dovresti utilizzare l'endpoint API wallet/restore.
Tuttavia, è molto più sicuro utilizzare la mnemonica generata dal portafoglio.

A questo punto, tutte le interazioni con il portafoglio possono essere effettuate solo tramite l'API REST del nodo. Assicurati di aver impostato una chiave API nel tuo nodo prima di eseguire i passaggi successivi.

Configurazione del portafoglio

Il portafoglio è configurato tramite il file di configurazione del nodo. Di seguito sono riportati i parametri di configurazione a cui prestare attenzione quando si configura il portafoglio per la prima volta:

• ergo.wallet.seedStrengthBits - Lunghezza in bit di un seed nel caso venga generato dal nodo. Nota: più forte è il seed, più lunga è la lunghezza della frase mnemonica. Opzioni: 128, 160, 192, 224, 256
• ergo.wallet.secretStorage.secretDir - Directory in cui il segreto sarà memorizzato in forma crittografata
• ergo.wallet.mnemonicPhraseLanguage - Lingua da utilizzare nella frase mnemonica. Opzioni: "chinese_simplified", "chinese_traditional", "english", "french", "italian", "japanese", "korean", "spanish"

Utilizzo del portafoglio per la prima volta

Il portafoglio deve essere inizializzato tramite l'API REST quando si esegue il nodo per la prima volta. Qui sono disponibili due opzioni:

1. Inizializzalo da zero (il seed sarà generato dal nodo) effettuando una richiesta POST a /wallet/init con i dati body: {"pass": "123", "mnemonicPass": "abc"}. Non dimenticare di salvare la frase mnemonica con cui risponde il nodo. (Nota: il parametro mnemonicPass nel corpo della richiesta è facoltativo e viene utilizzato per proteggere la frase mnemonica).
2. Ripristina il portafoglio da un seed esistente. Dovrai fornire la tua frase mnemonica quando utilizzi questa opzione. Questo viene fatto effettuando una richiesta POST a /wallet/restore con i dati body: {"pass": "123", "mnemonic": "abandon abandon ...", "mnemonicPass": "abc"} (Nota: il campo mnemonicPass è richiesto solo nel caso in cui la tua frase mnemonica fosse protetta da una password aggiuntiva al momento della creazione).

Sblocco del portafoglio

Dopo l'inizializzazione e prima di ogni utilizzo, il portafoglio deve essere sbloccato effettuando una richiesta POST a /wallet/unlock con i dati body: {"pass": "123"}. (Nota: utilizza la password che hai scelto nella fase di inizializzazione)

Devi eseguire questo passaggio ogni volta che il nodo viene riavviato o il portafoglio è bloccato.
In particolare, il portafoglio deve essere sbloccato per le seguenti operazioni:

• Utilizzo del miner interno
• Firmare transazioni
• Monitorare le box

Blocco del portafoglio

Un portafoglio viene bloccato automaticamente dopo un certo periodo, il che significa che tutti i segreti attualmente caricati vengono rimossi dalla memoria. Puoi anche utilizzare l'API REST per bloccare il portafoglio effettuando una richiesta GET a /wallet/lock.
Si consiglia di bloccare il portafoglio quando non è in uso.
Dopo il blocco, dovrai sbloccare il portafoglio per utilizzarlo di nuovo.

Gestione delle chiavi

Un portafoglio implementa BIP32 ("Portafogli deterministici gerarchici"). Quando il portafoglio viene inizializzato, viene creata solo la chiave radice.
Per derivare una coppia di chiavi aggiuntive corrispondenti a un percorso di derivazione specifico (metodo: POST, corpo della richiesta: {"derivationPath": "m/1/2"}) può essere utilizzato il percorso API /wallet/deriveKey.
Per creare semplicemente una coppia di chiavi aggiuntive, utilizza un percorso API /wallet/deriveNextKey (metodo: GET).