Biaya CPMM

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.Lihat versi bahasa Inggris →

Dua biaya independen, empat tujuan

CPMM mengenakan dua biaya dengan tarif terpisah pada setiap swap:

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*; dikumpulkan oleh protocol_owner melalui CollectProtocolFee.
- Bagian dana — terakumulasi ke PoolState.fund_fees_token*; dikumpulkan oleh fund_owner melalui CollectFundFee.
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 mengumpulkannya melalui CollectCreatorFee, atau pembayar apa pun dapat memicu jalur CollectCreatorFeePermissionless yang dibatasi tujuan. Aktif hanya ketika pool dibuat dengan enable_creator_fee = true.

Biaya kreator bukan bagian dari biaya perdagangan. Kedua tarif ditambahkan bersama ketika biaya diambil dari input swap, tetapi masing-masing tetap menjadi bucket tersendiri — bagian protokol dan dana selalu berasal dari trade_fee saja, tidak pernah dari creator_fee. Pool dengan creator_fee_rate = 1000 (0,10%) dan trade_fee_rate = 2500 (0,25%) mengenakan biaya gabungan 0,35% dari input pada swap dengan creator-fee-on-input, di mana kreator menyimpan 0,10% dan bucket biaya perdagangan mendapat 0,25%. Tarif biaya perdagangan (trade_fee_rate, protocol_fee_rate, fund_fee_rate) dan creator_fee_rate semuanya berada di AmmConfig. Flag enable_creator_fee per-pool dan mode creator_fee_on (sisi perdagangan mana biaya kreator diambil) berada di PoolState. Lihat products/cpmm/accounts.

Tarif dan satuan

Semua tarif adalah u64 yang dinyatakan dalam satuan 1 / FEE_RATE_DENOMINATOR di mana FEE_RATE_DENOMINATOR = 1_000_000.

trade_fee_rate adalah fraksi dari volume swap. 2500 ⇒ 0,25% dari sisi yang relevan (input atau output, tergantung 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.

Parameter default untuk AmmConfig[index=0] (pool “standar” 0,25%) di mainnet, sebagai referensi:

Field	Nilai	Persentase Efektif
`trade_fee_rate`	`2500`	0,25% dari volume (bucket biaya perdagangan)
`protocol_fee_rate`	`120000`	12% dari biaya perdagangan ≈ 0,030% dari volume
`fund_fee_rate`	`40000`	4% dari biaya perdagangan ≈ 0,010% dari volume
`creator_fee_rate`	`0` (default)	0% (bucket terpisah)
→ Bagian LP efektif		0,210% dari volume

Jadi pada swap $1.000 terhadap AmmConfig[0] dengan enable_creator_fee = false: $2,50 total biaya perdagangan, di mana $2,10 tetap bersama LP, $0,30 ke protokol, $0,10 ke dana. Bucket kreator adalah 0 karena biaya kreator dinonaktifkan. Jika pool yang sama memiliki enable_creator_fee = true dan creator_fee_rate = 1000 (0,10%), pengguna membayar tambahan $1,00 ke bucket kreator — diambil dari sisi perdagangan yang sama yang dikonfigurasi oleh creator_fee_on — untuk total $3,50 biaya. Bucket biaya perdagangan dan pembagian protokol/dana-nya tidak berubah. Konfirmasi nilai mainnet saat ini terhadap GET https://api-v3.raydium.io/main/cpmm-config — tarif dapat diubah admin dan harus dibaca segar daripada dikodekan.

Pembagian, dalam kode

// 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)
}

Catatan:

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 PoolState.creator_fee_on (lihat bagian berikutnya). Tarifnya tidak berubah baik cara.

Sisi perdagangan mana biaya diambil

CPMM memiliki pengaturan creator_fee_on per-pool (BothToken / OnlyToken0 / OnlyToken1) yang menentukan apakah biaya kreator diambil dari sisi input atau output dari swap tertentu. Helper runtime is_creator_fee_on_input(direction) menyederhanakan itu menjadi boolean per swap:

