# 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)이므로 명시하십시오. [레지스트리](https://achivx.kr/academy/reference/glossary/#g-registry)에 활성 스테이블코인이 없는 숫자 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`는 서비스 자체의 예산과 기준점이며, 역시 네트워크의 [인덱싱 지연](https://achivx.kr/academy/concepts/coverage-and-freshness/)이 아닙니다.

## Stablecoin scanner ACHIVX에서

[이더리움 동기화 상태 열기 ↗](https://stablescan.achivx.com/v1/sync/status?chain=1)

- 이더리움용 REST 대응 엔드포인트: [/v1/sync/status?chain=1](https://stablescan.achivx.com/v1/sync/status?chain=1). 솔라나용: [/v1/sync/status?chain=-1](https://stablescan.achivx.com/v1/sync/status?chain=-1).
- 사람이 행 위에서 보는 [최신성 표시줄](https://achivx.kr/academy/concepts/coverage-and-freshness/): [정산 피드](https://stablescan.achivx.com/transactions).

## 출처

- [A2A 에이전트 카드 (1.4.0)](https://stablescan.achivx.com/.well-known/agent-card.json)
- [에이전트 매뉴얼 — agents.md (버전 2026-10-05)](https://stablescan.achivx.com/agents.md)
- [REST 인터페이스의 OpenAPI 3.1 명세 (API 1.4.0)](https://stablescan.achivx.com/openapi.json)
- [stablescan-settlement-data SKILL.md](https://stablescan.achivx.com/.well-known/agent-skills/stablescan-settlement-data/SKILL.md)
- [GET /v1/sync/status?chain=1 (2026-10-13 조회)](https://stablescan.achivx.com/v1/sync/status?chain=1)
- [GET /v1/sync/status?chain=-1 (2026-10-13 조회)](https://stablescan.achivx.com/v1/sync/status?chain=-1)

## 더 알아보기

- [집계 범위와 최신성](https://achivx.kr/academy/concepts/coverage-and-freshness/)
- [전송이 확정되기까지 얼마나 걸립니까?](https://achivx.kr/academy/how-it-works/how-long-until-a-transfer-is-final/)

## 관련 질문

- [get-recent-transactions는 무엇을 반환합니까?](https://achivx.kr/academy/for-agents/get-recent-transactions/)
- [한도는 무엇이며, 거부는 어떤 모습입니까?](https://achivx.kr/academy/for-agents/what-are-the-limits-and-refusals/)
- [기계가 조회할 때 원시 행은 얼마나 과거까지 닿습니까?](https://achivx.kr/academy/for-agents/how-far-back-raw-rows-reach/)

정직성 계약과 여덟 가지 기능 · 스킬 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다.

---

출처: https://achivx.kr/academy/for-agents/get-sync-status/ · 영어 원문: https://achivx.com/academy/for-agents/get-sync-status.html