Adapter Map
Swap Flow
- Operator or agent chooses a venue on
/swaps. - ArcPay records source asset, target asset, amount, slippage, executor, and venue.
- Treasury policy checks run before wallet signing or agent order creation.
- Execution happens through the selected venue or a custom adapter.
- Audit record is completed only after tx hash and route evidence are attached.
Yield / Liquidity Flow
- Operator chooses a strategy on
/yield: dreamDEX maker yield, Somnia Exchange LP, Somnex liquidity/perps, Potion Swap LP, or treasury hold. - ArcPay records risk limit, max drawdown, asset, amount, and executor agent.
- Operator approval is required before any LP, perps, or strategy action.
- Final audit requires venue evidence, tx hash, final balance, and risk snapshot.
Developer Tools
HTTP developer tool:Boundary
ArcPay does not claim an official private Somnia DeFi SDK where one is not published. The adapter layer is designed to be honest and useful:- use dreamDEX’s documented REST/CLI/contract flow for CLOB market discovery and signed order transactions
- use live Somnia venues when they expose usable testnet flows
- use a custom router when building directly from Somnia’s DEX tutorial
- never mark execution done without transaction evidence
- keep all route and strategy actions inside treasury policy controls
Source References
- dreamDEX docs: https://docs.dreamdex.io/ld25g222WKDrLlJMcR41
- dreamDEX quick start: https://docs.dreamdex.io/ld25g222WKDrLlJMcR41/welcome/quick-start.md
- dreamDEX contracts: https://docs.dreamdex.io/ld25g222WKDrLlJMcR41/developers/contracts.md
- dreamDEX contract specs and testnet pools: https://docs.dreamdex.io/ld25g222WKDrLlJMcR41/trading/readme-1/contract-specifications.md
- Somnia network information and faucet: https://docs.somnia.network/developer/network-info
- Somnia DEX tutorial: https://docs.somnia.network/developer/tutorials/build-a-dex-on-somnia
- Somnia MCP transaction tooling: https://somniamcp.xyz/mcp/
- Potion Swap overview: https://docs.uprisinglabs.io/games-and-products/potion-swap-dex