Skip to main content

Adın həlli

Adın həlli​

PIVX adını həll edir və ona bağlı PIVX ünvanını, sübut təfərrüatlarını, sinxronizasiya nəzarət nöqtələrini və qeydiyyat verilənlərini qaytarır.

Son nöqtə​

GET https://indexer.pivx.name/v1.0/resolve/{name} (yalnız adın həlli)
POST https://indexer.pivx.name/v1.0/resolve/{name} (əlavə parametrlər lazımdırsa)

Yol parametrləri​

ParametrTipMəcburiTəsvir
{name}stringBəliHəll ediləcək PIVX adı (məsələn, richard.pivx).

Sorğunun gövdəsi​

Sorğunun gövdəsi aşağıdakı parametrləri ehtiva edən JSON obyekti olmalıdır:

ParametrTipSusmaya görəTəsvir
extendedbooleanfalsetrue olarsa, əlavə olaraq created_block_id, updated_block_id və domain_tx (adın son əməliyyatının əməliyyat heşi) qaytarılır.
with_checkpointbooleanfalsetrue olarsa, checkpoint də qaytarılır: bu sübutun qurulduğu kökə (smt_root ilə eyni) malik lövbərlənmiş nəzarət nöqtəsi. Sinxronizasiya yazılarkən null olur; sorğunu təkrarlayın. updated_block_id də onunla birlikdə qaytarılır.

Kod nümunələri​

curl -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'

Cavab nümunəsi

{
"response": {
"domain_name": "richard.pivx",
"target_address": "ps1zu2xyry4rc5j0trs3w9zqr5ayhw8h3ulhsfw4reufcg8c62gpg3rzcj7tkasn7tlwgc9y4emwtq",
"owner_pubkey": "ba17d58e11e9828a4ffc140560730ce1b410c924043c1d60cf52a127bde47544",
"price": 750000000000,
"nonce": 1793384994,
"created_block_id": 5648982,
"domain_tx": "a1003dace6ed2ea966aba28926c6ecb7cb5436229db329ce72d118d2cf502d66",
"updated_block_id": 5649418,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245",
"merkle_proof": [
"5a9acd90db63c21d8eff4b656d4526c1bb4b5f9f5e7cf6c5a22719c4d8854bec",
"0000000000000000000000000000000000000000000000000000000000000000",
"d8f11c6213a091087e5bcf8aeac624c7f768d9436af9b6883880155e28e3f4a7",
"ed05b1037b96221bda47b2dd76aa37a93f3d39cb336f8e6f8a203f8fb1ea2a98",
"3af379894717ec7000caf91fcd2bf0e570fda54befa24f5a5770275728dcb11e",
"50e173401bd419424082e3cb2caf9ee62e0808e79e8c8ade99d3396f35e995ce",
"4c1b349c97b95c712f4777b357de9ff1535aad68bb7c56134273a88fefe8bef5",
"3695b047cfbd47f93c899c03736d085924a23ba48d51a6db8382bb2a7452c4b6",
"badcf46ab543cb4a9a1ad7335a07b87d8ede6dc241cf4b4168894f4822f08325",
"e33ad310acd0cc3f5a4261ed6a24615e60e91de423a8ace2f6716c0b60aa351c"
],
"proof_depth": 10,
"proof_terminal": "Occupied",
"checkpoint": {
"idx": 31,
"block_id": 5671618,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245"
}
}
}

Bu, indexer.pivx.name-in yuxarıdakı sorğuya 31 nömrəli nəzarət nöqtəsində (PIVX bloku 5671618) verdiyi cavabdır. Kök hər yeni əməliyyat paketi ilə dəyişir, ona görə sonra göndərilən sorğu başqa smt_root və başqa qonşu heşlər qaytara bilər; bu cavab isə Sübutların yoxlanması səhifəsindəki kodla yenə də öz kökünə gətirilir.

