Skip to main content

Adın həlli

Adın həlli​

ZCash adını həll edir və ona bağlı ZCash ü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.zcashnames.co/v1.0/resolve/{name} (yalnız adın həlli)
POST https://indexer.zcashnames.co/v1.0/resolve/{name} (əlavə parametrlər lazımdırsa)

Yol parametrləri​

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

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 domain_tx (domen qeydiyyatı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.

Kod nümunələri​

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

Cavab nümunəsi

{
"response": {
"domain_name": "bob.zec",
"target_address": "u146xylzx0uygtu0f2ae0p67w0229vm8h756aurrhsjpsfpyxy20ustc62xhtc9a4xrr734u5nndw0kzzav7vt57qh95yvwqktpqcfvkwx",
"owner_pubkey": "1111111111111111111111111111111111111111111111111111111111111111",
"price": 250000000,
"nonce": 1780000002,
"smt_root": "5892c31e50ad3a4cf0407b91b3012a196d60c4e4f53e37261ac6747dea180eea",
"merkle_proof": [
"29bc98ae3a939618e50ba72e11a25ba30b37bb53a168a17463b9ef3fe90495d8",
"0000000000000000000000000000000000000000000000000000000000000000"
],
"proof_depth": 2,
"proof_terminal": "Occupied"
}
}
SahəTipTəsvir
domain_namestringQeydiyyatdan keçmiş ad
target_addressstringHədəf ZCash ü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ığı ZCash block_id
updated_block_idintDomenin son dəyişdirildiyi ZCash block_id
domain_txstringAdın qeydiyyatına aid ZCash əməliyyatının heşi
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 ZCash 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 ZCash ünvanı göstərin:

GET/POST https://indexer.zcashnames.co/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.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}

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