Перейти до основного вмісту

Інформація про індексатор

Інформація та стан індексатора​

Повертає поточний статус, прогрес синхронізації і поточний корінь 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
попередження

Якщо last_processed_coin_block помітно відстає від last_checkpoint.block_id, нещодавні реєстрації можуть ще не відображатися.