Chuyển tới nội dung chính

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ểuBắt buộcMô tả
{name}stringCó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ểuMặc địnhMô tả
extendedbooleanfalseNế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_checkpointbooleanfalseNế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 -X POST https://indexer.pivx.name/v1.0/resolve/richard.pivx \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'

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ườngKiểuMô tả
domain_namestringTên đã đăng ký
target_addressstringĐịa chỉ PIVX đích
owner_pubkeystringKhóa công khai của chủ sở hữu tên
priceintMức giá (dùng cho Chợ)
nonceintNonce tăng dần
smt_rootstringGốc cây Merkle (hex) dùng để dựng bằng chứng, có trong mọi câu trả lời
merkle_proofstring[]Các băm anh em ở dạng hex; [0] là sâu nhất. Độ dài bằng proof_depth
proof_depthintSố lượng anh em — hãy kiểm tra rằng nó bằng merkle_proof.length
proof_terminalstring | object"Occupied", "Vacant" hoặc {"Blocked":{…}} — xem bên dưới
extended:
created_block_idintblock_id PIVX khi tên miền được tạo
updated_block_idintblock_id PIVX của lần cập nhật tên miền gần nhất
domain_txstringBă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):
idxintChỉ 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_idintblock_id PIVX mà điểm kiểm tra bao phủ
smt_rootstringGố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ểuMặc địnhMô tả
countinteger500Số tên mỗi trang, từ 1 đến 500. Giá trị lớn hơn bị cắt xuống 500.
afterstring—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"}'