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

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

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

Разрешает имя PIVX, возвращая связанный с ним адрес PIVX, детали доказательства, контрольные точки синхронизации и данные регистрации.

Точка доступа​

GET https://indexer.pivx.name/v1.0/resolve/{name} (только разрешение имени)
POST https://indexer.pivx.name/v1.0/resolve/{name} (если нужны дополнительные параметры)

Параметры пути​

ПараметрТипОбязательныйОписание
{name}stringДаИмя PIVX, которое нужно разрешить (например, richard.pivx).

Тело запроса​

Тело запроса должно быть объектом JSON со следующими параметрами:

ПараметрТипПо умолчаниюОписание
extendedbooleanfalseЕсли true, дополнительно возвращает created_block_id, updated_block_id и domain_tx (хеш транзакции последней операции с именем).
with_checkpointbooleanfalseЕсли true, дополнительно возвращает checkpoint: закреплённую контрольную точку, на корне которой (том же, что smt_root) построено это доказательство. Пока синхронизация фиксируется, он null; повторите запрос. Вместе с ним возвращается и updated_block_id.

Примеры кода​

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

Пример ответа

{
"response": {
"domain_name": "richard.pivx",
"target_address": "ps1zu2xyry4rc5j0trs3w9zqr5ayhw8h3ulhsfw4reufcg8c62gpg3rzcj7tkasn7tlwgc9y4emwtq",
"owner_pubkey": "ba17d58e11e9828a4ffc140560730ce1b410c924043c1d60cf52a127bde47544",
"price": 750000000000,
"nonce": 1793384994,
"created_block_id": 5648982,
"domain_tx": "a1003dace6ed2ea966aba28926c6ecb7cb5436229db329ce72d118d2cf502d66",
"updated_block_id": 5649418,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245",
"merkle_proof": [
"5a9acd90db63c21d8eff4b656d4526c1bb4b5f9f5e7cf6c5a22719c4d8854bec",
"0000000000000000000000000000000000000000000000000000000000000000",
"d8f11c6213a091087e5bcf8aeac624c7f768d9436af9b6883880155e28e3f4a7",
"ed05b1037b96221bda47b2dd76aa37a93f3d39cb336f8e6f8a203f8fb1ea2a98",
"3af379894717ec7000caf91fcd2bf0e570fda54befa24f5a5770275728dcb11e",
"50e173401bd419424082e3cb2caf9ee62e0808e79e8c8ade99d3396f35e995ce",
"4c1b349c97b95c712f4777b357de9ff1535aad68bb7c56134273a88fefe8bef5",
"3695b047cfbd47f93c899c03736d085924a23ba48d51a6db8382bb2a7452c4b6",
"badcf46ab543cb4a9a1ad7335a07b87d8ede6dc241cf4b4168894f4822f08325",
"e33ad310acd0cc3f5a4261ed6a24615e60e91de423a8ace2f6716c0b60aa351c"
],
"proof_depth": 10,
"proof_terminal": "Occupied",
"checkpoint": {
"idx": 31,
"block_id": 5671618,
"smt_root": "5613850a42087074b88a35dfd6c878d53267f6fa571438026a437c059cbc8245"
}
}
}

Это ответ indexer.pivx.name на запрос выше на контрольной точке 31 (блок PIVX 5671618). Корень меняется с каждым новым пакетом операций, поэтому более поздний запрос может вернуть другой smt_root и другие соседние хеши; этот ответ по-прежнему сворачивается в свой корень кодом со страницы Проверка доказательств.

ПолеТипОписание
domain_namestringЗарегистрированное имя
target_addressstringЦелевой адрес PIVX
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 блока PIVX, в котором создан домен
updated_block_idintblock_id блока PIVX последнего изменения домена
domain_txstringХеш транзакции PIVX последней операции с именем: его регистрации, пока имя не обновлено, не передано, не выставлено на продажу, не снято с продажи и не куплено
with_checkpoint:Поля внутри "checkpoint" (null, пока синхронизация фиксируется):
idxintИндекс корня в отображении rootAt якорного контракта (0 — генезис-корень); курсор возобновления при получении чекпоинтов
block_idintblock_id блока PIVX, который покрывает контрольная точка
smt_rootstringКорень контрольной точки (hex) — тот же, что smt_root выше

proof_terminal​

Описывает, что находится в конце пути доказательства, — именно это позволяет доказательству показать не только наличие, но и отсутствие:

ЗначениеСмысл
"Occupied"там собственный лист имени — успешное разрешение. Отклоняйте любое разрешение, терминал которого отличается от этого.
"Vacant"там пустое поддерево — имя не зарегистрировано
{"Blocked": {"record": {…}}}эту позицию занимает лист другого имени, значит, запрошенное имя не зарегистрировано. Блокирующая запись включена целиком, так что вы можете проверить это утверждение, а не доверять ему.

На имя, которого индексатор не знает, он отвечает ошибкой Domain not found без доказательства: API пока не возвращает доказательств Vacant или Blocked, так что «not found» — это слово индексатора. Прежде чем на это полагаться, проверьте через второй индексатор.

Код проверки всего перечисленного на Python, PHP и JavaScript приведён в разделе Проверка доказательств.

Обратное разрешение имени​

Укажите адрес PIVX, чтобы выполнить обратное разрешение:

GET/POST https://indexer.pivx.name/v1.0/resolve/reverse/{address}

Параметры POST описаны выше.

Имена по владельцу​

Все имена, которыми владеет заданный публичный ключ Ed25519.

GET/POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key}

Параметры POST описаны выше.

Постраничный вывод списков​

Обратное разрешение и поиск по владельцу отдают имена по одной странице за раз, в порядке имён (от A до Z). Листать их позволяют ещё два параметра POST:

ПараметрТипПо умолчаниюОписание
countinteger500Имён на странице, от 1 до 500. Большее значение урезается до 500.
afterstring—Последнее имя предыдущей страницы: эта страница начинается после него. Для первой страницы не указывается.

Если на странице count имён, за ней могут быть ещё: запросите снова, указав в after её последнее имя. Более короткая страница — последняя, а страница за последним именем — пустой список, [].

curl -X POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key} \
-H "Content-Type: application/json" \
-d '{"count": 100, "after": "alice.pivx"}'