名称解析
解析名称
解析一个 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 对象:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
extended | boolean | false | 若为 true,则额外返回 created_block_id、updated_block_id 和 domain_tx(该名称最近一次操作的交易哈希)。 |
with_checkpoint | boolean | false | 若为 true,还会返回 checkpoint:构建此证明所依据的根(与 smt_root 相同)所对应的已锚定检查点。同步正在提交时它为 null,请重试请求。 同时也会返回 updated_block_id。 |
代码示例
- 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);
?>
响应示例
{
"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_name | string | 已注册的名称 |
target_address | string | 目标 PIVX 地址 |
owner_pubkey | string | 名称持有者的公钥 |
price | int | 价格标签(用于市场) |
nonce | int | 递增的 nonce |
smt_root | string | 构建证明所依据的默克尔树根(十六进制),每个响应中都有 |
merkle_proof | string[] | 十六进制的兄弟哈希;[0] 最深。长度等于 proof_depth |
proof_depth | int | 兄弟节点数量 — 请核对它等于 merkle_proof.length |
proof_terminal | string | object | "Occupied"、"Vacant" 或 {"Blocked":{…}} — 见下文 |
| extended: | ||
created_block_id | int | 域名创建时的 PIVX block_id |
updated_block_id | int | 域名最近一次更新时的 PIVX block_id |
domain_tx | string | 该名称最近一次操作的 PIVX 交易哈希:在名称被更新、转让、挂单出售、取消出售或被购买之前,即其注册交易 |
| with_checkpoint: | "checkpoint" 内部的字段(同步正在提交时为 null): | |
idx | int | 根在锚定合约 rootAt 映射中的索引(0 为创世根);检查点发现的续传游标 |
block_id | int | 该检查点覆盖到的 PIVX block_id |
smt_root | string | 检查点的根(十六进制)——与上面的 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 参数用于翻页:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
count | integer | 500 | 每页的名称数,1 到 500。更大的值会被截为 500。 |
after | string | — | 上一页的最后一个名称:本页从它之后开始。请求第一页时省略。 |
一页含有 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"}'