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.

​

手續費等級

​

每筆 swap 的手續費分配

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

​

動態手續費

​

狀態

​

每次 swap 的更新流程

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. 計算附加費率。附加費率與累積器呈二次方關係（因為標準公式中 swap 的「tick 距離」是平方項），並由 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 個區塊的費率也可能改變——每筆 swap 都會移動波動率累積器。Trade API 的報價僅在報價區塊有效；若反應靈敏的池子在報價與執行之間觸發更新，實際費率可能偏差數個基點。
• volatility_accumulator 與 last_update_timestamp 均為鏈上公開資料——用戶端可在離線模擬時於客戶端側重現計算公式。

​

倉位手續費記帳

• fee_growth_inside_0_last_x64 與 fee_growth_inside_1_last_x64——該快照時刻的範圍專屬手續費成長值。

1. 程式從全域手續費成長值及兩個端點 tick 的 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 互動

• swap 輸入 mint 的轉帳手續費。 池子收到 amount_in − mint_transfer_fee。CLMM 程式的步驟輸入基於淨額計算，因此池子的手續費累積器反映的是實際進入金庫的代幣。
• 輸出 mint 的轉帳手續費。 池子發送 amount_out，使用者收到 amount_out − mint_transfer_fee。滑點檢查應以使用者實際收到的金額為基準。
• 獎勵 mint 的轉帳手續費。 獎勵以 InitializeReward 時「存入金庫」的單位計算（資金提供方已支付存入時的 mint 轉帳手續費）。CollectReward 提取時會再次產生 mint 轉帳手續費；LP 應預期在轉帳手續費獎勵代幣上有輕微折扣。
• 不可轉讓／機密／群組成員 mint。 在 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——搭配轉帳手續費 mint 進行報價。
• reference/fee-comparison——CLMM／CPMM／AMM-v4 手續費對照表。

• raydium-io/raydium-clmm — states/pool.rs, libraries/fixed_point_64.rs
• “Uniswap v3 Core” 白皮書，第 7 節（手續費成長）