Edit this page on GitHub (opens in a new tab)
Z3 Stack adalah platform node terpaket milik Zcash Foundation: Zebra (full node) + Zallet (dompet full node), dengan opsional indexer Zaino. Ini dimaksudkan sebagai pengganti untuk proses zcashd mandiri, yang menggabungkan konsensus dan dompet dalam satu biner dan mencapai akhir masa pakai pada 18 Juli 2026.
Implementasi referensinya adalah proyek Docker Compose di github.com/ZcashFoundation/z3.
Status, 14 November 2026: pin default mendahului NU7.
docker-compose.ymlmilik Z3 terakhir diubah pada 10 Agustus 2026. Isinya masih mematokzfnd/zebra:6.2.3danzodlinc/zallet:v0.1.0-beta.1, serta awalnya menggunakan binaryzallet-zaino. NU7 diaktifkan di Mainnet pada blok 3.543.405 pada 6 November 2026, dan hanya Zebra 7.0.0 atau yang lebih baru yang mengikutinya: Zebra 6.x tetap menggunakan aturan lama dan tertinggal dari chain yang sebenarnya. Zallet v0.1.0-beta.4, rilis pertama yang mengikuti NU7, tidak lagi menyertakanzallet-zaino. Periksa repo untuk mengetahui pin terbaru sebelum melakukan deployment. Jika Anda mengganti image sendiri, perhatikan bahwa backendzebrayang masih digunakan oleh Zallet membaca direktori state milik Zebra secara langsung, sehingga Zallet harus berjalan di host yang sama dan memiliki akses ke direktori tersebut (Zallet).
zcashd secara terpadu: Zebra memvalidasi chain, Zallet menyimpan kunci dan menyediakan RPC dompet, dan Zaino (opsional) menggunakan protokol gRPC lightwalletd.zcashd dalam satu paket. Z3 memisahkan peran tersebut. Exchange, pool penambangan, dan operator dompet full node lainnya beralih ke kombinasi ini, bukan hanya ke Zebra.zallet-zaino-nya (pustaka pengindeks Zaino) dan berkomunikasi dengan Zebra melalui JSON-RPC. Zallet menghapus backend tersebut pada v0.1.0-beta.4; Zallet saat ini membaca state Zebra secara langsung. Layanan Zaino mandiri hanya diperlukan jika Anda menginginkan endpoint yang kompatibel dengan lightwalletd untuk dompet eksternal.Selama sebagian besar masa hidup Zcash, zcashd berfungsi sebagai full node referensi sekaligus satu-satunya dompet full node produksi. Desain itulah yang menjadi acuan integrasi bagi exchange, pool, dan kustodial.
zcashd telah dipensiunkan. Konsensus telah pindah ke (dan sekarang juga ke ). Dompet yang tertanam telah pindah ke Zallet. Layanan light-wallet sedang berpindah dari ke .
Ketiga bagian tersebut adalah repositori yang terpisah, rangkaian rilis yang terpisah, dan konfigurasi yang terpisah. Z3 adalah perekatnya: image yang dipaku (pinned), health check yang menjaga dompet tetap mati hingga node tersinkronisasi, port dan volume per-jaringan, serta jalur operator yang terdokumentasi.
Nama tersebut adalah singkatan ekosistem informal — Zebra, Zaino, Zallet — meskipun file Compose default hanya memulai Zebra dan Zallet. Zaino adalah profil Compose, bukan proses ketiga yang diwajibkan.
┌──────────────────────── 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
| Komponen | Peran di Z3 | Wajib? |
|---|---|---|
| Zebra | Menyinkronkan dan memvalidasi chain, gossip, JSON-RPC, serta endpoint kesehatan | Ya |
| Zallet | Dompet full node. Image beta.1 yang disematkan menjalankan backend pustaka Zaino (zallet-zaino, dihapus pada beta.4 Zallet) dan terhubung langsung ke JSON-RPC Zebra. Tidak memanggil container Zaino mandiri | Ya |
| Zaino | Indexer mandiri. gRPC yang kompatibel dengan lightwalletd untuk light client eksternal, serta proxy JSON-RPC untuk explorer dan faucet | Tidak — --profile indexer |
Z3 menyematkan versi gambar di docker-compose.yml. Timpa dengan Z3_ZEBRA_IMAGE, Z3_ZAINO_IMAGE, atau Z3_ZALLET_IMAGE jika Anda memerlukan tag yang berbeda.
| zcashd | Z3 | |
|---|---|---|
| Bahasa | C++ (fork Bitcoin) | Layanan Rust, diorkestrasi dengan Docker Compose |
| Model proses | Satu biner: node + dompet | Kontainer node dan dompet terpisah |
| Konsensus | Dihentikan (EOS 18 Juli 2026) | Zebra (atau node kompatibel lainnya) |
| Dompet | wallet.dat bawaan | Zallet, datadir terenkripsi-age |
| Light client | Biasanya lightwalletd terpisah | Profil Zaino opsional |
| Konfigurasi | zcash.conf | File per-jaringan di bawah config/<network>/ ditambah file env Compose |
Jika Anda masih memiliki dompet zcashd, gunakan dari ZecHub dan perintah migrate-zcashd-wallet dari Zallet daripada menyalin wallet.dat ke dalam volume Z3.
Z3 terdiri dari tiga proyek Compose yang independen. Proyek-proyek ini tidak berbagi port atau volume.
| Jaringan | Nama proyek | Gunakan untuk | Sinkronisasi pertama | Dana asli |
|---|---|---|---|---|
| mainnet | z3-mainnet | Produksi | 24–72 jam | Ya |
| testnet | z3-testnet | Staging pada jaringan uji publik | 2–12 jam | Tidak (uji ZEC) |
| regtest | z3-regtest | Praktik lokal: blok instan, tanpa peer | Detik | Tidak |
Operator baru sebaiknya memulai pada regtest, konfirmasikan alur RPC dan dompet, lalu pindah ke testnet atau mainnet.
Ketiga jaringan tersebut dimaksudkan untuk dapat berjalan bersamaan pada satu mesin. Nilai-nilai di bawah ini adalah nilai default yang dipublikasikan; setiap nilai dapat ditimpa melalui variabel lingkungan Z3_* yang sesuai. Matriks kanoniknya adalah z3-contract.yaml.
| Layanan | Mainnet | Testnet | Regtest |
|---|---|---|---|
| JSON-RPC Zebra | 8232 | 18232 | 29232 |
| P2P Zebra | 8233 | 18233 | (tidak dipublikasikan) |
health (/ready) Zebra | 8080 | 18080 | 28080 |
| gRPC (profil indexer) Zaino | 8137 | 18137 | 28137 |
| JSON-RPC (profil indexer) Zaino | 8237 | 18237 | 28237 |
| RPC Zallet | 28232 | 40232 | 50232 |
Di dalam jaringan Compose, layanan diselesaikan berdasarkan nama (zebra, zaino, zallet).
| Volume | Apa yang dikandungnya | Cadangkan? |
|---|---|---|
z3-<network>-chain | State chain Zebra (~300 GB mainnet) | Opsional — dapat disinkronisasi ulang |
z3-<network>-zallet | Database dompet terenkripsi dan identitas age yang membukanya | Ya — ini adalah satu-satunya volume yang wajib dicadangkan |
z3-<network>-zaino | State indexer (hanya dengan profil indexer) | Opsional — dapat dibangun ulang |
z3-<network>-cookie | Cookie RPC Zebra | Tidak — dibuat ulang |
Untuk meletakkan status chain pada disk lain sebelum memulai pertama kali:
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 menghentikan stack dan menyimpan volume. Menambahkan -v akan menghapusnya dan memaksa sinkronisasi ulang secara penuh. Sertakan --profile "*" agar layanan yang dibatasi profil (indexer, monitoring) benar-benar dihentikan.
Prasyarat: Docker Engine, Docker Compose v2.24.4+, Git. openssl hanya diperlukan untuk regtest.
git clone https://github.com/ZcashFoundation/z3 && cd z3
./scripts/regtest-init.sh
docker compose --env-file .env.regtest up -d
Lihat docs/regtest.md untuk perintah pengujian.
Zebra harus selesai melakukan sinkronisasi sebelum Zallet dapat digunakan. Memulai Zallet lebih awal akan membuatnya mengalami loop-restart hingga /ready bernilai benar.
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 memiliki alur yang sama dengan .env.testnet dan ./scripts/check-zebra-readiness.sh 18080.
Penyuntingan di bawah config/<network>/ tetap bersifat lokal dan bertahan dalam 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
Port default Grafana adalah 3000 (mainnet), 13000 (testnet), 23000 (regtest).
:latest. Perbarui pin dalam perubahan yang telah ditinjau, atau tetapkan Z3_<SERVICE>_IMAGE. Pin tidak berubah sejak Agustus 2026, jadi mendahului NU7 (lihat catatan status di bagian atas).ZEBRA_NETWORK__EXTERNAL_ADDR ke alamat yang harus dihubungi peer. Regtest tidak memiliki peer.linux/amd64. Di Apple Silicon, image ini berjalan melalui emulasi kecuali Anda membangunnya dari kode sumber. Zebra dan Zallet mendukung banyak arsitektur.deploy.resources.limits dalam file override jika mesin tersebut tidak dikhususkan untuk node.Daftar periksa dan FAQ siap produksi: docs/faq.md, docs/docker-architecture.md.
Sesuai
zcashd sebagai node-plus-walletBiasanya alat yang salah
| Jaringan pada satu host |
| Bentrokan port yang menyulitkan |
Kelas utama: z3-mainnet, z3-testnet, z3-regtest |