Phân giải tên
Phân giải một tên
Phân giải một tên PIVX để lấy địa chỉ PIVX tương ứng, chi tiết bằng chứng, các điểm kiểm tra đồng bộ và dữ liệu đăng ký.
Điểm cuối
GET https://indexer.pivx.name/v1.0/resolve/{name} (chỉ phân giải tên)
POST https://indexer.pivx.name/v1.0/resolve/{name} (nếu cần thêm tham số)
Tham số đường dẫn
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
{name} | string | Có | Tên PIVX cần phân giải (ví dụ richard.pivx). |
Thân yêu cầu
Thân yêu cầu phải là một đối tượng JSON gồm các tham số sau:
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
extended | boolean | false | Nếu true, trả về thêm created_block_id, updated_block_id và domain_tx (băm giao dịch của thao tác gần nhất với tên). |
with_checkpoint | boolean | false | Nếu true, trả thêm checkpoint: điểm kiểm tra đã neo mà gốc của nó (giống smt_root) là gốc dùng để dựng bằng chứng này. Nó là null trong lúc một lần đồng bộ đang được ghi; hãy gửi lại yêu cầu. updated_block_id cũng được trả về kèm theo. |
Ví dụ mã
- 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);
?>
Ví dụ phản hồi
{
"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"
}
}
}
Đây là một phản hồi của indexer.pivx.name cho yêu cầu ở trên, tại điểm kiểm tra 31 (khối PIVX 5671618). Gốc thay đổi theo mỗi lô thao tác mới, nên một yêu cầu về sau có thể trả về smt_root khác và các băm anh em khác; phản hồi này vẫn gộp về đúng gốc của nó bằng mã ở trang Kiểm chứng bằng chứng.
| Trường | Kiểu | Mô tả |
|---|---|---|
domain_name | string | Tên đã đăng ký |
target_address | string | Địa chỉ PIVX đích |
owner_pubkey | string | Khóa công khai của chủ sở hữu tên |
price | int | Mức giá (dùng cho Chợ) |
nonce | int | Nonce tăng dần |
smt_root | string | Gốc cây Merkle (hex) dùng để dựng bằng chứng, có trong mọi câu trả lời |
merkle_proof | string[] | Các băm anh em ở dạng hex; [0] là sâu nhất. Độ dài bằng proof_depth |
proof_depth | int | Số lượng anh em — hãy kiểm tra rằng nó bằng merkle_proof.length |
proof_terminal | string | object | "Occupied", "Vacant" hoặc {"Blocked":{…}} — xem bên dưới |
| extended: | ||
created_block_id | int | block_id PIVX khi tên miền được tạo |
updated_block_id | int | block_id PIVX của lần cập nhật tên miền gần nhất |
domain_tx | string | Băm giao dịch PIVX của thao tác gần nhất với tên: là giao dịch đăng ký cho đến khi tên được cập nhật, chuyển nhượng, rao bán, hủy rao bán hoặc được mua |
| with_checkpoint: | Các trường bên trong "checkpoint" (null trong lúc một lần đồng bộ đang được ghi): | |
idx | int | Chỉ số của gốc trong ánh xạ rootAt của hợp đồng neo (0 là gốc khởi tạo); con trỏ tiếp tục khi khám phá checkpoint |
block_id | int | block_id PIVX mà điểm kiểm tra bao phủ |
smt_root | string | Gốc của điểm kiểm tra (hex) — giống smt_root ở trên |
proof_terminal
Mô tả thứ nằm ở cuối đường đi của bằng chứng; chính điều này cho phép một bằng chứng cho thấy cả sự vắng mặt lẫn sự hiện diện:
| Giá trị | Ý nghĩa |
|---|---|
"Occupied" | ở đó là lá của chính cái tên — một lần phân giải thành công. Hãy từ chối mọi kết quả phân giải có terminal khác giá trị này. |
"Vacant" | ở đó là một cây con rỗng — tên chưa được đăng ký |
{"Blocked": {"record": {…}}} | vị trí đó bị lá của một tên khác chiếm giữ, nên tên được hỏi chưa được đăng ký. Bản ghi chặn được đưa vào đầy đủ để bạn kiểm chứng lời khẳng định thay vì tin nó. |
Với một tên mà trình lập chỉ mục không biết, nó trả lỗi Domain not found mà không kèm bằng
chứng: API chưa trả về bằng chứng Vacant hay Blocked, nên một câu «not found» chỉ là lời
của trình lập chỉ mục. Hãy kiểm tra lại bằng một trình lập chỉ mục thứ hai trước khi dựa vào
nó.
Mã kiểm chứng cho tất cả những điều này, bằng Python, PHP và JavaScript, có tại Kiểm chứng bằng chứng.
Tra cứu tên ngược
Cung cấp một địa chỉ PIVX để phân giải ngược:
GET/POST https://indexer.pivx.name/v1.0/resolve/reverse/{address}
Các tham số POST được mô tả ở trên.
Tên theo chủ sở hữu
Mọi tên thuộc về một khóa công khai Ed25519 cho trước.
GET/POST https://indexer.pivx.name/v1.0/resolve/owner/{Ed25519_public_key}
Các tham số POST được mô tả ở trên.
Phân trang danh sách
Tra cứu ngược và tra cứu theo chủ sở hữu trả về tên theo từng trang, theo thứ tự tên (từ A đến Z). Hai tham số POST nữa dùng để lật qua các trang:
| Tham số | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
count | integer | 500 | Số tên mỗi trang, từ 1 đến 500. Giá trị lớn hơn bị cắt xuống 500. |
after | string | — | Tên cuối cùng của trang trước: trang này bắt đầu sau tên đó. Bỏ trống với trang đầu tiên. |
Một trang có đủ count tên có thể còn tên phía sau: hãy gửi lại yêu cầu với after là tên cuối cùng của trang đó. Trang ngắn hơn là trang cuối, và trang nằm sau tên cuối cùng là một danh sách rỗng, [].
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"}'