Biaya CPMM

​

Dua biaya independen, empat tujuan

1. Biaya perdagangan — dikenakan pada AmmConfig.trade_fee_rate dan dibagi antara tiga tujuan:
   • Bagian LP — tetap di vault dan menambah k. Diklaim secara implisit dengan membakar token LP.
   • Bagian protokol — terakumulasi ke PoolState.protocol_fees_token*; disapu oleh protocol_owner melalui CollectProtocolFee.
   • Bagian dana — terakumulasi ke PoolState.fund_fees_token*; disapu oleh fund_owner melalui CollectFundFee.
2. Biaya kreator (opsional, per-pool) — dikenakan pada AmmConfig.creator_fee_rate secara independen dari biaya perdagangan dan terakumulasi ke PoolState.creator_fees_token*. Kreator dapat menyapunya melalui CollectCreatorFee, atau pembayar apa pun dapat memicu jalur CollectCreatorFeePermissionless yang dibatasi tujuan. Aktif hanya ketika pool dibuat dengan enable_creator_fee = true. Sejak upgrade 2026-09-19, biaya kreator yang terakumulasi dibagi sekali lagi pada saat pengumpulan: bagian yang dapat dikonfigurasi dipindahkan ke bucket protokol pool dan hanya sisanya yang mencapai kreator — lihat Bagian protokol dari biaya kreator.

​

Tarif dan unit

• trade_fee_rate adalah fraksi dari volume swap. 2500 ⇒ 0,25% dari sisi yang relevan (input atau output, tergantung pada creator_fee_on — lihat “Sisi perdagangan mana biaya diambil” di bawah).
• creator_fee_rate adalah fraksi dari volume swap, diambil secara terpisah dari biaya perdagangan. 1000 ⇒ 0,10% dari sisi yang relevan.
• protocol_fee_rate dan fund_fee_rate adalah fraksi dari biaya perdagangan, bukan dari volume. 120_000 ⇒ 12% dari biaya perdagangan.
• creator_fee_share_rate adalah fraksi dari biaya kreator yang terakumulasi, bukan dari volume dan bukan dari biaya perdagangan. 200_000 ⇒ 20% dari apa pun yang berada di creator_fees_token* pada saat dikumpulkan. 0 (default) membiarkan seluruh biaya kreator bersama kreator.

​

Pembagian, dalam kode

// Diparafrasekan dari raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs.
// Kode aktual bercabang pada `is_creator_fee_on_input`; kedua cabang mempertahankan
// invarian bahwa creator_fee adalah tarifnya sendiri, tidak pernah bagian dari 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)
}

• Total biaya pada input dibulatkan ke atas sehingga pool tidak pernah mengenakan biaya kurang.
• Sub-pembagian trade_fee (protokol, dana) dibulatkan ke bawah sehingga jumlahnya tidak pernah melebihi trade_fee; sisanya adalah bagian LP.
• lp_share = trade_fee − protocol_fee − fund_fee (creator_fee tidak dikurangi di sini karena merupakan bucket tersendiri).
• Biaya kreator diambil dari input atau output tergantung pada PoolState.creator_fee_on (lihat bagian berikutnya). Tarifnya tidak berubah.

​

Sisi perdagangan mana biaya diambil

​

Bagaimana biaya “terakumulasi” berinteraksi dengan kurva

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 dari saldo mentah salah. Jika Anda membangun quoter dari getTokenAccountBalance, Anda akan secara konsisten menyatakan harga yang akan dihormati pool. Selalu kurangi biaya terakumulasi, atau simulasikan melalui SwapBaseInput / API.
• CollectProtocolFee tidak menggerakkan harga. Ini memindahkan token keluar dari vault dan menolkan counter protocol_fees_token*, jadi curve_x dan curve_y tidak berubah.
• Biaya LP tidak terakumulasi ke counter. Mereka implisit dalam saldo vault. Hak LP atas biaya LP yang terakumulasi dilakukan dengan membakar token LP (yaitu, melalui Withdraw) — tidak ada CollectLpFee.

