Edit this page on GitHub (opens in a new tab)
Questa pagina è un ricettario per comunicare con un full node (nodo completo) Zcash in esecuzione tramite JSON-RPC e per collegare un indicizzatore interrogabile da portafogli leggeri ed explorer. Non è una seconda guida all'installazione.
Per sapere come avviare lo stack post-zcashd (Zebra + Zallet, Zaino facoltativo, porte, volumi, avvio in due fasi), consulta la pagina Z3 Stack e il repository Z3. Per informazioni sui nodi di consenso, consulta Full Nodes e Zebra Full Node.
zcashd ha raggiunto la fine del ciclo di vita il 18 luglio 2026. Il nuovo lavoro degli operatori dovrebbe puntare a Zebra (o Zakura) più un portafoglio/indicizzatore, non a zcashd.
http://127.0.0.1:8181 accetta zebra / zebra e inoltra i metodi del nodo a Zebra e i metodi del portafoglio a Zallet.--profile indexer) serve gRPC compatibile con lightwalletd. Ztreamer è un indicizzatore basato su Zakura; non è ciò che distribuisce Z3.| Cosa vuoi | Comunica con | Porta host mainnet di Z3 | Note |
|---|---|---|---|
Punta della chain, peer, getblockchaininfo | JSON-RPC di Zebra | 8232 | Autenticazione tramite cookie |
| Saldo del portafoglio, indirizzi, invio | RPC di Zallet | 28232 | Processo separato; software beta |
| Blocchi compatti per portafogli leggeri | gRPC di Zaino | 8137 | Solo con --profile indexer; h2c in testo semplice |
| Proxy JSON-RPC per explorer / faucet | JSON-RPC di Zaino | 8237 | Solo rete fidata |
| Esercitati con tutto quanto sopra senza sincronizzazione | rpc-router regtest di Z3 | 8181 | Nome utente zebra / password |
Matrice delle porte e nomi dei progetti Compose: e z3-contract.yaml.
Da un checkout di Z3, dopo ./scripts/regtest-init.sh e docker compose --env-file .env.regtest up -d:
# Node method (Zebra)
curl -s -X POST -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"getblockchaininfo","params":[],"id":1}' \
http://127.0.0.1:8181
# Wallet method (Zallet)
curl -s -X POST -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"getwalletinfo","params":[],"id":2}' \
http://127.0.0.1:8181
Un risultato sano di getblockchaininfo include "blocks" e una mappa "upgrades". Se curl resta in attesa, il router non è attivo; se ricevi 401, stai raggiungendo direttamente Zebra anziché il router (il Zebra diretto su regtest è 29232 e continua ad aspettarsi le credenziali del router, a meno che tu non le abbia modificate).
Flusso di lavoro regtest completo, incluso il mining dei blocchi di attivazione: Z3 docs/regtest.md.
Su mainnet e testnet, Zallet e il servizio facoltativo Zaino leggono un volume cookie condiviso. Il cookie viene rigenerato all'avvio; non è una destinazione di backup.
Non pubblicare JSON-RPC di Zebra sulla rete Internet pubblica. Chiamalo dalla rete Compose (zebra:8232) o dall'host solo se lo hai associato al loopback.
Controlli tipici dell'operatore dopo che Zebra è /ready:
# Wait until Zebra is synced (Z3 helper)
./scripts/check-zebra-readiness.sh
# Then start Zallet
docker compose --env-file .env.mainnet up -d
getblocktemplate / getmininginfo sono RPC di mining. Le pool che continuavano ad aspettarsi un singolo processo zcashd necessitano di Zebra (o Zakura) per i template, oltre al portafoglio che usano per coinbase. Consulta e la .
Convalida e indicizzazione sono compiti diversi.
Zaino legge Zebra e serve un'API gRPC compatibile con lightwalletd oltre a un proxy JSON-RPC. Zallet non richiede il container Zaino autonomo; incorpora librerie Zaino e comunica con Zebra tramite JSON-RPC. Avvia Zaino autonomo quando vuoi portafogli leggeri, explorer o faucet esterni:
docker compose --env-file .env.mainnet --profile indexer up -d
Attendi che Zebra sia sincronizzato prima di indirizzare i client a Zaino. Un indicizzatore bulk in recupero con alta concorrenza di fetch può rallentare il verificatore di Zebra; mantieni fetch_concurrency sulle poche unità finché l'indicizzatore non ha completato il recupero.
gRPC regtest (testo semplice; porta 28137):
# From the Z3 repo, after: scripts/vendor.sh zaino
# and: docker compose --env-file .env.regtest --profile indexer up -d zaino
grpcurl -plaintext \
-import-path vendor/zaino/zaino-proto/proto \
-proto service.proto \
127.0.0.1:28137 \
cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLightdInfo
grpcurl -plaintext \
-import-path vendor/zaino/zaino-proto/proto \
-proto service.proto \
-d '{}' \
127.0.0.1:28137 \
cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLatestBlock
Il gRPC di Zaino è h2c in testo semplice su tutte le reti. Termina TLS presso un reverse proxy se qualcosa al di fuori dell'host si connetterà. Dettagli: e Z3 docs/regtest.md.
CompactTxStreamer. Non è un servizio Z3. Consulta il repository Ztreamer.WalletQuery e un adapter CompactTxStreamer compatibile con lightwalletd. La guida rapida lo avvia accanto a un nodo Z3, ma non è un servizio Z3. Consulta .rpc.indexer_listen_addr — un listener gRPC facoltativo all'interno di Zebra. Z3 non lo richiede e non lo espone sull'host.Chiamare metodi del portafoglio su Zebra. getwalletinfo e gli RPC di invio appartengono a Zallet (o a un altro portafoglio), non al nodo di consenso.
Avviare Zallet prima che Zebra sia /ready. Zallet entrerà in un ciclo di riavvii. Usa scripts/check-zebra-readiness.sh su mainnet/testnet.
Copiare zebra/zebra di regtest su mainnet. L'autenticazione tramite cookie è l'impostazione predefinita per mainnet/testnet per un motivo.
Trattare Zaino come un full node. Zebra (o Zakura) convalida. Zaino indicizza.
Esporre pubblicamente JSON-RPC di Zaino o il gRPC dell'indicizzatore Zebra. Questi endpoint sono destinati al loopback o a una rete privata fidata.
Supporre che ogni portafoglio leggero parli già Zaino. Verifica la release corrente del portafoglio rispetto al protocollo che implementa realmente.
Ultimo aggiornamento: settembre 2026
Network Upgrade 6.3 (NU6.3) activated on mainnet at block 3,428,143 (about 28 July 2026) and introduced the Ironwood shielded pool; ZIP 258 specifies the height. Ironwood uses the Orchard shielded protocol but keeps a separate value pool, with its own note commitment tree, anchor and chain value pool balance. NU6.3 is a consensus upgrade, so a node that does not implement it stops following the chain.
zcashd does not implement NU6.3. Zebra is expected to be the only full validator that follows the chain after activation.getdeprecationinfo, added in Zebra 6.3.0, reports the height and estimated time at which a release halts for end of support, in the zcashd end_of_service format. The end_of_service object is present on mainnet only, where end of support is enforced.Pair every component with a release that supports NU6.3 and read each project’s release notes before upgrading. Avoid pinning guidance to a specific historical version, because releases move quickly. Two documented examples:
getblockchaininfo, and its chainSupply is the total across all pools. See the Zaino 0.10.1 release notes.MAX_MONEY. See the Zebra 6.3.0 release notes.Do not rely on the exact field layout of RPC responses for pool balances across versions; check the response of the version you run.
z3-contract.yaml for your network.zcashd wallet RPC methods may be missing. Check the Zallet documentation for the methods you need.zebra