Инструкции 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.

​

Перечень инструкций

​

Initialize

nonce: u8
open_time: u64

• model_data_account должен быть уже создан и инициализирован предыдущим вызовом InitModelData.
• lp_mint должен быть пуст (нулевое предложение).
• Vaults должны существовать и быть владены amm_authority.

• AmmInfo инициализируется со всеми ссылками.
• TargetOrders обнуляется и готов к первому MonitorStep.
• Начальные LP токены выпускаются и отправляются на user_dest_lp_token.
• Ордера OpenBook еще не размещены; первый MonitorStep их размещает.

​

InitModelData

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

• model_data_account должен быть достаточно большим (~1,2 MB для 50k × 24 bytes).
• model_data_account должен быть владен программой Stable.

• status = Initialized.
• multiplier установлен.
• valid_data_count = 0 (элементы еще не заполнены; вызовите UpdateModelData для добавления).
• Массив elements обнулен.

​

UpdateModelData

array_data: [UpdateModelData; 5]

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

• amm_admin должен совпадать с AmmInfo.amm_admin.
• Каждый индекс в array_data должен быть корректным (в пределах 50,000).
• Элементы должны быть отсортированы (не проверяется в цепи для скорости): x по возрастанию, y по убыванию, цена по возрастанию.

• Элементы записываются в model_data_account.elements[index] для каждого входа.
• valid_data_count обновляется до максимального индекса + 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 токены для сжигания

• user_lp_token_account содержит минимум amount.

• amount LP токенов сжигаются.
• Пользователь получает количества coin и pc согласно текущей pro-rata, с учетом накопленных комиссий.

​

SwapBaseIn

amount_in: u64
minimum_amount_out: u64

• amm.status позволяет swap.
• user_source_token содержит ≥ amount_in.

• Пользователь теряет amount_in, получает amount_out ≥ minimum_amount_out.
• Комиссии пула увеличивают счетчики need_take_pnl_*.
• Ордера OpenBook могут быть исполнены, если заполнены.

​

SwapBaseOut

max_amount_in: u64
amount_out: u64

​

MonitorStep

plan_order_limit: u16
place_order_limit: u16
cancel_order_limit: u16

• Ссылки на аккаунты OpenBook должны совпадать с привязанным рынком пула.

• Ожидающие заполнения OpenBook обрабатываются в vaults пула.
• Новые лимит-ордера размещаются на OpenBook на основе кривой таблицы поиска.
• TargetOrders обновляется.

​

SetParams

param: u8              // какой параметр изменить (Status, State, Fees, и т.д.)
value: Option<u64>    // новое значение (если param числовой)
new_pubkey: Option<Pubkey>  // новый адрес (если param ключ аккаунта)
fees: Option<Fees>    // новые комиссии (если param Fees)

• param = 0 (Status) — изменить маску операций.
• param = 9 (Fees) — изменить trade_fee, pnl split и т.д.
• param = 11 (ModelDataKey) — переподключить таблицу поиска (редко, требует действия администратора).

​

WithdrawPnl

• pnl_admin должен быть авторизован.

• need_take_pnl_coin и need_take_pnl_pc передаются на аккаунты администратора.
• Счетчики обнуляются.

​

WithdrawSrm

amount: u64

​

SimulateInfo

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

​

Что дальше

• Аккаунты — для макетов и размеров полей аккаунтов.
• Математика — для логики интерполяции таблицы поиска.
• Примеры кода — чтобы увидеть, как вызывать это из SDK.

• raydium-stable/program/src/instruction.rs (enum и pack/unpack)
• raydium-stable/program/src/processor.rs (логика выполнения)