​

Interaksi dengan biaya transfer Token-2022

1. Biaya transfer mint input pada amount_in (ke otoritas biaya mint).
2. Biaya trade_fee pool pada sisanya (dibagi per di atas).
3. Biaya transfer mint output pada amount_out (ke otoritas biaya mint).

​

Biaya kreator

• Diaktifkan saat pembuatan pool. Initialize menetapkan enable_creator_fee = false secara default; pool yang dibuat melalui InitializeWithPermission (digunakan oleh kelulusan LaunchLab dan jalur gated lainnya) dapat melewatkan enable_creator_fee = true dan memilih creator_fee_on.
• Tarif dibagikan dengan tier biaya. Tarifnya sendiri adalah AmmConfig.creator_fee_rate, nilai yang sama di setiap pool yang terikat pada config itu. Setiap pool kemudian memutuskan apakah akan mengenakan biaya (enable_creator_fee) dan sisi swap mana untuk mengenakan biaya (creator_fee_on). Ketika enable_creator_fee = false, tarif biaya kreator efektif pool adalah nol terlepas dari nilai config (lihat PoolState::adjust_creator_fee_rate dalam sumber).
• Independen dari biaya perdagangan. Biaya kreator tidak pernah mengurangi bagian LP / protokol / dana — biaya tersebut adalah tarifnya sendiri, diterapkan secara terpisah, terakumulasi di counter tersendiri.
• Disapu melalui CollectCreatorFee atau CollectCreatorFeePermissionless. Jalur asli memerlukan PoolState.pool_creator untuk menandatangani. Jalur tanpa izin membiarkan pembayar apa pun memicu pengumpulan tetapi memperbaiki kedua tujuan ke ATA kanonik kreator. Kedua jalur menyelesaikan bagian protokol terlebih dahulu — lihat bagian berikutnya.
• Tidak dapat diaktifkan kembali atau dialihkan setelah pembuatan. Pool yang diinisialisasi dengan enable_creator_fee = false tidak akan pernah mengenakan biaya kreator; yang diinisialisasi dengan creator_fee_on tertentu tidak dapat beralih sisi.

​

Bagian protokol dari biaya kreator

​

Dari mana tarifnya berasal

1. PDA CreatorFeeShare — seeds ["creator_fee_share", creator, amm_config]. Ketika akun ini ada dan dimiliki oleh CPMM, share_rate-nya menang. Ini memungkinkan protokol untuk menegosiasikan tarif per-kreator pada tier biaya tertentu tanpa menyentuh tier itu sendiri.
2. AmmConfig.creator_fee_share_rate — default untuk setiap kreator pada tier biaya itu. Digunakan setiap kali PDA tidak ada.

​

Apa yang dilakukan pembagian

// programs/cp-swap/src/states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);   // to the protocol
creator_amount = creator_fee - shared_amount;                   // to the creator

• creator_amount_{0,1} ditransfer keluar dari vault ke akun token kreator.
• shared_amount_{0,1} ditambahkan ke protocol_fees_token_{0,1} dan tetap di vault sampai pemilik protokol menyapunya dengan CollectProtocolFee. Tidak ada instruksi terpisah dan tidak ada counter terpisah untuk itu.
• creator_fees_token_{0,1} dinolkan, persis seperti sebelumnya.

• Pembulatan menguntungkan kreator. Bagian protokol lantai, jadi debu tetap bersama kreator — arah yang sama dengan protocol_fee dan fund_fee, yang juga mengukir bagian dari biaya yang sudah terakumulasi.
• Nilai dikonservasi. creator_amount + shared_amount == creator_fee untuk setiap tarif dan setiap biaya, termasuk u64::MAX.
• share_rate = 0 adalah no-op. Baik nilai config default maupun ketiadaan PDA CreatorFeeShare membiarkan seluruh biaya kreator bersama kreator, yang merupakan perilaku pra-upgrade.

