Инструкции CLMM

​

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

​

CreatePool

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

• token_mint_0 < token_mint_1 по порядку байтов.
• amm_config.disable_create_pool == false.
• Mints не отклоняются списком разрешений расширения 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).
• Те же правила mint / allow-list, что и 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].
• Два PDA массива тиков переданы. Они не должны уже существовать — get_or_create_tick_array выделяет отсутствующий за счёт payer внутри этой инструкции. Нет отдельной инструкции инициализации массива тиков.
• Пользователь имеет по крайней мере 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).
• Mint NFT позиции записывает pool_state как полномочие заморозки. Полномочие mint удаляется после выпуска единственного NFT. Запись полномочия заморозки не изменяет состояние аккаунта токена NFT.
• Аккаунт токена NFT остаётся разморозенным, если инструкция — это OpenPositionV2 или OpenPositionWithToken22Nft и полномочие заморозки любого mint хранилища совпадает со списком ограниченных издателей 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 конечного тика.
• Собирает комиссии и вознаграждения, причитающиеся с последнего касания, и кредитует их на token_fees_owed_{0,1} / reward_amount_owed. Они выплачиваются только на DecreaseLiquidity / DecreaseLiquidityV2, а не на увеличение — нет отдельной инструкции сбора.

​

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, он также закрывает mint NFT; классические mint 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 (администратор)

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 (администратор)

​

CollectProtocolFee / CollectFundFee