Struct StablecoinDEX 

pub struct StablecoinDEX {
    pub books: <Mapping<FixedBytes<32>, Orderbook> as StorableType>::Handler,
    pub orders: <Mapping<u128, Order> as StorableType>::Handler,
    pub balances: <Mapping<Address, Mapping<Address, u128>> as StorableType>::Handler,
    pub next_order_id: <u128 as StorableType>::Handler,
    pub book_keys: <Vec<FixedBytes<32>> as StorableType>::Handler,
    address: Address,
    storage: StorageCtx,
}

Fields

books: <Mapping<FixedBytes<32>, Orderbook> as StorableType>::Handler

orders: <Mapping<u128, Order> as StorableType>::Handler

balances: <Mapping<Address, Mapping<Address, u128>> as StorableType>::Handler

next_order_id: <u128 as StorableType>::Handler

book_keys: <Vec<FixedBytes<32>> as StorableType>::Handler

address: Address

storage: StorageCtx

Implementations

impl StablecoinDEX

pub fn new() -> StablecoinDEX

Creates an instance of the precompile.

Caution: This does not initialize the account, see Self::initialize.

impl StablecoinDEX

pub fn address(&self) -> Address

Returns the StablecoinDEX address.

pub fn initialize(&mut self) -> Result<(), TempoPrecompileError>

Initializes the stablecoin DEX precompile.

pub fn balance_of( &self, user: Address, token: Address, ) -> Result<u128, TempoPrecompileError>

Returns the user’s DEX balance for token.

pub fn min_price(&self) -> u32

Returns the minimum representable scaled price (MIN_PRICE).

pub fn max_price(&self) -> u32

Returns the maximum representable scaled price (MAX_PRICE).

pub fn get_order(&self, order_id: u128) -> Result<Order, TempoPrecompileError>

Fetches an active [Order] from storage by ID.

Errors

• OrderDoesNotExist — order has a zero maker (already filled/deleted) or has not yet been assigned (ID ≥ next order ID)

pub fn quote_swap_exact_amount_out( &self, token_in: Address, token_out: Address, amount_out: u128, ) -> Result<u128, TempoPrecompileError>

Quotes the input amount required to receive exactly amount_out tokens, routing through one or more orderbooks without executing trades.

Errors

• IdenticalTokens — token_in and token_out are the same address
• InvalidToken — a token address does not have a valid TIP-20 prefix
• PairDoesNotExist — no orderbook exists for one of the hops in the route
• InsufficientLiquidity — not enough resting orders to fill amount_out

pub fn quote_swap_exact_amount_in( &self, token_in: Address, token_out: Address, amount_in: u128, ) -> Result<u128, TempoPrecompileError>

Quotes the output amount received for exactly amount_in input tokens, routing through one or more orderbooks without executing trades.

Errors

• IdenticalTokens — token_in and token_out are the same address
• InvalidToken — a token address does not have a valid TIP-20 prefix
• PairDoesNotExist — no orderbook exists for one of the hops in the route
• InsufficientLiquidity — not enough resting orders to fill amount_in

pub fn swap_exact_amount_in( &mut self, sender: Address, token_in: Address, token_out: Address, amount_in: u128, min_amount_out: u128, ) -> Result<u128, TempoPrecompileError>

Swaps amount_in of token_in for token_out, routing through one or more orderbooks. Deducts input via [TIP20Token] transfer or DEX balance, then fills orders at best price per hop.

Errors

• InvalidBaseToken — token address does not have a valid TIP-20 prefix
• PairNotFound — no orderbook exists for the token pair
• InsufficientOutput — final output amount falls below min_amount_out
• InsufficientBalance — sender balance lower than required input

pub fn swap_exact_amount_out( &mut self, sender: Address, token_in: Address, token_out: Address, amount_out: u128, max_amount_in: u128, ) -> Result<u128, TempoPrecompileError>

Swaps to receive exactly amount_out of token_out, routing through one or more orderbooks. Works backwards from output to compute input, then deducts via [TIP20Token] or DEX balance.

Errors

• InvalidBaseToken — token address does not have a valid TIP-20 prefix
• PairNotFound — no orderbook exists for the token pair
• MaxInputExceeded — required input exceeds max_amount_in
• InsufficientBalance — sender balance lower than required input

pub fn get_price_level( &self, base: Address, tick: i16, is_bid: bool, ) -> Result<TickLevel, TempoPrecompileError>

Returns the [TickLevel] for a given base token, tick, and side. Looks up the quote token via [TIP20Token] and derives the book key.

Errors

• InvalidBaseToken — base address does not resolve to a valid [TIP20Token]

pub fn books( &self, pair_key: FixedBytes<32>, ) -> Result<Orderbook, TempoPrecompileError>

Returns the [Orderbook] for a given pair key.

pub fn get_book_keys(&self) -> Result<Vec<FixedBytes<32>>, TempoPrecompileError>

Returns all registered orderbook keys.

pub fn tick_to_price(&self, tick: i16) -> Result<u32, TempoPrecompileError>

