Thông tin trình lập chỉ mục
Thông tin và trạng thái của trình lập chỉ mục
Trả về trạng thái hiện tại, tiến độ đồng bộ và gốc SMT hiện tại của nút lập chỉ mục phân giải PIVX Name.
Điểm cuối
GET https://indexer.pivx.name/v1.0/info (lấy thông tin cơ bản)
POST https://indexer.pivx.name/v1.0/info (nếu cần thêm tham số)
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 các thông tin mở rộng |
Ví dụ mã
- cURL
- JavaScript
- Python
- PHP
curl -X GET https://indexer.pivx.name/v1.0/info
const url = 'https://indexer.pivx.name/v1.0/info';
fetch(url, {
method: 'GET'
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
url = "https://indexer.pivx.name/v1.0/info"
response = requests.get(url)
print(response.json())
<?php
$url = 'https://indexer.pivx.name/v1.0/info';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
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 (với extended: true)
Giá trị registrar_address và registrar_viewing_key hiển thị ở đây chỉ mang tính minh họa.
Nút thật trả về các giá trị mainnet, và khi ra mắt chúng cũng được công bố trên
trang chủ.
{
"response": {
"last_processed_coin_block": 5538251,
"last_checkpoint": {
"idx": 42,
"block_id": 5538251,
"smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
},
"indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
"indexer_synced": true,
"checkpoints_behind": false,
"anchored_epoch": 2,
"sync_stopped": false,
"domains_count": 4,
"zones": ["pivx", "private", "secure", "safe"],
"registrar_address": "ps1…",
"registrar_viewing_key": "pxviews1…"
}
}
| Trường | Kiểu | Mô tả |
|---|---|---|
last_processed_coin_block | int | Khối cuối cùng đã xử lý trên chuỗi (thường là block_id của điểm kiểm tra gần nhất) |
indexer_smt_root | string | Điểm đồng bộ hiện tại của trình lập chỉ mục (gốc SMT của nó) |
anchored_smt_root | string | Gốc mà hợp đồng neo hiện đang chứng thực, đọc trực tiếp từ trạng thái của nó |
indexer_synced | boolean | Gốc do nút này tự tính có bằng gốc mà hợp đồng neo chứng thực hay không. Đây là kiểm tra đồng bộ đầy đủ — được đo với hợp đồng, không phải với bảng cục bộ |
checkpoints_behind | boolean | True khi checkpoint mới nhất của nút này cũ hơn gốc mà hợp đồng chứng thực — tức là việc khám phá đang bị chậm |
anchored_epoch | int | Kỷ nguyên của hợp đồng neo mà người vận hành nút này đã xem xét và đặt cho nút. Nút ngừng theo dõi chuỗi ngay khi kỷ nguyên trên chuỗi vượt qua nó (xem sync_stopped). Đây là thiết lập của nút, không phải giá trị đọc từ chuỗi: một nút được cập nhật trước một lần thay đổi quy tắc đã lên lịch sẽ báo ngay kỷ nguyên sắp tới, và cho đến khi thay đổi có hiệu lực, nút phục vụ trạng thái nó đang có, được tạo dưới kỷ nguyên hiện hành, mà không nhận checkpoint mới. Hãy đọc kỷ nguyên của một gốc từ hợp đồng — xem Bước 3 — kiểm tra kỷ nguyên |
sync_stopped | boolean | True khi nút không còn theo dõi chuỗi và đang chờ người vận hành: kỷ nguyên trên chuỗi, đã đổi do một lần thay đổi quy tắc hoặc quay lui, là kỷ nguyên mà nút chưa được cập nhật. Nút vẫn phục vụ trạng thái nó đang có, nên trong lúc đó hãy ưu tiên một nút khác |
domains_count | int | Tổng số tên đã đăng ký |
zones | string[] | Các vùng có thể đăng ký tên |
registrar_address | string | Địa chỉ của nhà đăng ký để xử lý giao dịch đến và ký quỹ |
registrar_viewing_key | string | Khóa xem đầy đủ của địa chỉ PIVX của nhà đăng ký, cho phép truy cập toàn bộ lịch sử giao thức — cả lệnh đến lẫn khoản chi trả đi |
last_checkpoint | Thông tin về điểm kiểm tra gần nhất (lần cập nhật gốc SMT gần nhất) | |
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 |
smt_root | string | Gốc cây Merkle gần nhất (hex) |
block_id | int | block_id PIVX của điểm kiểm tra gần nhất và lần tạo gốc SMT |
cảnh báo
Nếu last_processed_coin_block tụt lại đáng kể so với last_checkpoint.block_id, các lần đăng ký gần đây có thể chưa được phản ánh.