名前の解決
名前を解決する
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 | 証明が構築されたマークルツリールート(16 進数)。すべての応答に含まれます |
merkle_proof | string[] | 16 進数の兄弟ハッシュ。[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 | チェックポイントのルート(16 進数)— 上の smt_root と同じ |
proof_terminal
証明経路の末端に何があるかを表します。これがあるからこそ、証明は存在だけでなく不在も示せます:
| 値 | 意味 |
|---|---|
"Occupied" | そこにその名前自身の葉がある — 解決成功。ターミナルがこれ以外の解決結果はすべて拒否してください。 |
"Vacant" | そこに空の部分木がある — 名前は登録されていない |
{"Blocked": {"record": {…}}} | その位置を別の名前の葉が占めているため、問い合わせた名前は登録されていません。ブロックしているレコードが丸ごと含まれているので、その主張を信じる代わりに検証できます。 |
インデクサーが知らない名前には、証明なしでエラー Domain not found が返されます。API はまだ Vacant や Blocked の証明を返さないため、「not found」はインデクサーの言い分にすぎません。それに頼る前に 2 つ目のインデクサーで確認してください。
これらすべての検証コードは、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 パラメーターは上記のとおりです。
リストのページ送り
逆引きと保有者による検索は、名前を一度に 1 ページずつ、名前順(A から Z)で返します。さらに 2 つの POST パラメーターでページを送ります。
| パラメーター | 型 | 既定値 | 説明 |
|---|---|---|---|
count | integer | 500 | 1 ページあたりの名前の数(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"}'