Контрольні точки
Повертає список контрольних точок синхронізації, які цей індексатор прочитав з якірного контракту, — кожна з них це корінь стану з висотою блоку PIVX, яку він охоплює, — що дозволяє клієнтам перевіряти цілісність даних відносно конкретних висот блоків.
Точка доступу
POST https://indexer.pivx.name/v1.0/checkpoints
Тіло запиту
Тіло запиту має бути об'єктом JSON із такими параметрами:
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
count | integer | 100 | Обмежує максимальну кількість контрольних точок в одній відповіді, не більше 500: більше число скорочується до 500. |
from_block | integer | Немає | Повернути лише контрольні точки за цією висотою блоку: на пізніших висотах при asc, на раніших при desc; сам блок не входить. Без нього список починається з найстарішої контрольної точки (asc) або з найновішої (desc). |
order | string | desc | Порядок сортування контрольних точок. Допустимі значення: asc або desc. |
Приклади коду
- 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);
Приклад відповіді
{
"response": [
{
"idx": 41,
"block_id": 5537048,
"smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
},
{
"idx": 42,
"block_id": 5537335,
"smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
}
]
}
| Поле | Тип | Опис |
|---|---|---|
idx | int | Індекс кореня у відображенні rootAt якірного контракту (0 — генезис-корінь); курсор відновлення під час отримання чекпоінтів |
block_id | int | Останній block_id блоку PIVX, включений у контрольну точку |
smt_root | string | Корінь SMT контрольної точки |