Edit this page on GitHub (opens in a new tab)
Z3 スタック(Z3 Stack)は、Zcash Foundationがパッケージ化したノードプラットフォームです。Zebra(フルノード)とZallet(フルノードウォレット)、および任意のZainoインデクサーで構成されます。コンセンサスとウォレットを1つのバイナリにまとめ、2026年7月18日にサポート終了となったスタンドアロンのzcashdプロセスを置き換えることを目的としています。
参照実装は、github.com/ZcashFoundation/z3にあるDocker Composeプロジェクトです。
zcashd後のスタックをまとめて実行する方法です。zcashdはノードとウォレットを1つにまとめていました。Z3はこれらの役割を分離します。取引所、マイニングプール、その他のフルノードウォレット運用者は、Zebra単体ではなくこの組み合わせへ移行します。Zcashの歴史の大半において、zcashdは参照フルノードであると同時に、唯一の本番用フルノードウォレットでもありました。この設計は、取引所、プール、カストディアンが統合対象としていたものです。
zcashdは廃止されました。コンセンサスはへ移行し、現在はにも対応しています。組み込みウォレットはZalletへ移行しました。ライトウォレットの提供は、からへ移行中です。
この3つは別々のリポジトリ、別々のリリースサイクル、別々の設定を持ちます。Z3はそれらをつなぐ役割を果たします。固定されたイメージ、ノードの同期が完了するまでウォレットを停止状態に保つヘルスチェック、ネットワークごとのポートとボリューム、そして文書化された運用手順を提供します。
この名称は、Zebra、Zaino、Zalletを指す非公式なエコシステム上の略称です。ただし、標準のComposeファイルが起動するのはZebraとZalletのみです。Zainoは必須の第3プロセスではなく、Composeプロファイルです。
┌──────────────────────── Z3 (per network) ────────────────────────┐
│ │
peers ◄──P2P──► Zebra (zebrad) ──JSON-RPC──► Zallet │
│ full node │ embeds Zaino libraries │
│ │ wallet RPC for operators │
│ └─────────────────────────────────┤
│ │
│ Zaino (optional, --profile indexer) │
│ lightwalletd-compatible gRPC + JSON-RPC proxy │
│ │ │
└────────────┼─────────────────────────────────────────────────────┘
▼
light wallets / explorers
| コンポーネント | Z3での役割 | 必須ですか? |
|---|---|---|
| Zebra | チェーンの同期・検証、ゴシップ、JSON-RPC、ヘルスエンドポイント | はい |
| Zallet | フルノードウォレットです。Zainoライブラリを組み込みます。Zebra JSON-RPCへ直接接続します。スタンドアロンのZainoコンテナは呼び出しません。 | はい |
| Zaino | スタンドアロンインデクサーです。外部ライトクライアント向けのlightwalletd互換gRPCに加え、エクスプローラーとフォーセット向けのJSON-RPCプロキシを提供します。 | いいえ — --profile indexer |
Z3はdocker-compose.ymlでイメージバージョンを固定します。異なるタグが必要な場合は、Z3_ZEBRA_IMAGE、Z3_ZAINO_IMAGE、またはZ3_ZALLET_IMAGEで上書きしてください。
| zcashd | Z3 | |
|---|---|---|
| 言語 | C++(Bitcoinフォーク) | Rustサービス、Docker Composeによるオーケストレーション |
| プロセスモデル | 1つのバイナリ:ノード + ウォレット | 分離されたノードおよびウォレットコンテナ |
| コンセンサス | 廃止済み(2026年7月18日にサポート終了) | Zebra(または別の互換ノード) |
| ウォレット | 組み込みのwallet.dat | Zallet、age暗号化済みデータディレクトリ |
| ライトクライアント | 通常は別のlightwalletd | 任意のZainoプロファイル |
| 設定 | zcash.conf | config/<network>/配下のネットワーク別ファイルとCompose環境ファイル |
| 1ホスト上のネットワーク | 厄介なポート競合 |
zcashdウォレットをまだ使用している場合は、wallet.datをZ3ボリュームへコピーするのではなく、ZecHubのとZalletのmigrate-zcashd-walletコマンドを使用してください。
Z3は3つの独立したComposeプロジェクトです。ポートやボリュームを共有しません。
| ネットワーク | プロジェクト名 | 用途 | 初回同期 | 実資金 |
|---|---|---|---|---|
| メインネット | z3-mainnet | 本番運用 | 24~72時間 | はい |
| テストネット | z3-testnet | 公開テストネット上でのステージング | 2~12時間 | いいえ(テストZEC) |
| regtest | z3-regtest | ローカル練習:即時ブロック、ピアなし | 数秒 | いいえ |
新しい運用者は、まずregtestで開始し、RPCとウォレットのフローを確認してから、テストネットまたはメインネットへ移行してください。
3つのネットワークはすべて、1台のマシン上で共存することを想定しています。以下の値は公開されている標準値であり、対応するZ3_*環境変数で上書きできます。正規の一覧はz3-contract.yamlです。
| サービス | メインネット | テストネット | Regtest |
|---|---|---|---|
| Zebra JSON-RPC | 8232 | 18232 | 29232 |
| Zebra P2P | 8233 | 18233 | (未公開) |
Zebraヘルス(/ready) | 8080 | 18080 | 28080 |
| Zaino gRPC(インデクサープロファイル) | 8137 | 18137 | 28137 |
| Zaino JSON-RPC(インデクサープロファイル) | 8237 | 18237 | 28237 |
| Zallet RPC | 28232 | 40232 | 50232 |
Composeネットワーク内では、サービスは名前で解決されます(zebra、zaino、zallet)。
| ボリューム | 保存内容 | バックアップしますか? |
|---|---|---|
z3-<network>-chain | Zebraチェーン状態(メインネットでは約300 GB) | 任意 — 再同期可能です |
z3-<network>-zallet | 暗号化済みウォレットデータベースおよびロック解除に使用するageアイデンティティ | はい — バックアップが必須なのはこのボリュームのみです |
z3-<network>-zaino | インデクサー状態(インデクサープロファイル使用時のみ) | 任意 — 再構築可能です |
z3-<network>-cookie | Zebra RPCクッキー | いいえ — 再生成されます |
初回起動前にチェーン状態を別のディスクへ置くには、次のようにします。
export Z3_CHAIN_DATA_PATH=/mnt/ssd/zebra-state
./scripts/fix-permissions.sh zebra /mnt/ssd/zebra-state
docker compose --env-file .env.<network> --profile "*" downはスタックを停止し、ボリュームを保持します。-vを追加するとボリュームが削除され、完全な再同期が必要になります。プロファイルで制御されるサービス(インデクサー、モニタリング)も確実に停止するよう、--profile "*"を含めてください。
前提条件:Docker Engine、Docker Compose v2.24.4以降、Git。opensslはregtestでのみ必要です。
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
テストコマンドについては、docs/regtest.mdを参照してください。
Zebraの同期が完了するまで、Zalletは有用ではありません。Zalletを早期に起動すると、/readyが真になるまで再起動ループに入ります。
git clone https://github.com/ZcashFoundation/z3 && cd z3
# 1. One-time setup: local config + Zallet wallet identity
./scripts/setup-network.sh mainnet
# 2. Start Zebra and wait until it is synced
docker compose --env-file .env.mainnet up -d zebra
./scripts/check-zebra-readiness.sh
# 3. Start Zallet (and anything else in the default profile)
docker compose --env-file .env.mainnet up -d
テストネットでも、.env.testnetと./scripts/check-zebra-readiness.sh 18080を使って同じ手順を行います。
config/<network>/配下の編集はローカルに保持され、git pull後も残ります。
# Lightwalletd-compatible gRPC + JSON-RPC proxy
docker compose --env-file .env.mainnet --profile indexer up -d
# Prometheus, Grafana, Jaeger, Alertmanager
docker compose --env-file .env.mainnet --profile monitoring up -d
標準のGrafanaポートは、3000(メインネット)、13000(テストネット)、23000(regtest)です。
:latestへ追従しません。レビュー済みの変更で固定値を更新するか、Z3_<SERVICE>_IMAGEを設定してください。ZEBRA_NETWORK__EXTERNAL_ADDRを設定してください。regtestにはピアがありません。linux/amd64専用です。Apple Siliconでは、ソースからビルドしない限りエミュレーションで実行されます。ZebraとZalletはマルチアーキテクチャです。deploy.resources.limitsを追加してください。本番環境を想定したチェックリストとFAQについては、docs/faq.md、docs/docker-architecture.mdを参照してください。
適しているケース
zcashdをノード兼ウォレットとして使用していた取引所、カストディアン、マイニングプール通常は適していないケース
第1級対応:z3-mainnet、z3-testnet、z3-regtest |