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 ZCash để lấy địa chỉ ZCash 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.zcashnames.co/v1.0/resolve/{name} (chỉ phân giải tên)
POST https://indexer.zcashnames.co/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 ZCash cần phân giải (ví dụ richard.zcash).

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 domain_tx (băm giao dịch của lần đăng ký tên miề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.

Ví dụ mã​

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

Ví dụ phản hồi

{
"response": {
"domain_name": "bob.zec",
"target_address": "u146xylzx0uygtu0f2ae0p67w0229vm8h756aurrhsjpsfpyxy20ustc62xhtc9a4xrr734u5nndw0kzzav7vt57qh95yvwqktpqcfvkwx",
"owner_pubkey": "1111111111111111111111111111111111111111111111111111111111111111",
"price": 250000000,
"nonce": 1780000002,
"smt_root": "5892c31e50ad3a4cf0407b91b3012a196d60c4e4f53e37261ac6747dea180eea",
"merkle_proof": [
"29bc98ae3a939618e50ba72e11a25ba30b37bb53a168a17463b9ef3fe90495d8",
"0000000000000000000000000000000000000000000000000000000000000000"
],
"proof_depth": 2,
"proof_terminal": "Occupied"
}
}
TrườngKiểuMô tả
domain_namestringTên đã đăng ký
target_addressstringĐịa chỉ ZCash đí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 ZCash khi tên miền được tạo
updated_block_idintblock_id ZCash của lần cập nhật tên miền gần nhất
domain_txstringBăm giao dịch ZCash của lần đăng ký tên
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 ZCash 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ỉ ZCash để phân giải ngược:

GET/POST https://indexer.zcashnames.co/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.zcashnames.co/v1.0/resolve/owner/{Ed25519_public_key}

Các tham số POST được mô tả ở trên.