Phí CPMM

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.

​

Hai khoản phí độc lập, bốn địa chỉ đích

1. Phí giao dịch — được tính theo AmmConfig.trade_fee_rate và chia thành ba địa chỉ đích:
   • Phần LP — nằm trong vault và tăng k. Được yêu cầu ngầm bằng cách đốt token LP.
   • Phần giao thức — được tích lũy vào PoolState.protocol_fees_token*; được rút bởi protocol_owner thông qua CollectProtocolFee.
   • Phần quỹ — được tích lũy vào PoolState.fund_fees_token*; được rút bởi fund_owner thông qua CollectFundFee.
2. Phí nhà tạo (tùy chọn, cho mỗi pool) — được tính theo AmmConfig.creator_fee_rate độc lập với phí giao dịch, tích lũy vào PoolState.creator_fees_token*, được rút bởi pool_state.pool_creator thông qua CollectCreatorFee. Chỉ hoạt động khi pool được tạo với enable_creator_fee = true.

​

Tỷ lệ và đơn vị

• trade_fee_rate là một phân số của khối lượng swap. 2500 ⇒ 0.25% của phía liên quan (đầu vào hoặc đầu ra, tùy thuộc vào creator_fee_on — xem “Phía nào của giao dịch được tính phí” dưới đây).
• creator_fee_rate là một phân số của khối lượng swap, được tính riêng biệt từ phí giao dịch. 1000 ⇒ 0.10% của phía liên quan.
• protocol_fee_rate và fund_fee_rate là các phân số của phí giao dịch, không phải của khối lượng. 120_000 ⇒ 12% của phí giao dịch.

​

Cách chia, dưới dạng code

// Paraphrased from raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs.
// The actual code branches on `is_creator_fee_on_input`; both branches preserve the
// invariant that creator_fee is its own rate, never a slice of trade_fee.

const FEE_RATE_DENOMINATOR_VALUE: u64 = 1_000_000;

pub struct FeeBreakdown {
    pub amount_in_after_fees: u64,    // input minus all fees taken on the input side
    pub amount_out_after_fees: u64,   // output minus any creator fee taken on the output side
    pub trade_fee:    u64,            // → split into LP / protocol / fund buckets below
    pub protocol_fee: u64,            // share of trade_fee
    pub fund_fee:     u64,            // share of trade_fee
    pub creator_fee:  u64,            // independent bucket (input or output side)
}

