Ana içeriğe geç

İsim çözümleme

Bir ismi çözümleme​

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

Uç nokta​

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

Yol parametreleri​

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

İstek gövdesi​

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

ParametreTürVarsayılanAçıklama
extendedbooleanfalsetrue ise ayrıca domain_tx (alan adı kaydının 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.

Kod örnekleri​

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

Örnek yanıt

{
"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"
}
}
AlanTürAçıklama
domain_namestringKayıtlı isim
target_addressstringHedef ZCash 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 ZCash block_id
updated_block_idintAlan adının son güncellendiği ZCash block_id
domain_txstringİsim kaydının ZCash işlem hash'i
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ığı ZCash 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 ZCash adresi verin:

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

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