Converts a relative tick to a scaled price. On T2+ validates [TICK_SPACING] alignment.

Errors

• InvalidTick — tick is not aligned to [TICK_SPACING] (T2+ only)

pub fn price_to_tick(&self, price: u32) -> Result<i16, TempoPrecompileError>

Converts a scaled price to a relative tick. On T2+ validates [TICK_SPACING] alignment.

Errors

• TickOutOfBounds — price is outside the [MIN_PRICE, MAX_PRICE] range
• InvalidTick — resulting tick is not aligned to [TICK_SPACING] (T2+ only)

pub fn create_pair( &mut self, base: Address, ) -> Result<FixedBytes<32>, TempoPrecompileError>

Creates a new trading pair between base and its quote token. Both must be USD-denominated tokens validated via [TIP20Factory]. Reverts if the pair already exists.

Errors

• InvalidBaseToken — token address does not have a valid TIP-20 prefix
• InvalidCurrency — both tokens must be USD-denominated (validated via [TIP20Factory]).
• PairAlreadyExists — an orderbook for this pair is already initialized

pub fn place( &mut self, sender: Address, token: Address, amount: u128, is_bid: bool, tick: i16, ) -> Result<u128, TempoPrecompileError>

Places a limit order on the orderbook for token against its quote token. Escrows the appropriate amount via [TIP20Token] transfer or DEX balance and enforces compliance via the [TIP403Registry]. Auto-creates the trading pair if needed.

Errors

• InvalidBaseToken — token address does not have a valid TIP-20 prefix
• TickOutOfBounds — tick is outside the allowed [MIN_TICK, MAX_TICK] range
• InvalidTick — tick is not aligned to TICK_SPACING
• BelowMinimumOrderSize — order amount is below MIN_ORDER_AMOUNT
• InsufficientBalance — sender balance lower than required
• PolicyForbids — TIP-403 policy rejects the token transfer

Returns

The assigned order ID

pub fn place_flip( &mut self, sender: Address, token: Address, amount: u128, is_bid: bool, tick: i16, flip_tick: i16, internal_balance_only: bool, ) -> Result<u128, TempoPrecompileError>

Places a flip order that auto-reverses to the opposite side when fully filled, acting as perpetual liquidity. Escrows tokens via [TIP20Token] and enforces compliance via [TIP403Registry]. Pre-T5: for bids flip_tick must be > tick; for asks, < tick. T5+ (TIP-1030): for bids flip_tick >= tick; for asks flip_tick <= tick.

Errors

• InvalidBaseToken — token address does not have a valid TIP-20 prefix
• TickOutOfBounds — tick or flip_tick outside [MIN_TICK, MAX_TICK]
• InvalidTick — tick is not aligned to TICK_SPACING
• InvalidFlipTick — flip_tick on wrong side of tick for order direction
• BelowMinimumOrderSize — order amount is below MIN_ORDER_AMOUNT
• InsufficientBalance — sender balance lower than required escrow
• PolicyForbids — TIP-403 policy rejects the token transfer

pub fn cancel( &mut self, sender: Address, order_id: u128, ) -> Result<(), TempoPrecompileError>

Cancels an active order and refunds escrowed tokens to the maker. Only the order maker can cancel their own orders.

Errors

• OrderDoesNotExist — order ID not found or already fully filled
• Unauthorized — only the order maker can cancel their order

pub fn cancel_stale_order( &mut self, order_id: u128, ) -> Result<(), TempoPrecompileError>

Cancels an order whose maker is blocked by [TIP403Registry] policy, allowing anyone to clean up stale liquidity.

TIP-1015: T4+ checks sender authorization on the escrow token and recipient authorization on the payout token. An order is stale if the maker fails either check.

Errors

• OrderDoesNotExist — order ID not found or already fully filled
• OrderNotStale — order maker is still authorized by TIP-403 policy

pub fn withdraw( &mut self, user: Address, token: Address, amount: u128, ) -> Result<(), TempoPrecompileError>

Withdraws amount from the caller’s DEX balance, transferring tokens back via [TIP20Token].

Errors

• InsufficientBalance — DEX balance lower than withdrawal amount

impl StablecoinDEX

pub fn create_precompile(cfg: &CfgEnv<TempoHardfork>) -> DynPrecompile

Creates the EVM precompile for this type.

Trait Implementations

impl ContractStorage for StablecoinDEX

fn address(&self) -> Address

Contract address.

fn storage(&self) -> &StorageCtx

Contract storage accessor.

fn storage_mut(&mut self) -> &mut StorageCtx

Contract storage mutable accessor.

fn is_initialized(&self) -> Result<bool, TempoPrecompileError>

Returns true if the contract has been initialized (has bytecode deployed).

impl Default for StablecoinDEX

fn default() -> StablecoinDEX

Returns the “default value” for a type.

impl Precompile for StablecoinDEX

fn call( &mut self, calldata: &[u8], msg_sender: Address, ) -> Result<PrecompileOutput, PrecompileError>

Dispatches an EVM call to this precompile.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 504 bytes