跳到主要内容

检查点

返回本索引器从锚定合约读取的同步检查点列表——每个检查点是一个状态根及其覆盖的 PIVX 区块高度——使客户端能够针对特定区块高度校验数据完整性。

端点​

POST https://indexer.pivx.name/v1.0/checkpoints

请求体​

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

参数类型默认值说明
countinteger100限制单次响应中返回的检查点最大数量,最多 500:更大的值会被截为 500。
from_blockinteger无只返回该区块高度之外的检查点:asc 时取更高的区块高度,desc 时取更低的区块高度;该区块本身不包括在内。不指定时,列表从最早的检查点(asc)或最新的检查点(desc)开始。
orderstringdesc检查点的排序方式。可接受的取值:asc 或 desc。

代码示例​

curl -X POST https://indexer.pivx.name/v1.0/checkpoints \
-H "Content-Type: application/json" \
-d '{
"count": 2,
"from_block": 1,
"order": "asc"
}'

响应示例

{
"response": [
{
"idx": 41,
"block_id": 5537048,
"smt_root": "b4c9dacf8e194e353dce7638d76f282fe40399f7b0ad74a2229a6d4f5be774de"
},
{
"idx": 42,
"block_id": 5537335,
"smt_root": "eba675788f0fbf1df8a3c32e83da3e71dfd9337cca5a7c8ae2f51e963d03be17"
}
]
}
字段类型说明
idxint根在锚定合约 rootAt 映射中的索引(0 为创世根);检查点发现的续传游标
block_idint该检查点所包含的最后一个 PIVX block_id
smt_rootstring该检查点的 SMT 根