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. 프로그램은 글로벌 수수료 성장과 두 엔드포인트 틱의 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 (fee growth)