Architecture

System Components

1. Frontend (web): user UI, order entry, portfolio, market pages, rewards pages.
2. Backend (backend): authentication, market APIs, rewards accounting, payout orchestration.
3. CLOB Engine (clob-engine): orderbook state, matching, execution stream.
4. Contracts (contracts): market lifecycle, tokenized outcomes, settlement.

Data Flow (High Level)

1. User places order via frontend.
2. Backend validates and forwards to CLOB engine.
3. Match/trade events are persisted and indexed.
4. Rewards jobs compute maker and creator ledgers by epoch/day.
5. Payout service settles rewards from fee collector treasury.

Reliability

• Idempotent reward epoch finalization
• Payout failure reason codes and retry paths
• Dry-run mode for safe verification before payouts
• Admin observability for epochs, payouts, and failures