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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
{name} | string | Có | 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ểu | Mặc định | Mô tả |
|---|---|---|---|
extended | boolean | false | Nếu true, trả về thêm domain_tx (băm giao dịch của lần đăng ký tên miề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. |
Ví dụ mã
- cURL
- JavaScript
- Python
- PHP
curl -X POST https://indexer.zcashnames.co/v1.0/resolve/richard.zcash \
-H "Content-Type: application/json" \
-d '{
"extended": true,
"with_checkpoint": true
}'
const url = 'https://indexer.zcashnames.co/v1.0/resolve/richard.zcash';
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.zcashnames.co/v1.0/resolve/richard.zcash"
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.zcashnames.co/v1.0/resolve/richard.zcash';
$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": "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ường | Kiểu | Mô tả |
|---|---|---|
domain_name | string | Tên đã đăng ký |
target_address | string | Địa chỉ ZCash đí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 ZCash khi tên miền được tạo |
updated_block_id | int | block_id ZCash của lần cập nhật tên miền gần nhất |
domain_tx | string | Bă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): | |
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 ZCash 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ỉ 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.