Instrucciones Stable AMM

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.

​

Inventario de instrucciones

​

Initialize

nonce: u8
open_time: u64

• model_data_account debe estar ya creada e inicializada por un InitModelData previo.
• lp_mint debe estar vacía (suministro cero).
• Las bóvedas deben existir y ser propiedad de amm_authority.

• AmmInfo se inicializa con todas las referencias.
• TargetOrders se pone en cero y está listo para el primer MonitorStep.
• Los tokens LP iniciales se acuñan y se envían a user_dest_lp_token.
• Las órdenes OpenBook aún no se han publicado; el primer MonitorStep las publica.

​

InitModelData

multiplier: u64       // factor de escala (p. ej., 10^6)

• model_data_account debe ser suficientemente grande (~1.2 MB para 50k × 24 bytes).
• model_data_account debe ser propiedad del programa Stable.

• status = Initialized.
• multiplier se establece.
• valid_data_count = 0 (sin elementos rellenados aún; llamar a UpdateModelData para agregarlos).
• El array elements se pone en cero.

​

UpdateModelData

array_data: [UpdateModelData; 5]

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

• amm_admin debe coincidir con AmmInfo.amm_admin.
• Cada índice en array_data debe ser válido (dentro de 50,000).
• Las entradas deben estar ordenadas (no se valida en cadena por velocidad): x ascendente, y descendente, precio ascendente.

• Los elementos se escriben en model_data_account.elements[index] para cada entrada.
• valid_data_count se actualiza al índice máximo escrito + 1.

​

Deposit

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

​

Withdraw

amount: u64            // tokens LP a quemar

• user_lp_token_account contiene al menos amount.

• Se queman amount tokens LP.
• El usuario recibe cantidades de coin y pc según el pro-rata actual, ajustado por comisiones acumuladas.

​

SwapBaseIn

amount_in: u64
minimum_amount_out: u64

• amm.status permite swap.
• user_source_token contiene ≥ amount_in.

• El usuario pierde amount_in, gana amount_out ≥ minimum_amount_out.
• Las comisiones del pool incrementan los contadores need_take_pnl_*.
• Las órdenes OpenBook pueden liquidarse si se cumplen.

​

SwapBaseOut

max_amount_in: u64
amount_out: u64

​

MonitorStep

plan_order_limit: u16
place_order_limit: u16
cancel_order_limit: u16

• Las referencias de cuenta OpenBook deben coincidir con el mercado vinculado del pool.

• Los rellenos OpenBook pendientes se liquidan en las bóvedas del pool.
• Se publican nuevas órdenes limitadas en OpenBook basadas en la curva de tabla de búsqueda.
• Se actualiza TargetOrders.

​

SetParams

param: u8              // qué parámetro cambiar (Status, State, Fees, etc.)
value: Option<u64>    // nuevo valor (si param es numérico)
new_pubkey: Option<Pubkey>  // nueva dirección (si param es una clave de cuenta)
fees: Option<Fees>    // nuevas comisiones (si param es Fees)

• param = 0 (Status) — cambiar la máscara de operación.
• param = 9 (Fees) — cambiar trade_fee, división de pnl, etc.
• param = 11 (ModelDataKey) — revincular la tabla de búsqueda (raro, requiere acción del admin).

​

WithdrawPnl

• pnl_admin debe estar autorizado.

• need_take_pnl_coin y need_take_pnl_pc se transfieren a las cuentas del admin.
• Los contadores se ponen en cero.

​

WithdrawSrm

amount: u64

​

SimulateInfo

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

​

Próximos pasos

• Cuentas — para diseños y tamaños de campos de cuenta.
• Matemáticas — para la lógica de interpolación de tabla de búsqueda.
• Demostraciones de código — para ver cómo llamar a estas desde el SDK.

• raydium-stable/program/src/instruction.rs (enum y pack/unpack)
• raydium-stable/program/src/processor.rs (lógica de ejecución)