Phí CPMM

​

Hai phí độc lập, bốn điểm đến

1. Phí giao dịch — tính theo AmmConfig.trade_fee_rate và chia thành ba điểm đến:
   • Phần LP — nằm trong vault và làm tăng k. Được yêu cầu ngầm bằng cách đốt token LP.
   • Phần giao thức — tích lũy vào PoolState.protocol_fees_token*; được quét bởi protocol_owner thông qua CollectProtocolFee.
   • Phần quỹ — tích lũy vào PoolState.fund_fees_token*; được quét bởi fund_owner thông qua CollectFundFee.
2. Phí tạo pool (tùy chọn, theo pool) — tính theo AmmConfig.creator_fee_rate độc lập với phí giao dịch và tích lũy vào PoolState.creator_fees_token*. Người tạo pool có thể quét nó thông qua CollectCreatorFee, hoặc bất kỳ người trả tiền nào có thể kích hoạt đường dẫn CollectCreatorFeePermissionless bị ràng buộc bởi điểm đến. 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 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 mà phí được tính” dưới đây).
• creator_fee_rate là một phần của khối lượng swap, được tính riêng biệt với 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 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.

​

Phần chia, trong mã

// 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í thiếu.
• Các phần chia 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 được trừ ở đây vì nó là bucket riêng của nó).
• Phí tạo pool đượ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ù bằng cách nào.

​

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

​

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

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)

• Quoting từ raw balances là sai. Nếu bạn xây dựng quoter từ getTokenAccountBalance, bạn sẽ liên tục phóng đại giá mà pool sẽ danh dự. Luôn trừ phí tích lũy, hoặc mô phỏng thông qua SwapBaseInput / API.
• CollectProtocolFee không di chuyển giá. Nó di chuyển token ra khỏi vault và đặt lại các bộ đếm protocol_fees_token*, vì vậy curve_x và curve_y không thay đổi.
• Phí LP không tích lũy vào bộ đếm. Chúng ngầm trong vault balance. 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à thông 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 cơ quan quản lý phí của mint).
2. trade_fee của pool trên phần còn lại (chia theo trên).
3. Phí chuyển của mint đầu ra trên amount_out (cho cơ quan quản lý phí của mint).

​

Phí tạo pool

• Bật tại tạo pool. Initialize đặt enable_creator_fee = false theo mặc định; các pool được tạo thông qua InitializeWithPermission (được sử dụng bởi các tốt nghiệp LaunchLab và các đường dẫn được gated khác) có thể chuyển enable_creator_fee = true và chọn creator_fee_on.
• Tỷ lệ được chia sẻ với tầng phí. Tỷ lệ chính nó là AmmConfig.creator_fee_rate, cùng một giá trị trên mỗi pool được ràng buộc 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í tạo pool hiệu quả của pool là zero bất kể giá trị config (xem PoolState::adjust_creator_fee_rate trong nguồn).
• Độc lập với phí giao dịch. Phí tạo pool không bao giờ giảm phần LP / giao thức / quỹ — nó là tỷ lệ riêng của nó, được áp dụng riêng biệt, tích lũy trong các bộ đếm riêng của nó.
• Quét thông qua CollectCreatorFee hoặc CollectCreatorFeePermissionless. Đường dẫn gốc yêu cầu PoolState.pool_creator ký. Đường dẫn không cần phép cho phép bất kỳ người trả tiền nào kích hoạt bộ sưu tập nhưng sửa cả hai điểm đến thành ATA chính tắc của người tạo pool.
• Không thể được bật lại hoặc định tuyến lại sau khi tạo. Một pool được khởi tạo với enable_creator_fee = false sẽ không bao giờ tính phí tạo pool; một pool được khởi tạo với creator_fee_on cụ thể không thể chuyển phía.

​

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

​

Thay đổi tầng phí

• Di chuyển pool từ AmmConfig này sang AmmConfig khác.
• Định giá lại các phí đã tích lũy.
• Thu thập phí mà không có người ký protocol_owner / fund_owner.

​

Đọ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 phần chia LP/giao thức khác và không có phí quỹ.
• Phí CLMM là theo tầng khoảng tick, tích lũy theo vị trí (không phải theo pool), và được yêu cầu thông qua DecreaseLiquidity hoặc CollectFees.

​

Tiếp theo đi đâu

• products/cpmm/math — nơi phần trừ phí giao dịch cắm vào curve.
• products/cpmm/instructions — danh sách tài khoản lệnh Collect*.
• algorithms/token-2022-transfer-fees — cách kết hợp phí giao dịch pool với phí chuyển mint một cách chính xác.

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