Edit this page on GitHub (opens in a new tab)
Zalletは、Rustで記述されたフルノード(full-node)のZcashウォレット(wallet)です。これは以前zcashdに組み込まれていたウォレットの後継です。zcashdが2026年7月18日、ブロック(block)高3417100でサポート終了の停止に達した後、コンセンサス(consensus)とウォレットの役割は分離されました。ZebraまたはZakuraがチェーン(chain)を検証し、Zalletが鍵を保持してノート(note)をスキャンし、ウォレットJSON-RPCを公開します。
Zalletは現在ベータ版です。完全なレビューはまだ実施されていません。破壊的変更により、ウォレットを削除して再作成する必要が生じる場合があります。The Zallet Bookのセキュリティ警告を読まずに、多額のZECを本番環境でカストディとして扱わないでください。
zcashdのウォレット部分を置き換えます。ノード部分はZebraまたはZakuraです。zebradに対する直接ReadStateService)またはZainoです。wallet.db内に平文で保存されます。zallet(ランチャー)、zallet-zebra、zallet-zainoの3つのバイナリが含まれます。zcashdは、Bitcoin Core由来のコンセンサスノードとウォレットを1つのプロセスにまとめていました。この設計は廃止されました。
| 役割 | 旧スタック | 現行スタック |
|---|---|---|
| コンセンサス / P2P | zcashd | Zebra(zebrad)またはZakura |
| ウォレット / 鍵 / 残高 | zcashd wallet.dat | Zallet(wallet.db) |
| ライトクライアントのインデクサー | lightwalletd | Zainoまたはlightwalletd |
ウォレットをノードから分離することには、次の意味があります。
zcashd固有の挙動に固定されません。Zalletは、以前zcashdをホットウォレット、取引所バックエンド、フォーセット(faucet)、またはマイニング(mining)報酬用ウォレットとして運用していた事業者向けのウォレットです。
Zalletはベータ版です。
実際には、これは次を意味します。
zcashdウォレットRPCが移植されているわけではありません。zcashdとはセマンティクスが異なります。統合ではaltered-semantics pageを読む必要があります。フィードバックは、GitHub issues、またはZcash R&D Discord上の#wallet-devチャンネルへ送ってください。
想定されるRPC表面が整った後、後の安定フェーズが計画されています。その時点で呼び出し側は、文書化されたセマンティクスの差異を含め、Zalletのメソッドへ移行することが期待されます。
Zalletは、2つのチェーンバックエンドが異なる依存関係グラフを追跡できるよう、3つのCargoワークスペースに分かれています。
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
3つのバイナリはいずれも同じwallet.dbを開きます。ランチャーは実行時にバックエンドを選択するため、切り替えのために再コンパイルする必要はありません。
典型的なデプロイメント:
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はフルノードウォレットです。ローカルの検証ノードを必要とします。ライトクライアントではありません。ライトウォレットおよびコンパクトブロックサーバーについては、ZainoとLightwallet Nodesを参照してください。
Zcash FoundationのZ3 composeスタックは、ZebraとZalletを一緒に実行し、外部ライトクライアント向けにオプションでスタンドアロンのZainoを実行します。
Zalletは、zcashdの単一の暗黙的アカウントではなく、ZIP 32アカウントを中心に構築されています。
zip32seedfp1…)によって識別されます。(seedfp, account index)です。z_getaddressforaccountで生成されるZIP 316統合アドレスです。1つのアカウントは多数の多様化アドレスを持つことができ、シールドされた(shielded)受信者はオンチェーン(on-chain)ではリンクできません。z_importkey)とウォッチ専用アドレス(z_importaddress)は、ニーモニックがカバーしないUUIDアカウントになります。z_exportviewingkey、z_importviewingkey)。getnewaddressは実装されていません。z_getnewaccountおよびz_getaddressforaccountを使用してください。
keystore.require_backupがオンの場合(zcashdのwalletrequirebackupを移行した形式)、Zalletは、バックアップが確認されていないニーモニックから新しい支出権限を導出することを拒否します。
鍵素材は常に暗号化されます。暗号化なしのモードはなく、encryptwallet RPCもありません。そのzcashdメソッドは完全にはサポートされていませんでした。
{datadir}/encryption-identity.txtのageアイデンティティが作成されます。wallet.dbにage暗号文として保存されます。generate-encryption-identity -p)。walletpassphrase RPCでロック解除し、walletlockでロックしてください。wallet.dbのコピーを(別途暗号化して)バックアップしてください。Zalletの実行中にwallet.dbをコピーしても、安全なバックアップにはなりません。SQLiteの書き込みが破損する可能性があります。プロセスを停止するか、公式のオンラインバックアップコマンドを待つことを推奨します。
Zalletは、Basic認証付きHTTP経由でzcashdウォレットRPCのサブセットを実装します。ループバックにバインドしてください。リモート利用は暗号化トンネル経由にしてください。rpc.allow_insecure_remote_bindは存在しますが、安全ではありません。
zcashdとの主な違い:
getwalletinfoの残高フィールドは空です。z_getbalances、z_getbalanceforaccount、z_gettotalbalanceを使用してください。settxfeeはありません。ClientInInitialDownload / ForbiddenBySafeMode)。意図的に省かれたメソッドには、createrawtransaction、fundrawtransaction、getnewaddress、getrawchangeaddress、keypoolrefill、importwallet、encryptwalletがあります。代替手段はZallet Bookに記載されています。
公式のインストール手順(Debianパッケージ、Docker、リリースバイナリ)は、installation guideにあります。リリースアーカイブはzallet-<version>-<arch>.tar.gzという名前で、3つのバイナリすべてを含みます。
最小限の新規ウォレット作成フロー:
# 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
[indexer]をローカルのzebrad JSON-RPCエンドポイントに向けてください。zebraバックエンドには[indexer.read_state_service]と、Zalletがチェーン状態を直接読めるようインデクサー機能を有効にしてビルドしたzebradも必要です。
再現可能なイメージは、StageXを使用してビルドできます(Docker 25以降、containerdイメージストア、GNU Make)。
残高を確認し、復元テストが完了するまで、旧zcashdデータディレクトリを保持してください。
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は、zcashd-import機能を有効にしたビルドにのみ含まれます。wallet.datを読み取るには、zcashdが使用していたバージョンであるBerkeley DB 6.2のdb_dumpが必要です。
事業者向けの手順詳細:。
| Zallet | zecd | Zashi / ZODL / YWallet | Zebra / Zakura | Zaino | |
|---|---|---|---|---|---|
| 種別 | フルノードRPCウォレット | シールド優先のウォレットサーバー | エンドユーザー向けウォレット | コンセンサスノード | インデクサー / lightwalletdの後継 |
| 置き換えるもの | zcashdウォレット | 代替可能なzcashdクローンではない | モバイル/デスクトップアプリ | zcashdノード | lightwalletd |
| ローカルノードが必要か | はい | はい(デフォルトではZebra) | いいえ(ライトクライアント) | それ自体がノードです | はい |
| zcashd RPC互換性 | 互換性のための経路として設計 |
ZalletとzecdはいずれもZebraの前段に配置できます。z_*ウォレット表面とwallet.datからの移行経路が必要な場合はZalletを選んでください。明確にzcashdクローンではないシールド優先サーバーが必要な場合はzecdを選んでください。
zallet.ioには、同じ名前を再利用した別の消費者向け製品があります。そのアプリはこのプロジェクトではありません。
zcashdノード| 選定された小規模なサブセットのみ |
| 該当なし |
| 部分的 / Zakura互換モード |
| 異なるAPI |
| カストディモデル | 事業者がwallet.db内で鍵を保有 | シード復元可能なサーバー | ユーザーデバイス上の鍵 | ウォレットなし | 鍵なし |