Saltar al contenido principal

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ámetroTipoObligatorioDescripción
{name}stringSí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ámetroTipoPor defectoDescripción
extendedbooleanfalseSi 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_checkpointbooleanfalseSi 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 -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'

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.

CampoTipoDescripción
domain_namestringEl nombre registrado
target_addressstringDirección de PIVX de destino
owner_pubkeystringClave pública del titular del nombre
priceintPrecio indicado (se usa en el Mercado)
nonceintNonce incremental
smt_rootstringLa raíz del árbol de Merkle (hex) sobre la que se construyó la prueba, en todas las respuestas
merkle_proofstring[]Hashes hermanos en hex; [0] es el más profundo. Su longitud es igual a proof_depth
proof_depthintNúmero de hermanos: compruebe que es igual a merkle_proof.length
proof_terminalstring | object"Occupied", "Vacant" o {"Blocked":{…}} — véase más abajo
extended:
created_block_idintblock_id de PIVX de la creación del dominio
updated_block_idintblock_id de PIVX de la última modificación del dominio
domain_txstringEl 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):
idxintÍ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_idintEl block_id de PIVX que cubre el punto de control
smt_rootstringLa 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:

ValorSignificado
"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ámetroTipoPor defectoDescripción
countinteger500Nombres por página, de 1 a 500. Un valor mayor se recorta a 500.
afterstring—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"}'