Перейти к основному содержимому

Разрешение имени

Разрешение имени​

Разрешает имя 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 описаны выше.