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           // initial price
open_time:      u64            // swaps rejected before this time

• 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 から初期化されます（5つのキャリブレーションパラメータがコピーされ、状態フィールドはゼロになります）。
• それ以外の場合：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              // desired L (or 0 to use amounts below)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // write NFT metadata (Metaplex)
base_flag: Option<bool>       // true = fit to amount0; false = fit to amount1

• tick_lower < tick_upper、両方とも pool.tick_spacing の倍数で、[MIN_TICK, MAX_TICK] の範囲内。
• 必要なティックアレイが渡され、初期化済みであること（またはトランザクション内の InitTickArray CPIでここで作成）。
• ユーザーのソースATAに少なくとも amount_0_max と amount_1_max があること。

• personal_position が存在し、liquidity が設定され、fee_growth_inside_last がスナップショットされています。
• tick_lower と tick_upper のティックアレイエントリが更新されます（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（レンジ内の場合）、およびエンドポイントティックの 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ミントアカウントと personal_position アカウントを閉じ、payer にレントを返金します。

​

SwapV2

amount: u64                  // input if is_base_input=true, output otherwise
other_amount_threshold: u64  // min out or max in
sqrt_price_limit_x64: u128   // hard bound; 0 ⇒ unbounded
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 のフィルター・減衰ルールを使用）、AmmConfig.trade_fee_rate に dynamic_fee_component を上乗せします。合計手数料は10%上限です（MAX_FEE_RATE_NUMERATOR / 1_000_000）。
2. 指値注文マッチング — 価格ウォークがオープン指値注文を保持するティックを横断すると、プログラムはまずそのティックで利用可能な指値注文流動性を約定させ（order_phase によるFIFO）、その後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       // user's chosen nonce-account index (0..255 per wallet)
zero_for_one:   bool     // true: sell token0 for token1; false: sell token1 for token0
tick_index:     i32      // must be a multiple of pool.tick_spacing
amount:         u64      // input-token amount

• 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    // additional input-token amount

• limit_order.owner == signer。
• 注文が同じコホートに属していること（tick.order_phase == limit_order.order_phase）。コホートが既に約定を開始している場合、注文は部分的に決済されています。呼び出し元はまず DecreaseLimitOrder または SettleLimitOrder を呼び出してロールフォワードしてください。

• オーナーATAから input_vault へ amount を転送します。
• limit_order.total_amount += amount；tick.orders_amount += amount。

​

DecreaseLimitOrder

amount:     u64    // input-token amount to withdraw (max = unfilled remainder)
amount_min: u64    // slippage floor on the input-side withdrawal

• オープン以降のコホートの 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   // seconds; e.g. 30
decay_period:                u16   // seconds; e.g. 600. Must be > filter_period
reduction_factor:            u16   // 1..10_000; e.g. 5_000 = 50% retention per decay window
dynamic_fee_control:         u32   // 1..100_000; gain on the volatility-to-fee curve
max_volatility_accumulator:  u32   // ceiling

​

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) 分のリワードトークンをボルトに預け入れます。
• 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