Skip to main content
ArcPay Somnia treats DeFi execution as a policy-bound adapter flow, not a fake fill. Operators and agents can prepare route or yield intents, but an action is only complete after real Somnia evidence is attached.

​
Adapter Map

AdapterRoleExecution ModeEvidence Required
dreamDEX CLOBFully on-chain central limit order bookREST/CLI market discovery plus wallet-signed Somnia transactionMarket quote, pool address, signed order tx hash, order/fill status, before/after balance
Somnia ExchangeNative swap venueWallet-signed route executionQuote, wallet simulation, tx hash, before/after balance
SomnexAggregator, liquidity, and perps venueAgent-prepared route or strategy intentVenue quote, position/risk summary, tx hash, risk snapshot
Potion SwapTestnet DEX candidateManual signer or agent handoffQuote screenshot, pool route, tx hash
Custom Somnia DEX adapterBuilder-owned router from Somnia’s DEX tutorialContract adapterAdapter address, quote response, fill transaction hash

​
Swap Flow

  1. Operator or agent chooses a venue on /swaps.
  2. ArcPay records source asset, target asset, amount, slippage, executor, and venue.
  3. Treasury policy checks run before wallet signing or agent order creation.
  4. Execution happens through the selected venue or a custom adapter.
  5. Audit record is completed only after tx hash and route evidence are attached.

​
Yield / Liquidity Flow

  1. Operator chooses a strategy on /yield: dreamDEX maker yield, Somnia Exchange LP, Somnex liquidity/perps, Potion Swap LP, or treasury hold.
  2. ArcPay records risk limit, max drawdown, asset, amount, and executor agent.
  3. Operator approval is required before any LP, perps, or strategy action.
  4. Final audit requires venue evidence, tx hash, final balance, and risk snapshot.

​
Developer Tools

HTTP developer tool: 
curl https://arcpay-somnia.vercel.app/api/developer/tools/somnia_defi_adapters
Public adapter status: 
curl https://arcpay-somnia.vercel.app/api/somnia/defi/status
CLI: 
npm install -g @arcpaylabs/somnia-cli
arcpay-somnia defi-adapters
MCP: 
Tool: somnia_defi_adapters

​
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