fn take_fees_on_input(
    amount_in: u64,
    trade_rate: u64,
    creator_rate: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* trade_fee */, u64 /* creator_fee */, u64 /* amount_in_after_fees */) {
    // The two rates are added so we round once on the combined fee, then split
    // proportionally — this is purely a rounding/efficiency trick. The split
    // honours the rates exactly: creator_fee/trade_fee == creator_rate/trade_rate.
    let total_fee = ((amount_in as u128) * ((trade_rate + creator_rate) as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;

    let creator_fee = ((total_fee as u128) * (creator_rate as u128)
                       / ((trade_rate + creator_rate) as u128)) as u64;
    let trade_fee   = total_fee - creator_fee;

    (trade_fee, creator_fee, amount_in - total_fee)
}

fn take_creator_fee_on_output(amount_out_swapped: u64, creator_rate: u64) -> (u64, u64) {
    // When creator_fee_on routes the creator fee to the output side,
    // trade_fee is taken on input as a single rate, and creator_fee
    // is computed against the curve output.
    let creator_fee = ((amount_out_swapped as u128) * (creator_rate as u128))
        .div_ceil(FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (amount_out_swapped - creator_fee, creator_fee)
}

fn split_trade_fee(
    trade_fee: u64,
    protocol_rate: u64,
    fund_rate: u64,
) -> (u64 /* protocol_fee */, u64 /* fund_fee */) {
    let protocol_fee = (trade_fee as u128 * protocol_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    let fund_fee     = (trade_fee as u128 * fund_rate as u128
                        / FEE_RATE_DENOMINATOR_VALUE as u128) as u64;
    (protocol_fee, fund_fee)
}

• Tổng phí trên đầu vào làm tròn lên để pool không bao giờ tính phí thấp hơn.
• Các phân chia phụ của trade_fee (giao thức, quỹ) làm tròn xuống để tổng của chúng không bao giờ vượt quá trade_fee; phần còn lại là phần LP.
• lp_share = trade_fee − protocol_fee − fund_fee (creator_fee không bị trừ ở đây vì nó là hạng mục riêng).
• Phí nhà tạo được tính từ đầu vào hoặc đầu ra tùy thuộc vào PoolState.creator_fee_on (xem phần tiếp theo). Tỷ lệ không thay đổi dù là trường hợp nào.

​

Phía nào của giao dịch được tính phí

​

Cách các phí “tích lũy” tương tác với đường cong

raw_vault_0_balance = getTokenAccountBalance(vault_0).amount
                    = lp_entitled + protocol_fees_token0
                      + fund_fees_token0 + creator_fees_token0

curve_x = raw_vault_0_balance − (protocol_fees_token0
                                  + fund_fees_token0
                                  + creator_fees_token0)

• Trích dẫn từ số dư thô là sai. Nếu bạn xây dựng một quoter từ getTokenAccountBalance, bạn sẽ liên tục nêu quá cao giá mà pool sẽ chấp nhận. Luôn trừ các phí tích lũy, hoặc mô phỏng qua SwapBaseInput / API.
• CollectProtocolFee không di chuyển giá. Nó di chuyển token ra khỏi vault và làm không các bộ đếm protocol_fees_token*, nên curve_x và curve_y không thay đổi.
• Phí LP không tích lũy vào một bộ đếm. Chúng ngầm trong số dư vault. Quyền của LP đối với phí LP tích lũy được thực hiện bằng cách đốt token LP (tức là qua Withdraw) — không có CollectLpFee.

​

Tương tác với phí chuyển Token-2022

1. Phí chuyển của mint đầu vào trên amount_in (cho nhà cung cấp phí của mint).
2. trade_fee của pool trên phần còn lại (chia như trên).
3. Phí chuyển của mint đầu ra trên amount_out (cho nhà cung cấp phí của mint).

​

Phí nhà tạo

• Bật tại tạo pool. Initialize đặt enable_creator_fee = false theo mặc định; các pool được tạo qua InitializeWithPermission (được sử dụng bởi các tốt nghiệp LaunchLab và các đường dẫn được cấu hình khác) có thể chuyển enable_creator_fee = true và chọn creator_fee_on.
• Tỷ lệ được chia sẻ với tiers phí. Tỷ lệ tự nó là AmmConfig.creator_fee_rate, giá trị giống nhau trên mọi pool gắn với config đó. Mỗi pool sau đó quyết định có tính nó (enable_creator_fee) và phía nào của swap để tính nó (creator_fee_on). Khi enable_creator_fee = false, tỷ lệ phí nhà tạo hiệu dụng của pool là không có gì bất kể giá trị config (xem PoolState::adjust_creator_fee_rate trong source).
• Độc lập với phí giao dịch. Phí nhà tạo không bao giờ giảm các phần LP / giao thức / quỹ — nó là tỷ lệ riêng, được áp dụng riêng, tích lũy trong các bộ đếm riêng.
• Được rút qua CollectCreatorFee, ký bởi PoolState.pool_creator.
• Không thể được bật lại hoặc định tuyến lại sau tạo. Một pool được khởi tạo với enable_creator_fee = false sẽ không bao giờ tính phí nhà tạo; một pool được khởi tạo với creator_fee_on cụ thể không thể chuyển đổi phía.

​

Luồng hoạt động bộ sưu tập

​

Thay đổi một tiers phí

• Di chuyển một pool từ AmmConfig này sang AmmConfig khác.
• Tính giá lại các phí đã tích lũy.
• Sưu tập phí mà không có protocol_owner / fund_owner signer.

​

Đọc phí từ một pool đang chạy

// Off-chain: current accrued fees in each bucket
const pool = await connection.getAccountInfo(poolStatePda);
const decoded = PoolState.decode(pool.data);
console.log(
  "Protocol accrued:",
  decoded.protocolFeesToken0.toString(),
  decoded.protocolFeesToken1.toString(),
);
console.log(
  "Fund accrued:",
  decoded.fundFeesToken0.toString(),
  decoded.fundFeesToken1.toString(),
);
console.log(
  "Creator accrued:",
  decoded.creatorFeesToken0.toString(),
  decoded.creatorFeesToken1.toString(),
);

// Off-chain: effective rates today.
// trade_fee_rate, creator_fee_rate are fractions of volume (denominator 1e6).
// protocol_fee_rate, fund_fee_rate are fractions of the *trade fee* (same denominator).
const config = await fetch("https://api-v3.raydium.io/main/cpmm-config")
  .then((r) => r.json());
const tier = config.data.find((t) => t.index === decoded.ammConfigIndex);

const tradeFeeOfVolume   = tier.tradeFeeRate / 1_000_000;
const protocolOfTradeFee = tier.protocolFeeRate / 1_000_000;
const fundOfTradeFee     = tier.fundFeeRate / 1_000_000;
const lpOfTradeFee       = 1 - protocolOfTradeFee - fundOfTradeFee;

console.log("LP fee effective:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Protocol fee effective:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Fund fee effective:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Creator fee effective:",
  decoded.enableCreatorFee
    ? ((tier.creatorFeeRate / 1_000_000) * 100).toFixed(4) + " %"
    : "0 % (disabled on this pool)",
);

​

So sánh với CLMM và AMM v4

• AMM v4 sử dụng phí giao dịch cố định 0.25% với một phân chia LP/giao thức khác và không có phí quỹ.
• CLMM phí là cho mỗi tiers khoảng cách tick, tích lũy cho mỗi vị trí (không phải cho mỗi pool), và được yêu cầu qua DecreaseLiquidity hoặc CollectFees.

​

Đi đến đâu tiếp theo

• products/cpmm/math — nơi khấu trừ phí giao dịch kết nối với đường cong.
• products/cpmm/instructions — danh sách tài khoản hướng dẫn Collect*.
• algorithms/token-2022-transfer-fees — cách kết hợp chính xác phí giao dịch pool với phí chuyển mint.

• raydium-io/raydium-cp-swap — states/config.rs, states/pool.rs, states/curve.rs
• Raydium API — GET /main/cpmm-config