Zinder adalah indexer Zcash yang dihosting sendiri, ditulis dalam Rust dan diterbitkan oleh Zcash Foundation. Indexer ini membaca chain satu kali dari Zebra atau full node Zakura, menyimpan satu tampilan yang konsisten, lalu menyajikan tampilan tersebut ke beberapa dompet, aplikasi, dan explorer secara bersamaan. Dompet ringan yang sudah ada dapat mengaksesnya melalui adapter yang kompatibel dengan lightwalletd.
Zinder masih berstatus alfa. README-nya menyatakan bahwa API native, lapisan kompatibilitas lightwalletd, tata letak penyimpanan, dan topologi deployment akan berubah, serta bahwa rilis bertag bukan jaminan stabilitas. Tetapkan versi yang tepat dan bersiaplah menghadapi pembaruan yang dapat merusak kompatibilitas.
WalletQuery milik Zinder, serta adapter terpisah yang menggunakan protokol CompactTxStreamer milik lightwalletd, sehingga dompet yang dibuat untuk lightwalletd dapat mengarah ke sana tanpa perubahan kode.Dompet ringan tidak pernah berkomunikasi langsung dengan full node. Dompet tersebut meminta blok ringkas, status tree, dan data transaksi dari indexer (lihat ). Ekosistem Zcash kini memiliki beberapa indexer yang dapat melakukan hal ini:
| Indexer | Bahasa | Pengelola | Terhubung ke | Catatan |
|---|---|---|---|---|
| lightwalletd | Go | Komunitas ECC / Zcash | Zebra atau zcashd | Server dompet ringan yang pertama |
| Rust | Zingo Labs | Zebra atau zcashd | Profil indexer opsional di stack Z3 | |
| Ztreamer | Rust | zcashlabs | Node Zakura tertanam | Lihat |
| Zinder | Rust | Zcash Foundation | Zebra 7.0.0 atau Zakura 1.8.6 (node arsip) | Alfa. API native, adapter lightwalletd, dan pembacaan explorer opsional |
Dokumentasi Zinder menjelaskan secara langsung kapan sistem ini menjadi pilihan yang tepat: keunggulannya paling terasa ketika akses ke chain perlu tetap tersedia di luar satu proses dompet, melayani beberapa konsumen independen, atau dipisahkan dari kode dompet tertentu. Untuk satu dompet yang terintegrasi erat, indexer tertanam bisa lebih sederhana. Sementara itu, konsumen yang hanya membutuhkan data yang sudah dimiliki node dapat menggunakan RPC milik Zebra secara langsung.
Zinder membagi pekerjaan ke dalam proses-proses terpisah, masing-masing dengan satu tugas:
| Runtime | Peran |
|---|---|
zinder-ingest | Satu-satunya penulis ke penyimpanan chain kanonis (RocksDB). Mengikuti node, menangani reorganisasi, dan menjaga status mempool terkini |
zinder-projector | Satu-satunya penulis ke penyimpanan dompet. Membangun dan mengikuti tampilan chain yang disesuaikan untuk dompet |
zinder-query | Menyajikan API gRPC native WalletQuery |
zinder-compat-lightwalletd | Menyajikan API CompactTxStreamer milik lightwalletd di atas data yang sama |
Lapisan explorer opsional (zinder-explorer dengan ExplorerQuery) menyajikan ringkasan blok, detail transaksi, tampilan mempool, dan pencarian. Adapter opsional menyajikan API REST dan WebSocket milik explorer CipherScan. Keduanya tidak termasuk dalam image rilis.
Setiap runtime menyediakan /healthz, /readyz, dan /metrics. Reader hanya melaporkan status siap setelah salinan penyimpanan chain dan penyimpanan dompetnya menunjuk ke status chain yang persis sama.
zinder-compat-lightwalletd. Dokumentasi Zinder membedakan kompatibilitas protokol dari dukungan: sebuah dompet baru dianggap didukung setelah rilis terkininya lulus sertifikasi menyeluruh. Rilis 0.10.0 memperbaiki kolom versi protokol GetLightdInfo agar Zingo dapat melakukan sinkronisasi.zinder-query untuk pembacaan yang dikaitkan dengan status tertentu, blok ringkas, stream peristiwa chain dan mempool, serta hasil siaran dengan alasan penolakan bertipe.zinder-client, SDK yang mengutamakan koneksi jarak jauh dan terhubung ke zinder-query tanpa menautkan stack penyimpanan.ExplorerQuery opsional.Panduan mulai cepat upstream menjalankan node dengan , lalu Zinder dengan Docker Compose dari checkout Zinder:
# In the Z3 checkout
Z3_NETWORK=testnet docker compose up -d
# In the Zinder checkout
docker compose --env-file deploy/.env.testnet \
-f deploy/docker-compose.yml up -d --build
File env untuk Mainnet dan untuk node Zakura (deploy/.env.zakura-mainnet, deploy/.env.zakura-testnet) berada di sebelahnya. Sejak versi 0.11.0, file Compose tidak lagi mengasumsikan Z3: file env harus mencantumkan jaringan node, volume cookie, dan alamat RPC.
Port host default (Testnet menambahkan 10000):
| Layanan | Mainnet | Testnet |
|---|---|---|
gRPC native WalletQuery | 9102 | 19102 |
| gRPC yang kompatibel dengan lightwalletd | 9067 | 19067 |
| Kesiapan: ingest / projector / query / compat | 9105 / 9110 / 9106 / 9107 | 19105 / 19110 / 19106 / 19107 |
Kedua port dompet terikat ke loopback. Periksa port tersebut dengan:
grpcurl -plaintext -d '{}' 127.0.0.1:19102 zinder.v1.wallet.WalletQuery/ServerInfo
grpcurl -plaintext -d '{}' 127.0.0.1:19067 cash.z.wallet.sdk.rpc.CompactTxStreamer/GetLightdInfo
Cara deployment lainnya:
ghcr.io/zcashfoundation/: keempat runtime, ditambah zinder-wallet-serving (ingest, projector, dan native query dalam satu container untuk host yang dapat memasang satu volume ke satu container; tanpa adapter lightwalletd) dan zinder-canonical-runtime (ingest saja).zinder-ingest menolak untuk dijalankan dengan node yang dipangkas.zinder-wallet-serving, sediakan endpoint gRPC indexer milik node (ZINDER_NODE__INDEXER_GRPC_ADDR, Zebra indexer_listen_addr, port 8155 di Mainnet). Indexer Zakura pada alamat selain loopback memerlukan mutual TLS, yang didukung Zinder sejak versi 0.11.0.Berdasarkan panduan operasional penyajian dompet:
| Versi | Tanggal | Perubahan bagi operator |
|---|---|---|
| 0.7.0 | 2026-11-10 | Jendela reorganisasi default dinaikkan menjadi 1000 blok, kedalaman saat Zebra 7 dan Zakura memfinalisasi blok. Perubahan ini tidak dapat dibatalkan: rilis yang lebih lama tidak dapat membuka penyimpanan yang sudah dinaikkan batasnya |
| 0.9.0 | 2026-11-12 | Image zinder-wallet-serving dan zinder-canonical-runtime yang baru |
| 0.10.0 | 2026-11-13 | Rilis pertama yang dapat mendekode blok NU7. Versi 0.9.0 dan sebelumnya berhenti pada blok NU7 pertama. Revisi protokol native 8: perbarui ingest dan query secara bersamaan, beserta klien native |
| 0.11.1 | 2026-11-14 | Zakura 1.8.6 tersertifikasi bersama Zebra 7.0.0; mutual TLS ke indexer node; node yang dipangkas ditolak. Versi 0.11.0 hanya dirilis sebagai crate, jadi deploy versi 0.11.1 |
| 0.12.0 |
Menganggapnya sebagai perangkat lunak produksi. Proyek ini menyebut dirinya berstatus alfa. Menurut proyek itu sendiri, deployment Compose lokal yang berhasil "belum dengan sendirinya merupakan sertifikasi untuk produksi".
Mengarahkannya ke node yang dipangkas. Ingest berhenti saat startup. Gunakan node Zebra atau Zakura arsip.
Membuka port gRPC secara langsung. Kedua port dompet terikat ke loopback karena suatu alasan. Pasang TLS, autentikasi, pembatasan laju, dan kuota pada proxy yang Anda kelola sebelum membuka port tersebut ke internet.
Memperbarui runtime satu per satu. Beberapa rilis mengubah revisi protokol native atau format penyimpanan. Perbarui layanan Zinder secara bersamaan, lalu perbarui klien native dalam proses peralihan yang sama.
Menganggap dompet didukung hanya karena protokolnya didukung. Adapter lightwalletd menggunakan protokol tersebut, tetapi Zinder hanya menyatakan dukungan untuk dompet tertentu setelah rilis terkini dompet itu tersertifikasi secara menyeluruh.
Terakhir diperbarui: November 2026
| 2026-11-14 |
| Perbaikan status kesiapan dan shutdown; pemutaran ulang explorer lebih cepat dan dijeda saat ruang disk menipis |