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:
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
extended | boolean | false | Bei true werden zusätzlich erweiterte Angaben zurückgegeben |
Codebeispiele
- cURL
- JavaScript
- Python
- PHP
curl -X GET https://indexer.pivx.name/v1.0/info
const url = 'https://indexer.pivx.name/v1.0/info';
fetch(url, {
method: 'GET'
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.pivx.name/v1.0/info"
response = requests.get(url)
print(response.json())
<?php
$url = 'https://indexer.pivx.name/v1.0/info';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
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…"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
last_processed_coin_block | int | Zuletzt verarbeiteter Block der Kette (üblicherweise block_id des letzten Checkpoints) |
indexer_smt_root | string | Aktueller Synchronisationsstand des Indexers (dessen SMT-Root) |
anchored_smt_root | string | Der Root, den der Anchor-Vertrag derzeit bezeugt, direkt aus seinem Zustand gelesen |
indexer_synced | boolean | Ob 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_behind | boolean | True, wenn der neueste Checkpoint dieses Knotens älter ist als der vom Vertrag bezeugte Root — die Ermittlung hinkt also hinterher |
anchored_epoch | int | Die 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_stopped | boolean | True, 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_count | int | Insgesamt registrierte Namen |
zones | string[] | Zonen, in denen ein Name registriert werden kann |
registrar_address | string | Adresse der Registrierungsstelle zur Verarbeitung eingehender TX und für die Treuhand |
registrar_viewing_key | string | Vollständiger Viewing Key der PIVX-Adresse der Registrierungsstelle, der Zugriff auf die gesamte Protokollhistorie gibt — eingehende Befehle wie ausgehende Auszahlungen |
last_checkpoint | Angaben zum letzten Checkpoint (letzte Aktualisierung des SMT-Roots) | |
idx | int | Index des Roots im rootAt-Mapping des Anchor-Vertrags (0 ist der Genesis-Root); der Wiederaufnahmepunkt der Checkpoint-Ermittlung |
smt_root | string | Letzter Merkle-Tree-Root (hex) |
block_id | int | PIVX-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.