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.

​

手数料ティア

​

スワップごとの手数料分配

step_trade_fee   = ceil(step_input * trade_fee_rate / 1_000_000)
step_protocol    = floor(step_trade_fee * protocol_fee_rate / 1_000_000)
step_fund        = floor(step_trade_fee * fund_fee_rate     / 1_000_000)
step_lp          = step_trade_fee - step_protocol - step_fund

• step_lp は現在のアクティブなリクイディティでスケールされ、fee_growth_global_{input_side}_x64 に流入します：fee_growth_global += step_lp × 2^64 / pool.liquidity
• step_protocol は PoolState.protocol_fees_token_{input_side} に累積され、CollectProtocolFee で回収されます。
• step_fund は PoolState.fund_fees_token_{input_side} に累積され、CollectFundFee で回収されます。

​

手数料がサイドごとである理由

​

片側手数料（CollectFeeOn）

pool.is_fee_on_input(zero_for_one: bool) -> bool   // true → fee is deducted from input
pool.is_fee_on_token0(zero_for_one: bool) -> bool  // for telemetry / accounting

​

ダイナミック手数料

​

状態

​

スワップごとの更新

1. リファレンスのデケイ。now - last_update_timestamp > filter_period の場合、ボラティリティリファレンスがデケイします：
   if elapsed > decay_period:
       volatility_reference = 0
   elif elapsed > filter_period:
       volatility_reference = volatility_accumulator * reduction_factor / 10_000
   # else: hold the previous reference
   
2. アキュムレータの更新。新しいアキュムレータはリファレンスに、移動した絶対距離（tick_spacing 単位）に粒度スケールを掛けた値を加算し、設定された最大値でキャップします：
   delta_idx     = abs(tick_spacing_index_reference - current_tick_spacing_index)
   accumulator   = volatility_reference + delta_idx * 10_000   // VOLATILITY_ACCUMULATOR_SCALE
   accumulator   = min(accumulator, max_volatility_accumulator)
   
3. サーチャージの計算。サーチャージはアキュムレータに対して放物線的（スワップの「ティック距離」は正規の計算式で二乗される）で、dynamic_fee_control でゲインスケールされます：
   fee_increment_rate = dynamic_fee_control * (accumulator * tick_spacing)^2
                      / (100_000 * 10_000^2)
   fee_rate           = AmmConfig.trade_fee_rate + fee_increment_rate
   fee_rate           = min(fee_rate, 100_000)              // 10% cap
   

​

パラメータの選択

​

LPから見た挙動

​

インテグレーターが知っておくべきこと

• クォートが返す手数料は、プールの準備金が変動していなくても、ブロックNとブロックN+1の間で変わる可能性があります。スワップのたびにボラティリティアキュムレータが更新されるためです。Trade APIのクォートはクォート時のブロックで有効であり、反応性の高いプールがクォートと実行の間に動いた場合、数bpsのズレが生じることがあります。
• volatility_accumulator と last_update_timestamp はオンチェーンで公開されているため、クライアントがオフラインシミュレーション用に計算式をクライアントサイドで再現できます。

​

ポジションごとの手数料会計

• fee_growth_inside_0_last_x64 と fee_growth_inside_1_last_x64 — そのスナップショット時点のレンジ固有の手数料成長。

1. プログラムはグローバル手数料成長と2つのエンドポイントティックの fee_growth_outside_* から fee_growth_inside_{0,1}_x64 を再計算します。
2. Δをポジションのリクイディティで重み付けして tokens_fees_owed_{0,1} に加算します：
   Δ_fee_growth_inside_0 = fee_growth_inside_now_0 - fee_growth_inside_last_0
   tokens_fees_owed_0  += Δ_fee_growth_inside_0 * position.liquidity / 2^64
   
3. fee_growth_inside_{0,1}_last_x64 が更新されます。

​

レンジ外ポジションは手数料を獲得しない

​

リワードストリーム

pub struct RewardInfo {
    pub reward_state: u8,               // Uninitialized | Initialized | Open | Ended
    pub open_time: u64,
    pub end_time: u64,
    pub last_update_time: u64,
    pub emissions_per_second_x64: u128, // Q64.64 reward tokens per second
    pub reward_total_emissioned: u64,
    pub reward_claimed: u64,
    pub token_mint:    Pubkey,
    pub token_vault:   Pubkey,
    pub authority:     Pubkey,           // who can SetRewardParams / fund
    pub reward_growth_global_x64: u128,  // accumulator, Q64.64
}

​

決済ループ

for each reward_info with state in {Open, Ended within grace}:
    elapsed         = min(now, end_time) − last_update_time
    if elapsed > 0 && pool.liquidity > 0:
        reward_growth_global_x64 += emissions_per_second_x64 × elapsed × 2^64 / pool.liquidity
        reward_total_emissioned  += emissions_per_second × elapsed
    last_update_time = min(now, end_time)

​

ポジションごとのリワード累積

for each stream i:
    reward_growth_inside_now_i   = compute_inside_i(pool, tick_lower, tick_upper)
    Δ_i = reward_growth_inside_now_i - personal_position.reward_infos[i].growth_inside_last_x64
    personal_position.reward_infos[i].reward_amount_owed += Δ_i * personal_position.liquidity / 2^64
    personal_position.reward_infos[i].growth_inside_last_x64 = reward_growth_inside_now_i

​

レンジ内ポジションのみリワードを獲得

​

ストリームの資金調達と終了

​

管理者による回収

​

Token-2022との相互作用

• スワップの入力ミントにトランスファーフィーがある場合。 プールが受け取るのは amount_in − mint_transfer_fee です。CLMMプログラムのステップ入力は純額に対して計算されるため、プールの手数料アキュムレータは実際にボールトに存在するトークンを反映します。
• アウトプットミントにトランスファーフィーがある場合。 プールは amount_out を送金し、ユーザーは amount_out − mint_transfer_fee を受け取ります。スリッページ確認はユーザーの受取金額に対して行う必要があります。
• リワードミントにトランスファーフィーがある場合。 排出は InitializeReward 時の「ボールトへの入金」単位で計算されます（資金調達者がミントのトランスファーフィーをボールトに支払います）。CollectReward での引き出し時にも別途ミントのトランスファーフィーが発生するため、LPはトランスファーフィー付きのリワードトークンで若干のカットが生じることを想定してください。
• 転送不可・機密・グループメンバーミント。 CreatePool / InitializeReward で拒否されます。

​

オフチェーンでの手数料とリワードの読み取り

const pool = await raydium.clmm.getPoolInfoFromRpc(poolId);
const position = await raydium.clmm.getOwnerPositionInfo({
  wallet: owner.publicKey,
});

for (const p of position) {
  console.log("Position", p.nftMint.toBase58(),
              "range", p.tickLower, "→", p.tickUpper,
              "L", p.liquidity.toString(),
              "fees owed:", p.tokenFeesOwed0.toString(),
              p.tokenFeesOwed1.toString(),
              "rewards owed:", p.rewardInfos.map(r => r.rewardAmountOwed.toString()));
}

​

次のステップ

• products/clmm/math — fee_growth_inside の完全な導出。
• products/clmm/instructions — CollectReward、InitializeReward、SetRewardParams のアカウント一覧。
• algorithms/token-2022-transfer-fees — トランスファーフィーミントを使ったクォーティング。
• reference/fee-comparison — CLMM/CPMM/AMM-v4の手数料マトリクスの比較。

• raydium-io/raydium-clmm — states/pool.rs, libraries/fixed_point_64.rs
• “Uniswap v3 Core” ホワイトペーパー、§7（手数料成長）