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

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

Параметр	Тип	За замовчуванням	Опис
`extended`	`boolean`	`false`	Якщо `true`, додатково повертає `domain_tx` (хеш транзакції реєстрації домену).
`with_checkpoint`	`boolean`	`false`	Якщо `true`, повертає поточну контрольну точку, до якої синхронізований індексатор.

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

cURL
JavaScript
Python
PHP

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

const url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
const data = {
  extended: true,
  with_checkpoint: true
};

fetch(url, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));

import requests

url = "https://indexer.pivx.name/v1.0/resolve/richard.pivx"
payload = {
    "extended": True,
    "with_checkpoint": True
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

php
<?php

$url = 'https://indexer.pivx.name/v1.0/resolve/richard.pivx';
$data = [
    'extended' => true,
    'with_checkpoint' => true
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result);
?>

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

{
  "response": {
    "domain_name": "bob.pivx",
    "target_address": "ps12qtzaw6x3dh35xuukrqgk06e9ffx8szg2n2huqncwjsnj3ajczmklqgcx97kn63vwlge6gj2cmn",
    "owner_pubkey": "1111111111111111111111111111111111111111111111111111111111111111",
    "price": 250000000,
    "nonce": 1780000002,
    "smt_root": "5892c31e50ad3a4cf0407b91b3012a196d60c4e4f53e37261ac6747dea180eea",
    "merkle_proof": [
      "29bc98ae3a939618e50ba72e11a25ba30b37bb53a168a17463b9ef3fe90495d8",
      "0000000000000000000000000000000000000000000000000000000000000000"
    ],
    "proof_depth": 2,
    "proof_terminal": "Occupied"
  }
}

Поле	Тип	Опис
`domain_name`	string	Зареєстроване ім'я
`target_address`	string	Цільова адреса PIVX
`owner_pubkey`	string	Публічний ключ власника імені
`price`	int	Ціна (використовується на Маркетплейсі)
`nonce`	int	Зростаючий nonce
`smt_root`	string	Поточний корінь дерева Меркла (hex)
		(якщо with_checkpoint:false, інакше див. корінь SMT у "checkpoint")
`merkle_proof`	string[]	Сусідні хеші в hex; `[0]` — найглибший. Довжина дорівнює `proof_depth`
`proof_depth`	int	Кількість сусідів — перевірте, що вона дорівнює `merkle_proof.length`
`proof_terminal`	string \| object	`"Occupied"`, `"Vacant"` або `{"Blocked":{…}}` — див. нижче
extended:
`created_block_id`	int	block_id блоку PIVX, у якому створено домен
`updated_block_id`	int	block_id блоку PIVX останньої зміни домену
`domain_tx`	string	Хеш транзакції PIVX із реєстрацією імені
with_checkpoint:		Поля всередині "checkpoint":
`idx`	int	Позиція в масиві `rootChain` якірного контракту; курсор відновлення під час отримання чекпоінтів
`block_id`	int	block_id блоку PIVX останнього згенерованого доказу SMT
`smt_root`	string	Поточний корінь дерева Меркла (hex)

`proof_terminal`

Описує, що розташоване в кінці шляху доказу. Саме це робить відсутність доказовою, а не просто заявленою:

Значення	Зміст
`"Occupied"`	там власний лист імені — успішне розв'язання. Відхиляйте будь-яке розв'язання, термінал якого відрізняється від цього.
`"Vacant"`	там порожнє піддерево — ім'я не зареєстроване
`{"Blocked": {"record": {…}}}`	цю позицію займає лист іншого імені, отже, запитане ім'я не зареєстроване. Блокувальний запис включено повністю, тож ви можете перевірити це твердження, а не довіряти йому.

Код перевірки всього переліченого на 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 описані вище.