Edit this page on GitHub (opens in a new tab)
Z3 Stack bụ ikpo okwu node nke Zcash Foundation chịkọtara: Zebra (full node) + Zallet (e-akpa ego full-node), yana indexer Zaino nhọrọ. Ọ bụ ihe e bu n'obi iji dochie usoro zcashd kwụụrụ onwe ya, nke jikọtara consensus na e-akpa ego n'otu binary ma kwụsị ndụ ya na 18 Julaị 2026.
Mmejuputa ntụaka bụ ọrụ Compose nke Docker dị na github.com/ZcashFoundation/z3.
zcashd ọnụ: Zebra na-enyocha chain, Zallet na-edobe igodo ma na-enye wallet RPC, ebe Zaino (nhọrọ) na-ekwu protocol gRPC nke lightwalletd.zcashd jikọtara node + e-akpa ego. Z3 na-ekewa ọrụ ndị a. Exchanges, pool ịgwụputa, na ndị ọrụ e-akpa ego full node ndị ọzọ na-akwaga na njikọta a kama na Zebra naanị.N'ọtụtụ ndụ Zcash, zcashd bụ ma full node ntụaka ma naanị e-akpa ego full node mmepụta. Nhazi ahụ bụ nke exchanges, pools, na ndị nlekota jikọtara megide.
zcashd alala ezumike nka. Consensus kwagara na (ma ugbu a kwa na ). E-akpa ego agbakwunyere kwagara na Zallet. Ijere e-akpa ego light ozi na-apụ na gaa na .
Akụkụ atọ ahụ bụ repository dị iche iche, usoro ntọhapụ dị iche iche, na config dị iche iche. Z3 bụ gluu: image akpọchiri, nyocha ahụike nke na-eme ka e-akpa ego ghara ịmalite ruo mgbe node mekọrịtara, ports na volumes maka netwọkụ nke ọ bụla, yana ụzọ onye ọrụ edere n'akwụkwọ.
Aha ahụ bụ mkpirisi okwu nkịtị n'ọrụ gburugburu ebe obibi — Zebra, Zaino, Zallet — n'agbanyeghị na faịlụ Compose ndabara na-amalite naanị Zebra na Zallet. Zaino bụ profile Compose, ọ bụghị usoro nke atọ a chọrọ.
┌──────────────────────── 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
| Akụkụ | Ọrụ ya na Z3 | A chọrọ ya? |
|---|---|---|
| Zebra | Na-emekọrịta ma na-enyocha chain, gossip, JSON-RPC, endpoint ahụike | Ee |
| Zallet | E-akpa ego full node. Na-etinye ọba akwụkwọ Zaino. Na-ejikọ ozugbo na JSON-RPC nke Zebra. Ọ dịghị akpọ container Zaino kwụụrụ onwe ya | Ee |
| Zaino | Indexer kwụụrụ onwe ya. gRPC kwekọrọ na lightwalletd maka ndị ahịa light mpụta, tinyere proxy JSON-RPC maka explorers na faucets | Mba — --profile indexer |
Z3 na-akpọchi nsụgharị image na docker-compose.yml. Jiri Z3_ZEBRA_IMAGE, Z3_ZAINO_IMAGE, ma ọ bụ Z3_ZALLET_IMAGE dochie ya ma ọ bụrụ na ịchọrọ tag ọzọ.
| zcashd | Z3 | |
|---|---|---|
| Asụsụ | C++ (fork Bitcoin) | Ọrụ Rust, nke Docker Compose na-ahazi |
| Ụdị usoro | Otu binary: node + e-akpa ego | Containers node na e-akpa ego dị iche |
| Consensus | Alala ezumike nka (EOS 18 Julaị 2026) | Zebra (ma ọ bụ node ọzọ kwekọrọ) |
| E-akpa ego | wallet.dat arụnyere n'ime ya | Zallet, datadir e ji age zoo |
| Ndị ahịa light | Ọtụtụ mgbe lightwalletd dị iche | Profile Zaino nhọrọ |
| Config | zcash.conf | Faịlụ maka netwọkụ ọ bụla n'okpuru config/<network>/ tinyere faịlụ env Compose |
Ọ bụrụ na ị ka nwere e-akpa ego zcashd, jiri ndu mbufe nke ZecHub na iwu migrate-zcashd-wallet nke Zallet kama idetuo wallet.dat n'ime volume Z3.
Z3 bụ ọrụ Compose atọ nọọrọ onwe ha. Ha anaghị ekerịta ports ma ọ bụ volumes.
| Netwọkụ | Aha ọrụ | Jiri ya maka | Mmekọrịta mbụ | Ezigbo ego |
|---|---|---|---|---|
| mainnet | z3-mainnet | Mmepụta | awa 24–72 | Ee |
| testnet | z3-testnet | Nhazi tupu mmepụta na netwọkụ ule ọha | awa 2–12 | Mba (ule ZEC) |
| regtest | z3-regtest | Omume mpaghara: blocks ozugbo, enweghị peers | Sekọnd | Mba |
Ndị ọrụ ọhụrụ kwesịrị ịmalite na regtest, gosi na RPC na usoro e-akpa ego na-arụ ọrụ, wee kwaga na testnet ma ọ bụ mainnet.
E bu n'obi ka netwọkụ atọ ahụ biri n'otu igwe. Uru ndị dị n'okpuru bụ ndabara e bipụtara; nke ọ bụla nwere ike dochie ya site na mgbanwe env Z3_* kwekọrọ. Matrix iwu bụ z3-contract.yaml.
| Ọrụ | Mainnet | Testnet | Regtest |
|---|---|---|---|
| JSON-RPC nke Zebra | 8232 | 18232 | 29232 |
| P2P nke Zebra | 8233 | 18233 | (ebipụtabeghị) |
Ahụike Zebra (/ready) | 8080 | 18080 | 28080 |
| gRPC nke Zaino (profile indexer) | 8137 | 18137 | 28137 |
| JSON-RPC nke Zaino (profile indexer) | 8237 | 18237 | 28237 |
| RPC nke Zallet | 28232 | 40232 | 50232 |
N'ime netwọkụ Compose, ọrụ na-achọta ibe ha site n'aha (zebra, zaino, zallet).
| Volume | Ihe ọ na-edobe | Kwado ya? |
|---|---|---|
z3-<network>-chain | Ọnọdụ chain Zebra (~300 GB mainnet) | Nhọrọ — enwere ike imekọrịta ya ọzọ |
z3-<network>-zallet | Database e-akpa ego ezoro ezo na njirimara age na-emeghe ya | Ee — nke a bụ naanị volume a ga-akwado |
z3-<network>-zaino | Ọnọdụ indexer (naanị na profile indexer) | Nhọrọ — enwere ike iwughachi ya |
z3-<network>-cookie | Kuki RPC nke Zebra | Mba — a na-emepụta ya ọzọ |
Iji tinye ọnọdụ chain na disk ọzọ tupu mmalite mbụ:
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 na-akwụsị stack ma debe volumes. Ịgbakwunye -v na-ehichapụ ha ma manye mmekọrịta zuru ezu ọzọ. Tinye --profile "*" ka e wee kwatuo n'ezie ọrụ ndị profile na-achịkwa (indexer, nlekota).
Ihe a chọrọ tupu amalite: Engine Docker, Compose Docker v2.24.4+, Git. A chọrọ openssl naanị maka regtest.
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
Lee docs/regtest.md maka iwu ule.
Zebra ga-emecharịrị mmekọrịta tupu Zallet aba uru. Ịmalite Zallet n'isi na-eme ka ọ banye na loop ịmalitegharịa ruo mgbe /ready bụ eziokwu.
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
Testnet bụ otu usoro ahụ na .env.testnet na ./scripts/check-zebra-readiness.sh 18080.
Ndozi n'okpuru config/<network>/ na-anọgide na mpaghara ma dịgide mgbe git pull gachara.
# 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
Ports Grafana ndabara bụ 3000 (mainnet), 13000 (testnet), 23000 (regtest).
:latest. Gbanwee pin n'ime mgbanwe enyochara, ma ọ bụ setịpụ Z3_<SERVICE>_IMAGE.ZEBRA_NETWORK__EXTERNAL_ADDR na adreesị ndị peers kwesịrị ịkpọ. Regtest enweghị peers.linux/amd64. Na Apple Silicon ọ na-agba n'okpuru emulation belụsọ ma i wuo ya site na source. Zebra na Zallet bụ multi-arch.deploy.resources.limits n'ime faịlụ override ma ọ bụrụ na igbe ahụ abụghị nke a raara nye node.Ndepụta nyocha na FAQ maka mmepụta: docs/faq.md, docs/docker-architecture.md.
Dabara nke ọma
zcashd dịka node-na-e-akpa egoỌtụtụ mgbe ọ bụghị ngwá ọrụ ziri ezi
| Netwọkụ n'otu host |
| Mkpọkọta port na-esiri ike |
Ọkwa mbụ: z3-mainnet, z3-testnet, z3-regtest |