索引器信息

索引器信息与状态

返回 PIVX Names 解析索引器节点的当前状态、同步进度以及当前 SMT 根。

端点

GET https://indexer.pivx.name/v1.0/info（获取基础信息）
POST https://indexer.pivx.name/v1.0/info（若需要额外参数）

请求体

请求体必须是包含以下参数的 JSON 对象：

参数	类型	默认值	说明
extended	boolean	false	若为 true，则额外返回扩展信息

---

代码示例

cURL

curl -X GET https://indexer.pivx.name/v1.0/info

JavaScript

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));

Python

import requests

url = "https://indexer.pivx.name/v1.0/info"

response = requests.get(url)
print(response.json())

PHP

<?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);

响应示例（extended: true 时）

此处显示的 registrar_address 与 registrar_viewing_key 仅供示意。真实运行的节点会返回主网 数值，上线时这些数值也会公布在首页。

{
  "response": {
    "last_processed_coin_block": 3423251,
    "last_checkpoint": {
      "idx": 42,
      "block_id": 3423251,
      "smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128"
    },
    "indexer_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "anchored_smt_root": "1c3ba6eb818b93823d635b7d6737377693796312a1abd2d3b863da5d455df128",
    "indexer_synced": true,
    "checkpoints_behind": false,
    "domains_count": 4,
    "registrar_address": "ps1…",
    "registrar_viewing_key": "pxviews1…"
  }
}

字段	类型	说明
last_processed_coin_block	int	链上最近处理的区块（通常是最近检查点的 block_id）
indexer_smt_root	string	索引器当前的同步位置（其 SMT 根）
anchored_smt_root	string	锚定合约当前证明的根，直接从其状态读取
indexer_synced	boolean	本节点独立计算出的根是否等于锚定合约所证明的根。这就是完整的同步检查——它以合约为准，而不是以本地表为准
checkpoints_behind	boolean	当本节点最新的检查点早于合约所证明的根时为 true，即检查点发现已落后
domains_count	int	已注册名称总数
registrar_address	string	注册方用于处理入账交易与托管的地址
registrar_viewing_key	string	注册方 PIVX 地址的完整查看密钥，可访问全部协议历史——入账命令与出账支付皆可见
last_checkpoint		最近一次检查点的信息（最近一次 SMT 根更新）
idx	int	在锚定合约 rootChain 数组中的位置；检查点发现的续传游标
smt_root	string	最新的默克尔树根（十六进制）
block_id	int	最近检查点与 SMT 根生成所对应的 PIVX block_id

注意

若 last_processed_coin_block 明显落后于 last_checkpoint.block_id，近期的注册可能尚未反映出来。