Инструкции CLMM

​

Список инструкций

​

CreatePool

sqrt_price_x64: u128           // начальная цена
open_time:      u64            // swap-операции отклоняются до этого времени

• token_mint_0 < token_mint_1 по порядку байт.
• amm_config.disable_create_pool == false.
• Минты не отклонены белым списком расширений Token-2022.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (позиций ещё нет).
• pool_state.fee_on = FromInput (устаревшее значение по умолчанию).
• pool_state.dynamic_fee_info обнулён (динамическая комиссия отключена).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on устанавливается в выбранный вариант CollectFeeOn.
• Если динамическая комиссия включена: pool_state.dynamic_fee_info инициализируется из переданного DynamicFeeConfig (копируются пять калибровочных параметров; поля состояния обнуляются).
• В противном случае: pool_state.dynamic_fee_info обнулён (динамическая комиссия навсегда неактивна для этого пула).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // желаемое L (или 0 — использовать суммы ниже)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // записать метаданные NFT (Metaplex)
base_flag: Option<bool>       // true = подогнать под amount0; false = подогнать под amount1

• tick_lower < tick_upper, оба кратны pool.tick_spacing, в диапазоне [MIN_TICK, MAX_TICK].
• Требуемые массивы тиков переданы и инициализированы (или созданы здесь через CPI InitTickArray в транзакции).
• У пользователя не менее amount_0_max и amount_1_max в исходных ATA.

• personal_position существует, liquidity установлено, fee_growth_inside_last зафиксировано.
• Записи массива тиков на tick_lower и tick_upper обновлены (liquidity_gross += L, liquidity_net ± L, снимки роста комиссий сохранены).
• pool_state.liquidity += L, если позиция в диапазоне (tick_lower ≤ tick_current < tick_upper).

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• Переводит amount_0_actual / amount_1_actual от пользователя в хранилища.
• Увеличивает personal_position.liquidity и pool_state.liquidity (если в диапазоне), а также liquidity_gross / liquidity_net граничных тиков.
• Собирает комиссии и вознаграждения, накопленные с последнего обращения, и зачисляет их в tokens_fees_owed_{0,1} / reward_amount_owed. Выплата происходит только при вызове DecreaseLiquidity или CollectReward, но не при увеличении позиции.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Вычисляет (amount_0, amount_1) для удалённого L при текущем sqrt_price_x64.
• Начисляет комиссии и вознаграждения, накопленные с последнего обращения, — аналогично IncreaseLiquidity.
• Переводит amount_0 + fees_owed_0 и amount_1 + fees_owed_1 из хранилищ пользователю.
• Уменьшает счётчики ликвидности; если новое personal_position.liquidity == 0, позицию можно закрыть через ClosePosition.

​

ClosePosition

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Все счётчики вознаграждений reward_amount_owed == 0.

• Сжигает NFT.
• Закрывает аккаунт минта NFT и аккаунт personal_position, возвращая ренту payer.

​

SwapV2

amount: u64                  // ввод при is_base_input=true, вывод иначе
other_amount_threshold: u64  // минимум вывода или максимум ввода
sqrt_price_limit_x64: u128   // жёсткая граница; 0 ⇒ без ограничений
is_base_input: bool

• pool_state.status разрешает swap.
• now >= open_time.
• sqrt_price_limit_x64 находится на корректной стороне от sqrt_price_x64 для выбранного направления.

1. Надбавка динамической комиссии — если pool.dynamic_fee_info ненулевой, программа обновляет аккумулятор волатильности, используя расстояние по тикам, пройденное с момента последнего swap (с правилами фильтра/затухания из products/clmm/fees), и добавляет dynamic_fee_component поверх AmmConfig.trade_fee_rate. Суммарная комиссия ограничена 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Исполнение лимитных ордеров — когда обход цены пересекает тик с открытыми лимитными ордерами, программа сначала исполняет доступную ликвидность лимитных ордеров на этом тике (FIFO по order_phase), затем продолжает по кривой ликвидности LP. Исполненные суммы обновляют tick.unfilled_ratio_x64 и tick.part_filled_orders_remaining для последующего расчёта; сами ордера остаются незавершёнными до тех пор, пока владелец не вызовет SettleLimitOrder.
3. Маршрутизация комиссий на одну сторону — при pool.fee_on = Token0Only или Token1Only шаг swap по-прежнему вычисляет то же соотношение ввода и вывода; комиссия затем направляется на настроенную сторону. Для направлений, где настроенная сторона комиссии является выводом, комиссия вычитается из вывода swap (пользователь получает out − fee); для направлений, где это ввод, поведение совпадает с FromInput. См. is_fee_on_input(zero_for_one) и is_fee_on_token0(zero_for_one) на PoolState.

