Zum Hauptinhalt springen

Domain-Historie

Liefert das Protokoll der Operationen (etwa Registrierung und Änderungen), die an einem bestimmten PIVX-Namen vorgenommen wurden.

Endpunkt​

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

Pfadparameter​

ParameterTypErforderlichBeschreibung
domain_namestringJaDie PIVX-Domain, deren Historie abgefragt wird (z. B. richard.pivx).

Anfragekörper​

Der Anfragekörper muss ein JSON-Objekt mit folgenden Parametern sein:

ParameterTypStandardBeschreibung
countinteger100Die höchste Zahl zurückgegebener Einträge, bis 500: eine größere Zahl wird auf 500 gekürzt.
from_block_idintegerKeinerNur Einträge nach diesem Block zurückgeben: aus späteren Blöcken bei asc, aus früheren bei desc; der Block selbst ist ausgenommen. Ohne ihn beginnt die Liste beim ältesten Eintrag (asc) oder beim neuesten (desc).
from_nonceintegerKeinerNur zusammen mit from_block_id: die nonce des letzten Eintrags, den Sie haben. Die Liste setzt dann direkt nach diesem Eintrag fort statt nach seinem ganzen Block; siehe Seitenweises Lesen.
orderstringdescDie Sortierreihenfolge: asc oder desc. Die Einträge sind nach Block und dann nach nonce sortiert.

Codebeispiele​

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

Beispielantwort

{
"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
}
]
}
FeldTypBeschreibung
domain_block_idintDer PIVX-Block, der die Operation enthält
domain_tsintDie Zeit dieses Blocks, in Unix-Sekunden
target_addressstringDie Adresse, auf die der Name nach der Operation aufgelöst wird
opstringDie Operation: REG, UPD, CHG, LST, ULT oder BUY
owner_pubkeystringDer öffentliche Schlüssel des Namensinhabers nach der Operation
domain_txstringDer Hash der PIVX-Transaktion, die die Operation trug
nonceintDie Nonce der Operation: ein Zeitstempel, der mit jeder Operation am Namen wächst
priceintDer Verkaufspreis nach der Operation, in Satoshi: der Angebotspreis bei LST, sonst 0. Ein BUY-Eintrag zeigt 0, da der Name nicht mehr zum Verkauf steht; gezahlt wurde der Preis des letzten LST davor

Seitenweises Lesen​

Um eine lange Historie seitenweise zu lesen, senden Sie den letzten Eintrag jeder Seite als Cursor zurück: seine domain_block_id als from_block_id und seine nonce als from_nonce. Senden Sie beide: Ein Block kann mehrere Operationen am selben Namen enthalten (im Beispiel oben das LST und das ULT in Block 5538248), und eine Seite kann zwischen ihnen enden. Mit from_block_id allein würde die nächste Seite beim nächsten Block beginnen und den Rest dieses Blocks überspringen. Eine Seite mit weniger Einträgen als angefragt (oder als 500, wenn Sie mehr angefragt haben) ist die letzte.

Eine from_nonce ohne from_block_id oder eine, die keine nichtnegative ganze Zahl ist, wird mit dem Fehler One or several params provided have wrong value beantwortet, ebenso ein negativer oder nicht ganzzahliger count.