Skip to main content

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

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

Вырашае імя 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"}'