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 Names.
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": 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…"
}
}
| 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 |
domains_count | int | Total de nomes registados |
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 | Posição no array rootChain do contrato âncora; 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.