Edit this page on GitHub (opens in a new tab)
Awọn ** Z3 Stack** ni awọn Zcash Foundation ká ti a fi sori ẹrọ node Syeed: ** Zebra ** (pupọ-node) + ** Zallet ** (pipa owo kikun), pẹlu kan aṣayan ** Zaino ** indexer. O jẹ yiyan rọpo fun iduroṣinṣin ọkan zcashd ilana, eyi ti o ṣe idapọ ifọkanbalẹ ati apamọwọ ni alakomeji kan ki o de opin igbesi aye lori 18 Keje 2026.
Awọn itọkasi imuse ni awọn Docker Kọ ise agbese ni github.com/ZcashFoundation/z3.
zcashd ṣajọ pọ: Zebra ṣe idanimọ ẹwọn naa, Zallet ni awọn bọtini ati ṣiṣẹ apamọwọ RPC, ati Zaino (oṣiṣẹ) sọ ilana lightwalletd gRPC.zcashd ìsopọ̀ node + wallet. Z3 ** pín àwọn ipa wọnyìí**. Àwọn ilé-ìtajà, àwùjọ tí ó ń ṣe èlò ìdáná àti gbogbo oníṣẹ́ àpò owó ti o ní ojúlówó nóòdí máa n ṣí lọ sí àjọpọ yìí dípò Zebra nìkan.Ní gbogbo ìgbà tí Zcash fi wà láàyè, zcashd ni mejeeji awọn itọkasi kikun node ati nikan gbóògì pipe-node apamọwọ. ti apẹrẹ jẹ ohun paṣipaarọ, adagun, ki o si custodians integrated lodi si.
zcashd ti fi sípò. ìfohùnṣọ̀kan yí padà sí (àti nísinsìnyí pẹ̀lú) A gbe apamọwọ ti a fi sinu rẹ si: ZalletÌránṣẹ́ owó-ìmọ̀ràn ń ṣí lọ láti ibùdó ìsọfúnni. to .
Those three pieces are separate repositories, separate release trains, and separate configs. Z3 is the glue: pinned images, health checks that keep the wallet down until the node is synced, per-network ports and volumes, and a documented operator path.
Orukọ naa jẹ ọna-ọna ti o ni imọran Zebra, Zaino, Zallet biotilejepe faili Ṣeto aiyipada nikan bẹrẹ Zebra ati Zallet. Zaino jẹ profaili Kọwe kan, kii ṣe ilana kẹta to nilo.
┌──────────────────────── 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
| Ẹ̀yà ara | Ipa ninu Z3 | A nilo? |
|---|---|---|
| Zebra | Ṣe àmúṣiṣẹ́pọ̀ àti ìfọwọ́sowọ́pọ̀ pq, ọ̀rọ̀ àfojúsùn, JSON-RPC, àti ìparí ìlera | Bẹ́ẹ̀ni |
| Zallet | Àpò ìpamọ́ gbogbo-nọ́ńbà. Ó fi àwọn ilé ìkàwé Zaino sí i. Ó so mọ́ Zebra JSON-RPC tààrà. Kò pe àpótí Zaino tí ó dúró ṣinṣin ní ìdúró tààrà | Bẹ́ẹ̀ni |
| Zaino | Atọka ti o da duro nikan. gRPC lightwalletd-compatible fun awọn alabara ina ita, pẹlu aṣoju JSON-RPC fun awọn oluwakiri ati awọn faucets | No — --profile indexer |
Awọn ẹya aworan Z3 pin ni: docker-compose.yml. Ṣàtúnṣe pẹlú Z3_ZEBRA_IMAGE, Z3_ZAINO_IMAGE, or Z3_ZALLET_IMAGE tó o bá nílò àmì mìíràn.
| zcashd | Z3 | |
|---|---|---|
| Èdè | C++ (Fọ́kì Bitcoin) | Àwọn iṣẹ́ ipata, tí a ṣètò pẹ̀lú Docker Compose |
| Àwòṣe ilana | Oníná méjì kan: nódù + àpò owó | Awọn apoti ati awọn apoti apamọwọ lọtọ |
| Ìfohùnṣọ̀kan | Fẹ̀yìntì (EOS 18 Keje 2026) | Zebra (tàbí nódù mìíràn tó báramu) |
| Àpò owó | Inu-inu wallet.dat | Zallet, datadir ti a fi ọjọ-ori pamọ |
| Awọn alabara ina | Nigbagbogbo a lightwalletd lọtọ | Ìfilọ́lẹ̀ Zaino tí a lè yàn |
| Ṣètò | zcash.conf | Àwọn fáìlì fún nẹ́tíwọ́ọ̀kì kọ̀ọ̀kan lábẹ́ config/<network>/ pẹlu Ṣakojọ awọn faili env |
Tó o bá ṣì ní àpò kan tó ń gba omi ara rẹ, zcashd wallet, use ZecHub’s and Zallet’s migrate-zcashd-wallet pàṣẹ dípò kó o ṣe àdàkọ rẹ̀ wallet.dat sinu iwọn didun Z3.
Z3 jẹ́ iṣẹ́ kọ̀ǹpútà tí ó dá dúró. Wọn kò pín àwọn èbúté tàbí ìmúlò wọn.
| Nẹ́ẹ̀tìwọ́ọ̀kì | Orúkọ iṣẹ́ náà | Lò ó fún | Ìmúṣiṣẹ́pọ̀ àkọ́kọ́ | Awọn owo gidi |
|---|---|---|---|---|
| àkójọpọ̀ | z3-mainnet | Ìṣẹ̀dá | Wákàtí 24–72 | Bẹ́ẹ̀ni |
| nẹ́ẹ̀tì ìdánwò | z3-testnet | Ṣíṣe àgbékalẹ̀ lórí nẹ́tíwọ́ọ̀kì ìdánwò gbogbogbò | Wákàtí 2–12 | Rárá (dánwò ZEC) |
| ìforúkọsílẹ̀ | z3-regtest | Iṣẹ́ àdúgbò: àwọn ìdènà lẹ́sẹ̀kẹsẹ̀, kò sí àwọn ẹlẹgbẹ́ | Awọn iṣẹ́jú-àáyá | No |
Àwọn oníṣẹ́ tuntun ní láti bẹ̀rẹ̀ sí í ṣe àyẹwò padà, kí wọ́n fìdí ìtòlẹ́sẹẹsẹ RPC àti ìṣàn owó alágbèéká múlẹ̀, lẹ́yìn náà ni kí wọn lọ sórí ẹ̀rọ ìdánrawò tàbí orí ère.
Gbogbo awọn mẹta nẹtiwọki ti wa ni o kan lati coexist lori ọkan ẹrọ. iye isalẹ jẹ awọn atejade aiyipada; kọọkan ọkan ni overridable nipasẹ awọn baramu Z3_* Àwòrán ìlà àwọn àdàkọ ni: z3-contract.yaml.
| Iṣẹ́ | Mainnet | Nẹ́ẹ̀tìwọ́ọ̀kì ìdánwò | Ìforúkọsílẹ̀ |
|---|---|---|---|
| Zebra JSON-RPC | 8232 | 18232 | 29232 |
| Zebra P2P | 8233 | 18233 | (kò ṣe àtẹ̀jáde) |
Ìlera Zebra (/ready) | 8080 | 18080 | 28080 |
| Zaino gRPC (profaili atọka) | 8137 | 18137 | 28137 |
| Zaino JSON-RPC (profaili atọka) | 8237 | 18237 | 28237 |
| RPC Zallet | 28232 | 40232 | 50232 |
Láàárín ẹ̀rọ Compose, àwọn iṣẹ́ máa ń yanjú nípasẹ̀ orúkọ (zebra, zaino, zallet).
| Iwọn didun | Ohun tí ó ń mú | Ṣe àtìlẹ́yìn rẹ̀? |
|---|---|---|
z3-<network>-chain | Ipò ẹ̀wọ̀n Zebra (~300 GB mainnet) | Àṣàyàn — a lè tún ṣe àtúnṣe |
z3-<network>-zallet | Ibi ipamọ data apamọwọ ti a fi pamọ ati idanimọ ọjọ-ori ti o ṣii rẹ | Bẹ́ẹ̀ni — èyí nìkan ni ohùn tí a gbọ́dọ̀ fi ṣe àtìlẹ́yìn |
z3-<network>-zaino | Ipò olùtọ́ka (pẹ̀lú ìṣàfihàn olùtọ́ka nìkan) | Àṣàyàn — a lè tún un kọ́ |
z3-<network>-cookie | Kúkì RPC Zebra | Rárá — àtúnṣe |
Lati fi ipo ẹ̀rọ-ìmọ́lẹ̀ sórí àwo mìíràn kí o tó bẹ̀rẹ̀:
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 ó dá ìdìpọ̀ náà dúró, tó sì ń pa àwọn àdàkọ rẹ̀ mọ́. -v ó pa wọ́n mọ́, tó sì mú kí a tún àtúnṣe ìsopọ̀ náà ṣe. --profile "*" nítorí náà, àwọn iṣẹ́ tó ní í ṣe pẹ̀lú ìsọfúnni (ìwé-àkójọpọ̀, àbójútó) ni a máa ń tú ká.
Àwọn ohun tí ó pọn dandan: Docker Engine, Docker Compose v2.24.4+, Git. openssl kìkì fún ìwádìí àyẹ̀wò ìṣègùn ni wọ́n nílò.
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
Wo àwọn ojúewé yìí: àwọn ìwé/àtúnṣe-ìdánwò.md fún àwọn àṣẹ ìdánwò.
Zebra gbọdọ pari isọdọkan ki Zallet to wulo. Ṣíṣe Zallet ni kutukutu jẹ ki o tun bẹrẹ-akopọ titi di igba ti a fi le lohun naa lati ṣe atunṣe rẹ fun awọn ohun elo miiran, ṣugbọn kii yoo ṣiṣẹ bi ẹnipe wọn ko mọ ọ daradara. /ready òótọ́ ni.
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 ni kanna sisan pẹlu awọn ti o ba wa ni a ṣe akiyesi. .env.testnet àti pé, ./scripts/check-zebra-readiness.sh 18080.
Àwọn àtúnṣe lábẹ́: config/<network>/ dúró sí àdúgbò kí o sì yè é. 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
Awọn ibudo Grafana aiyipada jẹ 3000 (mainnet), 13000 (testnet), 23000 (regtest).
:latest. Bump kan pin ni a ti ṣe atunyẹwo ayipada, tabi ṣeto Z3_<SERVICE>_IMAGE.ZEBRA_NETWORK__EXTERNAL_ADDR Regtest kò ní àwọn ẹlẹgbẹ́.linux/amd64 O ti wa ni o kan fun Apple Silicon, eyi nṣiṣẹ labẹ emulation ayafi ti o ba kọ lati orisun. Zebra ati Zallet jẹ ọpọ-apakan.deploy.resources.limits nínú fáìlì àtúnṣe tí kò bá sí àpótí tó wà fún nóòdù náà.Àtòjọ àyẹ̀wò tí ó ní ìrísí ìṣẹ́ àti FAQ: àwọn ìwé/ìwé-ẹ̀rí.md, docs/docker-architecture.md.
Ó bá mi mu dáadáa.
zcashd gẹ́gẹ́ bí node-plus-walletGbogbo ìgbà ni irinṣẹ́ tí kò tọ̀nà
| Awọn nẹtiwọọki lori olupin kan |
| Àwọn ìjàkadì ojú omi tó ń roni lára |
Kilasi akọkọ: z3-mainnet, z3-testnet, z3-regtest |