Инструкции CLMM

​

Инвентарь инструкций

​

CreatePool

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

• 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 обнулен (= динамическая комиссия неактивна навсегда для этого пула).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // то же самое, что CreateCustomizablePool
seed_index:          u16                          // должен быть ненулевым; встроен в семена PDA пула

• seed_index != 0. seed_index из 0 зарезервирован для устаревших пулов и отклоняется здесь; компонент семени [0, 0] — это то, что заставляет адрес устаревшего пула свернуться в классическую четырехсемейную форму.
• PDA permission для payer существует (создан администратором через CreatePermissionPda).
• Те же правила монет/белого списка, что и CreatePool.

• Новый pool_state существует по адресу, выведенному из seed_index, с pool_state.seed_index = seed_index.
• Все остальное состояние соответствует CreateCustomizablePool (режим комиссии, опциональная динамическая комиссия).

​

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).
• Минт NFT позиции записывает pool_state как полномочие заморозки. Полномочие минта удаляется после выпуска одного NFT. Запись полномочия заморозки не изменяет состояние аккаунта токена NFT.
• Аккаунт токена NFT остается разморозенным, если инструкция не является OpenPositionV2 или OpenPositionWithToken22Nft и полномочие заморозки хранилища совпадает со списком ограниченных издателей CLMM. Только этот соответствующий путь V2 замораживает аккаунт. OpenPosition V1 не замораживает.

​

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

• Разморозенный NFT: ничего не требуется; дополнительный аккаунт пула безвреден, потому что обработчик его не читает.
• Замороженный NFT: добавить personal_position.pool_id как первый оставшийся аккаунт. Программа загружает его как PoolState и использует его семена PDA для подписания разморозки.

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

• Если аккаунт токена NFT заморожен, проверяет, что первый оставшийся аккаунт равен personal_position.pool_id, затем размораживает его с помощью PDA пула.
• Сжигает NFT.
• Закрывает аккаунт токена NFT и personal_position, возвращая арендную плату nft_owner. Если NFT позиции использует Token-2022, он также закрывает минт NFT; классические минты SPL Token не могут быть закрыты и остаются с нулевым предложением.

​

SwapV2

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

• pool_state.status позволяет своп.
• now >= open_time.
• sqrt_price_limit_x64 находится на правильной стороне sqrt_price_x64 для направления.

1. Надбавка за динамическую комиссию — если pool.dynamic_fee_info ненулевой, программа обновляет накопитель волатильности, используя расстояние тика, пройденное с последнего своп (с правилами фильтра/затухания из 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, шаг своп все еще вычисляет одинаковый вход-выход торговли; комиссия затем маршрутизируется на настроенную сторону. Для направлений, где настроенная сторона комиссии является выходом, комиссия вычитается из выхода своп (пользователь получает 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      // сумма входного токена

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

• 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    // пол проскальзывания на выводе входной стороны

• Пересчитывает заполненную сумму ордера из 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