Перейти до основного вмісту

Розв'язання імені

Розв'язання імені​

Розв'язує ім'я 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 із такими параметрами:

ПараметрТипЗа замовчуваннямОпис
extendedbooleanfalseЯкщо true, додатково повертає domain_tx (хеш транзакції реєстрації домену).
with_checkpointbooleanfalseЯкщо true, додатково повертає checkpoint: закріплену контрольну точку, на корені якої (тому самому, що smt_root) побудовано цей доказ. Поки синхронізація фіксується, він null; повторіть запит.

Приклади коду​

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

Приклад відповіді

{
"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_namestringЗареєстроване ім'я
target_addressstringЦільова адреса ZCash
owner_pubkeystringПублічний ключ власника імені
priceintЦіна (використовується на Маркетплейсі)
nonceintЗростаючий nonce
smt_rootstringКорінь дерева Меркла (hex), на якому побудовано доказ, — у кожній відповіді
merkle_proofstring[]Сусідні хеші в hex; [0] — найглибший. Довжина дорівнює proof_depth
proof_depthintКількість сусідів — перевірте, що вона дорівнює merkle_proof.length
proof_terminalstring | object"Occupied", "Vacant" або {"Blocked":{…}} — див. нижче
extended:
created_block_idintblock_id блоку ZCash, у якому створено домен
updated_block_idintblock_id блоку ZCash останньої зміни домену
domain_txstringХеш транзакції ZCash із реєстрацією імені
with_checkpoint:Поля всередині "checkpoint" (null, поки синхронізація фіксується):
idxintІндекс кореня у відображенні rootAt якірного контракту (0 — генезис-корінь); курсор відновлення під час отримання чекпоінтів
block_idintblock_id блоку ZCash, який охоплює контрольна точка
smt_rootstringКорінь контрольної точки (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 описані вище.