İ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
| Parametre | Tür | Zorunlu | Açıklama |
|---|---|---|---|
{name} | string | Evet | Çözümlenecek PIVX ismi (örneğin richard.pivx). |
İstek gövdesi
İstek gövdesi, şu parametreleri içeren bir JSON nesnesi olmalıdır:
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
extended | boolean | false | true 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_checkpoint | boolean | false | true 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
- JavaScript
- Python
- PHP
curl -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'
const url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
const data = {
extended: true,
with_checkpoint: true
};
fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.pivx.name/v1.0/resolve/richard.pivx"
payload = {
"extended": True,
"with_checkpoint": True
}
headers = {
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
<?php
$url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
$data = [
'extended' => true,
'with_checkpoint' => true
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);
?>
Ö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.
| Alan | Tür | Açıklama |
|---|---|---|
domain_name | string | Kayıtlı isim |
target_address | string | Hedef PIVX adresi |
owner_pubkey | string | İsim sahibinin açık anahtarı |
price | int | Fiyat etiketi (Pazar yerinde kullanılır) |
nonce | int | Artan nonce |
smt_root | string | İspatın üzerine kurulduğu Merkle ağacı kökü (hex), her yanıtta |
merkle_proof | string[] | Kardeş hash'ler, hex; [0] en derindekidir. Uzunluğu proof_depth değerine eşittir |
proof_depth | int | Kardeş sayısı — merkle_proof.length değerine eşit olduğunu doğrulayın |
proof_terminal | string | object | "Occupied", "Vacant" veya {"Blocked":{…}} — aşağıya bakın |
| extended: | ||
created_block_id | int | Alan adının oluşturulduğu PIVX block_id |
updated_block_id | int | Alan adının son güncellendiği PIVX block_id |
domain_tx | string | İ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): | |
idx | int | Kö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_id | int | Kontrol noktasının kapsadığı PIVX block_id değeri |
smt_root | string | Kontrol 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ğer | Anlamı |
|---|---|
"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:
| Parametre | Tür | Varsayılan | Açıklama |
|---|---|---|---|
count | integer | 500 | Sayfa başına isim sayısı, 1 ile 500 arası. Daha büyük bir değer 500'e indirilir. |
after | string | — | Ö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"}'