# 숫자는 어떻게 만들어지며, 누가 서명합니까?

정직성 계약과 여덟 가지 기능 · 원칙, 정의, 제외 항목, 한계를 담은 하나의 문서. 서명은 배포 환경이 서명하는 경우에만

*에이전트용 · 5분 · 고급 · 개발자 · 방법론*

`GET /v1/methodology`(2026-10-13 기준 버전 stablscan-methodology-v0.4.0)는 모든 숫자가 어떻게 만들어지는지 밝힙니다: 세 가지 원칙, 정의(정산 거래량, 헤어컷(haircut), 시장 대시보드, 운영 SLO…), 여섯 가지 제외 항목, 각각 공개 문구와 제품 규칙을 갖춘 열두 가지 한계, 섀도 모드로 시작하는 탐지기 신호, 그리고 질문 → 경로 지도입니다. 배포 환경이 서명하는 경우 카드에 `signature`와 `jwks_uri`가 있고 `POST /v1/verify-attestation`이 본문을 검사합니다. 그날 이 배포 환경의 방법론에는 `attestation` 블록이 없었습니다.

## 하나의 문서

매뉴얼은 이것을 *전체 인터페이스를 한 번에 담는* 문서 중 하나로 꼽습니다: `GET /v1/methodology` — *모든 숫자가 어떻게 만들어지는지, 그리고 무엇이 서명하는지*. 2026-10-13 기준 키: `version`, `principles`, `definitions`, `exclusions`, `limits`, `signals`, `scores`(그날은 비어 있음), `provider_questions`.

**원칙** — `precision_first`, `agent_first`, `shadow_before_prod`. **정의** — 그중 `settlement_volume`(*총액에는 관련 없는 토큰 이동이 포함될 수 있으므로, 단일 스칼라 대신 GET /v1/stats/overview의 (체인, 토큰)별 분할을 읽으십시오*), `haircut`(*불확실한 노출 전파에 대한 가치 비례 감액. 할인은 오염이 아니며 제재 판단이 아닙니다*), `recall_unknown`, `self_attested`, `attributed_stop`, `watchlist_alerts`, `market_dashboard`, `operational_slo`. **제외 항목** — 여섯 가지이며 각각 범위와 이유가 있습니다: `relay_leg`: 정산 거래량에서 *릴레이 구간은 제외되지 않습니다*(허브를 경유한 결제는 두 번 집계될 수 있음). 자기 결제 순환은 조정 지표에서, 테스트넷은 메인넷 분모에서 제외되는 식입니다. **한계** — 열두 가지이며 각각 `disclosure`와 `product_rule`이 있습니다: `passive_recall`, `ofac_source`(*제재 데이터는 상용 위험 오라클이 아니라 OFAC SDN 수집에서 가져옵니다*), `mega_hub_degree_gate`, `deep_hops_time_budget`, `window_is_whole_utc_days`, `raw_rows_are_offloaded`, `edge_grain_horizon`, `coverage_status_values` 등. **신호** — 탐지기 계열(`wash.*`, `sybil.*`, `attribution.*`, …)로, `default_mode`는 `shadow`이며 `promotion`은 각 계열이 제품에 노출되기 전에 무엇을 갖춰야 하는지 밝힙니다. **공급자 질문** — 아카데미의 [주소를 자동으로 확인하려면 — 스크립트나 AI 에이전트로 — 어떻게 합니까?](https://stablescan.achivx.com/docs/user/how-it-works/how-to-check-an-address-automatically.html)가 인용하는 질문 → 경로 지도입니다.

## 기간과 날짜

한계 항목 `window_is_whole_utc_days`: *이름이 붙은 모든 기간은 UTC 기준 온전한 날들을 포괄하며, 요청 시점이 아니라 마지막 자정에서 끝납니다: `"24h"`는 마지막 온전한 UTC 하루, `"7d"`는 마지막 7일, `"30d"`는 마지막 30일입니다.* 날짜는 `built_at`이 아니라 `window_start`와 `window_end`에서 읽으십시오. 시장 문서와 토큰별 순위에는 둘 다 있습니다.

## 서명

매뉴얼(§1): *배포 환경이 서명하는 경우 카드에 `signature`와 `jwks_uri`(`/.well-known/jwks.json`)가 있고, `POST /v1/verify-attestation`이 본문을 증명과 대조해 검사합니다.* 그리고 변경 이력에는: *`/v1/methodology`는 배포 환경이 서명할 때만 `attestation`을 담습니다. 서명 키가 없으면 이 블록은 없습니다(예전에는 어떤 응답에도 쓰이지 않던 방식을 설명했습니다).* 2026-10-13에 방법론에는 `attestation` 키가, 카드에는 `signature`가 없었습니다: 이 호스트는 현재 서명하지 않습니다. `openapi.json`이 설명하는 대로 증명된 본문과 그 `attestation`을 담은 호출은 현재 코드 `no_key`, *public_key가 제공되지 않았고 이 배포 환경에는 서명 키가 없음*과 함께 `400`으로 답합니다(2026-10-14 조회) — `openapi.json`에 있는 이 경로의 세 가지 코드 `invalid_body`, `invalid_public_key`, `no_key` 중 하나입니다. 대조할 키가 있으면 — 호스트가 서명을 시작한 뒤의 호스트 키, 또는 `no_key` 메시지가 말하듯 호출자가 제공하는 `public_key`(어디에 어떤 형식으로 넣는지는 아직 어떤 문서도 밝히지 않음) — `valid: false`는 *오류가 아니라 응답*이며 HTTP는 `200`으로 유지됩니다. 이 경로는 [openapi.json](https://stablescan.achivx.com/openapi.json)에 자체 태그 `attestation` 아래 있으며, 요약은 *본문을 그 증명과 대조해 검사(무료, 독립적)*입니다.

## Stablecoin scanner ACHIVX에서

[/v1/methodology 열기 ↗](https://stablescan.achivx.com/v1/methodology)

- 문서: [/v1/methodology](https://stablescan.achivx.com/v1/methodology).
- 검증 경로와 카드의 `signature` 필드는 매뉴얼 §1에 있습니다: [/agents.md](https://stablescan.achivx.com/agents.md). 경로는 [/openapi.json](https://stablescan.achivx.com/openapi.json)에 있습니다.

## 출처

- [GET /v1/methodology (stablscan-methodology-v0.4.0)](https://stablescan.achivx.com/v1/methodology)
- [에이전트 매뉴얼 — 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)

## 더 알아보기

- [기계로 사이트 읽기](https://achivx.kr/academy/reference/api-methodology/)
- [정산 거래량의 의미](https://achivx.kr/academy/how-it-works/what-settled-volume-means/)

## 관련 질문

- [정직성 계약이란 무엇입니까?](https://achivx.kr/academy/for-agents/what-is-the-honesty-contract/)
- [기계가 조회할 때 원시 행은 얼마나 과거까지 닿습니까?](https://achivx.kr/academy/for-agents/how-far-back-raw-rows-reach/)
- [REST API는 어떻게 구성되어 있습니까?](https://achivx.kr/academy/for-agents/how-the-rest-api-is-organised/)

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

---

출처: https://achivx.kr/academy/for-agents/how-the-numbers-are-produced-and-signed/ · 영어 원문: https://achivx.com/academy/for-agents/how-the-numbers-are-produced-and-signed.html