​

Apa artinya bagi integrator

• LP dan quoting tidak terpengaruh. Jumlah bersama bergerak antara dua counter yang keduanya sudah dikecualikan dari pandangan kurva tentang vault (vault_amount_without_fee), jadi curve_x dan curve_y tidak bergerak di seluruh pengumpulan. k tidak tersentuh.
• Estimator biaya kreator yang membaca creator_fees_token* sekarang menyatakan pembayaran berlebihan. Kalikan dengan (1 − share_rate / 1_000_000) menggunakan tarif yang benar-benar berlaku untuk pasangan (creator, amm_config) itu, bukan default config.
• protocol_fees_token* tumbuh di luar swap. Monitor yang merekonsiliasi akrual protokol terhadap volume swap akan melihat lompatan pada setiap pengumpulan biaya kreator. Akrual protokol tidak lagi trade_fee × protocol_fee_rate saja.
• Tarifnya dapat berubah antara akrual dan pengumpulan. Tarifnya dibaca pada saat pengumpulan, jadi biaya yang terakumulasi di bawah satu tarif menyelesaikan pada tarif apa pun yang berlaku ketika seseorang memanggil Collect*.

​

Alur operasional pengumpulan

​

Mengubah tier biaya

• Pindahkan pool dari satu AmmConfig ke yang lain.
• Harga ulang biaya yang sudah terakumulasi secara retroaktif.
• Kumpulkan biaya tanpa penandatangan protocol_owner / fund_owner.

​

Membaca biaya dari pool yang berjalan

// Off-chain: current accrued fees in each bucket.
// The SDK exports the layout, not a `PoolState` class, and the fee fields are
// named ...MintA / ...MintB — there are no ...Token0 / ...Token1 fields.
import { CpmmPoolInfoLayout } from "@raydium-io/raydium-sdk-v2";

const pool = await connection.getAccountInfo(poolStatePda);
const decoded = CpmmPoolInfoLayout.decode(pool!.data);   // no .slice(8) — the
                                                          // layout includes the discriminator
console.log(
  "Protocol accrued:",
  decoded.protocolFeesMintA.toString(),
  decoded.protocolFeesMintB.toString(),
);
console.log(
  "Fund accrued:",
  decoded.fundFeesMintA.toString(),
  decoded.fundFeesMintB.toString(),
);
console.log(
  "Creator accrued:",
  decoded.creatorFeesMintA.toString(),
  decoded.creatorFeesMintB.toString(),
);
// What the creator actually receives is this minus the protocol share, resolved at
// collection time from the (creator, ammConfig) CreatorFeeShare PDA if it exists and
// from AmmConfig.creator_fee_share_rate otherwise. See "Protocol share of the creator
// fee" above.

// 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());
// `configId` on the decoded pool is the config account's PublicKey, not an index.
const tier = config.data.find((t) => t.id === decoded.configId.toBase58());

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)",
);

​

Perbandingan dengan CLMM dan AMM v4

• AMM v4 menggunakan biaya perdagangan tetap 0,25% dengan pembagian LP/protokol yang berbeda dan tidak ada biaya dana.
• CLMM biaya adalah per-tick-spacing tier, terakumulasi per-posisi (bukan per-pool), dan diklaim melalui DecreaseLiquidity atau CollectFees.

​

Ke mana selanjutnya

• products/cpmm/math — di mana pengurangan biaya perdagangan terhubung ke kurva.
• products/cpmm/instructions — daftar akun instruksi Collect*, termasuk akun creator_fee_share yang sekarang diperlukan oleh kedua jalur kreator.
• algorithms/token-2022-transfer-fees — cara menggabungkan biaya perdagangan pool dengan biaya transfer mint dengan benar.

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