Informação do indexador
Informação e estado do indexador
Devolve o estado atual, o progresso da sincronização e a raiz SMT atual do nó indexador de resolução do PIVX Name.
Ponto de acesso
GET https://indexer.pivx.name/v1.0/info (obter informação básica)
POST https://indexer.pivx.name/v1.0/info (se forem precisos parâmetros adicionais)
Corpo do pedido
O corpo do pedido tem de ser um objeto JSON com os seguintes parâmetros:
| Parâmetro | Tipo | Predefinição | Descrição |
|---|---|---|---|
extended | boolean | false | Se for true, devolve também informação adicional |
Exemplos 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);
Exemplo de resposta (com extended: true)
Os valores registrar_address e registrar_viewing_key aqui mostrados são ilustrativos. O nó
real devolve os valores da mainnet, que no lançamento também são publicados na
página inicial.
{
"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 | Descrição |
|---|---|---|
last_processed_coin_block | int | Último bloco processado na cadeia (normalmente o block_id do último ponto de controlo) |
indexer_smt_root | string | Ponto atual de sincronização do indexador (a sua raiz SMT) |
anchored_smt_root | string | A raiz que o contrato âncora atesta atualmente, lida diretamente do seu estado |
indexer_synced | boolean | Se a raiz calculada independentemente por este nó é igual à raiz atestada pelo contrato âncora. Esta é a verificação de sincronização completa — medida face ao contrato, não a uma tabela local |
checkpoints_behind | boolean | True quando o checkpoint mais recente deste nó é anterior à raiz atestada pelo contrato — ou seja, a descoberta está atrasada |
anchored_epoch | int | A época do contrato âncora que o operador deste nó reviu e configurou. O nó deixa de seguir a cadeia assim que a época na cadeia a ultrapassa (ver sync_stopped). É uma definição do nó, não um valor lido da cadeia: um nó atualizado antes de uma alteração de regras agendada já indica a época seguinte e, até a alteração entrar em vigor, serve o estado que tem, criado sob a época em vigor, sem tomar novos checkpoints. Leia a época de uma raiz no contrato — ver Passo 3 — verificar a época |
sync_stopped | boolean | True enquanto o nó deixou de seguir a cadeia e espera pelo seu operador: a época na cadeia, movida por uma alteração de regras ou por um rollback, é uma para a qual não foi atualizado. Continua a servir o estado que tem, por isso entretanto prefira outro nó |
domains_count | int | Total de nomes registados |
zones | string[] | Zonas em que um nome pode ser registado |
registrar_address | string | Endereço do registador para processar transações recebidas e o depósito em garantia |
registrar_viewing_key | string | Chave de visualização completa do endereço PIVX do registador, que dá acesso a todo o histórico do protocolo — tanto comandos recebidos como pagamentos enviados |
last_checkpoint | Informação do último ponto de controlo (última atualização da raiz SMT) | |
idx | int | Índice da raiz no mapping rootAt do contrato âncora (0 é a raiz génese); o cursor de retoma na descoberta de checkpoints |
smt_root | string | Última raiz da árvore de Merkle (hex) |
block_id | int | block_id PIVX do último ponto de controlo e da geração da raiz SMT |
aviso
Se last_processed_coin_block estiver bastante atrás de last_checkpoint.block_id, os registos recentes podem ainda não estar refletidos.