Visual Diagrams
High-level flows, sequences, and state machines for clarity and reviews.
System Overview
flowchart LR
A[Client] -- intent --> B[Coordinator]
B -- RFQ --> C[Market Makers]
B -- Pools --> D[AMM Adapters]
B -- plan --> A
A -- signed tx --> E[Router]
E -- fill --> C
E -- swap --> D
E -- receipt --> A
Intent → Settlement (Sequence)
sequenceDiagram
participant Client
participant Coord as Coordinator
participant Makers
participant AMMs
participant Router
Client->>Coord: POST /v1/intent
Coord-->>Makers: RFQ requests
Coord-->>AMMs: Route queries
Makers-->>Coord: Quotes (TTL)
AMMs-->>Coord: Candidates
Coord->>Client: Plan preview
Client->>Router: Signed tx
Router-->>Makers: IOC fills
Router-->>AMMs: Swaps
Router->>Client: Receipt
Settlement State Machine
stateDiagram-v2
[*] --> INIT
INIT --> VALIDATE
VALIDATE --> PREP
PREP --> EXECUTE
EXECUTE --> RECONCILE
RECONCILE --> EMIT
EMIT --> DONE
VALIDATE --> ERROR: bad plan
EXECUTE --> ERROR: ttl / slippage
ERROR --> [*]