メインコンテンツまでスキップ

ドメイン履歴

特定の 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 トランザクションのハッシュ
nonceint操作の nonce:名前に対する操作のたびに増えるタイムスタンプ
priceint操作後の売却価格(satoshi 単位):LST では出品価格、それ以外は 0。BUY の行は名前がもう売りに出ていないため 0 を示し、支払われた価格はその前の最後の LST の価格です

ページング​

長い履歴をページごとに読むには、各ページの最後の行をカーソルとして送り返してください。その行の domain_block_id を from_block_id に、nonce を from_nonce に指定します。必ず両方を送ってください。1 つのブロックに同じ名前に対する操作が複数含まれることがあり(上の例ではブロック 5538248 の LST と ULT)、ページがその間で終わることがあるからです。from_block_id だけでは、次のページは次のブロックから始まり、そのブロックの残りを飛ばしてしまいます。要求した数より(それより多く要求した場合は 500 より)行が少ないページが最後のページです。

from_nonce を from_block_id なしで送った場合、またはそれが非負の整数でない場合には、エラー One or several params provided have wrong value が返されます。負の、または整数でない count も同様です。