Guida alla migrazione: da zcashd a Zebrad/Zallet
Il full node (nodo completo) tradizionale zcashd, gestito da Electric Coin Company (ECC) / Zodl, è stato sostituito da Zebra e Zallet. zcashd ha raggiunto l'interruzione del supporto il 18 luglio 2026 e non è più in esecuzione.
- Zebra è una moderna implementazione Rust del protocollo Zcash sviluppata dalla Zcash Foundation
- Zallet è un portafoglio leggero progettato per interfacciarsi senza problemi con i nodi Zebra sviluppati da Zodl
Questa guida ti accompagna nella migrazione da zcashd a Zebrad e Zallet, inclusi configurazione, importazione del portafoglio e risoluzione dei comuni problemi di migrazione.
zcashd ha smesso di funzionare il 18 luglio 2026
Cosa significa
- zcashd ha raggiunto l'interruzione del supporto il 18 luglio 2026. Non si sincronizzerà più con la punta della chain e non può inviare né ricevere fondi. È definitivo, non previsto.
- I due compiti di zcashd sono ora separati: zebrad è il full node e Zallet è il portafoglio.
- Zallet è in beta. Possono verificarsi modifiche incompatibili tra le release e alcuni metodi JSON-RPC di zcashd non sono ancora implementati. Controlla la matrice dello stato dei metodi prima di fare affidamento su una chiamata specifica.
- Se possiedi ancora fondi Sprout, leggi prima l'avvertenza nel passaggio 6. Zallet non supporta la pool Sprout e il modo abituale per spostare quei fondi richiedeva uno zcashd in esecuzione.
Perché migrare - oltre la deprecazione
Anche mettendo da parte la deprecazione, ci sono ragioni convincenti per migrare:
- Sicurezza e robustezza: la sicurezza della memoria di Rust e gli strumenti moderni riducono i rischi di vulnerabilità.
- Prestazioni ed efficienza: Zebrad è progettato per il parallelismo, un uso più efficiente delle risorse e una sincronizzazione più veloce.
- Architettura modulare: separare la logica del nodo (Zebrad) dall'interfaccia del portafoglio (Zallet) offre confini più chiari e migliori percorsi di aggiornamento.
- Compatibilità con l'ecosistema futuro: strumenti, miglioramenti e il resto dell'ecosistema di Zcash si rivolgeranno sempre più a Zebrad/Zallet.
- Tranquillità: evita di ritrovarti a usare un componente deprecato e non supportato.
Ora approfondiamo la guida alla migrazione
1. Esegui il backup di tutto
- Esegui il backup del tuo wallet.dat (o di qualsiasi altro file del portafoglio / archivio di chiavi) dal tuo nodo zcashd.
- Salva il tuo zcash.conf e tutte le impostazioni personalizzate.
- Esporta una copia di qualsiasi script RPC o automazione che utilizzi.
- Verifica che i tuoi backup siano validi (ad esempio, in un altro ambiente, prova ad aprirli o ispezionarli).
- Esamina i metodi JSON-RPC su cui fai attualmente affidamento.
- Confrontali con la tabella di compatibilità pianificata gestita sul sito di supporto di Zcash
- Preparati a modifiche o metodi mancanti (alcuni potrebbero richiedere soluzioni alternative o adattamenti).
2. Requisiti di sistema e spazio su disco
- Lo spazio su disco è il requisito che le persone sottovalutano. La chain di Zcash ha superato i 270 GB nell'agosto 2026, quindi prevedi almeno 300 GB di spazio libero, su un SSD se possibile.
- Assicurati che la tua macchina disponga di rete, CPU e RAM stabili.
- Una connessione Internet
- Se prevedi di compilare dal sorgente, installa Rust e Cargo.
3. Installa / configura Zebrad
Puoi scaricare un binario precompilato oppure compilare dal sorgente.
Opzione A: installazione tramite binario precompilato
Su Linux/macOS:
Questo installa l'ultima versione stabile di zebrad.
Opzione B: compilazione dal sorgente
Dopo la compilazione, sposta il binario nel tuo path:
4. Configurazione e avvio
Genera una configurazione predefinita:
Modifica zebrad.toml in base alle tue preferenze (indirizzo di ascolto, porte, directory di stato, caching).
Avvia il nodo:
Il nodo inizierà a sincronizzarsi dalla genesi: attenditi diverse ore (o più) a seconda dell'hardware e della rete.
5. Installa / configura Zallet (portafoglio)
Zallet è progettato per sostituire la parte del portafoglio di zcashd.
Controlla la pagina GitHub / delle release di Zallet per i binari.
Oppure compila dal sorgente:
- Avvia la GUI o la CLI (in base a quanto fornito dalla tua installazione).
- Configuralo per connettersi al tuo nodo Zebrad locale tramite endpoint RPC o API.
6. Importazione del tuo portafoglio zcashd in Zallet
Non hai bisogno di un zcashd in esecuzione per questo. Zallet legge direttamente il file wallet.dat, un aspetto importante perché zcashd non può più essere avviato.
Conserva wallet.dat. La migrazione segnala tutto ciò che non riesce a rappresentare in un portafoglio Zallet invece di importarlo, e quel materiale delle chiavi esiste quindi solo in wallet.dat. Non eliminarlo dopo la migrazione.
Esegui prima zallet init-wallet-encryption. Zallet cifra il materiale delle chiavi in un'identità age e tale identità deve esistere prima dell'importazione di qualsiasi chiave.
Quindi converti la tua configurazione e il tuo portafoglio:
Code-highlight
# translate zcash.conf into zallet.toml
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir -o /path/to/zallet/datadir/zallet.toml
# import wallet.dat into Zallet's wallet.db
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet è presente solo nelle build con la funzionalità zcashd-import, e la lettura di wallet.dat richiede l'utilità db_dump di Berkeley DB 6.2, la versione utilizzata da zcashd. Se hai più di un file del portafoglio, esegui il comando una volta per file e aggiungi --allow-multiple-wallet-imports nelle esecuzioni successive; ognuno diventa il proprio insieme di account. I tuoi rpcuser e rpcpassword non vengono trasferiti, perché il JSON-RPC di Zallet utilizza per impostazione predefinita l'autenticazione tramite cookie; aggiungi le credenziali con zallet add-rpc-user se ti servono.
Cosa viene trasferito
- Seed mnemonici e le chiavi derivate da essi, con gli account ricostruiti per corrispondere al portafoglio zcashd
- Chiavi di spesa Sapling importate autonomamente e chiavi trasparenti
- Voci trasparenti di sola visualizzazione che includono la loro chiave pubblica o script di riscatto
- Date di nascita degli account, affinché la scansione della chain inizi all'altezza corretta
Cosa non viene trasferito. Questi elementi vengono segnalati con conteggi anziché importati:
- Chiavi di spesa e fondi Sprout. Zallet non supporta la pool Sprout. Il percorso documentato consisteva nello spostare i fondi Sprout tramite zcashd prima di ritirarlo, e ciò non è più possibile. Se questo ti riguarda, chiedi sul Discord Zcash R&D o sul forum della community prima di fare qualsiasi altra cosa.
- Voci della rubrica indirizzi
- Voci di sola visualizzazione memorizzate senza una chiave pubblica o script di riscatto, e voci con chiavi pubbliche non compresse
- Portafogli Regtest
Esecuzione del backup successivamente. Una mnemonica da sola non è un backup completo, perché le chiavi importate esistono solo nel database del portafoglio. Conserva copie sicure di wallet.db, del file dell'identità di crittografia age indicato dall'opzione keystore.encryption_identity e della tua frase mnemonica, e conserva il wallet.dat originale. Nota che wallet.db non è esso stesso cifrato: conserva in chiaro la cronologia delle transazioni e le chiavi di visualizzazione, quindi archivia il backup in un luogo sicuro.
Riscansione e sincronizzazione del portafoglio
- Una volta importate le chiavi, Zallet attiverà una riscansione della chain tramite Zebrad.
- Lascia a Zallet il tempo necessario per ricostruire il tuo saldo e la cronologia delle transazioni.
7. Verifica saldi e sincronizzazione
Una volta importato, Zallet si connetterà al tuo nodo Zebrad e riscansionerà la blockchain.
Al termine della sincronizzazione, i tuoi saldi e le tue transazioni dovrebbero apparire esattamente come prima.
Puoi verificare lo stato di sincronizzazione del tuo nodo eseguendo:
Oppure controlla i log.
8. Risoluzione dei problemi
| Problema | Possibile causa | Soluzione |
|---|
| Zebrad non si avvia | Porta in uso o configurazione errata | Controlla zebrad.toml e usa una porta libera |
| Sincronizzazione lenta | Congestione della rete | Assicurati di avere una connessione Internet stabile, riavvia Zebrad |
| Nel portafoglio mancano transazioni | Importazione parziale delle chiavi | Reimporta le chiavi o esegui una riscansione in Zallet |
| Zallet non riesce a connettersi al nodo | Nodo non in esecuzione o endpoint errato | Avvia Zebrad e verifica la porta RPC corretta |
| Zallet va in crash | Build obsoleta | Aggiorna all'ultima release da GitHub |
9. Conclusione
La migrazione da zcashd a Zebrad e Zallet ti offre un'esperienza di Zcash più veloce, sicura e moderna.
Con la sicurezza basata su Rust, il design modulare e strumenti migliori, questa configurazione garantisce che il tuo nodo e portafoglio restino pronti per il futuro mentre l'ecosistema di Zcash continua a evolversi.
Suggerimento: conserva le chiavi del tuo portafoglio offline ed esegui regolarmente il backup dei dati Zallet.
Visita zebra.zfnd.org per Zebra e The Zallet Book o il repository Zallet per Zallet. Il capitolo Migrazione da zcashd di The Zallet Book è il riferimento autorevole per il passaggio 6.
