CLMM 指令

​

指令一覽

​

CreatePool

sqrt_price_x64: u128           // 初始價格
open_time:      u64            // 此時間前拒絕交換

• token_mint_0 < token_mint_1（依位元組順序排列）。
• amm_config.disable_create_pool == false。
• Mint 未被 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] 範圍內。
• 所需 tick array 已傳入並初始化（或在此交易中透過 InitTickArray CPI 建立）。
• 使用者來源 ATA 中至少持有 amount_0_max 及 amount_1_max。

• personal_position 已存在，liquidity 已設定，fee_growth_inside_last 已快照。
• tick_lower 和 tick_upper 的 tick-array 條目已更新（liquidity_gross += L、liquidity_net ± L、費用增長快照維護）。
• 若倉位在範圍內（tick_lower ≤ tick_current < tick_upper），則 pool_state.liquidity += L。

​

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（若在範圍內），並相應調整端點 tick 的 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

• 依當前 sqrt_price_x64 計算移除 L 所對應的 (amount_0, amount_1)。
• 結算自上次觸碰以來累積的手續費／獎勵，方式與 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 mint 帳戶及 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 允許交換。
• now >= open_time。
• sqrt_price_limit_x64 位於當前 sqrt_price_x64 在該方向的正確一側。

1. 動態費用附加 — 若 pool.dynamic_fee_info 非零，程式依自上次交換以來穿越的 tick 距離更新波動性累加器（套用 products/clmm/fees 中的過濾／衰減規則），並在 AmmConfig.trade_fee_rate 之上加入 dynamic_fee_component。總費率上限為 10%（MAX_FEE_RATE_NUMERATOR / 1_000_000）。
2. 限價單撮合 — 當價格行走穿越持有開放限價單的 tick 時，程式先按 order_phase FIFO 順序成交該 tick 的限價單流動性，再繼續沿 LP 流動性曲線行走。已成交金額更新 tick.unfilled_ratio_x64 及 tick.part_filled_orders_remaining，供後續結算使用；訂單本身保持未動，直至擁有者呼叫 SettleLimitOrder。
3. 單側費用路由 — 當 pool.fee_on = Token0Only 或 Token1Only 時，交換步驟仍計算相同的輸入輸出交易；費用隨後路由至設定的一側。若設定的費用側為輸出端，費用從交換輸出中扣除（使用者收到 out − fee）；若為輸入端，行為與 FromInput 相同。請參閱 PoolState 上的 is_fee_on_input(zero_for_one) 及 is_fee_on_token0(zero_for_one)。

​

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 → tick 必須在當前之上，反之亦然）。在已穿越的 tick 掛單會立即被撮合，因此會被拒絕。
• 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 以向前推進。

• 從擁有者 ATA 轉入 amount 至 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

​

InitializeReward

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

• 池目前啟用的獎勵流少於 3 個。
• 資助方在此指令執行時向保險庫存入 total_emission = emissions_per_second × (end_time − open_time) 數量的獎勵代幣。
• 獎勵 mint 已依 operation_state 加入白名單。

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• 結算獎勵增長（方式與手續費相同）。
• 將應付金額轉至接收方 ATA，並將 reward_amount_owed[i] 歸零。

​

狀態變更矩陣

​

下一步

• products/clmm/code-demos — 可執行的 TypeScript 範例。
• products/clmm/fees — 手續費與獎勵累積詳情。
• reference/error-codes — 完整的 CLMM Anchor 錯誤代碼表。

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