跳到主要内容

名称解析

解析名称​

解析一个 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 对象:

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

代码示例​

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

响应示例

{
"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"
}
}
}

这是 indexer.pivx.name 对上述请求的一个回答,对应检查点 31(PIVX 区块 5671618)。根会随每一批新操作而变化,因此之后发出的请求可能得到另一个 smt_root 和另一组兄弟哈希;而这个回答用 验证证明 中的代码仍能折叠到它自己的根。

字段类型说明
domain_namestring已注册的名称
target_addressstring目标 PIVX 地址
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域名创建时的 PIVX block_id
updated_block_idint域名最近一次更新时的 PIVX block_id
domain_txstring该名称最近一次操作的 PIVX 交易哈希:在名称被更新、转让、挂单出售、取消出售或被购买之前,即其注册交易
with_checkpoint:"checkpoint" 内部的字段(同步正在提交时为 null):
idxint根在锚定合约 rootAt 映射中的索引(0 为创世根);检查点发现的续传游标
block_idint该检查点覆盖到的 PIVX block_id
smt_rootstring检查点的根(十六进制)——与上面的 smt_root 相同

proof_terminal​

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

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

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

以上全部内容的 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 参数见上文说明。

列表分页​

反向查询和按持有者查询每次返回一页名称,按名称排序(A 到 Z)。另外两个 POST 参数用于翻页:

参数类型默认值说明
countinteger500每页的名称数,1 到 500。更大的值会被截为 500。
afterstring—上一页的最后一个名称:本页从它之后开始。请求第一页时省略。

一页含有 count 个名称时,后面可能还有:把 after 设为该页最后一个名称再请求一次。更短的一页是最后一页;最后一个名称之后的一页是空列表 []。

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"}'