Saltar al contenido principal

Resolución de nombres

Resolver un nombre​

Resuelve un nombre de ZCash y devuelve su dirección de ZCash asociada, los detalles de su prueba, los puntos de control de sincronización y los datos de registro.

Punto de acceso​

GET https://indexer.zcashnames.co/v1.0/resolve/{name} (solo resolución del nombre)
POST https://indexer.zcashnames.co/v1.0/resolve/{name} (si hacen falta parámetros adicionales)

Parámetros de ruta​

ParámetroTipoObligatorioDescripción
{name}stringSíEl nombre de ZCash que se quiere resolver (por ejemplo, richard.zcash).

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 domain_tx (el hash de la transacción del registro del dominio).
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.

Ejemplos de código​

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

Ejemplo de respuesta

{
"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"
}
}
CampoTipoDescripción
domain_namestringEl nombre registrado
target_addressstringDirección de ZCash 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 ZCash de la creación del dominio
updated_block_idintblock_id de ZCash de la última modificación del dominio
domain_txstringEl hash de la transacción de ZCash del registro del nombre
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 ZCash 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 ZCash para hacer una resolución inversa:

GET/POST https://indexer.zcashnames.co/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.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}

Los parámetros POST se describen más arriba.