Edit this page on GitHub (opens in a new tab)
Zallet è un portafoglio di Zcash full node (nodo completo) scritto in Rust. Sostituisce il portafoglio che in precedenza era incorporato in zcashd. Dopo che zcashd ha raggiunto l'interruzione del supporto il 18 luglio 2026 all'altezza del blocco 3417100, i compiti di consenso e del portafoglio sono stati separati: Zebra o Zakura convalidano la chain, mentre Zallet conserva le chiavi, scansiona le note ed espone il JSON-RPC del portafoglio.
Zallet è attualmente in versione beta. Non è stato sottoposto a una revisione completa. Modifiche incompatibili potrebbero richiedere l'eliminazione e la ricreazione del portafoglio. Non considerarlo una soluzione di custodia in produzione per grandi quantità di ZEC senza aver letto gli avvisi di sicurezza nel The Zallet Book.
zcashd. La componente nodo è Zebra oppure Zakura.ReadStateService diretto contro un zebrad locale) oppure Zaino.wallet.db.zallet (launcher), zallet-zebra e zallet-zaino.zcashd raggruppava un nodo di consenso derivato da Bitcoin Core e un portafoglio in un unico processo. Quel progetto non esiste più.
| Ruolo | Stack precedente | Stack attuale |
|---|---|---|
| Consenso / P2P | zcashd | Zebra (zebrad) oppure Zakura |
| Portafoglio / chiavi / saldi | zcashd wallet.dat | Zallet (wallet.db) |
| Indicizzatore light client | lightwalletd | Zaino oppure lightwalletd |
Separare il portafoglio dal nodo significa:
zcashd.Zallet è il portafoglio destinato agli operatori che in precedenza utilizzavano zcashd come portafoglio hot, backend per exchange, faucet o portafoglio per pagamenti di mining.
Zallet è in versione beta.
Cosa significa in pratica:
zcashd sono stati portati.zcashd. Le integrazioni devono leggere la pagina semantica modificata.I feedback vanno alle issue GitHub o al canale #wallet-dev sul Zcash R&D Discord.
È prevista una successiva fase stabile una volta disponibile la superficie RPC prevista. In tal caso, i chiamanti dovranno migrare ai metodi di Zallet, comprese le differenze semantiche documentate.
Zallet è suddiviso in tre workspace Cargo affinché i due backend della chain possano seguire grafi di dipendenze differenti.
zallet launcher: reads `backend` in zallet.toml (default "zebra")
and execs zallet-zebra or zallet-zaino
zallet-core shared wallet: CLI, config, JSON-RPC, SQLite DB, sync
zallet-zebra zebra-state backend (ReadStateService + Zebra JSON-RPC)
zallet-zaino Zaino indexer backend
Tutti e tre i binari aprono lo stesso wallet.db. Il launcher sceglie un backend in fase di esecuzione; non occorre ricompilare per cambiarlo.
Distribuzione tipica:
zebrad (or Zakura)
│ JSON-RPC / ReadStateService
▼
Zallet (zallet-zebra or zallet-zaino)
│ JSON-RPC on 127.0.0.1
▼
Your application, exchange, faucet, or operator scripts
Zallet è un portafoglio full node: richiede un nodo validante locale. Non è un light client. Per i portafogli light e i server di blocchi compatti, vedi Zaino e Nodi Lightwallet.
Lo stack compose Zcash Foundation Z3 esegue insieme Zebra + Zallet, con Zaino autonomo opzionale per light client esterni.
Zallet è basato sugli account ZIP 32, non sull'unico account implicito di zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Un account può avere molti indirizzi diversificati; i receiver schermati non sono collegabili on-chain.z_importkey) e gli indirizzi watch-only (z_importaddress) diventano account UUID non coperti da alcun mnemonic.z_exportviewingkey, z_importviewingkey), comprese le chiavi di visualizzazione complete unificate e le chiavi di visualizzazione in entrata.getnewaddress non è implementato. Usa z_getnewaccount e z_getaddressforaccount.
Se keystore.require_backup è attivo (la forma migrata di zcashd di walletrequirebackup), Zallet rifiuta di derivare nuova autorità di spesa da un mnemonic il cui backup non è stato confermato.
Il materiale delle chiavi è sempre crittografato. Non esiste una modalità non crittografata né un RPC encryptwallet: quel metodo di zcashd non è mai stato pienamente supportato.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Sblocca con l'RPC walletpassphrase; blocca con walletlock.wallet.db che conservi.Copiare wallet.db mentre Zallet è in esecuzione non è un backup sicuro. SQLite può danneggiarsi. Preferisci un processo arrestato, oppure attendi un comando ufficiale di backup online.
Zallet implementa un sottoinsieme degli RPC del portafoglio zcashd su HTTP con autenticazione Basic. Effettua il bind su loopback. L'uso remoto dovrebbe passare attraverso un tunnel crittografato. rpc.allow_insecure_remote_bind esiste ed è insicuro.
Differenze rilevanti rispetto a zcashd:
getwalletinfo sono vuoti. Usa z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).I metodi volutamente omessi includono createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet e encryptwallet. Le alternative sono elencate nel Zallet Book.
I percorsi di installazione ufficiali (pacchetti Debian, Docker, binari di release) sono nella guida all'installazione. Gli archivi di release sono denominati zallet-<version>-<arch>.tar.gz e contengono tutti e tre i binari.
Flusso minimo per un nuovo portafoglio:
# data directory; default is $HOME/.zallet
zallet -d /path/to/zallet/datadir example-config > /path/to/zallet/datadir/zallet.toml
# edit zallet.toml: network, backend, indexer / read-state, rpc.bind
zallet -d /path/to/zallet/datadir generate-encryption-identity
zallet -d /path/to/zallet/datadir init-wallet-encryption
zallet -d /path/to/zallet/datadir generate-mnemonic
zallet -d /path/to/zallet/datadir confirm-backup
zallet -d /path/to/zallet/datadir start
Indirizza [indexer] a un endpoint JSON-RPC zebrad locale. Il backend zebra richiede anche [indexer.read_state_service] e un zebrad compilato con la funzionalità indexer affinché Zallet possa leggere direttamente lo stato della chain.
Le immagini riproducibili possono essere compilate con StageX (Docker 25+, image store containerd, GNU Make).
Conserva la vecchia datadir di zcashd finché non avrai confermato i saldi e testato un ripristino.
zallet init-wallet-encryption
zallet migrate-zcash-conf --zcashd-datadir /path/to/zcashd/datadir \
-o /path/to/zallet/datadir/zallet.toml
zallet migrate-zcashd-wallet --zcashd-datadir /path/to/zcashd/datadir
migrate-zcashd-wallet è disponibile solo nelle build con la funzionalità zcashd-import. Per leggere wallet.dat occorre db_dump di Berkeley DB 6.2, la versione utilizzata da zcashd.
Note operative passo per passo: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Cos'è | Portafoglio RPC full node | Server di portafoglio incentrato sullo schermato | Portafogli per utenti finali | Nodo di consenso | Indicizzatore / sostituto di lightwalletd |
| Sostituisce | Portafoglio zcashd | Non è un clone zcashd drop-in | App mobile/desktop | Nodo zcashd | lightwalletd |
| Richiede un nodo locale | Sì | Sì (Zebra per impostazione predefinita) | No (light client) | È il nodo | Sì |
Zallet e zecd possono entrambi essere posti davanti a Zebra. Scegli Zallet quando ti serve la superficie del portafoglio z_* e un percorso di migrazione da wallet.dat. Scegli zecd quando desideri un server incentrato sullo schermato che esplicitamente non è un clone di zcashd.
Esiste un prodotto consumer separato su zallet.io che riutilizza il nome. Quell'app non è questo progetto.
zcashd ritirato| Compatibilità RPC zcashd |
| Progettato come percorso di compatibilità |
| Solo un piccolo sottoinsieme selezionato |
| N/D |
| Modalità di compatibilità parziale / Zakura |
| API diversa |
| Modello di custodia | L'operatore conserva le chiavi in wallet.db | Server recuperabile tramite seed | Chiavi sul dispositivo dell'utente | Nessun portafoglio | Nessuna chiave |