跳到主要内容

名称解析

解析名称​

解析一个 ZCash 名称,取得其关联的 ZCash 地址、证明细节、同步检查点以及注册数据。

端点​

GET https://indexer.zcashnames.co/v1.0/resolve/{name}(仅解析名称)
POST https://indexer.zcashnames.co/v1.0/resolve/{name}(若需要额外参数)

路径参数​

参数类型必填说明
{name}string是要解析的 ZCash 名称(例如 richard.zcash)。

请求体​

请求体必须是包含以下参数的 JSON 对象:

参数类型默认值说明
extendedbooleanfalse若为 true,则额外返回 domain_tx(域名注册的交易哈希)。
with_checkpointbooleanfalse若为 true,还会返回 checkpoint:构建此证明所依据的根(与 smt_root 相同)所对应的已锚定检查点。同步正在提交时它为 null,请重试请求。

代码示例​

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

响应示例

{
"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"
}
}
字段类型说明
domain_namestring已注册的名称
target_addressstring目标 ZCash 地址
owner_pubkeystring名称持有者的公钥
priceint价格标签(用于市场)
nonceint递增的 nonce
smt_rootstring构建证明所依据的默克尔树根(十六进制),每个响应中都有
merkle_proofstring[]十六进制的兄弟哈希;[0] 最深。长度等于 proof_depth
proof_depthint兄弟节点数量 — 请核对它等于 merkle_proof.length
proof_terminalstring | object"Occupied"、"Vacant" 或 {"Blocked":{…}} — 见下文
extended:
created_block_idint域名创建时的 ZCash block_id
updated_block_idint域名最近一次更新时的 ZCash block_id
domain_txstring该名称注册所对应的 ZCash 交易哈希
with_checkpoint:"checkpoint" 内部的字段(同步正在提交时为 null):
idxint根在锚定合约 rootAt 映射中的索引(0 为创世根);检查点发现的续传游标
block_idint该检查点覆盖到的 ZCash block_id
smt_rootstring检查点的根(十六进制)——与上面的 smt_root 相同

proof_terminal​

描述证明路径末端是什么,正是它让证明既能显示存在,也能显示不存在:

取值含义
"Occupied"那里是该名称自己的叶子 — 解析成功。请拒绝任何终端节点不是它的解析结果。
"Vacant"那里是一棵空子树 — 名称未注册
{"Blocked": {"record": {…}}}该位置被另一个名称的叶子占据,因此所查询的名称未注册。阻塞记录被完整附上,好让你去验证这个说法,而不是被迫相信它。

对于索引器不知道的名称,它会不带证明地返回错误 Domain not found:API 目前还不返回 Vacant 或 Blocked 证明,所以「not found」只是索引器的一面之词。在依赖它之前,请用第二个索引器核实。

以上全部内容的 Python、PHP 和 JavaScript 验证代码都在验证证明。

反向名称查询​

提供一个 ZCash 地址即可进行反向解析:

GET/POST https://indexer.zcashnames.co/v1.0/resolve/reverse/{address}

POST 参数见上文说明。

按持有者查询名称​

某个给定 Ed25519 公钥所拥有的全部名称。

GET/POST https://indexer.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}

POST 参数见上文说明。