CLMM 指令参考

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.

​

指令总览

​

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 数组已传入并初始化（或在本交易中通过 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 从用户转入 vault。
• 递增 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 从 vault 转出给用户。
• 递减流动性计数器；若新的 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 时，程序优先以 FIFO 顺序（按 order_phase）成交该 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 推进状态。

• 将 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) 数量的奖励代币存入 vault。
• 奖励 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