Stable AMM instructions

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Instruction inventory

​

Initialize

nonce: u8
open_time: u64

• model_data_account must already be created and initialized by a prior InitModelData.
• lp_mint must be empty (zero supply).
• Vaults must exist and be owned by amm_authority.

• AmmInfo is initialized with all references.
• TargetOrders is zeroed and ready for the first MonitorStep.
• Initial LP tokens are minted and sent to user_dest_lp_token.
• OpenBook orders have not been posted yet; the first MonitorStep posts them.

​

InitModelData

multiplier: u64       // scale factor (e.g., 10^6)

• model_data_account must be sufficiently large (~1.2 MB for 50k × 24 bytes).
• model_data_account must be owned by the Stable program.

• status = Initialized.
• multiplier is set.
• valid_data_count = 0 (no elements populated yet; call UpdateModelData to add them).
• elements array is zeroed.

​

UpdateModelData

array_data: [UpdateModelData; 5]

pub struct UpdateModelData {
  pub index: u64,
  pub data: DataElement,
}

• amm_admin must match AmmInfo.amm_admin.
• Each index in array_data must be valid (within 50,000).
• Entries must be sorted (not validated on-chain for speed): x ascending, y descending, price ascending.

• Elements are written to model_data_account.elements[index] for each input.
• valid_data_count is updated to the max index written + 1.

​

Deposit

max_coin_amount: u64
max_pc_amount: u64
base_side: u64          // 0 = base on coin, 1 = base on pc

​

Withdraw

amount: u64            // LP tokens to burn

• user_lp_token_account holds at least amount.

• amount LP tokens are burned.
• User receives coin and pc amounts according to the current pro-rata, adjusted for accrued fees.

​

SwapBaseIn

amount_in: u64
minimum_amount_out: u64

• amm.status allows swap.
• user_source_token holds ≥ amount_in.

• User loses amount_in, gains amount_out ≥ minimum_amount_out.
• Pool fees increment need_take_pnl_* counters.
• OpenBook orders may settle if filled.

​

SwapBaseOut

max_amount_in: u64
amount_out: u64

​

MonitorStep

plan_order_limit: u16
place_order_limit: u16
cancel_order_limit: u16

• OpenBook account references must match the pool’s bound market.

• Pending OpenBook fills are settled into the pool vaults.
• New limit orders are posted to OpenBook based on the lookup-table curve.
• TargetOrders is updated.

​

SetParams

param: u8              // which parameter to change (Status, State, Fees, etc.)
value: Option<u64>    // new value (if param is numeric)
new_pubkey: Option<Pubkey>  // new address (if param is an account key)
fees: Option<Fees>    // new fees (if param is Fees)

• param = 0 (Status) — change the operation bitmask.
• param = 9 (Fees) — change trade_fee, pnl split, etc.
• param = 11 (ModelDataKey) — rebind the lookup table (rare, requires admin action).

​

WithdrawPnl

• pnl_admin must be authorized.

• need_take_pnl_coin and need_take_pnl_pc are transferred to the admin’s accounts.
• Counters are zeroed.

​

WithdrawSrm

amount: u64

​

SimulateInfo

param: u8              // PoolInfo, SwapBaseInInfo, SwapBaseOutInfo, RunCrankInfo
swap_base_in_value: Option<SwapInstructionBaseIn>
swap_base_out_value: Option<SwapInstructionBaseOut>

​

Where to go next

• Accounts — for account field layouts and sizes.
• Math — for the lookup-table interpolation logic.
• Code demos — to see how to call these from the SDK.

• raydium-stable/program/src/instruction.rs (enum and pack/unpack)
• raydium-stable/program/src/processor.rs (execution logic)