Resolución de nombres
Resolver un nombre
Resuelve un nombre de PIVX y devuelve su dirección de PIVX asociada, los detalles de su prueba, los puntos de control de sincronización y los datos de registro.
Punto de acceso
GET https://indexer.pivx.name/v1.0/resolve/{name} (solo resolución del nombre)
POST https://indexer.pivx.name/v1.0/resolve/{name} (si hacen falta parámetros adicionales)
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
{name} | string | Sí | El nombre de PIVX que se quiere resolver (por ejemplo, richard.pivx). |
Cuerpo de la petición
El cuerpo de la petición debe ser un objeto JSON con los siguientes parámetros:
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
extended | boolean | false | Si es true, devuelve además created_block_id, updated_block_id y domain_tx (el hash de la transacción de la última operación del nombre). |
with_checkpoint | boolean | false | Si es true, también devuelve checkpoint: el punto de control anclado sobre cuya raíz (la misma que smt_root) se construyó esta prueba. Es null mientras se confirma una sincronización; repita la solicitud. También devuelve updated_block_id. |
Ejemplos de código
- 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
$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);
?>
Ejemplo de respuesta
{
"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"
}
}
}
Esta es una respuesta de indexer.pivx.name a la solicitud anterior, en el punto de control 31 (bloque de PIVX 5671618). La raíz cambia con cada nuevo lote de operaciones, así que una solicitud posterior puede devolver otro smt_root y otros hashes hermanos; esta respuesta sigue plegándose a su propia raíz con el código de Verificar pruebas.
| Campo | Tipo | Descripción |
|---|---|---|
domain_name | string | El nombre registrado |
target_address | string | Dirección de PIVX de destino |
owner_pubkey | string | Clave pública del titular del nombre |
price | int | Precio indicado (se usa en el Mercado) |
nonce | int | Nonce incremental |
smt_root | string | La raíz del árbol de Merkle (hex) sobre la que se construyó la prueba, en todas las respuestas |
merkle_proof | string[] | Hashes hermanos en hex; [0] es el más profundo. Su longitud es igual a proof_depth |
proof_depth | int | Número de hermanos: compruebe que es igual a merkle_proof.length |
proof_terminal | string | object | "Occupied", "Vacant" o {"Blocked":{…}} — véase más abajo |
| extended: | ||
created_block_id | int | block_id de PIVX de la creación del dominio |
updated_block_id | int | block_id de PIVX de la última modificación del dominio |
domain_tx | string | El hash de la transacción de PIVX de la última operación del nombre: su registro, hasta que el nombre se actualiza, se transfiere, se pone a la venta, se retira de la venta o se compra |
| with_checkpoint: | Campos dentro de "checkpoint" (null mientras se confirma una sincronización): | |
idx | int | Índice de la raíz en el mapping rootAt del contrato ancla (0 es la raíz génesis); el cursor de reanudación al descubrir checkpoints |
block_id | int | El block_id de PIVX que cubre el punto de control |
smt_root | string | La raíz del punto de control (hex) — la misma que smt_root arriba |
proof_terminal
Describe qué hay al final del camino de la prueba, que es lo que permite a una prueba mostrar tanto la ausencia como la presencia:
| Valor | Significado |
|---|---|
"Occupied" | ahí está la hoja propia del nombre: una resolución correcta. Rechace toda resolución cuyo terminal no sea este. |
"Vacant" | ahí hay un subárbol vacío: el nombre no está registrado |
{"Blocked": {"record": {…}}} | esa posición la ocupa la hoja de un nombre distinto, así que el nombre consultado no está registrado. El registro que bloquea se incluye completo para que pueda comprobar la afirmación en vez de confiar en ella. |
A un nombre que el indexador no conoce se le responde con el error Domain not found, sin
prueba: la API todavía no devuelve pruebas Vacant ni Blocked, así que un «not found» es la
palabra del indexador. Compruébelo con un segundo indexador antes de fiarse de él.
El código de verificación de todo esto, en Python, PHP y JavaScript, está en Verificar pruebas.
Resolución inversa de nombres
Indique una dirección de PIVX para hacer una resolución inversa:
GET/POST https://indexer.pivx.name/v1.0/resolve/reverse/{address}
Los parámetros POST se describen más arriba.
Nombres por titular
Todos los nombres que posee una clave pública Ed25519 dada.
GET/POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key}
Los parámetros POST se describen más arriba.
Paginación de las listas
La resolución inversa y la búsqueda por titular devuelven los nombres página a página, en orden alfabético (de la A a la Z). Dos parámetros POST más recorren las páginas:
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
count | integer | 500 | Nombres por página, de 1 a 500. Un valor mayor se recorta a 500. |
after | string | — | El último nombre de la página anterior: esta página empieza después de él. Omítalo para la primera página. |
Una página con count nombres puede tener más detrás: vuelva a pedirla con after igual a su último nombre. Una página más corta es la última, y una página posterior al último nombre es una lista vacía, [].
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"}'