Contract Specifications

Deployed addresses for all environments are listed in Contract Addresses.

Overview

dreamDEX spot markets enable direct exchange of crypto assets with atomic on-chain settlement. Spot trades result in immediate ownership transfer of the underlying assets, with no margin, funding, or expiration mechanics.

All v1.0 spot markets are quoted in USDso (Somnia's USD stablecoin, backed 1:1 by FraxUSD via LayerZero), providing a consistent quote currency across pairs.

Contract Specifications

Live Markets

All dreamDEX spot markets quote against USDso.

Mainnet (chain ID 5031)

Testnet (Somnia Shannon, chain ID 50312)

Per-pair parameters (mainnet)

Current mainnet values, in human-readable units. tickSize is the minimum price increment (quote); lotSize the minimum size increment and minQuantity the minimum order size (both base):

These are set at pool initialization and are admin-tunable, so treat the table as a snapshot. GET /v0/markets and on-chain getPoolParams() are the canonical, always-current source of truth - query them at runtime rather than hard-coding, and see Quantizing price and quantity for the integer arithmetic.

Raw values. On-chain parameters are stored in raw token units. For example, with USDso at 18 decimals, a tick size of 0.01 USDso is stored as 10000000000000000 on-chain. Use getPoolParams() to query the raw values for a specific market.

Stablecoin conversion. The USDC.e / USDso pair provides an on-ramp between bridged USDC and USDso, the quote currency used across dreamDEX.

Native SOMI pool. On the SOMI/USDso pair, SOMI is the chain's native token (no ERC-20 deposit). For manual vault funding use depositNative() with msg.value instead of deposit(token, amount); under the default auto-pull flow, placeOrder is payable and pulls input from msg.value instead of an ERC-20 allowance.

Gas limit on native-base BUYs: the payout path enforces a gas headroom guard, so set the tx gas limit to ≥ 5,000,000 (and use the same limit in eth_call simulation). Below that, the call reverts with InsufficientGasForPayout(uint256 gasLeft).

Stop Order Registries

Each spot market has an associated SpotStopOrderRegistry for conditional stop-loss and take-profit orders. Registries are triggered automatically by Somnia's on-chain reactivity when the SpotPool's EMA-smoothed mark price crosses a trigger threshold.

Mainnet

Testnet

Default configuration

These are admin-tunable per registry. Read the live values via slippageToleranceBps(), somiPaymentPerOrder(), minStopDistanceBps(), and gasBufferBps() on the registry contract.