​

OpenLimitOrder

nonce_index:    u8       // выбранный пользователем индекс nonce-аккаунта (0..255 на кошелёк)
zero_for_one:   bool     // true: продать token0 за token1; false: продать token1 за token0
tick_index:     i32      // должен быть кратен pool.tick_spacing
amount:         u64      // количество входного токена

• tick_index % pool.tick_spacing == 0 и в диапазоне [MIN_TICK, MAX_TICK].
• tick_index находится на правильной стороне от pool.tick_current для выбранного направления (продажа token0 → тик должен быть выше текущего, и наоборот). Продажа на уже пройденном тике будет немедленно исполнена и отклонена.
• pool_state.status разрешает операцию с лимитным ордером (бит 5).

• limit_order существует, зафиксированы tick.order_phase и tick.unfilled_ratio_x64 на момент открытия.
• tick.orders_amount += amount (в текущей когорте).
• limit_order_nonce.order_nonce += 1.
• Эмитировано OpenLimitOrderEvent.

​

IncreaseLimitOrder

amount: u64    // дополнительное количество входного токена

• limit_order.owner == signer.
• Ордер всё ещё находится в той же когорте (tick.order_phase == limit_order.order_phase). Если когорта уже начала исполняться, ордер частично завершён — вызывающему следует сначала вызвать DecreaseLimitOrder или SettleLimitOrder для продвижения вперёд.

• Переводит amount из ATA владельца в input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // количество входного токена для вывода (максимум = неисполненный остаток)
amount_min: u64    // нижняя граница slippage для вывода входной стороны

• Пересчитывает исполненную сумму ордера по unfilled_ratio_x64 когорты с момента открытия.
• Отправляет исполненный вывод на output_token_account.
• Возвращает amount неисполненного ввода на input_token_account.
• Соответственно обновляет limit_order. Если новый неисполненный остаток равен нулю, программа закрывает аккаунт и возвращает ренту owner.

​

SettleLimitOrder

• Вычисляет накопленный вывод по (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• Переводит дельту на output_token_account.
• Обновляет limit_order.settled_output.
• Не закрывает ордер; он остаётся открытым против любого оставшегося ввода.

​

CloseLimitOrder

• Неисполненный остаток ордера равен нулю (либо amount == total_amount было исполнено и рассчитано, либо владелец ранее уменьшил ордер до нуля и забыл закрыть).

• Закрывает limit_order; рента отправляется limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // секунды; например 30
decay_period:                u16   // секунды; например 600. Должен быть > filter_period
reduction_factor:            u16   // 1..10_000; например 5_000 = удержание 50% за окно затухания
dynamic_fee_control:         u32   // 1..100_000; усиление на кривой волатильность→комиссия
max_volatility_accumulator:  u32   // верхняя граница

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

• На пуле активно менее 3 потоков.
• Фандер вносит total_emission = emissions_per_second × (end_time − open_time) токенов вознаграждения в хранилище в рамках этой инструкции.
• Минт вознаграждения входит в белый список operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Начисляет рост вознаграждений (по той же схеме, что и комиссии).
• Переводит причитающуюся сумму на ATA получателя, обнуляет reward_amount_owed[i].

​

Матрица изменения состояния

​

Что дальше

• products/clmm/code-demos — запускаемые примеры на TypeScript.
• products/clmm/fees — подробности о начислении комиссий и вознаграждений.
• reference/error-codes — полная таблица Anchor-ошибок CLMM.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2