Ana içeriğe geç

İsim çözümleme

Bir ismi çözümleme​

Bir PIVX ismini çözümleyerek ilişkili PIVX adresini, ispat ayrıntılarını, senkronizasyon kontrol noktalarını ve kayıt verilerini döndürür.

Uç nokta​

GET https://indexer.pivx.name/v1.0/resolve/{name} (yalnızca isim çözümleme)
POST https://indexer.pivx.name/v1.0/resolve/{name} (ek parametreler gerekiyorsa)

Yol parametreleri​

ParametreTürZorunluAçıklama
{name}stringEvetÇözümlenecek PIVX ismi (örneğin richard.pivx).

İstek gövdesi​

İstek gövdesi, şu parametreleri içeren bir JSON nesnesi olmalıdır:

ParametreTürVarsayılanAçıklama
extendedbooleanfalsetrue ise ayrıca created_block_id, updated_block_id ve domain_tx (ismin son işleminin işlem hash'i) döndürülür.
with_checkpointbooleanfalsetrue ise checkpoint de döndürülür: bu ispatın üzerine kurulduğu köke (smt_root ile aynı) sahip çıpalanmış kontrol noktası. Bir senkronizasyon kaydedilirken null olur; isteği tekrarlayın. updated_block_id de onunla birlikte döndürülür.

Kod örnekleri​

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

Örnek yanıt

{
"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 yukarıdaki isteğe 31 numaralı kontrol noktasında (PIVX bloğu 5671618) verdiği bir yanıttır. Kök her yeni işlem toplu işiyle değişir, bu yüzden daha sonra gönderilen bir istek başka bir smt_root ve başka kardeş hash'ler döndürebilir; bu yanıt ise İspatları doğrulama sayfasındaki kodla hâlâ kendi köküne katlanır.

AlanTürAçıklama
domain_namestringKayıtlı isim
target_addressstringHedef PIVX adresi
owner_pubkeystringİsim sahibinin açık anahtarı
priceintFiyat etiketi (Pazar yerinde kullanılır)
nonceintArtan nonce
smt_rootstringİspatın üzerine kurulduğu Merkle ağacı kökü (hex), her yanıtta
merkle_proofstring[]Kardeş hash'ler, hex; [0] en derindekidir. Uzunluğu proof_depth değerine eşittir
proof_depthintKardeş sayısı — merkle_proof.length değerine eşit olduğunu doğrulayın
proof_terminalstring | object"Occupied", "Vacant" veya {"Blocked":{…}} — aşağıya bakın
extended:
created_block_idintAlan adının oluşturulduğu PIVX block_id
updated_block_idintAlan adının son güncellendiği PIVX block_id
domain_txstringİsmin son işleminin PIVX işlem hash'i: isim güncellenene, devredilene, satışa çıkarılana, satıştan kaldırılana veya satın alınana kadar kaydının hash'idir
with_checkpoint:"checkpoint" içindeki alanlar (bir senkronizasyon kaydedilirken null):
idxintKökün, çıpa sözleşmesinin rootAt eşlemesindeki indeksi (0 genesis köküdür); kontrol noktası keşfinde kaldığı yerden devam imleci
block_idintKontrol noktasının kapsadığı PIVX block_id değeri
smt_rootstringKontrol noktasının kökü (hex) — yukarıdaki smt_root ile aynı

proof_terminal​

İspat yolunun sonunda ne olduğunu anlatır; bir ispatın varlığın yanı sıra yokluğu da gösterebilmesini sağlayan budur:

DeğerAnlamı
"Occupied"orada ismin kendi yaprağı var — başarılı bir çözümleme. Terminali bu olmayan her çözümlemeyi reddedin.
"Vacant"orada boş bir alt ağaç var — isim kayıtlı değil
{"Blocked": {"record": {…}}}o konumu başka bir ismin yaprağı işgal ediyor, yani sorgulanan isim kayıtlı değil. Engelleyen kayıt eksiksiz verilir; böylece iddiaya güvenmek yerine onu denetleyebilirsiniz.

İndeksleyicinin tanımadığı bir isme ispat olmadan Domain not found hatasıyla yanıt verilir: API henüz Vacant ya da Blocked ispatları döndürmez, yani bir "not found" indeksleyicinin sözüdür. Ona güvenmeden önce ikinci bir indeksleyiciyle denetleyin.

Tüm bunlar için Python, PHP ve JavaScript'te doğrulama kodu İspatları doğrulama sayfasındadır.

Ters isim araması​

Ters çözümleme yapmak için bir PIVX adresi verin:

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

POST parametreleri yukarıda açıklanmıştır.

Sahibe göre isimler​

Belirli bir Ed25519 açık anahtarına ait tüm isimler.

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

POST parametreleri yukarıda açıklanmıştır.

Listelerde sayfalama​

Ters isim araması ve sahibe göre arama isimleri her seferinde bir sayfa olarak, isim sırasıyla (A'dan Z'ye) döndürür. İki POST parametresi daha sayfalar arasında gezinmeyi sağlar:

ParametreTürVarsayılanAçıklama
countinteger500Sayfa başına isim sayısı, 1 ile 500 arası. Daha büyük bir değer 500'e indirilir.
afterstring—Önceki sayfanın son ismi: bu sayfa ondan sonra başlar. İlk sayfa için verilmez.

count isim içeren bir sayfanın ardından başka isimler gelebilir: after değerini sayfanın son ismi yaparak yeniden sorun. Daha kısa bir sayfa sonuncusudur; son isimden sonraki bir sayfa ise boş bir listedir, [].

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