İ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 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
- JavaScript
- Python
- PHP
curl -X POST https://indexer.zcashnames.co/v1.0/resolve/richard.zcash \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'
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));
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
$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 | İspatın üzerine kurulduğu Merkle ağacı kökü (hex), her yanıtta |
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 (bir senkronizasyon kaydedilirken null): | |
idx | int | Kö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_id | int | Kontrol noktasının kapsadığı ZCash block_id değeri |
smt_root | string | Kontrol 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ğ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. |
İ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.