본문으로 건너뛰기

체크포인트

이 인덱서가 앵커 컨트랙트에서 읽어 온 동기화 체크포인트 목록을 반환합니다. 각 체크포인트는 상태 루트와 그것이 다루는 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 루트