SahəTipTəsvir
domain_namestringQeydiyyatdan keçmiş ad
target_addressstringHədəf PIVX ünvanı
owner_pubkeystringAd sahibinin açıq açarı
priceintQiymət (Bazarda istifadə olunur)
nonceintArtan nonce
smt_rootstringSübutun qurulduğu Merkle ağacı kökü (hex), hər cavabda
merkle_proofstring[]Qonşu heşlər, hex; [0] ən dərindəkidir. Uzunluğu proof_depth dəyərinə bərabərdir
proof_depthintQonşuların sayı — merkle_proof.length dəyərinə bərabər olduğunu yoxlayın
proof_terminalstring | object"Occupied", "Vacant" və ya {"Blocked":{…}} — aşağıya baxın
extended:
created_block_idintDomenin yaradıldığı PIVX block_id
updated_block_idintDomenin son dəyişdirildiyi PIVX block_id
domain_txstringAdın son əməliyyatının PIVX əməliyyat heşi: ad yenilənənə, ötürülənə, satışa çıxarılana, satışdan götürülənə və ya alınana qədər bu, onun qeydiyyatıdır
with_checkpoint:"checkpoint" daxilindəki sahələr (sinxronizasiya yazılarkən null):
idxintKökün lövbər müqaviləsinin rootAt xəritəsindəki indeksi (0 genezis köküdür); nəzarət nöqtələrinin aşkarlanmasında davam kursoru
block_idintNəzarət nöqtəsinin əhatə etdiyi PIVX block_id
smt_rootstringNəzarət nöqtəsinin kökü (hex) — yuxarıdakı smt_root ilə eyni

proof_terminal​

Sübut yolunun sonunda nə olduğunu təsvir edir; sübutun yalnız mövcudluğu deyil, yoxluğu da göstərə bilməsi məhz bundandır:

DəyərMənası
"Occupied"orada adın öz yarpağı var — uğurlu həll. Terminalı bu olmayan hər həlli rədd edin.
"Vacant"orada boş alt ağac var — ad qeydiyyatda deyil
{"Blocked": {"record": {…}}}həmin mövqeyi başqa adın yarpağı tutub, deməli sorğulanan ad qeydiyyatda deyil. Bloklayan qeyd tam şəkildə verilir ki, iddiaya etibar etmək əvəzinə onu yoxlaya biləsiniz.

İndeksləyicinin tanımadığı ada sübutsuz Domain not found xətası ilə cavab verilir: API hələ Vacant və ya Blocked sübutlarını qaytarmır, ona görə də «not found» indeksləyicinin sözüdür. Ona etibar etməzdən əvvəl ikinci indeksləyici ilə yoxlayın.

Bütün bunlar üçün Python, PHP və JavaScript-də yoxlama kodu Sübutların yoxlanması səhifəsindədir.

Əks ad axtarışı​

Əks həll aparmaq üçün PIVX ünvanı göstərin:

GET/POST https://indexer.pivx.name/v1.0/resolve/reverse/{address}

POST parametrləri yuxarıda təsvir olunub.

Sahibə görə adlar​

Verilmiş Ed25519 açıq açarına məxsus bütün adlar.

GET/POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key}

POST parametrləri yuxarıda təsvir olunub.

Siyahıların səhifələnməsi​

Əks ad axtarışı və sahibə görə axtarış adları hər dəfə bir səhifə olmaqla, ad sırası ilə (A-dan Z-yə) qaytarır. Daha iki POST parametri səhifələr arasında keçməyə imkan verir:

ParametrTipSusmaya görəTəsvir
countinteger500Səhifədəki adların sayı, 1-dən 500-ə qədər. Daha böyük dəyər 500-ə endirilir.
afterstring—Əvvəlki səhifənin son adı: bu səhifə ondan sonra başlayır. Birinci səhifə üçün göstərilmir.

count ad olan səhifədən sonra başqa adlar da ola bilər: after dəyərini səhifənin son adı edərək yenidən sorğu göndərin. Daha qısa səhifə sonuncudur, son addan sonrakı səhifə isə boş siyahıdır, [].

curl -X POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key} \
-H "Content-Type: application/json" \
-d '{"count": 100, "after": "alice.pivx"}'