Puntos de control
Devuelve la lista de puntos de control de sincronización que este indexador ha leído del contrato ancla —cada uno, una raíz de estado con la altura de bloque de PIVX que cubre—, 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, hasta 500: un número mayor se reduce a 500. |
from_block | integer | Ninguno | Devuelve solo los puntos de control más allá de esta altura de bloque: a alturas mayores con asc, a alturas menores con desc; el bloque en sí queda fuera. Sin él, la lista empieza por el punto de control más antiguo (asc) o por el más reciente (desc). |
order | string | desc | Orden de clasificación de los puntos de control. Valores admitidos: asc o desc. |
Ejemplos de código
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.pivx.name/v1.0/checkpoints \
-H "Content-Type: application/json" \
-d '{
"count": 2,
"from_block": 1,
"order": "asc"
}'
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));
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
$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": 5537048,
"smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
},
{
"idx": 42,
"block_id": 5537335,
"smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
}
]
}
| Campo | Tipo | Descripción |
|---|---|---|
idx | int | Índice de la raíz en el mapping rootAt del contrato ancla (0 es la raíz génesis); 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 |