핵심 개념

아키텍처

SatoriEx가 어떻게 구성되어 있는지 고수준 지도입니다. 어떤 보장을 받는지 추론할 수 있도록 시스템 형태를 공유합니다; 특정 벤더와 제품 선택은 의도적으로 제외했습니다.

이 페이지 읽는 방법

Three layers. The Edge handles security and routing. The Core runs the application and matching logic. Data & Chain stores balances and history, with a public-blockchain bridge for deposits, withdrawals, and (planned) self-custody. Most trades complete entirely inside the Core; only deposits and withdrawals touch the chain.

고수준 컴포넌트 다이어그램. 실선은 수탁형 거래 흐름이고 점선은 온체인 브리지 흐름입니다.

Swipe left or right to see the full diagram.

세 가지 레이어

각 레이어는 하나의 역할을 갖습니다. 경계가 명확하여 다른 부분을 건드리지 않고 어떤 부분이든 교체할 수 있습니다.

엣지

경계를 방어합니다

TLS를 종료하고, 속도 제한과 지역 규칙을 적용하며, 정상 요청을 게이트웨이로 전달합니다. 엣지만이 유일한 공개 표면이며 뒤에 있는 모든 것은 비공개입니다.

코어

애플리케이션을 실행합니다

웹 앱은 UI를 제공하고, API는 요청을 인증하고 비즈니스 로직을 조율하며, 매처는 가격-시간 우선순위로 매수자와 매도자를 연결하고, 워커는 정산, 알림, 예약 작업을 처리합니다. 각각은 별도의 프로세스이므로 장애가 격리됩니다.

데이터 및 체인

상태를 저장하고 체인과 브리지합니다

잔액과 히스토리는 복식부기 원장으로 데이터베이스에 저장됩니다 — 모든 변경은 차변과 대변이며, 단방향 쓰기는 없습니다. 캐시와 큐가 핫 읽기와 주문 파이프라인을 위해 앞에 배치됩니다. 블록체인은 자금이 시스템에 들어오거나 나갈 때, 또는 사용자가 자기 수탁을 원할 때만 사용됩니다.

API 내부 레이어 구조

API 서버 내부에서 클린 아키텍처 레이아웃을 따릅니다. 도메인 엔티티는 외부에 대한 종속성이 없습니다. 비즈니스 로직은 도메인에만 의존합니다. 트랜스포트(HTTP, 이벤트)와 인프라(데이터 저장소, 체인 클라이언트)는 비즈니스 로직에 의존하며, 그 반대는 아닙니다.

Domain   ──▶   App           ──▶   Adapter             ──▶   Infra
entities       business logic       transport boundary         data stores
no imports     orchestration        request / response         DB · Cache · Queue · Chain

종속성은 안쪽을 향합니다. 도메인은 HTTP 서버나 데이터베이스가 존재한다는 것을 모릅니다.

수탁형 vs 자기 수탁

Custodial trading is fast and free of per-trade gas: matching and the ledger live inside the Core. Linking an external wallet today gives you an on-chain deposit/withdrawal path — your USDC moves between the wallet and the SatoriEx ledger across the chain, and a gas fee applies on each move. Trading itself still runs inside the Core in either case. A full self-custody trading mode — where outcome shares are represented on-chain as ERC-1155 CTF tokens during the position — is on the roadmap (see Contracts and Changelog); it is not active today.