Puntos de control

Devuelve una lista de puntos de control criptográficos de sincronización generados por el nodo generador de pruebas, con los que los clientes pueden verificar la integridad de los datos frente a alturas de bloque concretas.

Punto de acceso

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

Cuerpo de la petición

El cuerpo de la petición debe ser un objeto JSON con los siguientes parámetros:

Parámetro	Tipo	Por defecto	Descripción
count	integer	100	Limita el número máximo de puntos de control devueltos en una sola respuesta.
from_block	integer	Ninguno	Solicita los datos de puntos de control a partir de esta altura de bloque.
order	string	desc	Orden de clasificación de los puntos de control. Valores admitidos: asc o desc.

---

Ejemplos de código

cURL

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

JavaScript

const url = 'https://indexer.pivx.name/v1.0/checkpoints';
const data = {
    count: 2,
    from_block: 1,
    order: 'asc'
};

fetch(url, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
})
    .then(response => response.json())
    .then(result => console.log(result))
    .catch(error => console.error('Error:', error));

Python

import requests

url = "https://indexer.pivx.name/v1.0/checkpoints"
payload = {
    "count": 2,
    "from_block": 1,
    "order": "asc"
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

PHP

<?php

$url = 'https://indexer.pivx.name/v1.0/checkpoints';
$data = [
    'count' => 2,
    'from_block' => 1,
    'order' => 'asc'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

Ejemplo de respuesta

{
  "response": [
    {
      "idx": 41,
      "block_id": 3422048,
      "smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
    },
    {
      "idx": 42,
      "block_id": 3422335,
      "smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
    }
  ]
}

Campo	Tipo	Descripción
idx	int	Posición en el array rootChain del contrato ancla; el cursor de reanudación al descubrir checkpoints
block_id	int	El último block_id de PIVX incluido en el punto de control
smt_root	string	Raíz SMT del punto de control