Перейти до основного вмісту

Історія домену

Повертає журнал операцій (таких як реєстрація і зміни), виконаних над конкретним іменем PIVX.

Точка доступу​

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

Параметри шляху​

ПараметрТипОбов'язковийОпис
domain_namestringТакДомен PIVX, історію якого потрібно запитати (наприклад, richard.pivx).

Тіло запиту​

Тіло запиту має бути об'єктом JSON із такими параметрами:

ПараметрТипЗа замовчуваннямОпис
countinteger100Скільки записів повернути, не більше 500: більше число скорочується до 500.
from_block_idintegerНемаєПовернути лише записи після цього блоку: з пізніших блоків при asc, з раніших при desc; сам блок не входить. Без нього список починається з найстарішого запису (asc) або з найновішого (desc).
from_nonceintegerНемаєЛише разом із from_block_id: nonce останнього запису, який у вас є. Тоді список продовжується одразу після цього запису, а не після всього його блоку; див. Читання сторінками.
orderstringdescПорядок сортування: asc або desc. Записи впорядковано за блоком, потім за nonce.

Приклади коду​

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"
}'

Приклад відповіді

{
"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
}
]
}
ПолеТипОпис
domain_block_idintБлок PIVX, у якому виконано операцію
domain_tsintЧас цього блоку, у секундах Unix
target_addressstringАдреса, у яку розв'язується ім'я після операції
opstringОперація: REG, UPD, CHG, LST, ULT або BUY
owner_pubkeystringПублічний ключ власника імені після операції
domain_txstringХеш транзакції PIVX, яка несла операцію
nonceintNonce операції: часова позначка, що зростає з кожною операцією над іменем
priceintЦіна продажу після операції, у сатоші: ціна виставлення для LST, інакше 0. У записі BUY стоїть 0, бо ім'я більше не продається; сплачена ціна — ціна останнього LST перед ним

Читання сторінками​

Щоб читати довгу історію сторінками, передавайте останній запис кожної сторінки назад як курсор: його domain_block_id як from_block_id, а його nonce як from_nonce. Передавайте обидва: один блок може містити кілька операцій над тим самим іменем (у прикладі вище це LST і ULT у блоці 5538248), і сторінка може закінчитися між ними. З одним from_block_id наступна сторінка почалася б з наступного блоку й пропустила б решту цього. Сторінка, у якій записів менше, ніж ви запитали (або менше 500, якщо ви запитали більше), — остання.

from_nonce без from_block_id або такий, що не є невід'ємним цілим числом, отримує у відповідь помилку One or several params provided have wrong value, як і від'ємний чи нецілий count.