Instruções do 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.

​

Inventário de instruções

​

Initialize

nonce: u8
open_time: u64

• model_data_account deve já estar criada e inicializada por um InitModelData anterior.
• lp_mint deve estar vazio (oferta zero).
• Os cofres devem existir e ser de propriedade de amm_authority.

• AmmInfo é inicializado com todas as referências.
• TargetOrders é zerado e pronto para o primeiro MonitorStep.
• Tokens LP iniciais são cunhados e enviados para user_dest_lp_token.
• Pedidos do OpenBook ainda não foram postados; o primeiro MonitorStep os posta.

​

InitModelData

multiplier: u64       // fator de escala (p. ex., 10^6)

• model_data_account deve ser suficientemente grande (~1,2 MB para 50k × 24 bytes).
• model_data_account deve ser de propriedade do programa Stable.

• status = Initialized.
• multiplier é definido.
• valid_data_count = 0 (nenhum elemento populado ainda; chame UpdateModelData para adicioná-los).
• Array elements é zerado.

​

UpdateModelData

array_data: [UpdateModelData; 5]

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

• amm_admin deve corresponder a AmmInfo.amm_admin.
• Cada índice em array_data deve ser válido (dentro de 50.000).
• As entradas devem estar ordenadas (não validadas em cadeia por velocidade): x ascendente, y descendente, preço ascendente.

• Elementos são escritos em model_data_account.elements[index] para cada entrada.
• valid_data_count é atualizado para o máximo índice escrito + 1.

​

Deposit

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

​

Withdraw

amount: u64            // tokens LP a queimar

• user_lp_token_account contém pelo menos amount.

• amount tokens LP são queimados.
• Usuário recebe quantias de coin e pc de acordo com a pro-rata atual, ajustada para taxas acumuladas.

​

SwapBaseIn

amount_in: u64
minimum_amount_out: u64

• amm.status permite swap.
• user_source_token contém ≥ amount_in.

• Usuário perde amount_in, ganha amount_out ≥ minimum_amount_out.
• Taxas do pool incrementam contadores need_take_pnl_*.
• Pedidos do OpenBook podem ser liquidados se preenchidos.

​

SwapBaseOut

max_amount_in: u64
amount_out: u64

​

MonitorStep

plan_order_limit: u16
place_order_limit: u16
cancel_order_limit: u16

• As referências de conta do OpenBook devem corresponder ao mercado vinculado do pool.

• Preenchimentos pendentes do OpenBook são liquidados nos cofres do pool.
• Novos pedidos de limite são postados no OpenBook com base na curva da tabela de consulta.
• TargetOrders é atualizado.

​

SetParams

param: u8              // qual parâmetro alterar (Status, State, Fees, etc.)
value: Option<u64>    // novo valor (se param for numérico)
new_pubkey: Option<Pubkey>  // novo endereço (se param for uma chave de conta)
fees: Option<Fees>    // novas taxas (se param for Fees)

• param = 0 (Status) — alterar a máscara de operação.
• param = 9 (Fees) — alterar trade_fee, divisão de pnl, etc.
• param = 11 (ModelDataKey) — rebind à tabela de consulta (raro, requer ação do admin).

​

WithdrawPnl

• pnl_admin deve estar autorizado.

• need_take_pnl_coin e need_take_pnl_pc são transferidos para as contas do admin.
• Os contadores são zerados.

​

WithdrawSrm

amount: u64

​

SimulateInfo

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

​

Próximos passos

• Contas — para layouts e tamanhos dos campos de conta.
• Matemática — para a lógica de interpolação da tabela de consulta.
• Demos de código — para ver como chamar estas do SDK.

• raydium-stable/program/src/instruction.rs (enum e pack/unpack)
• raydium-stable/program/src/processor.rs (lógica de execução)