Edit this page on GitHub (opens in a new tab)
Z3 Stack no yɛ Zcash Foundation's packaged node platform: Zebra (full-node) + Zallet, a optional Zaino indexer wɔ mu. ɛyɛ ɔdan bi a ɛgyina hɔ ma wɔn ankasa de di dwuma na wɔde hyɛ ne ho so sɛ ɛno ara bɛyɛ adwuma ama amanɔnefoɔ nyinaa. zcashd kwan a wɔfa so de consensus ne wallet di dwuma wɔ ɔfã baako mu na ɛbɛwie adwuma no July 18, 2026.
Reference implementation yɛ Docker Compose project wɔ United States. github.com/ZcashFoundation/z3.
zcashd faako: Zebra di chain no ho dwuma, Zallet na ɛhwɛ keys so ma wallet RPC, ne Zaino (ɛwɔsɛ) kasa lightwalletd gRPC protocol.zcashd Z3 ** kyekyɛ saa dwumadie no**. Nkrataa a wɔde di dwuma, ne wɔn a wɔyɛ adwuma wɔ sika ho nneɛma mu nyinaa tu kɔ faako yi sen sɛ wɔbɛkɔ akɔfa Zebra nko ara so.Wɔ Zcash nkwa nna mu no, na ɔhwɛ sɛ ne nsa bɛka sika a ɔde resesaw akatua biara. zcashd Saa mfoni no yɛ nea nkyereso, nnwumakuo ne wɔn a wɔhwɛ so nya ho mfaso.
zcashd W'ahyehyɛde no akɔ n'akyi. (na afei nso) Ԑwɔsԑ wohyԑ no sԑnea wobedi dwuma. ZalletƆdan a wɔde sika nkontaabu tiawa ma no fi hɔ. to .
Saa nkrataafa yi yɛ nnwoma a wɔagye ato hɔ, nea wɔde to gua na ɛsan nso hyɛ no nsow. Z3 ne adebɔ: mfoni a wɔayɛ ho adwuma, apɔwmuden nsesaeɛ a ɛma wallet no so kosi sɛ node no bɛyɛ sync, ports biara-network ne mpɔw ahorow, ɛne ɔhwɛfoɔ akwankyerɛ krataa mu nsɛm nyinaa.
Din no yɛ nhyehyɛeɛ a ɛnnyɛ adwuma ho ntweasoɔ Zebra, Zaino, Zallet mpo sɛ nea wɔhyɛ ase di dwuma ne sɛ Compose fael no hyɛ aseɛ ma zebra na zallet. zaino yε compose profile bi, ɛnyɛ ade foforɔ biara.
┌──────────────────────── 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
| Component no | Dwuma a edi wɔ Z3 | Ɛhia? |
|---|---|---|
| Zebra | Syncs na ɛma nkɔnsɔnkɔnsɔn, nsɛmmɔnedi, JSON-RPC, akwahosan awiei no yɛ nokware | Aane |
| Zallet | Full-node sika kotoku. Embeds Zaino nhomakorabea ahorow. Nkitahodi tẽẽ kɔ Zebra JSON-RPC so. Ɛnyɛ ɛnyɛ frɛ Zaino ahina a egyina hɔ ma ne ho no | Aane |
| Zaino | Indexer a egyina hɔ ma ne ho. lightwalletd-compatible gRPC ma abɔnten hann afɛfoɔ, ne JSON-RPC proxy ma explorers ne faucets | No — --profile indexer |
Z3 pin mfoni nkyerɛaseɛ wɔ mu. docker-compose.yml. Fa di dwuma wɔ ne nyinaa so Z3_ZEBRA_IMAGE, Z3_ZAINO_IMAGE, or Z3_ZALLET_IMAGE sɛ wohia krataa foforo a.
| zcashd | Z3 | |
|---|---|---|
| Kasa | C++ (Bitcoin kyɛnsee) | Rust dwumadie, a wɔde Docker Compose ayɛ ho nhyehyɛeɛ |
| Adeyɛ ho nhwɛso | Binary biako: node + sika kotoku | Tetew node ne wallet nsukorade ahorow mu |
| Nneɛma a wɔpene so | Ɔkɔ pɛnhyen (EOS 18 Ɔpɛpɔn 2026) | Zebra (anaasɛ node foforo a ɛne no hyia) |
| Sikabɔtɔ | Wɔde ahyɛ mu wallet.dat | Zallet, mfe a wɔadi ho nsɛm a wɔde asie datadir |
| Hann akrafo | Mpɛn pii no, ɛyɛ lightwalletd a ɛyɛ soronko | Zaino profile a wopɛ |
| Config | zcash.conf | Per-network fael ahorow a ɛwɔ ase config/<network>/ nea ɛka ho ne Compose env fael ahorow |
Sɛ wowɔ wo ho a, ma w'ani nnye. zcashd wallet, use ZecHub’s and Zallet’s migrate-zcashd-wallet hyɛ paneɛ no sɛ anka wobɛyɛ ne copy wallet.dat wɔ Z3 mu.
Z3 yɛ nnwumakuw a wɔn ho nni mu, na wonni port anaa volume biara.
| Nɛtwɛke | Dwumadie no din | Fa di dwuma ma | Nea edi kan no, sync | Sika ankasa |
|---|---|---|---|---|
| afiri titiriw | z3-mainnet | Adeyɛ | nnɔnhwerew 24–72 | Aane |
| sɔhwɛ afiri | z3-testnet | Staging wɔ ɔmanfo sɔhwɛ ntam nkitahodi so | Nnɔnhwerew 2–12 | Dabi (sɔhwɛ ZEC) |
| regtest | z3-regtest | Mpɔtam hɔ adeyɛ: ntɛm ara blocks, atipɛnfo biara nni hɔ | Sekan kakraa bi | No |
Ɛsɛ sɛ wɔn a wɔyɛ adwuma foforo no fi ase wɔ "regtest" so, na wogye RPC ne sika kotoku mu di ansa na wɔatumi akɔ testnet anaa mainnet.
Wɔayɛ sɛ saa network mmiɛnsa yi nyinaa bɛbom atena afidie baako so. N'abodin a ɛwɔ ase ha no yɛ nea wɔatintim; obiara betumi afa deɛ ɛne wɔn bɔ abira so asiw ano Z3_* env var. The canonical matrix is: "Ɛyɛ sɛ wo de, na w'akyerɛ mu wɔ kasa foforo no mu". z3-contract.yaml.
| Asoɛeɛ | Mainnet a ɛwɔ hɔ | Testnet a wɔde sɔ hwɛ | Regtest yɛ nhwehwɛmu |
|---|---|---|---|
| Zebra JSON-RPC | 8232 | 18232 | 29232 |
| Zebra P2P | 8233 | 18233 | (wɔntintim) |
Zebra akwahosan (/ready) | 8080 | 18080 | 28080 |
| Zaino gRPC (indexer ho nsɛm) | 8137 | 18137 | 28137 |
| Zaino JSON-RPC (indexer ho nsɛm) | 8237 | 18237 | 28237 |
| Zallet RPC na ɔkyerɛwee | 28232 | 40232 | 50232 |
Wͻ Compose network no mu no, yεn dwumadi ahorow a w'aka ho asεm (zebra, zaino, zallet).
| Ne dodoɔ | Nea ɛkura mu | Back it up? |
|---|---|---|
z3-<network>-chain | Zebra nkɔnsɔnkɔnsɔn tebea (~300 GB mainnet) | Optional — san yɛ syncable |
z3-<network>-zallet | Encrypted wallet database ne mfeɛ ho nkyerɛkyerɛmu a ɛbue no | Yiw — eyi nkutoo ne volume a ɛsɛ sɛ wɔyɛ backup |
z3-<network>-zaino | Indexer tebea (ɛne indexer profile no nkutoo) | Optional — wotumi san si |
z3-<network>-cookie | Zebra RPC kukisi no | Dabi — wɔasan ayɛ no foforo |
Sɛ wode chain state bɛhyɛ disk foforɔ mu ansa na woafi ase:
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 Sɛ wode ka ho a, ɛtwa toɔ na ɛma wohwɛ so. -v deletes wɔn na hyɛ no ma ɔsan yɛ sync. Fa ka ho --profile "*" Enti profile-gated services (indexer, monitoring) no ankasa na wɔsan bubu.
Nkrataa a ɛho hia: Docker Engine, Docker Compose v2.24.4+, Git. openssl wo hia regtest nkoaa.
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
Hwɛ so. docs/regtest.md de sɔ commands hwɛ.
Ɛsɛ sɛ Zebra wie syncing ansa na Zallet betumi adi dwuma. Sɛ wode Zallet di kan a, ɛbɛma no asan akɔ so ayɛ loop kosi sɛ ɛbɛba mu bio /ready ɛyɛ nokware.
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 yɛ nsoroma koro no ara a ɛne: .env.testnet ne sɛ, ./scripts/check-zebra-readiness.sh 18080.
N'akyi nsɛm wɔ ase ha: config/<network>/ tena hɔ na nya nkwa 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
Default Grafana ports yɛ 3000 (mainnet), 13000 (testnet), 23000 (regtest).
:latest. Bump a pin in an reviewed change, or set no so yɛ den sɛ wobɛtumi asesa anaa woasesa. Z3_<SERVICE>_IMAGE.ZEBRA_NETWORK__EXTERNAL_ADDR Regtest nni peers biara.linux/amd64 Sɛ woamfa mfidie a w'atumi de adi dwuma no amfiri baabiara na anyɛ saa a, ɛbɛdi dwuma wɔ Apple Silicon so. Zebra ne Zallet yɛ multi-arch.deploy.resources.limits Wɔ override file mu sε box no nni hɔ a wɔayi ama node.Adwumakuo no ho nhwehwɛmu krataa ne FAQ: docs/faq.md, docs/docker-architecture.md.
Ɛfata no yiye
zcashd sɛ node-plus-walletNneɛma a ɛnyɛ papa no taa yɛ saa
| Networks a ɛwɔ host biako so | Hyɛn gyinabea ntawntawdi a ɛyɛ yaw | Adesuakuw a edi kan: z3-mainnet, z3-testnet, z3-regtest |