Pular para o conteúdo principal

Histórico do domínio

Devolve o registo histórico das operações (como o registo e as alterações) realizadas sobre um nome PIVX específico.

Ponto de acesso​

POST https://indexer.pivx.name/v1.0/history/richard.pivx

Parâmetros de caminho​

ParâmetroTipoObrigatórioDescrição
domain_namestringSimO domínio PIVX cujo histórico se pretende consultar (por exemplo, richard.pivx).

Corpo do pedido​

O corpo do pedido tem de ser um objeto JSON com os seguintes parâmetros:

ParâmetroTipoPredefiniçãoDescrição
countinteger100O máximo de linhas devolvidas, até 500: um número maior é reduzido a 500.
from_block_idintegerNenhumDevolve apenas as linhas posteriores a este bloco: de blocos mais recentes com asc, de blocos anteriores com desc; o próprio bloco fica de fora. Sem ele, a lista começa pela linha mais antiga (asc) ou pela mais recente (desc).
from_nonceintegerNenhumApenas em conjunto com from_block_id: o nonce da última linha que tem. A lista continua então logo a seguir a essa linha, e não a seguir a todo o seu bloco; consulte Paginação.
orderstringdescA ordenação: asc ou desc. As linhas são ordenadas por bloco e depois por nonce.

Exemplos de código​

curl -X POST https://indexer.pivx.name/v1.0/history/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"count": 10,
"from_block_id": 5537000,
"order": "asc"
}'

Exemplo de resposta

{
"response": [
{
"domain_block_id": 5537326,
"domain_ts": 1784808285,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "388241ffc5bf8ba3d7633d132298d157e26d6ac127ff8d162f26e7203084df08",
"op": "REG",
"nonce": 1784808228,
"price": 0
},
{
"domain_block_id": 5537369,
"domain_ts": 1784812590,
"target_address": "ps1f84lvgj0awz2yf2zha5d5gddhd4j88g0kzj5cwp776vhxp5fdjqe7e95cdx2qs5e7fcvg3ds3yq",
"owner_pubkey": "3757ee1a8b3f10353ca6edd47b66920392b02e323dca3f3edddb5de142079a53",
"domain_tx": "4d5419af400966616ba9325f78bb3cac2ff1229fd4d39ed022a9fc113ee4b67e",
"op": "LST",
"nonce": 1784812534,
"price": 200000
},
{
"domain_block_id": 5537421,
"domain_ts": 1784815647,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3834eb36ca816f1bd9074c546ec64b3a361aca67e88c35b1586fe4ec1ae60095",
"op": "BUY",
"nonce": 1784815586,
"price": 0
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "3c08640ed394b1a270abddcc3ca873c13793629c6a148ad0b5585003ca9e632a",
"op": "LST",
"nonce": 1784878114,
"price": 10012345678
},
{
"domain_block_id": 5538248,
"domain_ts": 1784878331,
"target_address": "ps1yq6m9k7hn4wzp3gv5xun8kf0eq2dm3ay5r7vc6t9jl0sxh2pw8dz4knmg7uve3cqr6t5hxj9fda",
"owner_pubkey": "66a998241f62b4c8e4340f6e840b4570ac1d2d9840e2e42f62e713a34244f098",
"domain_tx": "9ad75f893c002f21e9bbc3c6cdf4e151477293d64a013aa773db26598c1d5d11",
"op": "ULT",
"nonce": 1784878293,
"price": 0
}
]
}
CampoTipoDescrição
domain_block_idintO bloco PIVX que contém a operação
domain_tsintA hora desse bloco, em segundos Unix
target_addressstringO endereço para o qual o nome é resolvido após a operação
opstringA operação: REG, UPD, CHG, LST, ULT ou BUY
owner_pubkeystringA chave pública do titular do nome após a operação
domain_txstringO hash da transação PIVX que levou a operação
nonceintO nonce da operação: uma marca temporal que cresce a cada operação sobre o nome
priceintO preço de venda após a operação, em satoshi: o preço de listagem para LST, caso contrário 0. Uma linha BUY mostra 0, porque o nome já não está à venda; o preço pago é o do último LST antes dela

Paginação​

Para ler um histórico longo página a página, devolva a última linha de cada página como cursor: o seu domain_block_id como from_block_id e o seu nonce como from_nonce. Envie ambos: um bloco pode conter várias operações sobre o mesmo nome (no exemplo acima, o LST e o ULT do bloco 5538248) e uma página pode terminar entre elas. Só com from_block_id, a página seguinte começaria no bloco seguinte e saltaria o resto desse. Uma página com menos linhas do que pediu (ou do que 500, se pediu mais) é a última.

Um from_nonce sem from_block_id, ou que não seja um inteiro não negativo, é respondido com o erro One or several params provided have wrong value, tal como um count negativo ou não inteiro.