`creator_fee_on`	Swap `0 → 1`	Swap `1 → 0`
`BothToken` (`0`)	sisi input	sisi input
`OnlyToken0` (`1`)	sisi input	sisi output
`OnlyToken1` (`2`)	sisi output	sisi input

Ketika biaya kreator berada di sisi input, baik biaya perdagangan maupun biaya kreator dikurangi dari amount_in sebelum kurva berjalan. Matematika quote: ambil trade_rate + creator_rate gabungan dari input. Ketika biaya kreator berada di sisi output, hanya biaya perdagangan yang dikurangi dari amount_in; kurva menghasilkan output tanpa biaya, kemudian biaya kreator dikurangi dari output itu. Matematika quote: ambil trade_rate dari input; ambil creator_rate dari output. Biaya perdagangan itu sendiri selalu diambil dari sisi input (pola Uniswap-V2 standar). Hanya biaya kreator yang dapat mendarat di output.

Bagaimana biaya “terakumulasi” berinteraksi dengan kurva

Nuansa penting: biaya protokol, dana, dan kreator tetap secara fisik di vault sampai instruksi Collect* masing-masing dipanggil. Tetapi mereka dikecualikan dari pandangan kurva tentang saldo vault. Gambaran konkret setelah satu swap:

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)

Program menggunakan curve_x (dan curve_y analog) ketika menegakkan k' ≥ k. Ini adalah bagaimana biaya non-LP mencapai tujuan mereka tanpa menginflasi bagian LP dari pool. Konsekuensi yang harus Anda desain:

Quoting dari saldo mentah salah. Jika Anda membangun quoter dari getTokenAccountBalance, Anda akan secara konsisten menyatakan harga yang terlalu tinggi 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 terakumulasi dilakukan dengan membakar token LP (yaitu, melalui Withdraw) — tidak ada CollectLpFee.

Interaksi dengan biaya transfer Token-2022

Biaya transfer Token-2022 diterapkan oleh mint, bukan oleh CPMM. Mereka bertindak pada setiap transfer token — swap, deposit, penarikan, dan sweep Collect*. Matematika biaya perdagangan CPMM dihitung terhadap jumlah yang benar-benar mendarat di vault, yaitu, bersih dari biaya transfer mint input (jika ada). Jadi dalam kasus terburuk pengguna membayar tiga pajak berbeda pada swap input-exact:

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

Quoter SDK memperhitungkan ketiga-tiganya sehingga minimum_amount_out dinyatakan dalam apa yang benar-benar diterima pengguna. Jika Anda menulis quoter Anda sendiri, cerminkan perilaku itu, atau pemeriksaan slippage Anda akan secara sistematis terlalu murah hati. Lihat algorithms/token-2022-transfer-fees untuk derivasi terperinci.

Biaya kreator

