인덱서 정보
인덱서 정보와 상태
PIVX Name 해석 인덱서 노드의 현재 상태, 동기화 진행 상황, 현재 SMT 루트를 반환합니다.
엔드포인트
GET https://indexer.pivx.name/v1.0/info(기본 정보 조회)
POST https://indexer.pivx.name/v1.0/info(추가 매개변수가 필요한 경우)
요청 본문
요청 본문은 다음 매개변수를 담은 JSON 객체여야 합니다:
| 매개변수 | 타입 | 기본값 | 설명 |
|---|---|---|---|
extended | boolean | false | true이면 확장 정보도 함께 반환합니다 |
코드 예시
- 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);
응답 예시(extended: true인 경우)
여기 표시된 registrar_address와 registrar_viewing_key는 예시입니다. 실제 노드는 메인넷
값을 반환하며, 출시 시 그 값은 첫 페이지에도 공개됩니다.
{
"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…"
}
}
| 필드 | 타입 | 설명 |
|---|---|---|
last_processed_coin_block | int | 체인에서 마지막으로 처리한 블록(보통 최근 체크포인트의 block_id) |
indexer_smt_root | string | 인덱서의 현재 동기화 지점(그 SMT 루트) |
anchored_smt_root | string | 앵커 컨트랙트가 현재 증명하는 루트. 컨트랙트 상태에서 직접 읽습니다 |
indexer_synced | boolean | 이 노드가 독립적으로 계산한 루트가 앵커 컨트랙트가 증명하는 루트와 같은지 여부. 이것이 완전한 동기화 검사이며, 로컬 테이블이 아니라 컨트랙트를 기준으로 측정합니다 |
checkpoints_behind | boolean | 이 노드의 최신 체크포인트가 컨트랙트가 증명하는 루트보다 오래된 경우 true. 즉 탐색이 뒤처진 상태입니다 |
anchored_epoch | int | 이 노드의 운영자가 검토하고 노드에 설정한 앵커 컨트랙트 에포크. 온체인 에포크가 이를 넘어서는 즉시 노드는 체인 추적을 멈춥니다(sync_stopped 참조). 체인에서 읽은 값이 아니라 노드의 설정입니다. 예정된 규칙 변경에 앞서 업데이트된 노드는 다가올 에포크를 이미 보고하며, 변경이 발효될 때까지 새 체크포인트를 받지 않고 가진 상태(현행 에포크에서 만들어진 것)를 제공합니다. 루트의 에포크는 대신 컨트랙트에서 읽으세요 — 3단계 — 에포크 확인을 참조하세요 |
sync_stopped | boolean | 노드가 더 이상 체인을 따라가지 않고 운영자를 기다리는 동안 true입니다. 규칙 변경이나 롤백으로 바뀐 온체인 에포크에 맞게 노드가 아직 업데이트되지 않은 경우입니다. 노드는 가진 상태를 계속 제공하므로, 그동안은 다른 노드를 쓰는 편이 좋습니다 |
domains_count | int | 등록된 이름 총수 |
zones | string[] | 이름을 등록할 수 있는 영역 |
registrar_address | string | 수신 트랜잭션과 에스크로를 처리하는 레지스트라 주소 |
registrar_viewing_key | string | 레지스트라 PIVX 주소의 완전 열람 키로, 프로토콜 이력 전체에 접근할 수 있습니다 — 수신 명령과 발신 지급 모두 |
last_checkpoint | 최근 체크포인트 정보(최근 SMT 루트 갱신) | |
idx | int | 앵커 컨트랙트 rootAt 매핑에서 루트의 인덱스(0은 제네시스 루트). 체크포인트 탐색의 재개 커서 |
smt_root | string | 최신 머클 트리 루트(16진수) |
block_id | int | 최근 체크포인트와 SMT 루트 생성에 해당하는 PIVX block_id |
경고
last_processed_coin_block이 last_checkpoint.block_id보다 크게 뒤처져 있다면, 최근 등록이 아직 반영되지 않았을 수 있습니다.