Zinder یک نمایهساز Zcash خودمیزبان است که با Rust نوشته شده و توسط Zcash Foundation منتشر شده است. این ابزار زنجیره را فقط یکبار از یک نود کامل Zebra یا Zakura میخواند، یک نمای سازگار از آن ذخیره میکند و همزمان آن را در اختیار چندین کیفپول، برنامه و کاوشگر قرار میدهد. کیفپولهای سبک موجود میتوانند از طریق یک آداپتور سازگار با lightwalletd به آن دسترسی پیدا کنند.
Zinder آلفا است. README آن میگوید API بومی، سطح سازگاری lightwalletd، چیدمانهای ذخیرهسازی و توپولوژی استقرار تغییر خواهند کرد و انتشار نسخه برچسبخورده تضمینکننده پایداری نیست. نسخههای دقیق را ثابت نگه دارید و انتظار ارتقاهای ناسازگار را داشته باشید.
WalletQuery، و آداپتوری جداگانه که با پروتکل lightwalletd یعنی CompactTxStreamer کار میکند؛ بنابراین کیفپولهای ساختهشده برای lightwalletd میتوانند بدون تغییر کد به آن متصل شوند.کیفپولهای سبک هرگز مستقیماً با فولنود ارتباط برقرار نمیکنند. آنها برای بلوکهای فشرده، وضعیت درخت و دادههای تراکنش از یک نمایهساز درخواست میفرستند (به مراجعه کنید). اکنون در اکوسیستم Zcash چند نمایهساز وجود دارد که این کار را انجام میدهند:
| نمایهساز | زبان | نگهدارنده | ارتباط با | توضیحات |
|---|---|---|---|---|
| lightwalletd | Go | ECC / کامیونیتی Zcash | Zebra یا zcashd | سرور اصلی کیفپول سبک |
| Rust | Zingo Labs | Zebra یا zcashd | نمایهساز اختیاری در پشته Z3 | |
| Ztreamer | Rust | zcashlabs | نود Zakura تعبیهشده | به معیارسنجی مراجعه کنید |
| Zinder | Rust | Zcash Foundation | Zebra 7.0.0 یا Zakura 1.8.6 (نود آرشیوی) | آلفا. API بومی بههمراه آداپتور lightwalletd و خواندن اختیاری برای کاوشگر |
مستندات Zinder درباره زمان مناسب استفاده از آن صریح است: این ابزار زمانی بهترین انتخاب است که دسترسی به زنجیره باید پس از پایان اجرای یک فرایند کیفپول ادامه یابد، به چند مصرفکننده مستقل سرویس بدهد یا از کد هر کیفپول جدا بماند. برای یک کیفپول واحد با اتصال تنگاتنگ، نمایهساز تعبیهشده میتواند سادهتر باشد و مصرفکنندهای که فقط به دادههای موجود در نود نیاز دارد میتواند مستقیماً از RPC Zebra استفاده کند.
Zinder کارها را میان فرایندهای جداگانه تقسیم میکند که هرکدام یک وظیفه دارند:
| زمان اجرا | نقش |
|---|---|
zinder-ingest | تنها نویسنده در ذخیرهساز canonical زنجیره (RocksDB). نود را دنبال میکند، بازسازماندهیها را مدیریت میکند و وضعیت زنده ممپول را نگه میدارد |
zinder-projector | تنها نویسنده در ذخیرهساز کیفپول. نمای زنجیره متناسب با کیفپول را میسازد و دنبال میکند |
zinder-query | API بومی gRPC WalletQuery را ارائه میدهد |
zinder-compat-lightwalletd | API CompactTxStreamer lightwalletd را بر پایه همان دادهها ارائه میدهد |
یک لایه اختیاری برای کاوشگر (zinder-explorer بههمراه ExplorerQuery) خلاصه بلوکها، جزئیات تراکنشها، نماهای ممپول و جستوجو را ارائه میدهد؛ آداپتوری اختیاری نیز APIهای REST و WebSocket کاوشگر CipherScan را ارائه میکند. هیچکدام بخشی از ایمیجهای انتشار نیستند.
هر زمان اجرا /healthz، /readyz و /metrics را ارائه میدهد. خوانشگرها فقط زمانی وضعیت آماده را گزارش میکنند که نسخههایشان از ذخیرهساز زنجیره و ذخیرهساز کیفپول دقیقاً به یک وضعیت زنجیره اشاره کنند.
zinder-compat-lightwalletd متصل میکنند. مستندات Zinder سازگاری پروتکل را از پشتیبانی جدا میداند: یک کیفپول فقط پس از آن پشتیبانیشده محسوب میشود که نسخه فعلی آن گواهی آزمون سرتاسری را بگذراند. نسخه 0.10.0 فیلد نسخه پروتکل GetLightdInfo را اصلاح کرد تا Zingo بتواند همگامسازی کند.zinder-query را فراخوانی میکنند.zinder-client استفاده میکنند؛ یک SDK با اولویت اتصال از راه دور که بدون پیوند دادن پشته ذخیرهسازی به zinder-query متصل میشود.ExplorerQuery ترکیب میکنند.راهنمای شروع سریع بالادستی ابتدا نودی را با پشته راهاندازی میکند و سپس از checkout Zinder با Docker Compose، 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
فایلهای env برای Mainnet و یک نود Zakura (deploy/.env.zakura-mainnet، deploy/.env.zakura-testnet) در کنار آن قرار دارند. از نسخه 0.11.0، فایل Compose دیگر Z3 را بهطور پیشفرض فرض نمیکند: فایل env باید شبکه، volume کوکی و نشانی RPC نود را مشخص کند.
درگاههای پیشفرض میزبان (در Testnet عدد 10000 به آنها اضافه میشود):
| سرویس | Mainnet | Testnet |
|---|---|---|
gRPC بومی WalletQuery | 9102 | 19102 |
| gRPC سازگار با lightwalletd | 9067 | 19067 |
| آمادگی: دریافت / پروژکتور / پرسوجو / سازگاری | 9105 / 9110 / 9106 / 9107 | 19105 / 19110 / 19106 / 19107 |
هر دو درگاه کیفپول به loopback متصل میشوند. با دستور زیر آنها را بررسی کنید:
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
روشهای دیگر استقرار:
ghcr.io/zcashfoundation/: چهار زمان اجرا، بهعلاوه zinder-wallet-serving (دریافت، پروژکتور و پرسوجوی بومی در یک کانتینر برای میزبانهایی که میتوانند یک volume را به یک کانتینر متصل کنند؛ بدون آداپتور lightwalletd) و zinder-canonical-runtime (فقط دریافت).zinder-ingest از راهاندازی در برابر نود هرسشده خودداری میکند.zinder-wallet-serving، نقطه پایانی gRPC نمایهساز نود (ZINDER_NODE__INDEXER_GRPC_ADDR، Zebra یعنی indexer_listen_addr، درگاه 8155 در Mainnet). نمایهساز Zakura در نشانیای غیر از loopback به TLS دوسویه نیاز دارد؛ Zinder از نسخه 0.11.0 از آن پشتیبانی میکند.بر اساس راهنمای اجرای سرویس کیفپول:
| نسخه | تاریخ | تغییرات برای اپراتورها |
|---|---|---|
| 0.7.0 | 2026-11-10 | پنجره پیشفرض بازسازماندهی به 1000 بلوک افزایش یافت؛ عمقی که Zebra 7 و Zakura در آن بلوکها را نهایی میکنند. برگشتناپذیر: نسخههای قدیمیتر نمیتوانند ذخیرهسازهای ارتقایافته را باز کنند |
| 0.9.0 | 2026-11-12 | ایمیجهای جدید zinder-wallet-serving و zinder-canonical-runtime |
| 0.10.0 | 2026-11-13 | نخستین نسخهای که بلوکهای NU7 را رمزگشایی میکند. نسخه 0.9.0 و نسخههای پیشین با رسیدن به نخستین بلوک NU7 متوقف میشوند. بازنگری 8 پروتکل بومی: دریافت و پرسوجو را با هم ارتقا دهید و کلاینتهای بومی را نیز همزمان بهروز کنید |
| 0.11.1 | 2026-11-14 | Zakura 1.8.6 در کنار Zebra 7.0.0 گواهی شد؛ TLS دوسویه با نمایهساز نود؛ نودهای هرسشده پذیرفته نمیشوند. نسخه 0.11.0 فقط بهصورت crate منتشر شد؛ بنابراین 0.11.1 را مستقر کنید |
| 0.12.0 | 2026-11-14 |
رفتار با آن مانند نرمافزار آماده تولید. پروژه خود را آلفا مینامد. به گفته خود پروژه، اجرای Compose محلیِ بدون خطا «بهتنهایی گواهی تولید نیست».
اتصال آن به نود هرسشده. فرایند دریافت هنگام راهاندازی خارج میشود. از نود آرشیوی Zebra یا Zakura استفاده کنید.
در معرض اینترنت قرار دادن مستقیم درگاههای gRPC. هر دو درگاه کیفپول به دلیلی به loopback متصل میشوند. پیش از باز کردن آنها به اینترنت، TLS، احراز هویت، محدودیت نرخ و سهمیهها را پشت پروکسیای قرار دهید که خودتان کنترل میکنید.
ارتقای زمانهای اجرا یکییکی. چند نسخه، بازنگری پروتکل بومی یا قالب ذخیرهساز را تغییر میدهند. سرویسهای Zinder را با هم ارتقا دهید و کلاینتهای بومی را نیز در همان مرحله بهروزرسانی کنید.
فرض اینکه کیفپول بهخاطر پشتیبانی از پروتکل، پشتیبانی میشود. آداپتور lightwalletd با پروتکل کار میکند، اما Zinder تنها پس از گواهی سرتاسری نسخه فعلی کیفپول، آن را پشتیبانیشده اعلام میکند.
آخرین بهروزرسانی: نوامبر 2026
| اصلاحات آمادگی و خاموششدن؛ بازپخش کاوشگر سریعتر شده و با کمبود فضای دیسک متوقف میشود |