Indexer-Info

Info und Zustand des Indexers

Liefert den aktuellen Status, den Synchronisationsfortschritt und den aktuellen SMT-Root des PIVX Names-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": 3423251,
    "last_checkpoint": {
      "idx": 42,
      "block_id": 3423251,
      "smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
    },
    "indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "indexer_synced": true,
    "checkpoints_behind": false,
    "domains_count": 4,
    "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
`domains_count`	int	Insgesamt registrierte Namen
`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	Position im `rootChain`-Array des Anchor-Vertrags; 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.

Info und Zustand des Indexers​

Endpunkt​

Anfragekörper​

Codebeispiele​

Info und Zustand des Indexers

Endpunkt

Anfragekörper

Codebeispiele