İ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

Parametre	Tür	Zorunlu	Açıklama
{name}	string	Evet	Çözümlenecek ZCash ismi (örneğin richard.zcash).

İ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 domain_tx (alan adı kaydının işlem hash'i) döndürülür.
with_checkpoint	boolean	false	true ise indeksleyicinin senkronize olduğu güncel kontrol noktası döndürülür.

---

Kod örnekleri

cURL

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

JavaScript

const url = 'https://indexer.zcashnames.co/v1.0/resolve/richard.zcash';
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.zcashnames.co/v1.0/resolve/richard.zcash"
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.zcashnames.co/v1.0/resolve/richard.zcash';
$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": "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"
  }
}

Alan	Tür	Açıklama
domain_name	string	Kayıtlı isim
target_address	string	Hedef ZCash 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	Güncel Merkle ağacı kökü (hex)
		(with_checkpoint:false ise; aksi hâlde SMT kökü için "checkpoint" bölümüne bakın)
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 ZCash block_id
updated_block_id	int	Alan adının son güncellendiği ZCash block_id
domain_tx	string	İsim kaydının ZCash işlem hash'i
with_checkpoint:		"checkpoint" içindeki alanlar:
idx	int	Çıpa sözleşmesinin rootChain dizisindeki konum; kontrol noktası keşfinde kaldığı yerden devam imleci
block_id	int	Üretilen son SMT ispatının ZCash block_id değeri
smt_root	string	Güncel Merkle ağacı kökü (hex)

proof_terminal

İspat yolunun sonunda ne olduğunu anlatır. Yokluğu yalnızca iddia edilen değil ispatlanabilir kılan şey 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.

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.