Skip to main content

Вырашэнне імя

Вырашэнне імя​

Вырашае імя 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 апісаны вышэй.