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
| Parametr | Tip | Məcburi | Təsvir |
|---|---|---|---|
{name} | string | Bəli | Hə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:
| Parametr | Tip | Susmaya görə | Təsvir |
|---|---|---|---|
extended | boolean | false | true 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_checkpoint | boolean | false | true 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
- 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);
?>
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ə | Tip | Təsvir |
|---|---|---|
domain_name | string | Qeydiyyatdan keçmiş ad |
target_address | string | Hədəf PIVX ünvanı |
owner_pubkey | string | Ad sahibinin açıq açarı |
price | int | Qiymət (Bazarda istifadə olunur) |
nonce | int | Artan nonce |
smt_root | string | Sübutun qurulduğu Merkle ağacı kökü (hex), hər cavabda |
merkle_proof | string[] | Qonşu heşlər, hex; [0] ən dərindəkidir. Uzunluğu proof_depth dəyərinə bərabərdir |
proof_depth | int | Qonşuların sayı — merkle_proof.length dəyərinə bərabər olduğunu yoxlayın |
proof_terminal | string | object | "Occupied", "Vacant" və ya {"Blocked":{…}} — aşağıya baxın |
| extended: | ||
created_block_id | int | Domenin yaradıldığı PIVX block_id |
updated_block_id | int | Domenin son dəyişdirildiyi PIVX block_id |
domain_tx | string | Adı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): | |
idx | int | Kö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_id | int | Nəzarət nöqtəsinin əhatə etdiyi PIVX block_id |
smt_root | string | Nə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ər | Mə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:
| Parametr | Tip | Susmaya görə | Təsvir |
|---|---|---|---|
count | integer | 500 | Səhifədəki adların sayı, 1-dən 500-ə qədər. Daha böyük dəyər 500-ə endirilir. |
after | string | — | Ə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"}'