Guide de migration : de zcashd vers Zebrad/Zallet
Le nœud complet traditionnel zcashd, maintenu par Electric Coin Company (ECC) / Zodl, a été remplacé par Zebra et Zallet. zcashd a atteint son arrêt de fin de support le 18 juillet 2026 et ne fonctionne plus.
- Zebra est une implémentation moderne en Rust du protocole Zcash, développée par la Zcash Foundation
- Zallet est un wallet léger conçu pour s'interfacer de façon transparente avec les nœuds Zebra, développé par Zodl
Ce guide vous accompagne dans la migration de zcashd vers Zebrad et Zallet, y compris l'installation, l'importation du wallet et la résolution des problèmes courants de migration.
zcashd a cessé de fonctionner le 18 juillet 2026
Ce que cela signifie
- zcashd a atteint son arrêt de fin de support le 18 juillet 2026. Il ne se synchronisera plus avec la pointe de la chaîne et ne peut ni envoyer ni recevoir de fonds. C'est terminé, pas prévu.
- Les deux fonctions de zcashd sont désormais séparées : zebrad est le nœud complet et Zallet est le wallet.
- Zallet est en bêta. Des changements incompatibles peuvent survenir entre les versions, et certaines méthodes JSON-RPC de zcashd ne sont pas encore implémentées. Consultez la matrice d'état des méthodes avant de dépendre d'un appel précis.
- Si vous détenez encore des fonds Sprout, lisez d'abord l'avertissement de l'étape 6. Zallet ne prend pas en charge le pool Sprout, et la méthode habituelle pour déplacer ces fonds nécessitait un zcashd en fonctionnement.
Pourquoi migrer — au-delà de l'abandon
Même sans tenir compte de l'abandon, il existe des raisons convaincantes de migrer :
- Sécurité et robustesse : la sûreté mémoire de Rust et les outils modernes réduisent les risques de vulnérabilités.
- Performances et efficacité : Zebrad est conçu pour le parallélisme, une utilisation plus efficace des ressources et une synchronisation plus rapide.
- Architecture modulaire : séparer la logique de nœud (Zebrad) de l'interface du wallet (Zallet) offre des limites plus claires et de meilleures possibilités de mise à niveau.
- Compatibilité avec le futur écosystème : les outils, améliorations et le reste de l'écosystème Zcash cibleront de plus en plus Zebrad/Zallet.
- Tranquillité d'esprit : évitez de vous retrouver à exécuter un composant obsolète et non pris en charge.
Passons maintenant au guide de migration
1. Sauvegardez tout
- Sauvegardez votre wallet.dat (ou tout autre fichier de wallet / magasin de clés) depuis votre nœud zcashd.
- Enregistrez votre zcash.conf et tous les paramètres personnalisés.
- Exportez une copie de tous les scripts RPC ou automatisations que vous utilisez.
- Vérifiez que vos sauvegardes sont valides (par exemple, dans un autre environnement, essayez de les ouvrir ou de les inspecter).
- Examinez les méthodes JSON-RPC dont vous dépendez actuellement.
- Comparez-les avec le tableau de compatibilité prévu maintenu sur le site d'assistance Zcash
- Préparez-vous aux changements ou aux méthodes manquantes (certaines peuvent nécessiter une solution de contournement ou une adaptation).
2. Configuration système et espace disque
- L'espace disque est une exigence que les gens sous-estiment. La chaîne Zcash a dépassé 270 Go en août 2026 ; prévoyez donc au moins 300 Go d'espace libre, sur un SSD si possible.
- Assurez-vous que votre machine dispose d'un réseau, d'un processeur et d'une mémoire vive stables.
- Une connexion Internet
- Si vous prévoyez de compiler depuis les sources, installez Rust et Cargo.
3. Installer / configurer Zebrad
Vous pouvez soit télécharger un binaire précompilé, soit compiler depuis les sources.
Option A : installer via un binaire précompilé
Sous Linux/macOS :
Cela installe la dernière version stable de zebrad.
Option B : compiler depuis les sources
Après la compilation, déplacez le binaire dans votre chemin :
4. Configuration et lancement
Générez une configuration par défaut :
Modifiez zebrad.toml selon vos préférences (adresse d'écoute, ports, répertoire d'état, mise en cache).
Démarrez le nœud :
Le nœud commencera la synchronisation depuis le bloc de genèse ; prévoyez plusieurs heures (ou plus) selon le matériel et le réseau.
5. Installer / configurer Zallet (wallet)
Zallet est conçu pour remplacer la partie wallet de zcashd.
Consultez la page GitHub / des versions de Zallet pour les binaires.
Ou compilez depuis les sources :
- Lancez l'interface graphique ou la CLI (selon votre installation).
- Configurez-la pour se connecter à votre nœud Zebrad local via un point de terminaison RPC ou API.
6. Importer votre wallet zcashd dans Zallet
Vous n'avez pas besoin d'un zcashd en fonctionnement pour cela. Zallet lit directement le fichier wallet.dat, ce qui est important car zcashd ne peut plus être démarré.
Conservez wallet.dat. La migration signale tout élément qu'elle ne peut pas représenter dans un wallet Zallet au lieu de l'importer, et ce matériel de clé n'existe alors que dans wallet.dat. Ne le supprimez pas après la migration.
Exécutez d'abord zallet init-wallet-encryption. Zallet chiffre le matériel de clé avec une identité age, et cette identité doit exister avant l'importation de clés.
Convertissez ensuite votre configuration et votre wallet :
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 est présent uniquement dans les compilations incluant la fonctionnalité zcashd-import, et la lecture de wallet.dat nécessite l'utilitaire db_dump de Berkeley DB 6.2, la version utilisée par zcashd. Si vous avez plus d'un fichier de wallet, exécutez la commande une fois par fichier et ajoutez --allow-multiple-wallet-imports lors des exécutions suivantes ; chacun deviendra son propre ensemble de comptes. Vos rpcuser et rpcpassword ne sont pas transférés, car le JSON-RPC de Zallet utilise par défaut l'authentification par cookie ; ajoutez des identifiants avec zallet add-rpc-user si vous en avez besoin.
Ce qui est transféré
- Les graines mnémoniques et les clés qui en sont dérivées, avec des comptes reconstruits pour correspondre au wallet zcashd
- Les clés de dépense Sapling importées de façon autonome et les clés transparentes
- Les entrées transparentes en lecture seule comprenant leur clé publique ou leur script de rachat
- Les dates de naissance des comptes, afin que l'analyse de la chaîne commence à la bonne hauteur
Ce qui n'est pas transféré. Ces éléments sont signalés avec leur nombre au lieu d'être importés :
- Clés de dépense et fonds Sprout. Zallet ne prend pas en charge le pool Sprout. La méthode documentée consistait à déplacer les fonds Sprout avec zcashd avant son retrait, et ce n'est désormais plus possible. Si cela vous concerne, demandez conseil sur le Discord R&D de Zcash ou le forum communautaire avant toute autre action.
- Les entrées du carnet d'adresses
- Les entrées en lecture seule enregistrées sans clé publique ni script de rachat, ainsi que les entrées comportant des clés publiques non compressées
- Les wallets Regtest
Sauvegarde après migration. Une phrase mnémonique seule ne constitue pas une sauvegarde complète, car les clés importées n'existent que dans la base de données du wallet. Conservez des copies sécurisées de wallet.db, du fichier d'identité de chiffrement age nommé par l'option keystore.encryption_identity, ainsi que de votre phrase mnémonique, et conservez le wallet.dat d'origine. Notez que wallet.db n'est pas lui-même chiffré : il contient votre historique de transactions et vos clés de visualisation en clair ; stockez donc la sauvegarde dans un emplacement sûr.
Nouvelle analyse et synchronisation du wallet
- Une fois les clés importées, Zallet déclenchera une nouvelle analyse de la chaîne via Zebrad.
- Prévoyez un peu de temps pour que Zallet reconstruise votre solde et votre historique de transactions.
7. Vérifier les soldes et la synchronisation
Une fois l'importation terminée, Zallet se connectera à votre nœud Zebrad et analysera à nouveau la blockchain.
Lorsque la synchronisation sera terminée, vos soldes et transactions devraient apparaître exactement comme auparavant.
Vous pouvez vérifier l'état de synchronisation de votre nœud en exécutant :
Ou consultez les journaux.
8. Résolution des problèmes
| Problème | Cause possible | Solution |
|---|
| Zebrad ne démarre pas | Port utilisé ou mauvaise configuration | Vérifiez zebrad.toml et utilisez un port libre |
| Synchronisation lente | Congestion du réseau | Assurez-vous d'avoir une connexion Internet stable, redémarrez Zebrad |
| Transactions manquantes dans le wallet | Importation partielle des clés | Réimportez les clés ou effectuez une nouvelle analyse dans Zallet |
| Zallet ne peut pas se connecter au nœud | Nœud non exécuté ou mauvais point de terminaison | Démarrez Zebrad et vérifiez le bon port RPC |
| Zallet plante | Compilation obsolète | Mettez à jour vers la dernière version depuis GitHub |
9. Conclusion
Migrer de zcashd vers Zebrad et Zallet vous offre une expérience Zcash plus rapide, plus sûre et plus moderne.
Grâce à la sécurité fondée sur Rust, à une conception modulaire et à de meilleurs outils, cette configuration garantit que votre nœud et votre wallet restent prêts pour l'avenir à mesure que l'écosystème Zcash continue d'évoluer.
Conseil : conservez vos clés de wallet hors ligne et sauvegardez régulièrement vos données Zallet.
Visitez zebra.zfnd.org pour Zebra, et The Zallet Book ou le dépôt Zallet pour Zallet. Le chapitre Migrer depuis zcashd de The Zallet Book est la référence faisant autorité pour l'étape 6.
