L’outil de développement Zcash est une plateforme permettant de travailler sur Zcash. Il est conçu par des développeurs, pour des développeurs, afin de tester et développer de nouvelles fonctionnalités de Zcash ; il ne doit pas être considéré comme prêt pour la production. L’API en ligne de commande exposée par cet outil peut changer à tout moment et sans préavis. NE confiez PAS de fonds importants au wallet intégré de zcash-devtool.
Tutoriel vidéo sur l’outil de développement Zcash :
Kris Nuttycombe (@nuttycom) a présenté cet outil lors de ZconVI.
Pour un guide pas à pas expliquant comment commencer à utiliser ces outils, consultez ce tutoriel. Il présente en détail comment configurer et utiliser les outils zcash devtool. Il a pour objectif de vous guider dans la configuration et l’ajout de vos propres fonctionnalités à l’outil.
Démarrage rapide
Les commandes ci-dessous ont été vérifiées avec zcash-devtool main (commit 5a26ee8, août 2026). L’outil change sans préavis ; exécutez donc --help avec toute commande si quelque chose ici ne correspond plus.
Installation
Il n’existe aucun binaire précompilé. Installez Rust, puis compilez depuis les sources :
Code-highlight
git clone https://github.com/zcash/zcash-devtool.git
cd zcash-devtool
cargo run --release -- --help
Les exemples ci-dessous appellent le binaire compilé, target/release/zcash-devtool. cargo run --release -- ... fonctionne de la même manière.
Créer un wallet testnet
Commencez sur testnet. Les pièces testnet (TAZ) n’ont aucune valeur.
-w est le répertoire du wallet. Il se place après wallet et avant la sous-commande.
-i est un fichier d’identité age. La phrase mnémonique du wallet y est chiffrée, et le fichier est créé s’il n’existe pas. Conservez-le : send, shield et les autres commandes de dépense en ont besoin pour déchiffrer la seed.
-n correspond au réseau : test ou main.
-s sélectionne le serveur de light wallet. La valeur par défaut, zecrocks, se connecte au serveur zec.rocks du réseau choisi.
Pour restaurer un wallet existant, utilisez restore-mnemonic à la place de init. La commande demande la phrase.
balance liste chaque pool séparément, y compris Ironwood :
Exécutez zcash-devtool wallet -w ./my-wallet list-addresses pour voir l’adresse unifiée du wallet, puis envoyez-lui des fonds testnet depuis un faucet.
Pour mainnet, passez -n main à init. N’utilisez que des montants que vous pouvez vous permettre de perdre.
Envoyer et protéger
Les montants sont exprimés en zatoshis (1 ZEC = 100 000 000 zatoshis).
propose affiche la transaction qu’un send construirait, sans l’envoyer. list-tx et list-unspent affichent l’historique et les notes du wallet.
Toute commande qui communique avec un serveur accepte également --connection tor, qui fait passer la connexion par le client Tor intégré.
Inspecter les adresses, les clés et les transactions
inspect décode hors ligne les données Zcash : adresses, clés et transactions brutes. Ajoutez --lookup pour récupérer davantage d’informations depuis la chaîne, par exemple une transaction à partir de son identifiant.
Les notes Ironwood sont envoyées au même récepteur Orchard dans une adresse unifiée ; les adresses n’ont donc pas changé avec NU6.3.
Construire des transactions étape par étape avec des PCZT
Une PCZT (transaction Zcash partiellement créée) divise la construction d’une transaction en étapes distinctes : créer, prouver, signer et envoyer. Chaque étape peut s’exécuter sur une machine différente, par exemple avec un signataire matériel tel que Keystone. Chaque commande pczt lit la PCZT depuis un fichier ou stdin et l’écrit dans un fichier (--output) ou stdout ; les étapes peuvent donc être chaînées :
zcash-devtool pczt --help liste les autres étapes, notamment inspect, redact, combine, extract et shield.
Déplacer des fonds de Orchard vers Ironwood
Depuis NU6.3, les fonds Orchard ne peuvent être déplacés que vers les propres adresses du wallet. Les commandes migration les déplacent vers Ironwood :
plan prévisualise les divisions de notes et le calendrier de transfert, sans rien modifier.
commit construit et pré-signe les premières transactions de préparation. Ajoutez --external pour les laisser non signées afin qu’un signataire externe tel que Keystone les signe.
status affiche la progression de la migration et l’étape suivante.
advance prouve la prochaine transaction dont l’ancre est prête.
Les commandes de migration sont encore en cours de développement. advance s’arrête à la première transaction prête à être diffusée, car la diffusion n’est pas encore implémentée dans l’outil. Pour un usage quotidien, déplacez les fonds avec un wallet qui prend en charge Ironwood. Consultez Pools protégés.
Avertissements de sécurité :
N’UTILISEZ PAS CECI EN PRODUCTION !!!
L’application n’a pas été conçue en tenant compte de la sécurité. Elle possède toutefois des mécanismes tels que le chiffrement des phrases mnémoniques de seed, qui devraient la rendre viable pour des expérimentations à petite échelle, à vos propres risques.
