Zum Hauptinhalt springen

Indexer-Info

Info und Zustand des Indexers​

Liefert den aktuellen Status, den Synchronisationsfortschritt und den aktuellen SMT-Root des ZCashNames-Auflösungs-Indexer-Knotens.

Endpunkt​

GET https://indexer.zcashnames.co/v1.0/info (Basisinformationen abrufen)
POST https://indexer.zcashnames.co/v1.0/info (falls zusätzliche Parameter nötig sind)

Anfragekörper​

Der Anfragekörper muss ein JSON-Objekt mit folgenden Parametern sein:

ParameterTypStandardBeschreibung
extendedbooleanfalseBei true werden zusätzlich erweiterte Angaben zurückgegeben

Codebeispiele​

curl -X GET https://indexer.zcashnames.co/v1.0/info

Beispielantwort (mit extended: true)

{
"response": {
"last_processed_coin_block": 3439751,
"last_checkpoint": {
"idx": 42,
"block_id": 3439751,
"smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
},
"indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"indexer_synced": true,
"checkpoints_behind": false,
"anchored_epoch": 1,
"sync_stopped": false,
"domains_count": 4,
"registrar_address": "u1nlded5cat3n9r4m0tpxr5a7sy3emccvaun7n4x9w848qa7ncl4eg5v2zyat4kevaa4fwfq0unwj3vnczfax3s9rutma43dckgqss8qrg",
"registrar_viewing_key": "uview1uxy3j27qhwkh8peq8k6g0vldalgqm4lyfxwuc2r95jelk458gmx6elc4e92t9g75x655vd7nxrtv3gllvajt3n8v0x36224ma3hrtvvtps7ejxysx8puelggt86vfuslxvdvjq7a778chqtcg626lcsr0ht26v3wgyfu5u04sn2qsle9k7faakg479tqf"
}
}
FeldTypBeschreibung
last_processed_coin_blockintZuletzt verarbeiteter Block der Kette (üblicherweise block_id des letzten Checkpoints)
indexer_smt_rootstringAktueller Synchronisationsstand des Indexers (dessen SMT-Root)
anchored_smt_rootstringDer Root, den der Anchor-Vertrag derzeit bezeugt, direkt aus seinem Zustand gelesen
indexer_syncedbooleanOb der von diesem Knoten selbst berechnete Root dem vom Anchor-Vertrag bezeugten Root entspricht. Das ist die vollständige Sync-Prüfung — gemessen am Vertrag, nicht an einer lokalen Tabelle
checkpoints_behindbooleanTrue, wenn der neueste Checkpoint dieses Knotens älter ist als der vom Vertrag bezeugte Root — die Ermittlung hinkt also hinterher
anchored_epochintDie Epoche des Anchor-Vertrags, unter der dieser Knoten seinen Zustand ausliefert. Der Knoten hört auf zu synchronisieren, sobald die On-Chain-Epoche darüber hinausgeht, alles, was er ausliefert, gehört also zu dieser Epoche. Lösen Sie nur über einen Knoten auf, dessen Epoche mit der von Ihnen geprüften übereinstimmt — siehe Schritt 3 — die Epoche prüfen
sync_stoppedbooleanTrue, solange der Knoten der Kette nicht mehr folgt und auf seinen Betreiber wartet: Die On-Chain-Epoche, durch eine Regeländerung oder einen Rollback verschoben, ist eine, für die er nicht aktualisiert wurde. Er liefert weiter den Zustand aus, den er hat — nutzen Sie solange besser einen anderen Knoten
domains_countintInsgesamt registrierte Namen
registrar_addressstringAdresse der Registrierungsstelle zur Verarbeitung eingehender TX und für die Treuhand
registrar_viewing_keystringVollständiger Viewing Key der ZCash-Adresse der Registrierungsstelle, der Zugriff auf die gesamte Protokollhistorie gibt — eingehende Befehle wie ausgehende Auszahlungen
last_checkpointAngaben zum letzten Checkpoint (letzte Aktualisierung des SMT-Roots)
idxintIndex des Roots im rootAt-Mapping des Anchor-Vertrags (0 ist der Genesis-Root); der Wiederaufnahmepunkt der Checkpoint-Ermittlung
smt_rootstringLetzter Merkle-Tree-Root (hex)
block_idintZCash-block_id des letzten Checkpoints und der SMT-Root-Erzeugung
warnung

Liegt last_processed_coin_block deutlich hinter last_checkpoint.block_id, sind jüngste Registrierungen möglicherweise noch nicht abgebildet.