Edit this page on GitHub (opens in a new tab)
Zallet est un portefeuille Zcash de nœud complet écrit en Rust. Il remplace le portefeuille qui était auparavant intégré à zcashd. Après l'arrêt de fin de support de zcashd le 18 juillet 2026 à la hauteur de bloc 3417100, les fonctions de consensus et de portefeuille ont été séparées : Zebra ou Zakura valident la chaîne, et Zallet conserve les clés, analyse les notes et expose le JSON-RPC du portefeuille.
Zallet est actuellement en bêta. Il n'a pas encore fait l'objet d'un audit complet. Des changements incompatibles peuvent obliger à supprimer puis recréer le portefeuille. Ne l'utilisez pas comme solution de conservation en production pour de gros montants de ZEC sans avoir lu les avertissements de sécurité figurant dans Le livre Zallet.
zcashd. La partie nœud est assurée par Zebra ou Zakura.ReadStateService direct sur un zebrad local) ou Zaino.wallet.db.zallet (lanceur), zallet-zebra et zallet-zaino.zcashd regroupait dans un seul processus un nœud de consensus dérivé de Bitcoin Core et un portefeuille. Cette conception a été abandonnée.
| Rôle | Ancienne pile | Pile actuelle |
|---|---|---|
| Consensus / P2P | zcashd | Zebra (zebrad) ou Zakura |
| Portefeuille / clés / soldes | zcashd wallet.dat | Zallet (wallet.db) |
| Indexeur pour clients légers | lightwalletd | Zaino ou lightwalletd |
Séparer le portefeuille du nœud signifie que :
zcashd.Zallet est le portefeuille destiné aux opérateurs qui utilisaient auparavant zcashd comme portefeuille chaud, backend d'exchange, faucet ou portefeuille de paiement de minage.
Zallet est en bêta.
Concrètement, cela signifie que :
zcashd n'ont pas été portées.zcashd. Les intégrations doivent consulter la page sur la sémantique modifiée.Vos retours sont les bienvenus via les issues GitHub ou sur le canal #wallet-dev du Zcash R&D Discord.
Une phase stable ultérieure est prévue une fois que l'ensemble des RPC envisagées sera disponible. Les utilisateurs devront alors migrer vers les méthodes de Zallet, en tenant compte des différences sémantiques documentées.
Zallet est réparti sur trois espaces de travail Cargo afin que les deux backends de chaîne puissent suivre des graphes de dépendances différents.
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
Les trois binaires ouvrent le même wallet.db. Le lanceur choisit un backend à l'exécution : vous n'avez pas besoin de recompiler pour en changer.
Déploiement type :
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 est un portefeuille de nœud complet : il nécessite un nœud de validation local. Ce n'est pas un client léger. Pour les portefeuilles légers et les serveurs de blocs compacts, consultez Zaino et Nœuds de portefeuille léger.
La pile compose Z3 de Zcash Foundation exécute Zebra et Zallet ensemble, avec un Zaino autonome facultatif pour les clients légers externes.
Zallet est conçu autour des comptes ZIP 32, et non du compte implicite unique de zcashd.
zip32seedfp1…).(seedfp, account index).z_getaddressforaccount. Un compte peut avoir de nombreuses adresses diversifiées ; les récepteurs protégés ne peuvent pas être reliés entre eux on-chain.z_importkey) et les adresses en lecture seule (z_importaddress) deviennent des comptes UUID qui ne sont couverts par aucune phrase mnémonique.z_exportviewingkey, z_importviewingkey), y compris les clés pour lecture seule complètes unifiées et les clés pour lecture seule entrantes.getnewaddress n'est pas implémentée. Utilisez z_getnewaccount et z_getaddressforaccount.
Si keystore.require_backup est activé (la forme migrée de walletrequirebackup de zcashd), Zallet refuse de dériver une nouvelle autorité de dépense à partir d'une phrase mnémonique dont la sauvegarde n'a pas été confirmée.
Les éléments de clé sont toujours chiffrés. Il n'existe ni mode non chiffré ni RPC encryptwallet : cette méthode de zcashd n'a jamais été entièrement prise en charge.
{datadir}/encryption-identity.txt.wallet.db.generate-encryption-identity -p). Déverrouillez-la avec la RPC walletpassphrase ; verrouillez-la avec walletlock.wallet.db que vous conservez.Copier wallet.db pendant que Zallet est en cours d'exécution ne constitue pas une sauvegarde sûre. SQLite peut produire un fichier incohérent. Préférez un processus arrêté, ou attendez une commande officielle de sauvegarde à chaud.
Zallet implémente un sous-ensemble des RPC de portefeuille de zcashd sur HTTP avec authentification Basic. Liez-le à l'interface de bouclage. L'utilisation à distance doit passer par un tunnel chiffré. rpc.allow_insecure_remote_bind existe et n'est pas sûr.
Différences notables par rapport à zcashd :
getwalletinfo sont vides. Utilisez z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).Les méthodes volontairement omises comprennent createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet et encryptwallet. Leurs remplaçantes sont répertoriées dans le livre Zallet.
Les méthodes d'installation officielles (paquets Debian, Docker, binaires de version) figurent dans le guide d'installation. Les archives de version sont nommées zallet-<version>-<arch>.tar.gz et contiennent les trois binaires.
Procédure minimale de création d'un nouveau portefeuille :
# 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
Faites pointer [indexer] vers un point de terminaison JSON-RPC zebrad local. Le backend zebra nécessite également [indexer.read_state_service] et un zebrad compilé avec la fonctionnalité d'indexation afin que Zallet puisse lire directement l'état de la chaîne.
Des images reproductibles peuvent être compilées avec StageX (Docker 25+, magasin d'images containerd, GNU Make).
Conservez l'ancien répertoire de données de zcashd jusqu'à ce que vous ayez vérifié les soldes et testé une restauration.
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 n'est disponible que dans les builds dotés de la fonctionnalité zcashd-import. La lecture de wallet.dat nécessite db_dump issu de Berkeley DB 6.2, la version utilisée par zcashd.
Notes détaillées pour les opérateurs : .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Nature | Portefeuille RPC de nœud complet | Serveur de portefeuille axé sur les transactions protégées | Portefeuilles pour utilisateurs finaux | Nœud de consensus | Indexeur / remplaçant de lightwalletd |
| Remplace | Portefeuille de zcashd | Pas un clone direct de zcashd | Applications mobiles/de bureau | Nœud zcashd | lightwalletd |
| Nécessite un nœud local | Oui | Oui (Zebra par défaut) | Non (client léger) | C'est le nœud | Oui |
Zallet et zecd peuvent tous deux être placés devant Zebra. Choisissez Zallet si vous avez besoin de l'interface de portefeuille de z_* et d'une voie de migration depuis wallet.dat. Choisissez zecd si vous voulez un serveur axé sur les transactions protégées qui n'est explicitement pas un clone de zcashd.
Il existe un produit grand public distinct sur zallet.io qui reprend le même nom. Cette application n'a rien à voir avec ce projet.
zcashd| Compatibilité RPC zcashd |
| Conçu comme voie de compatibilité |
| Petit sous-ensemble choisi uniquement |
| Sans objet |
| Partielle / mode de compatibilité Zakura |
| API différente |
| Modèle de conservation | L'opérateur détient les clés dans wallet.db | Serveur récupérable par la graine | Clés sur l'appareil de l'utilisateur | Pas de portefeuille | Pas de clés |