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

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

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

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

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

Тело запроса

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

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

---

Примеры кода

cURL

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

JavaScript

const url = 'https://indexer.pivx.name/v1.0/info';

fetch(url, {
    method: 'GET'
})
    .then(response => response.json())
    .then(result => console.log(result))
    .catch(error => console.error('Error:', error));

Python

import requests

url = "https://indexer.pivx.name/v1.0/info"

response = requests.get(url)
print(response.json())

PHP

<?php

$url = 'https://indexer.pivx.name/v1.0/info';

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);

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

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

{
  "response": {
    "last_processed_coin_block": 3423251,
    "last_checkpoint": {
      "idx": 42,
      "block_id": 3423251,
      "smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
    },
    "indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "indexer_synced": true,
    "checkpoints_behind": false,
    "domains_count": 4,
    "registrar_address": "ps1…",
    "registrar_viewing_key": "pxviews1…"
  }
}

Поле	Тип	Описание
last_processed_coin_block	int	Последний обработанный блок в цепочке (обычно block_id последней контрольной точки)
indexer_smt_root	string	Текущая точка синхронизации индексатора (его корень SMT)
anchored_smt_root	string	Корень, который в данный момент подтверждает якорный контракт, прочитанный напрямую из его состояния
indexer_synced	boolean	Совпадает ли самостоятельно вычисленный корень этого узла с корнем, подтверждаемым якорным контрактом. Это и есть полная проверка синхронизации — она выполняется относительно контракта, а не локальной таблицы
checkpoints_behind	boolean	True, если новейший чекпоинт этого узла старше корня, подтверждаемого контрактом, — то есть получение чекпоинтов отстаёт
domains_count	int	Всего зарегистрировано имён
registrar_address	string	Адрес регистратора для обработки входящих транзакций и эскроу
registrar_viewing_key	string	Полный ключ просмотра адреса PIVX регистратора, дающий доступ ко всей истории протокола — как к входящим командам, так и к исходящим выплатам
last_checkpoint		Сведения о последней контрольной точке (последнее обновление корня SMT)
idx	int	Позиция в массиве rootChain якорного контракта; курсор возобновления при получении чекпоинтов
smt_root	string	Последний корень дерева Меркла (hex)
block_id	int	block_id блока PIVX последней контрольной точки и генерации корня SMT

warning

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