DEX Architecture

◉Canonical

---

Purpose

Axodus DEX architecture separates swap execution, liquidity pools, routing, listing status, fees, risk controls, governance, treasury, security, monitoring, reporting, and ACS support.

Architecture Layers

• User interface layer: swap UI, pool UI, LP positions, token warnings, quote previews, and risk disclosures.
• Swap layer: quote generation, swap parameters, minimum received, deadline, transaction submission, and failure handling.
• Pool layer: pool creation, reserves, shares, add/remove liquidity, and pool parameters.
• Router layer: route selection, pathfinding, split routes if supported, and external liquidity integrations.
• Listing layer: token metadata, verification status, official asset status, and risk warnings.
• Fee layer: swap fees, LP fee distribution, protocol fees, treasury fees if approved, and fee reporting.
• Risk layer: slippage controls, price impact warnings, MEV warnings, token risk, liquidity risk, and pool risk.
• Governance layer: listing policy, pool policy, fee policy, incentive policy, emergency pause, and parameter updates.
• Treasury layer: treasury LP positions, liquidity support, fee revenue, and exposure reporting.
• Security layer: contract review, router review, pool logic review, access control, emergency controls, and incident response.
• Monitoring layer: liquidity metrics, volume, fees, price impact, failed transactions, suspicious pool activity, and incidents.
• Reporting layer: DEX, pool, fee, treasury exposure, and incident reports.
• ACS layer: analysis, risk flags, report drafts, listing review support, and route or liquidity summaries.

Core Objects

Core objects include TokenListing, Pool, SwapQuote, LPPosition, FeeRecord, and DEXReport.

Integration Surfaces

DEX integrates with DeFi, Tokenomics, Treasury, Trading, Marketplace, Governance, Academy, ACS, Security, and Accountability. Integration does not mean that any route, token, pool, fee, or settlement model is live unless verified.

Architecture Invariants

Listings must distinguish official, verified, community, warning, and unverified assets. Swap docs must explain slippage and price impact. LP docs must explain impermanent loss. Treasury liquidity requires policy and reporting. Smart contracts require security review before production use.