Edit this page on GitHub (opens in a new tab)
Эта страница представляет собой практическое руководство по взаимодействию с работающим полным узлом Zcash через JSON-RPC и подключению индексатора, к которому могут обращаться лёгкие кошельки и обозреватели. Это не второе руководство по установке.
О том, как запустить стек после zcashd (Zebra + Zallet, необязательный Zaino, порты, тома, двухэтапная загрузка), см. страницу Z3 Stack и репозиторий Z3. Сведения об узлах консенсуса см. в разделах Полные узлы и полный узел Zebra.
zcashd прекратил поддержку 18 июля 2026 года. Новая работа операторов должна быть ориентирована на Zebra (или Zakura) вместе с кошельком/индексатором, а не на zcashd.
http://127.0.0.1:8181 принимает zebra / zebra и перенаправляет методы узла в Zebra, а методы кошелька — в Zallet.--profile indexer) предоставляет gRPC, совместимый с lightwalletd. Ztreamer — это индексатор на базе Zakura; он не входит в поставку Z3.| Вам нужно | Обращаться к | Порт хоста Z3 mainnet | Примечания |
|---|---|---|---|
Вершина цепочки, пиры, getblockchaininfo | JSON-RPC Zebra | 8232 | Аутентификация по cookie |
| Баланс кошелька, адреса, отправка | RPC Zallet | 28232 | Отдельный процесс; бета-версия ПО |
| Компактные блоки для лёгких кошельков | gRPC Zaino | 8137 | Только с --profile indexer; незашифрованный h2c |
| Прокси JSON-RPC для обозревателя / крана | JSON-RPC Zaino | 8237 | Только доверенная сеть |
| Практиковать всё вышеперечисленное без синхронизации | rpc-router Z3 regtest | 8181 | Имя пользователя zebra / пароль |
Матрица портов и имена проектов Compose: и z3-contract.yaml.
Из рабочей копии Z3, после ./scripts/regtest-init.sh и 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
Исправный результат getblockchaininfo включает "blocks" и карту "upgrades". Если curl зависает, роутер не запущен; если вы получаете 401, вы обращаетесь напрямую к Zebra вместо роутера (прямой Zebra в regtest находится на 29232 и по-прежнему ожидает учётные данные роутера, если вы их не изменили).
Полный процесс работы с regtest, включая майнинг блоков активации: Z3 docs/regtest.md.
В mainnet и testnet Zallet и необязательный сервис Zaino используют общий том cookie. Этот cookie создаётся заново при загрузке; он не предназначен для резервного копирования.
Не публикуйте JSON-RPC Zebra в публичном интернете. Вызывайте его из сети Compose (zebra:8232) или с хоста только в случае привязки к loopback.
Типичные проверки оператора после того, как 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 — это RPC для майнинга. Пулам, которые всё ещё ожидали единый процесс zcashd, нужны Zebra (или Zakura) для шаблонов, а также любой используемый ими кошелёк для coinbase. См. и .
Валидация и индексирование — разные задачи.
Zaino читает Zebra и предоставляет gRPC API, совместимый с lightwalletd, а также прокси JSON-RPC. Zallet не требует отдельного контейнера Zaino; он встраивает библиотеки Zaino и взаимодействует с Zebra через JSON-RPC. Запускайте отдельный Zaino, если вам нужны внешние лёгкие кошельки, обозреватели или краны:
docker compose --env-file .env.mainnet --profile indexer up -d
Дождитесь синхронизации Zebra, прежде чем направлять клиентов к Zaino. Массовый индексатор в режиме догоняющей синхронизации с высокой параллельностью получения данных может замедлить верификатор Zebra; держите fetch_concurrency на уровне нескольких единиц, пока индексатор не завершит синхронизацию.
gRPC regtest (незашифрованный; порт 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
gRPC Zaino использует незашифрованный h2c во всех сетях. Завершайте TLS на обратном прокси, если подключаться будет что-либо за пределами хоста. Подробнее: и Z3 docs/regtest.md.
CompactTxStreamer. Это не сервис Z3. См. репозиторий Ztreamer.rpc.indexer_listen_addr — необязательный слушатель gRPC внутри Zebra. Z3 не требует его и не публикует его на хосте.Вызов методов кошелька в Zebra. getwalletinfo и RPC отправки относятся к Zallet (или другому кошельку), а не к узлу консенсуса.
Запуск Zallet до того, как Zebra станет /ready. Zallet будет перезапускаться в цикле. Используйте scripts/check-zebra-readiness.sh в mainnet/testnet.
Копирование zebra/zebra regtest в mainnet. Аутентификация по cookie является стандартом mainnet/testnet не без причины.
Считать Zaino полным узлом. Zebra (или Zakura) выполняет валидацию. Zaino выполняет индексирование.
Публичное раскрытие JSON-RPC Zaino или gRPC индексатора Zebra. Эти конечные точки предназначены для loopback или доверенной частной сети.
Предполагать, что каждый лёгкий кошелёк уже поддерживает Zaino. Сверяйте текущий релиз кошелька с протоколом, который он действительно реализует.
Последнее обновление: сентябрь 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