Edit this page on GitHub (opens in a new tab)
Zallet ist eine in Rust geschriebene Zcash-Wallet für Vollknoten. Sie ersetzt die Wallet, die früher in zcashd eingebettet war. Nachdem zcashd am 18. Juli 2026 bei Blockhöhe 3417100 das Ende seines Supports erreicht hatte, wurden Konsens- und Wallet-Aufgaben aufgeteilt: Zebra oder Zakura validieren die Chain, und Zallet verwaltet Schlüssel, scannt Notes und stellt die Wallet-JSON-RPC bereit.
Zallet befindet sich derzeit in der Beta-Phase. Es wurde noch nicht vollständig geprüft. Inkompatible Änderungen können das Löschen und Neuerstellen der Wallet erforderlich machen. Verwende es nicht als Verwahrungslösung für große Mengen an ZEC, ohne die Sicherheitswarnungen im The Zallet Book gelesen zu haben.
zcashd. Die Knoten-Hälfte ist Zebra oder Zakura.ReadStateService gegen einen lokalen zebrad) oder Zaino.wallet.db im Klartext vor.zallet (Starter), zallet-zebra und zallet-zaino.zcashd bündelte einen von Bitcoin Core abgeleiteten Konsens-Knoten und eine Wallet in einem Prozess. Dieses Design existiert nicht mehr.
| Rolle | Alter Stack | Aktueller Stack |
|---|---|---|
| Konsens / P2P | zcashd | Zebra (zebrad) oder Zakura |
| Wallet / Schlüssel / Guthaben | zcashd wallet.dat | Zallet (wallet.db) |
| Light-Client-Indexer | lightwalletd | Zaino oder lightwalletd |
Die Ausgliederung der Wallet aus dem Knoten bedeutet:
zcashd festzuhalten.Zallet ist die Wallet für Betreiber, die zcashd zuvor als Hot Wallet, Exchange-Backend, Faucet oder Mining-Auszahlungs-Wallet betrieben haben.
Zallet befindet sich in der Beta-Phase.
Das bedeutet in der Praxis:
zcashd wurde portiert.zcashd. Integrationen müssen die Seite zu geänderter Semantik lesen.Feedback gehört in GitHub-Issues oder in den Kanal #wallet-dev im Zcash R&D Discord.
Eine spätere stabile Phase ist geplant, sobald die vorgesehene RPC-Oberfläche existiert. Aufrufer werden dann voraussichtlich auf die Methoden von Zallet migrieren müssen, einschließlich der dokumentierten semantischen Unterschiede.
Zallet ist auf drei Cargo-Workspaces aufgeteilt, damit die beiden Chain-Backends unterschiedliche Abhängigkeitsgraphen verfolgen können.
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
Alle drei Binärdateien öffnen dieselbe wallet.db. Der Starter wählt zur Laufzeit ein Backend; zum Wechseln ist keine Neukompilierung nötig.
Typische Bereitstellung:
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 ist eine Wallet für Vollknoten: Sie erwartet einen lokalen validierenden Knoten. Sie ist kein Light Client. Informationen zu Light Wallets und Compact-Block-Servern findest du unter Zaino und Lightwallet-Knoten.
Der Zcash Foundation-Compose-Stack Z3 betreibt Zebra und Zallet zusammen, mit optionalem eigenständigem Zaino für externe Light Clients.
Zallet basiert auf ZIP 32 Accounts, nicht auf dem einzelnen impliziten Account von zcashd.
zip32seedfp1…) identifiziert.(seedfp, account index).z_getaddressforaccount erzeugt werden. Ein Account kann viele diversifizierte Adressen haben; Shielded Receiver sind on-chain nicht verknüpfbar.z_importkey) und Watch-only-Adressen (z_importaddress) werden zu UUID-Accounts, die von keiner Mnemonic abgedeckt werden.z_exportviewingkey, z_importviewingkey), einschließlich Unified Full Viewing Keys und Incoming Viewing Keys.getnewaddress ist nicht implementiert. Verwende z_getnewaccount und z_getaddressforaccount.
Wenn keystore.require_backup aktiviert ist (die migrierte Form von zcashds walletrequirebackup), verweigert Zallet das Ableiten neuer Ausgabeberechtigungen aus einer Mnemonic, deren Backup nicht bestätigt wurde.
Schlüsselmaterial wird immer verschlüsselt. Es gibt keinen unverschlüsselten Modus und keine encryptwallet-RPC — diese Methode von zcashd wurde nie vollständig unterstützt.
{datadir}/encryption-identity.txt.wallet.db gespeichert.generate-encryption-identity -p). Entsperre sie mit der walletpassphrase-RPC; sperre sie mit walletlock.wallet.db, die du aufbewahrst.Das Kopieren von wallet.db, während Zallet läuft, ist kein sicheres Backup. SQLite kann beschädigt werden. Bevorzuge einen gestoppten Prozess oder warte auf einen offiziellen Online-Backup-Befehl.
Zallet implementiert eine Teilmenge der zcashd-Wallet-RPCs über HTTP mit Basic Auth. Binde sie an Loopback. Remote-Nutzung sollte über einen verschlüsselten Tunnel erfolgen. rpc.allow_insecure_remote_bind existiert und ist unsicher.
Wesentliche Unterschiede zu zcashd:
getwalletinfo sind leer. Verwende z_getbalances, z_getbalanceforaccount, z_gettotalbalance.settxfee.ClientInInitialDownload / ForbiddenBySafeMode).Bewusst ausgelassene Methoden umfassen createrawtransaction, fundrawtransaction, getnewaddress, getrawchangeaddress, keypoolrefill, importwallet und encryptwallet. Ersatzmethoden sind im Zallet Book aufgeführt.
Offizielle Installationswege (Debian-Pakete, Docker, Release-Binärdateien) findest du im Installationsleitfaden. Release-Archive heißen zallet-<version>-<arch>.tar.gz und enthalten alle drei Binärdateien.
Minimaler Ablauf für eine neue Wallet:
# 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
Richte [indexer] auf einen lokalen zebrad-JSON-RPC-Endpunkt aus. Das Zebra-Backend benötigt außerdem [indexer.read_state_service] und einen mit der Indexer-Funktion kompilierten zebrad, damit Zallet den Chain-Zustand direkt lesen kann.
Reproduzierbare Images können mit StageX erstellt werden (Docker 25+, containerd-Image-Store, GNU Make).
Bewahre das alte zcashd-Datadir auf, bis du Guthaben bestätigt und eine Wiederherstellung getestet hast.
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 ist nur in Builds mit der Funktion zcashd-import verfügbar. Das Lesen von wallet.dat erfordert db_dump aus Berkeley DB 6.2, der von zcashd verwendeten Version.
Schrittweise Hinweise für Betreiber: .
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| Was es ist | RPC-Wallet für Vollknoten | Shielded-first-Wallet-Server | Endnutzer-Wallets | Konsens-Knoten | Indexer / lightwalletd-Ersatz |
| Ersetzt | zcashd-Wallet | Kein direkter zcashd-Klon | Mobile/Desktop-Apps | zcashd-Knoten | lightwalletd |
| Benötigt einen lokalen Knoten | Ja | Ja (standardmäßig Zebra) | Nein (Light Client) | Ist selbst der Knoten | Ja |
Zallet und zecd können beide vor Zebra eingesetzt werden. Wähle Zallet, wenn du die Wallet-Oberfläche von z_* und einen Migrationspfad von wallet.dat benötigst. Wähle zecd, wenn du einen Shielded-first-Server möchtest, der ausdrücklich kein zcashd-Klon ist.
Unter zallet.io gibt es ein separates Verbraucherprodukt, das denselben Namen verwendet. Diese App ist nicht dieses Projekt.
zcashd-Knoten| zcashd-RPC-Kompatibilität |
| Als Kompatibilitätspfad konzipiert |
| Nur kleine, gezielt ausgewählte Teilmenge |
| N/A |
| Teilweise / Zakura-Kompatibilitätsmodus |
| Andere API |
| Verwahrungsmodell | Betreiber verwaltet Schlüssel in wallet.db | Über Seed wiederherstellbarer Server | Schlüssel auf dem Nutzergerät | Keine Wallet | Keine Schlüssel |