Skip to main content

Гісторыя дамена

Вяртае журнал аперацый (такіх як рэгістрацыя і змяненні), выкананых над канкрэтным імем 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.