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 domain_tx (domen qeydiyyatının əməliyyat heşi) qaytarılır.
with_checkpoint	boolean	false	true olarsa, indeksləyicinin sinxronlaşdığı cari nəzarət nöqtəsi qaytarılır.

---

Kod nümunələri

cURL

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

JavaScript

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));

Python

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

php

<?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": "bob.pivx",
    "target_address": "ps12qtzaw6x3dh35xuukrqgk06e9ffx8szg2n2huqncwjsnj3ajczmklqgcx97kn63vwlge6gj2cmn",
    "owner_pubkey": "1111111111111111111111111111111111111111111111111111111111111111",
    "price": 250000000,
    "nonce": 1780000002,
    "smt_root": "5892c31e50ad3a4cf0407b91b3012a196d60c4e4f53e37261ac6747dea180eea",
    "merkle_proof": [
      "29bc98ae3a939618e50ba72e11a25ba30b37bb53a168a17463b9ef3fe90495d8",
      "0000000000000000000000000000000000000000000000000000000000000000"
    ],
    "proof_depth": 2,
    "proof_terminal": "Occupied"
  }
}

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	Merkle ağacının cari kökü (hex)
		(with_checkpoint:false olarsa; əks halda SMT kökü üçün "checkpoint" bölməsinə baxın)
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 qeydiyyatına aid PIVX əməliyyatının heşi
with_checkpoint:		"checkpoint" daxilindəki sahələr:
idx	int	Çıpa müqaviləsinin rootChain massivindəki mövqe; nəzarət nöqtələrinin aşkarlanmasında davam kursoru
block_id	int	Yaradılmış son SMT sübutunun PIVX block_id dəyəri
smt_root	string	Merkle ağacının cari kökü (hex)

proof_terminal

Sübut yolunun sonunda nə olduğunu təsvir edir. Yoxluğu sadəcə iddia edilən deyil, sübut edilə bilən edən məhz budur:

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.

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.