거래소 자료 수집
공통 source와 extraction 계약은 있다. Production 거래소에 연결된 ingestion runtime은 아직 없다.
거래소 adapter의 역할
거래소 문서는 trade, deposit, withdrawal, fee, reward를 확인하는 evidence source다. Adapter는 거래소 원문 record를 공통 형식으로 옮긴다.
SourceArtifact → SourceRecord → SourceExtractionRun → Observation
Observation 이후에는 거래소 evidence와 EVM evidence가 같은 Event-to-Report 계약을 사용한다. 문서 parsing은 adapter가 맡고 economic interpretation, valuation, tax inventory, reporting은 이후 단계에서 처리한다.
필요한 동작
- Source 위치, 전체 artifact hash, page/row/item 또는 source-native 좌표를 보존한다.
- Trade와 fee처럼 source record 하나에서 여러 Observation을 만들 수 있어야 한다.
- 선택된 모든 record를
NORMALIZED,DUPLICATE,UNSUPPORTED,ERROR,NOT_RELEVANT중 하나로 종결한다. - 거래소별 column·layout은 공통 schema가 아니라 adapter artifact에 둔다.
- Parser identity와 configuration을 versioning하여 재추출이 검토 가능한 revision을 만들게 한다.
현재 확인된 범위
실사한 네 저장소 밖에 standalone parser 작업이 있다. 다만 공통 extraction 계약, persistence, fixture, CI까지 연결되지 않아 production ingestion 구현으로 보지 않는다.
현재 확인한 범위에서는 production에 연결된 거래소 parser가 검증되지 않았다. 다음 단계는 source fixture 하나를 SourceExtractionRun과 Observation까지 처리하고 모든 record의 outcome을 남기는 것이다.
Observation이 만들어진 이후 withdrawal과 소유 wallet receipt의 연결은 Event, Posting, Valuation이 다루는 해석 문제다.