Información del indexador
Información y estado del indexador
Devuelve el estado actual, el progreso de sincronización y la raíz SMT actual del nodo indexador de resolución de PIVX Name.
Punto de acceso
GET https://indexer.pivx.name/v1.0/info (obtener información básica)
POST https://indexer.pivx.name/v1.0/info (si hacen falta parámetros adicionales)
Cuerpo de la petición
El cuerpo de la petición debe ser un objeto JSON con los siguientes parámetros:
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
extended | boolean | false | Si es true, devuelve además información ampliada |
Ejemplos de código
- cURL
- JavaScript
- Python
- PHP
curl -X GET https://indexer.pivx.name/v1.0/info
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));
import requests
url = "https://indexer.pivx.name/v1.0/info"
response = requests.get(url)
print(response.json())
<?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);
Ejemplo de respuesta (con extended: true)
Los valores registrar_address y registrar_viewing_key que se muestran aquí son
ilustrativos. El nodo real devuelve los valores de mainnet, que en el lanzamiento también se
publican en la portada.
{
"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…"
}
}
| Campo | Tipo | Descripción |
|---|---|---|
last_processed_coin_block | int | Último bloque procesado en la cadena (normalmente el block_id del último punto de control) |
indexer_smt_root | string | Punto actual de sincronización del indexador (su raíz SMT) |
anchored_smt_root | string | La raíz que el contrato ancla atestigua actualmente, leída directamente de su estado |
indexer_synced | boolean | Si la raíz calculada de forma independiente por este nodo coincide con la que atestigua el contrato ancla. Ésta es la comprobación de sincronización completa: se mide contra el contrato, no contra una tabla local |
checkpoints_behind | boolean | True cuando el checkpoint más reciente de este nodo es anterior a la raíz que atestigua el contrato, es decir, el descubrimiento va con retraso |
anchored_epoch | int | La época del contrato ancla que el operador de este nodo ha revisado y configurado. El nodo deja de seguir la cadena en cuanto la época en la cadena la supera (consulte sync_stopped). Es un ajuste del nodo, no un valor leído de la cadena: un nodo actualizado antes de un cambio de reglas programado ya informa de la época venidera y, hasta que el cambio entra en vigor, sirve el estado que tiene, creado bajo la época vigente, sin tomar nuevos checkpoints. Lea la época de una raíz en el contrato — consulte Paso 3 — comprobar la época |
sync_stopped | boolean | True mientras el nodo ya no sigue la cadena y espera a su operador: la época en la cadena, movida por un cambio de reglas o un rollback, es una para la que no se ha actualizado. Sigue sirviendo el estado que tiene, así que mientras tanto conviene usar otro nodo |
domains_count | int | Total de nombres registrados |
zones | string[] | Zonas en las que se puede registrar un nombre |
registrar_address | string | Dirección del registrador para procesar las transacciones entrantes y el depósito en garantía |
registrar_viewing_key | string | Clave de visualización completa de la dirección PIVX del registrador, que da acceso a todo el historial del protocolo: tanto comandos entrantes como pagos salientes |
last_checkpoint | Información del último punto de control (última actualización de la raíz SMT) | |
idx | int | Índice de la raíz en el mapping rootAt del contrato ancla (0 es la raíz génesis); el cursor de reanudación al descubrir checkpoints |
smt_root | string | Última raíz del árbol de Merkle (hex) |
block_id | int | block_id de PIVX del último punto de control y de la generación de la raíz SMT |
aviso
Si last_processed_coin_block está muy por detrás de last_checkpoint.block_id, es posible que los registros recientes aún no se reflejen.