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

Информация об индексаторе

Информация и состояние индексатора​

Возвращает текущий статус, прогресс синхронизации и текущий корень SMT узла-индексатора разрешения имён PIVX Name.

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

GET https://indexer.pivx.name/v1.0/info (получить базовую информацию)
POST https://indexer.pivx.name/v1.0/info (если нужны дополнительные параметры)

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

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

ПараметрТипПо умолчаниюОписание
extendedbooleanfalseЕсли true, дополнительно возвращает расширенные сведения

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

curl -X GET https://indexer.pivx.name/v1.0/info

Пример ответа (при extended: true)

Показанные здесь registrar_address и registrar_viewing_key даны для примера. Работающий узел возвращает настоящие значения основной сети, которые при запуске публикуются также на главной странице.

{
"response": {
"last_processed_coin_block": 5538251,
"last_checkpoint": {
"idx": 42,
"block_id": 5538251,
"smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
},
"indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"indexer_synced": true,
"checkpoints_behind": false,
"anchored_epoch": 2,
"sync_stopped": false,
"domains_count": 4,
"zones": ["pivx", "private", "secure", "safe"],
"registrar_address": "ps1…",
"registrar_viewing_key": "pxviews1…"
}
}
ПолеТипОписание
last_processed_coin_blockintПоследний обработанный блок в цепочке (обычно block_id последней контрольной точки)
indexer_smt_rootstringТекущая точка синхронизации индексатора (его корень SMT)
anchored_smt_rootstringКорень, который в данный момент подтверждает якорный контракт, прочитанный напрямую из его состояния
indexer_syncedbooleanСовпадает ли самостоятельно вычисленный корень этого узла с корнем, подтверждаемым якорным контрактом. Это и есть полная проверка синхронизации — она выполняется относительно контракта, а не локальной таблицы
checkpoints_behindbooleanTrue, если новейший чекпоинт этого узла старше корня, подтверждаемого контрактом, — то есть получение чекпоинтов отстаёт
anchored_epochintЭпоха якорного контракта, которую проверил оператор этого узла и на которую он его настроил. Узел перестаёт следовать за цепочкой, как только эпоха в блокчейне уходит дальше неё (см. sync_stopped). Это настройка узла, а не значение из блокчейна: узел, обновлённый заранее под запланированную смену правил, уже сообщает будущую эпоху, а пока смена не вступила в силу, отдаёт имеющееся у него состояние, созданное под действующей эпохой, и не берёт новых чекпоинтов. Эпоху корня читайте из контракта — см. Шаг 3 — проверьте эпоху
sync_stoppedbooleanTrue, пока узел больше не следует за цепочкой и ждёт своего оператора: эпоха в блокчейне, сдвинутая сменой правил или откатом, — та, под которую его не обновили. Он продолжает отдавать состояние, которое у него есть, поэтому на это время предпочтите другой узел
domains_countintВсего зарегистрировано имён
zonesstring[]Зоны, в которых можно зарегистрировать имя
registrar_addressstringАдрес регистратора для обработки входящих транзакций и эскроу
registrar_viewing_keystringПолный ключ просмотра адреса PIVX регистратора, дающий доступ ко всей истории протокола — как к входящим командам, так и к исходящим выплатам
last_checkpointСведения о последней контрольной точке (последнее обновление корня SMT)
idxintИндекс корня в отображении rootAt якорного контракта (0 — генезис-корень); курсор возобновления при получении чекпоинтов
smt_rootstringПоследний корень дерева Меркла (hex)
block_idintblock_id блока PIVX последней контрольной точки и генерации корня SMT
warning

Если last_processed_coin_block заметно отстаёт от last_checkpoint.block_id, недавние регистрации могут ещё не отражаться.