Перейти к основному содержимому

Контрольные точки

Возвращает список контрольных точек синхронизации, которые этот индексатор прочитал из якорного контракта, — каждая из них это корень состояния с высотой блока PIVX, которую он охватывает, — что позволяет клиентам проверять целостность данных относительно конкретных высот блоков.

Точка доступа​

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

Тело запроса​

Тело запроса должно быть объектом JSON со следующими параметрами:

ПараметрТипПо умолчаниюОписание
countinteger100Ограничивает максимальное число контрольных точек в одном ответе, не больше 500: большее число сокращается до 500.
from_blockintegerНетВернуть только контрольные точки за этой высотой блока: на более поздних высотах при asc, на более ранних при desc; сам блок не входит. Без него список начинается с самой старой контрольной точки (asc) или с самой новой (desc).
orderstringdescПорядок сортировки контрольных точек. Допустимые значения: asc или desc.

Примеры кода​

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

Пример ответа

{
"response": [
{
"idx": 41,
"block_id": 5537048,
"smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
},
{
"idx": 42,
"block_id": 5537335,
"smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
}
]
}
ПолеТипОписание
idxintИндекс корня в отображении rootAt якорного контракта (0 — генезис-корень); курсор возобновления при получении чекпоинтов
block_idintПоследний block_id блока PIVX, включённый в контрольную точку
smt_rootstringКорень SMT контрольной точки