Zum Hauptinhalt springen

Indexer-Info

Info und Zustand des Indexers​

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

Endpunkt​

GET https://indexer.pivx.name/v1.0/info (Basisinformationen abrufen)
POST https://indexer.pivx.name/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.pivx.name/v1.0/info

Beispielantwort (mit extended: true)

Die hier gezeigten registrar_address und registrar_viewing_key sind beispielhaft. Der laufende Knoten liefert die echten Mainnet-Werte, die zum Start auch auf der Startseite veröffentlicht werden.

{
"response": {
"last_processed_coin_block": 5538251,
"last_checkpoint": {
"idx": 42,
"block_id": 5538251,
"smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
},
"indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"indexer_synced": true,
"checkpoints_behind": false,
"anchored_epoch": 2,
"sync_stopped": false,
"domains_count": 4,
"zones": ["pivx", "private", "secure", "safe"],
"registrar_address": "ps1…",
"registrar_viewing_key": "pxviews1…"
}
}
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, die der Betreiber dieses Knotens geprüft und eingestellt hat. Der Knoten folgt der Kette nicht mehr, sobald die On-Chain-Epoche darüber hinausgeht (siehe sync_stopped). Es ist eine Einstellung des Knotens, nicht von der Kette gelesen: Ein Knoten, der vor einer angesetzten Regeländerung aktualisiert wurde, meldet bereits die kommende Epoche und liefert, bis die Änderung in Kraft tritt, den Zustand aus, den er hat und der unter der geltenden Epoche entstanden ist, ohne neue Checkpoints zu übernehmen. Lesen Sie die Epoche eines Roots stattdessen aus dem Vertrag — 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
zonesstring[]Zonen, in denen ein Name registriert werden kann
registrar_addressstringAdresse der Registrierungsstelle zur Verarbeitung eingehender TX und für die Treuhand
registrar_viewing_keystringVollständiger Viewing Key der PIVX-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_idintPIVX-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.