Το Zinder είναι ένα αυτοφιλοξενούμενο indexer του Zcash, γραμμένο σε Rust και δημοσιευμένο από το Zcash Foundation. Διαβάζει την αλυσίδα μία φορά από έναν πλήρη κόμβο Zebra ή Zakura, αποθηκεύει μία συνεπή εικόνα της και τη διαθέτει ταυτόχρονα σε πολλά πορτοφόλια, εφαρμογές και εξερευνητές. Τα υπάρχοντα light wallets μπορούν να συνδεθούν σε αυτό μέσω ενός προσαρμογέα συμβατού με το lightwalletd.
Το Zinder είναι σε alpha. Το ίδιο το README του αναφέρει ότι το εγγενές API, η επιφάνεια συμβατότητας με το lightwalletd, οι διατάξεις αποθήκευσης και η τοπολογία ανάπτυξης θα αλλάξουν, και ότι μια έκδοση με ετικέτα δεν αποτελεί υπόσχεση σταθερότητας. Κλείδωσε τις ακριβείς εκδόσεις και περίμενε ασύμβατες αλλαγές στις αναβαθμίσεις.
WalletQuery, και ένας ξεχωριστός προσαρμογέας που μιλά το πρωτόκολλο CompactTxStreamer του lightwalletd, ώστε τα πορτοφόλια που έχουν φτιαχτεί για το lightwalletd να μπορούν να συνδεθούν σε αυτό χωρίς αλλαγές στον κώδικα.Τα light wallets δεν επικοινωνούν ποτέ απευθείας με έναν πλήρη κόμβο. Ζητούν από ένα indexer συμπαγή μπλοκ, καταστάσεις δέντρων και δεδομένα συναλλαγών (βλ. ). Το οικοσύστημα του Zcash διαθέτει πλέον αρκετά indexers που μπορούν να το κάνουν:
| Indexer | Γλώσσα | Συντηρητής | Συνδέεται με | Σημειώσεις |
|---|---|---|---|---|
| lightwalletd | Go | ECC / κοινότητα του Zcash | Zebra ή zcashd | Ο αρχικός διακομιστής light wallet |
| Rust | Zingo Labs | Zebra ή zcashd | Προαιρετικό προφίλ indexer στη στοίβα Z3 | |
| Ztreamer | Rust | zcashlabs | Ενσωματωμένος κόμβος Zakura | Δες τη συγκριτική αξιολόγηση |
| Zinder | Rust | Zcash Foundation | Zebra 7.0.0 ή Zakura 1.8.6 (κόμβος αρχειοθέτησης) | Alpha. Εγγενές API, προσαρμογέας lightwalletd και προαιρετικές αναγνώσεις από explorer |
Η τεκμηρίωση του Zinder εξηγεί ξεκάθαρα πότε είναι η κατάλληλη επιλογή: υπερέχει όταν η πρόσβαση στην αλυσίδα πρέπει να παραμένει διαθέσιμη πέρα από τη διάρκεια ζωής μίας διεργασίας πορτοφολιού, να εξυπηρετεί πολλούς ανεξάρτητους καταναλωτές ή να παραμένει ξεχωριστή από τον κώδικα οποιουδήποτε πορτοφολιού. Για ένα μόνο, στενά συνδεδεμένο πορτοφόλι, ένα ενσωματωμένο indexer μπορεί να είναι απλούστερο, ενώ ένας καταναλωτής που χρειάζεται μόνο δεδομένα που διαθέτει ήδη ο κόμβος μπορεί να χρησιμοποιήσει απευθείας το RPC του Zebra.
Το Zinder χωρίζει τις εργασίες σε ξεχωριστές διεργασίες, καθεμία με έναν ρόλο:
| Runtime | Ρόλος |
|---|---|
zinder-ingest | Ο μοναδικός writer στο κανονικό αποθηκευτικό σύστημα της αλυσίδας (RocksDB). Ακολουθεί τον κόμβο, διαχειρίζεται αναδιοργανώσεις και διατηρεί την τρέχουσα κατάσταση του mempool |
zinder-projector | Ο μοναδικός writer στο αποθηκευτικό σύστημα του πορτοφολιού. Δημιουργεί και ακολουθεί την εικόνα της αλυσίδας όπως τη χρειάζεται το πορτοφόλι |
zinder-query | Παρέχει το εγγενές API gRPC του WalletQuery |
zinder-compat-lightwalletd | Παρέχει το API CompactTxStreamer του lightwalletd, πάνω στα ίδια δεδομένα |
Ένα προαιρετικό επίπεδο explorer (zinder-explorer με ExplorerQuery) παρέχει συνοπτικά στοιχεία μπλοκ, λεπτομέρειες συναλλαγών, προβολές mempool και αναζήτηση, ενώ ένας προαιρετικός προσαρμογέας παρέχει τα API REST και WebSocket του explorer CipherScan. Κανένα από τα δύο δεν περιλαμβάνεται στις εικόνες των εκδόσεων.
Κάθε runtime εκθέτει τα /healthz, /readyz και /metrics. Οι readers αναφέρουν ότι είναι έτοιμοι μόνο όταν τα αντίγραφά τους από το αποθηκευτικό σύστημα της αλυσίδας και του πορτοφολιού δείχνουν ακριβώς στην ίδια κατάσταση της αλυσίδας.
zinder-compat-lightwalletd. Η τεκμηρίωση του Zinder ξεχωρίζει τη συμβατότητα πρωτοκόλλου από την υποστήριξη: ένα συγκεκριμένο πορτοφόλι θεωρείται υποστηριζόμενο μόνο αφού η τρέχουσα έκδοσή του περάσει πιστοποίηση από άκρο σε άκρο. Η έκδοση 0.10.0 διόρθωσε το πεδίο έκδοσης πρωτοκόλλου GetLightdInfo, ώστε να μπορεί να συγχρονιστεί το Zingo.zinder-query για δεσμευμένες αναγνώσεις, συμπαγή μπλοκ, ροές συμβάντων της αλυσίδας και του mempool, καθώς και αποτελέσματα μετάδοσης με τυποποιημένους λόγους απόρριψης.zinder-client, ένα SDK που προτιμά την απομακρυσμένη σύνδεση και συνδέεται με το zinder-query χωρίς να συνδέει τη στοίβα αποθήκευσης.ExplorerQuery.Ο οδηγός γρήγορης εκκίνησης του upstream ξεκινά έναν κόμβο με τη στοίβα και στη συνέχεια εκτελεί το Zinder με το Docker Compose από το 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
Τα αρχεία env για το Mainnet και για έναν κόμβο Zakura (deploy/.env.zakura-mainnet, deploy/.env.zakura-testnet) βρίσκονται δίπλα του. Από την έκδοση 0.11.0, το αρχείο Compose δεν προϋποθέτει πλέον το Z3: το αρχείο env πρέπει να καθορίζει το δίκτυο του κόμβου, τον τόμο cookie και τη διεύθυνση RPC.
Προεπιλεγμένες θύρες host (το Testnet προσθέτει 10000):
| Υπηρεσία | Mainnet | Testnet |
|---|---|---|
Εγγενές gRPC WalletQuery | 9102 | 19102 |
| gRPC συμβατό με lightwalletd | 9067 | 19067 |
| Ετοιμότητα: ingest / projector / query / compat | 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/: τα τέσσερα runtimes, καθώς και το zinder-wallet-serving (ingest, projector και native query σε ένα container για hosts που μπορούν να προσαρτήσουν έναν τόμο σε ένα container· χωρίς προσαρμογέα lightwalletd) και το zinder-canonical-runtime (μόνο ingest).zinder-ingest αρνείται να ξεκινήσει με περικομμένο κόμβο.zinder-wallet-serving, το gRPC endpoint του indexer του κόμβου (ZINDER_NODE__INDEXER_GRPC_ADDR, indexer_listen_addr του Zebra, θύρα 8155 στο Mainnet). Για έναν indexer 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: αναβάθμισε μαζί τα ingest και query, καθώς και τους εγγενείς πελάτες |
| 0.11.1 | 2026-11-14 | Το Zakura 1.8.6 πιστοποιήθηκε μαζί με το Zebra 7.0.0· αμοιβαίο TLS προς τον indexer του κόμβου· οι περικομμένοι κόμβοι απορρίπτονται. Η έκδοση 0.11.0 κυκλοφόρησε μόνο ως crates, οπότε εγκατάστησε την 0.11.1 |
| 0.12.0 |
Να το αντιμετωπίζεις ως λογισμικό παραγωγής. Το έργο χαρακτηρίζει τον εαυτό του alpha. Μια επιτυχημένη τοπική ανάπτυξη με Compose, όπως αναφέρει το ίδιο, «δεν αποτελεί από μόνη της πιστοποίηση για παραγωγή».
Να το συνδέεις σε περικομμένο κόμβο. Το ingest τερματίζεται κατά την εκκίνηση. Χρησιμοποίησε κόμβο αρχειοθέτησης Zebra ή Zakura.
Να εκθέτεις απευθείας τις θύρες gRPC. Και οι δύο θύρες του πορτοφολιού συνδέονται μόνο στο loopback για κάποιο λόγο. Πριν τις ανοίξεις στο διαδίκτυο, βάλε τες πίσω από proxy που ελέγχεις, με TLS, έλεγχο ταυτότητας, όρια ρυθμού και ποσοστώσεις.
Να αναβαθμίζεις ένα runtime κάθε φορά. Αρκετές εκδόσεις αλλάζουν την αναθεώρηση του εγγενούς πρωτοκόλλου ή τη μορφή αποθήκευσης. Αναβάθμισε μαζί τις υπηρεσίες Zinder και ενημέρωσε τους εγγενείς πελάτες στην ίδια μετάβαση.
Να υποθέτεις ότι ένα πορτοφόλι υποστηρίζεται επειδή είναι συμβατό το πρωτόκολλο. Ο προσαρμογέας lightwalletd μιλά το πρωτόκολλο, αλλά το Zinder δηλώνει ότι υποστηρίζει ένα συγκεκριμένο πορτοφόλι μόνο αφού πιστοποιηθεί η τρέχουσα έκδοσή του από άκρο σε άκρο.
Τελευταία ενημέρωση: Νοέμβριος 2026
| 2026-11-14 |
| Διορθώσεις στην ετοιμότητα και στον τερματισμό· η αναπαραγωγή του explorer είναι ταχύτερη και διακόπτεται όταν εξαντλείται ο χώρος στον δίσκο |