Розв'язання імені
Розв'язання імені
Розв'язує ім'я ZCash, повертаючи пов'язану з ним адресу ZCash, деталі доказу, контрольні точки синхронізації і дані реєстрації.
Точка доступу
GET https://indexer.zcashnames.co/v1.0/resolve/{name} (лише розв'язання імені)
POST https://indexer.zcashnames.co/v1.0/resolve/{name} (якщо потрібні додаткові параметри)
Параметри шляху
| Параметр | Тип | Обов'язковий | Опис |
|---|---|---|---|
{name} | string | Так | Ім'я ZCash, яке потрібно розв'язати (наприклад, richard.zcash). |
Тіло запиту
Тіло запиту має бути об'єктом JSON із такими параметрами:
| Параметр | Тип | За замовчуванням | Опис |
|---|---|---|---|
extended | boolean | false | Якщо true, додатково повертає domain_tx (хеш транзакції реєстрації домену). |
with_checkpoint | boolean | false | Якщо true, додатково повертає checkpoint: закріплену контрольну точку, на корені якої (тому самому, що smt_root) побудовано цей доказ. Поки синхронізація фіксується, він null; повторіть запит. |
Приклади коду
- 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);
?>
Приклад відповіді
{
"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"
}
}
| Поле | Тип | Опис |
|---|---|---|
domain_name | string | Зареєстроване ім'я |
target_address | string | Цільова адреса ZCash |
owner_pubkey | string | Публічний ключ власника імені |
price | int | Ціна (використовується на Маркетплейсі) |
nonce | int | Зростаючий nonce |
smt_root | string | Корінь дерева Меркла (hex), на якому побудовано доказ, — у кожній відповіді |
merkle_proof | string[] | Сусідні хеші в hex; [0] — найглибший. Довжина дорівнює proof_depth |
proof_depth | int | Кількість сусідів — перевірте, що вона дорівнює merkle_proof.length |
proof_terminal | string | object | "Occupied", "Vacant" або {"Blocked":{…}} — див. нижче |
| extended: | ||
created_block_id | int | block_id блоку ZCash, у якому створено домен |
updated_block_id | int | block_id блоку ZCash останньої зміни домену |
domain_tx | string | Хеш транзакції ZCash із реєстрацією імені |
| with_checkpoint: | Поля всередині "checkpoint" (null, поки синхронізація фіксується): | |
idx | int | Індекс кореня у відображенні rootAt якірного контракту (0 — генезис-корінь); курсор відновлення під час отримання чекпоінтів |
block_id | int | block_id блоку ZCash, який охоплює контрольна точка |
smt_root | string | Корінь контрольної точки (hex) — той самий, що smt_root вище |
proof_terminal
Описує, що розташоване в кінці шляху доказу, — саме це дає доказу змогу показати не лише наявність, а й відсутність:
| Значення | Зміст |
|---|---|
"Occupied" | там власний лист імені — успішне розв'язання. Відхиляйте будь-яке розв'язання, термінал якого відрізняється від цього. |
"Vacant" | там порожнє піддерево — ім'я не зареєстроване |
{"Blocked": {"record": {…}}} | цю позицію займає лист іншого імені, отже, запитане ім'я не зареєстроване. Блокувальний запис включено повністю, тож ви можете перевірити це твердження, а не довіряти йому. |
На ім'я, якого індексатор не знає, він відповідає помилкою Domain not found без доказу: API
поки що не повертає доказів Vacant чи Blocked, тож «not found» — це слово індексатора. Перш
ніж на це покладатися, перевірте через другий індексатор.
Код перевірки всього переліченого на Python, PHP і JavaScript наведено в розділі Перевірка доказів.
Зворотне розв'язання імені
Укажіть адресу ZCash, щоб виконати зворотне розв'язання:
GET/POST https://indexer.zcashnames.co/v1.0/resolve/reverse/{address}
Параметри POST описані вище.
Імена за власником
Усі імена, якими володіє заданий публічний ключ Ed25519.
GET/POST https://indexer.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}
Параметри POST описані вище.