get-sync-status는 무엇을 반환합니까?
정직성 계약과 여덟 가지 기능 · 체인별 인덱서 헤드, 지연, 가장 최근 인덱싱된 전송의 경과 시간
- 에이전트용
- 4분
- 고급
- 개발자
- 스킬
한 네트워크에 대한 인덱서 최신성입니다: chain_id, last_indexed_block, head_block, safe_block, finalized_block, lag_blocks(헤드 빼기 마지막 인덱싱 블록), freshness_seconds — 가장 최근 인덱싱된 전송의 경과 시간으로, 모든 네트워크에서 쓰는 최신성 척도 — 와 as_of. 솔라나(Solana)에서는 lag_blocks가 구조상 0에 가까우므로 최신성 신호가 아닙니다. freshness_seconds를 읽으십시오 — 그리고 그 값이 null이면 lag_blocks로 대체하지 말고 다시 요청하십시오. 이 값은 모든 네트워크의 동기화 응답에서 null일 수 있습니다. /health와 /ready는 이에 대해 아무것도 말하지 않습니다.
무엇에 답합니까
카드 설명: 인덱서의 head/safe/finalized 블록, lag_blocks(head_block - last_indexed_block), freshness_seconds(가장 최근 인덱싱된 전송의 경과 시간, 모든 체인에서 쓰는 최신성 척도)를 제공해 에이전트가 데이터가 얼마나 최신인지 알 수 있게 합니다. 솔라나(체인 -1)에서 safe_block은 확정된 슬롯이며, lag_blocks는 구조상 0에 가깝고 결코 음수가 아니므로 그곳에서는 최신성 신호가 아닙니다: freshness_seconds를 읽으십시오. EVM 체인과 트론에서 lag_blocks가 음수이면 노드의 헤드가 뒤로 갔다는 뜻입니다. REST 대응 엔드포인트는 GET /v1/sync/status?chain=입니다. 카드에서 스킬의 chain 기본값은 베이스(Base)이므로 명시하십시오. 레지스트리에 활성 스테이블코인이 없는 숫자 id는 여기서 거부되지 않습니다 — 매뉴얼 §2: get-sync-status는 그런 id에 대해 0으로 채워진 상태를 답합니다(head_block은 기록된 것이 없으면 0). 그러니 id는 카드에서 가져오고, 0으로 채워진 응답을 정상으로 읽지 마십시오.
2026-10-13의 두 응답
이더리움(Ethereum), 13:53 UTC: last_indexed_block 26183979, head_block 26183995, lag_blocks 16, freshness_seconds 196. 같은 분의 솔라나: lag_blocks 0, 모든 블록 필드가 같은 슬롯, freshness_seconds 93 — 매뉴얼의 요점이 한 쌍의 응답에 담겨 있습니다: 솔라나에서 지연은 구조상 0에 가깝고, 읽어야 할 수치는 가장 최근 전송의 경과 시간입니다.
같은 수치가 나타나는 곳
모든 주소 응답에는 freshness_seconds가 있습니다 — 그 체인에서 가장 최근 인덱싱된 전송의 경과 시간(get-sync-status 수치를 옆에 가져온 것), 또는 이 응답에서 읽을 수 없었거나 체인에 아직 인덱싱된 전송이 없을 때 null. 실패한 읽기는 결코 숫자로 보고되지 않습니다. /v1/verify는 검색한 네트워크마다 sync 응답을 담습니다. /v1/stats/home은 빌드 시점에 읽은 as_of와 함께 freshness[] 행을 담습니다: 체인의 현재 지연은 /v1/sync/status?chain=에 물으십시오. 매뉴얼 §4의 규칙 최신성은 암시되는 것이 아니라 공개됩니다, 그리고 주소 응답과 관련된 §2의 규칙: 등급은 최신성에 따라 결코 움직이지 않습니다. 용도에 비추어 “너무 오래됨”이 무엇인지는 사용자가 정합니다. 누락된 결제에 대한 정산 스킬의 규칙: “받지 못함”으로 결론 내리기 전에 확인하십시오.
가동 여부가 아닙니다
/health와 /ready는 프로세스 가동 여부입니다 — 프로세스가 떠 있고 데이터베이스가 응답한다는 것. 인덱싱에 대해서는 아무것도 말하지 않습니다: 둘 다 200으로 답하는 동안에도 네트워크는 몇 시간 뒤처져 있을 수 있습니다. /v1/stats/slo는 서비스 자체의 예산과 기준점이며, 역시 네트워크의 인덱싱 지연이 아닙니다.
Stablecoin scanner ACHIVX에서
- 이더리움용 REST 대응 엔드포인트: /v1/sync/status?chain=1. 솔라나용: /v1/sync/status?chain=-1.
- 사람이 행 위에서 보는 최신성 표시줄: 정산 피드.
출처
- A2A 에이전트 카드 (1.4.0)
- 에이전트 매뉴얼 — agents.md (버전 2026-10-05)
- REST 인터페이스의 OpenAPI 3.1 명세 (API 1.4.0)
- stablescan-settlement-data SKILL.md
- GET /v1/sync/status?chain=1 (2026-10-13 조회)
- GET /v1/sync/status?chain=-1 (2026-10-13 조회)
더 알아보기
관련 질문
정직성 계약과 여덟 가지 기능 · 스킬 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다.
이 페이지는 ACHIVX Academy 영어 원문을 한국어로 옮긴 것입니다. 번역과 원문이 다르면 영어 원문이 기준입니다.