Zum Hauptinhalt springen

Checkpoints

Liefert die Liste der Synchronisations-Checkpoints, die dieser Indexer aus dem Anchor-Vertrag gelesen hat — jeder ein Zustands-Root mit der PIVX-Blockhöhe, die er abdeckt —, damit Clients die Datenintegrität gegen bestimmte Blockhöhen prüfen können.

Endpunkt​

POST https://indexer.pivx.name/v1.0/checkpoints

Anfragekörper​

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

ParameterTypStandardBeschreibung
countinteger100Begrenzt die maximale Anzahl der Checkpoints in einer einzelnen Antwort, bis 500: eine größere Zahl wird auf 500 gekürzt.
from_blockintegerKeinerNur Checkpoints jenseits dieser Blockhöhe zurückgeben: bei späteren Höhen mit asc, bei früheren mit desc; der Block selbst ist ausgenommen. Ohne ihn beginnt die Liste beim ältesten Checkpoint (asc) oder beim neuesten (desc).
orderstringdescSortierreihenfolge der Checkpoints. Zulässige Werte: asc oder desc.

Codebeispiele​

curl -X POST https://indexer.pivx.name/v1.0/checkpoints \
-H "Content-Type: application/json" \
-d '{
"count": 2,
"from_block": 1,
"order": "asc"
}'

Beispielantwort

{
"response": [
{
"idx": 41,
"block_id": 5537048,
"smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
},
{
"idx": 42,
"block_id": 5537335,
"smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
}
]
}
FeldTypBeschreibung
idxintIndex des Roots im rootAt-Mapping des Anchor-Vertrags (0 ist der Genesis-Root); der Wiederaufnahmepunkt der Checkpoint-Ermittlung
block_idintDie letzte im Checkpoint enthaltene PIVX-block_id
smt_rootstringSMT-Root des Checkpoints