Pular para o conteúdo principal

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âmetroTipoPredefiniçãoDescrição
extendedbooleanfalseSe for true, devolve também informação adicional

Exemplos de código​

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

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…"
}
}
CampoTipoDescrição
last_processed_coin_blockintÚltimo bloco processado na cadeia (normalmente o block_id do último ponto de controlo)
indexer_smt_rootstringPonto atual de sincronização do indexador (a sua raiz SMT)
anchored_smt_rootstringA raiz que o contrato âncora atesta atualmente, lida diretamente do seu estado
indexer_syncedbooleanSe 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_behindbooleanTrue quando o checkpoint mais recente deste nó é anterior à raiz atestada pelo contrato — ou seja, a descoberta está atrasada
anchored_epochintA é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_stoppedbooleanTrue 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_countintTotal de nomes registados
zonesstring[]Zonas em que um nome pode ser registado
registrar_addressstringEndereço do registador para processar transações recebidas e o depósito em garantia
registrar_viewing_keystringChave 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_checkpointInformação do último ponto de controlo (última atualização da raiz SMT)
idxintÍndice da raiz no mapping rootAt do contrato âncora (0 é a raiz génese); o cursor de retoma na descoberta de checkpoints
smt_rootstringÚltima raiz da árvore de Merkle (hex)
block_idintblock_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.