Phí và phần thưởng 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.

​

Các mức phí

​

Phân chia phí mỗi lần 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 được đưa vào fee_growth_global_{input_side}_x64 theo tỷ lệ với thanh khoản đang hoạt động: fee_growth_global += step_lp × 2^64 / pool.liquidity.
• step_protocol tích lũy vào PoolState.protocol_fees_token_{input_side} — được thu qua CollectProtocolFee.
• step_fund tích lũy vào PoolState.fund_fees_token_{input_side} — được thu qua CollectFundFee.

​

Lý do phí được tính theo từng phía

​

Phí một chiều (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

​

Phí động

​

Trạng thái

​

Cập nhật mỗi lần swap

1. Phân rã tham chiếu. Nếu now - last_update_timestamp > filter_period, tham chiếu biến động sẽ phân rã:
   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. Cập nhật bộ tích lũy. Bộ tích lũy mới là tham chiếu cộng với khoảng cách tuyệt đối đã đi qua (theo đơn vị tick_spacing), nhân với hệ số độ chi tiết, và bị giới hạn ở mức tối đa đã cấu hình:
   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. Tính phụ phí. Phụ phí có dạng parabol theo bộ tích lũy (vì “khoảng cách tick” của swap được bình phương trong công thức chuẩn), có hệ số khuếch đại là 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
   

​

Lựa chọn tham số

​

LP thấy gì

​

Điều integrator cần biết

• Phí mà một quote trả về có thể thay đổi giữa block N và block N+1 dù dự trữ pool chưa dịch chuyển — mỗi swap đều thay đổi bộ tích lũy biến động. Các quote từ Trade API có giá trị tại block lúc quote và có thể lệch vài bps nếu pool phản ứng nhanh bị kích hoạt giữa quote và thực thi.
• volatility_accumulator và last_update_timestamp là public trên chuỗi — client có thể tái hiện công thức phía client để mô phỏng ngoại tuyến.

​

Hạch toán phí trên từng vị thế

• fee_growth_inside_0_last_x64 và fee_growth_inside_1_last_x64 — mức tăng trưởng phí theo phạm vi tại snapshot đó.

1. Chương trình tính lại fee_growth_inside_{0,1}_x64 từ fee growth toàn cục và hai tick endpoint fee_growth_outside_*.
2. Δ được cộng vào tokens_fees_owed_{0,1} theo trọng số thanh khoản của vị thế:
   Δ_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 được cập nhật.

​

Vị thế ngoài phạm vi không kiếm được gì

​

Luồng phần thưởng

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
}

​

Vòng lặp quyết toán

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)

​

Tích lũy phần thưởng trên từng vị thế

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

​

Chỉ vị thế trong phạm vi mới nhận phần thưởng

​

Nạp vốn và kết thúc luồng

​

Thu phí quản trị

​

Tương tác với Token-2022

• Transfer fee trên mint đầu vào của swap. Pool nhận được amount_in − mint_transfer_fee. Đầu vào bước của chương trình CLMM được tính theo số tiền thực, nên các bộ tích lũy phí của pool phản ánh token thực sự trong vault.
• Transfer fee trên mint đầu ra. Pool gửi amount_out; người dùng nhận được amount_out − mint_transfer_fee. Kiểm tra slippage nên thực hiện dựa trên số tiền người dùng thực nhận.
• Transfer fee trên reward mint. Phát thải được tính theo đơn vị “vào-vault” tại thời điểm InitializeReward (người nạp trả transfer fee mint vào vault). Khi rút qua CollectReward sẽ phát sinh thêm một lần transfer fee; LP nên kỳ vọng bị khấu trừ một phần nhỏ khi nhận token phần thưởng có transfer fee.
• Mint không thể chuyển / bảo mật / thành viên nhóm. Bị từ chối tại CreatePool / InitializeReward.

​

Đọc phí và phần thưởng ngoại tuyến

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()));
}

​

Đọc thêm

• products/clmm/math — dẫn xuất đầy đủ của fee_growth_inside.
• products/clmm/instructions — danh sách tài khoản cho CollectReward, InitializeReward, SetRewardParams.
• algorithms/token-2022-transfer-fees — định giá với mint có transfer fee.
• reference/fee-comparison — ma trận so sánh phí CLMM/CPMM/AMM-v4.

• raydium-io/raydium-clmm — states/pool.rs, libraries/fixed_point_64.rs
• “Uniswap v3 Core” whitepaper, §7 (fee growth)