Biaya kreator bersifat opsional dan per-pool. Tarif berada di AmmConfig.creator_fee_rate; flag enable dan sisi (creator_fee_on) berada di PoolState:

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 melewati enable_creator_fee = true dan memilih creator_fee_on.
Tarif dibagikan dengan tier biaya. Tarif itu sendiri adalah AmmConfig.creator_fee_rate, nilai yang sama di setiap pool yang terikat pada config itu. Setiap pool kemudian memutuskan apakah akan mengenakan itu (enable_creator_fee) dan sisi swap mana untuk mengenakan itu (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 — itu adalah tarif tersendiri, diterapkan secara terpisah, terakumulasi di counter tersendiri.
Dikumpulkan melalui CollectCreatorFee atau CollectCreatorFeePermissionless. Jalur asli memerlukan PoolState.pool_creator untuk menandatangani. Jalur tanpa izin memungkinkan pembayar apa pun untuk memicu pengumpulan tetapi memperbaiki kedua tujuan ke ATA kanonik kreator.
Tidak dapat diaktifkan kembali atau dialihkan setelah pembuatan. Pool yang diinisialisasi dengan enable_creator_fee = false tidak akan pernah mengenakan biaya kreator; satu yang diinisialisasi dengan creator_fee_on tertentu tidak dapat beralih sisi.

Biaya kreator adalah mekanisme di balik pola “Burn & Earn” Raydium: token LP dikunci di bawah program LP Lock sehingga kreator tidak dapat menarik likuiditas, tetapi biaya kreator terakumulasi masih dapat dikumpulkan tanpa batas.

Alur operasional pengumpulan

Penandatangan	Instruksi	Counter Sumber Dinolkan	Frekuensi Tipikal
`amm_config.protocol_owner`	`CollectProtocolFee`	`protocol_fees_token{0,1}`	Mingguan atau programatik
`amm_config.fund_owner`	`CollectFundFee`	`fund_fees_token{0,1}`	Mingguan atau programatik
`pool_state.pool_creator`	`CollectCreatorFee`	`creator_fees_token{0,1}`	Kapan saja
Pembayar apa pun; kreator tidak menandatangani	`CollectCreatorFeePermissionless`	`creator_fees_token{0,1}`	Kapan saja; ATA kreator adalah tujuan tetap

Pemilik protokol dan dana adalah multisig Raydium di mainnet; lihat security/admin-and-multisig. Pada jalur kreator-saja asli, penandatangan kreator adalah akun yang dicatat di PoolState. Pada jalur tanpa izin, pemanggil membayar untuk membuat ATA kreator yang hilang. Program membatasi creator ke pool_state.pool_creator dan menurunkan setiap tujuan dari kreator itu ditambah mint vault dan program token yang sesuai, jadi pemanggil tidak dapat mengalihkan dana.

Mengubah tier biaya

Tarif biaya dapat diubah oleh admin melalui UpdateAmmConfig (lihat products/cpmm/instructions). Perubahan berlaku pada swap berikutnya untuk setiap pool yang terikat pada AmmConfig itu — tidak ada migrasi, karena pool memuat config setiap swap. Apa yang tidak dapat dilakukan admin:

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

Perbandingan dengan CLMM dan AMM v4

Lihat reference/fee-comparison untuk matriks berdampingan. Ringkasan:

AMM v4 menggunakan biaya perdagangan tetap 0,25% dengan pembagian LP/protokol 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*.
algorithms/token-2022-transfer-fees — cara menggabungkan biaya perdagangan pool dengan biaya transfer mint dengan benar.

Sumber:

Products

Algorithms

Dua biaya independen, empat tujuan

Tarif dan satuan

Pembagian, dalam kode

Sisi perdagangan mana biaya diambil

Bagaimana biaya “terakumulasi” berinteraksi dengan kurva

Interaksi dengan biaya transfer Token-2022

Biaya kreator

Alur operasional pengumpulan

Mengubah tier biaya

Membaca biaya dari pool yang berjalan

Perbandingan dengan CLMM dan AMM v4

Ke mana selanjutnya

​Dua biaya independen, empat tujuan

​Tarif dan satuan

​Pembagian, dalam kode

​Sisi perdagangan mana biaya diambil

​Bagaimana biaya “terakumulasi” berinteraksi dengan kurva

​Interaksi dengan biaya transfer Token-2022

​Biaya kreator

​Alur operasional pengumpulan

​Mengubah tier biaya

​Membaca biaya dari pool yang berjalan

​Perbandingan dengan CLMM dan AMM v4

​Ke mana selanjutnya

Dua biaya independen, empat tujuan

Tarif dan satuan

Pembagian, dalam kode

Sisi perdagangan mana biaya diambil

Bagaimana biaya “terakumulasi” berinteraksi dengan kurva

Interaksi dengan biaya transfer Token-2022

Biaya kreator

Alur operasional pengumpulan

Mengubah tier biaya

Membaca biaya dari pool yang berjalan

Perbandingan dengan CLMM dan AMM v4

Ke mana selanjutnya