CPMM ücretleri

​

İki bağımsız ücret, dört hedef

1. İşlem ücreti — AmmConfig.trade_fee_rate oranında alınır ve üç hedefe bölüştürülür:
   • LP payı — vault’ta kalır ve k’yı büyütür. LP token’larını yakarak örtülü olarak talep edilir.
   • Protokol payı — PoolState.protocol_fees_token* hesabına birikir; protocol_owner tarafından CollectProtocolFee aracılığıyla temizlenir.
   • Fon payı — PoolState.fund_fees_token* hesabına birikir; fund_owner tarafından CollectFundFee aracılığıyla temizlenir.
2. Yaratıcı ücreti (isteğe bağlı, havuz başına) — AmmConfig.creator_fee_rate oranında alınır ve işlem ücretinden bağımsız olarak PoolState.creator_fees_token* hesabına birikir. Yaratıcı bunu CollectCreatorFee aracılığıyla temizleyebilir veya herhangi bir ödeyici CollectCreatorFeePermissionless yolunu tetikleyebilir. Yalnızca havuz enable_creator_fee = true ile oluşturulduğunda etkindir. 2026-09-19 yükseltmesinden bu yana birikmiş yaratıcı ücreti koleksiyon sırasında bir kez daha bölüştürülür: yapılandırılabilir bir pay havuzun protokol hesabına taşınır ve yalnızca kalan kısım yaratıcıya ulaşır — bkz. Yaratıcı ücretinin protokol payı.

​

Oranlar ve birimler

• trade_fee_rate swap hacminin bir kesridir. 2500 ⇒ ilgili tarafın %0,25’i (giriş veya çıkış, creator_fee_on’a bağlı olarak — aşağıdaki “Ücretlerin trade’in hangi tarafından alındığı” bölümüne bakın).
• creator_fee_rate swap hacminin bir kesridir, işlem ücretinden ayrı olarak alınır. 1000 ⇒ ilgili tarafın %0,10’u.
• protocol_fee_rate ve fund_fee_rate hacimden değil, işlem ücretinin kesirleridir. 120_000 ⇒ işlem ücretinin %12’si.
• creator_fee_share_rate hacimden ve işlem ücretinden değil, birikmiş yaratıcı ücretinin bir kesridir. 200_000 ⇒ koleksiyon sırasında creator_fees_token* hesabında ne varsa onun %20’si. 0 (varsayılan) tüm yaratıcı ücretini yaratıcıyla bırakır.

​

Bölüşüm, kodda

// raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs dosyasından parafraz.
// Gerçek kod `is_creator_fee_on_input` üzerinde dallanır; her iki dal da
// creator_fee'nin kendi oranı olduğu, asla trade_fee'nin dilimi olmadığı değişmezini korur.

const FEE_RATE_DENOMINATOR_VALUE: u64 = 1_000_000;

pub struct FeeBreakdown {
    pub amount_in_after_fees: u64,    // giriş eksi giriş tarafında alınan tüm ücretler
    pub amount_out_after_fees: u64,   // çıkış eksi çıkış tarafında alınan yaratıcı ücreti
    pub trade_fee:    u64,            // → aşağıda LP / protokol / fon hesaplarına bölüştürülür
    pub protocol_fee: u64,            // trade_fee'nin payı
    pub fund_fee:     u64,            // trade_fee'nin payı
    pub creator_fee:  u64,            // bağımsız hesap (giriş veya çıkış tarafı)
}

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 */) {
    // İki oran toplanır, böylece birleşik ücret üzerinde bir kez yuvarlarız, sonra
    // orantılı olarak böleriz — bu tamamen yuvarlama/verimlilik hilesidir. Bölüşüm
    // oranları tam olarak onurlandırır: 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) {
    // creator_fee_on yaratıcı ücretini çıkış tarafına yönlendirdiğinde,
    // trade_fee giriş tarafında tek bir oran olarak alınır ve creator_fee
    // eğri çıkışına karşı hesaplanır.
    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)
}

• Giriş üzerindeki toplam ücret yukarı yuvarlanır, böylece havuz asla eksik ücret almaz.
• trade_fee’nin alt bölüşümleri (protokol, fon) aşağı yuvarlanır, böylece toplamları asla trade_fee’yi aşmaz; kalan LP payıdır.
• lp_share = trade_fee − protocol_fee − fund_fee (creator_fee burada çıkarılmaz çünkü kendi hesabıdır).
• Yaratıcı ücreti PoolState.creator_fee_on’a bağlı olarak giriş veya çıkıştan alınır (sonraki bölüme bakın). Oran her iki şekilde de değişmez.

​

Ücretlerin trade’in hangi tarafından alındığı

​

”Birikmiş” ücretlerin eğri ile etkileşimi

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)

• Ham bakiyelerden fiyat hesaplamak yanlıştır. getTokenAccountBalance üzerinden bir fiyat hesaplayıcı oluşturursanız, havuzun onurlandıracağı fiyatı tutarlı olarak abartacaksınız. Her zaman birikmiş ücretleri çıkarın veya SwapBaseInput / API aracılığıyla simüle edin.
• CollectProtocolFee fiyatı hareket ettirmez. Token’ları vault’tan çıkarır ve protocol_fees_token* sayaçlarını sıfırlar, böylece curve_x ve curve_y değişmez.
• LP ücretleri sayaca birikir. Bunlar vault bakiyesinde örtülüdür. LP’nin birikmiş LP ücretlerine hakkı LP token’larını yakarak (yani Withdraw aracılığıyla) kullanılır — CollectLpFee yoktur.

​

Token-2022 transfer ücretleri ile etkileşim

1. Giriş mint’inin amount_in üzerindeki transfer ücreti (mint’in ücret yetkilisine).
2. Havuzun kalan kısım üzerindeki trade_fee’si (yukarıda bölüştürüldüğü gibi).
3. Çıkış mint’inin amount_out üzerindeki transfer ücreti (mint’in ücret yetkilisine).

​

Yaratıcı ücreti

• Havuz oluşturmada etkinleştirilir. Initialize varsayılan olarak enable_creator_fee = false ayarlar; InitializeWithPermission aracılığıyla oluşturulan havuzlar (LaunchLab mezuniyetleri ve diğer kapılı yollar tarafından kullanılır) enable_creator_fee = true geçebilir ve creator_fee_on seçebilir.
• Oran ücret katmanı ile paylaşılır. Oran kendisi AmmConfig.creator_fee_rate’dir, o config’e bağlı her havuz arasında aynı değer. Her havuz daha sonra bunu ücretlendirip ücretlendirmeyeceğine (enable_creator_fee) ve swap’ın hangi tarafında ücretlendireceğine (creator_fee_on) karar verir. enable_creator_fee = false olduğunda, havuzun etkili yaratıcı-ücret oranı config değerinden bağımsız olarak sıfırdır (kaynakta PoolState::adjust_creator_fee_rate bölümüne bakın).
• İşlem ücretinden bağımsız. Yaratıcı ücreti asla LP / protokol / fon paylarını azaltmaz — kendi oranıdır, ayrı olarak uygulanır, kendi sayaçlarında birikir.
• CollectCreatorFee veya CollectCreatorFeePermissionless aracılığıyla temizlenir. Orijinal yol PoolState.pool_creator’ün imzalamasını gerektirir. İzinsiz yol herhangi bir ödeyicinin koleksiyonu tetiklemesine izin verir ancak her iki hedefi de yaratıcının kanonik ATA’larına sabitler. Her iki yol da protokolün payını önce kapatır — sonraki bölüme bakın.
• Oluşturmadan sonra yeniden etkinleştirilemez veya yeniden yönlendirilemez. enable_creator_fee = false ile başlatılan bir havuz asla yaratıcı ücreti ücretlendirmez; belirli bir creator_fee_on ile başlatılan bir havuz taraf değiştiremez.

​

Yaratıcı ücretinin protokol payı

​

Oran nereden gelir

1. CreatorFeeShare PDA — tohumlar ["creator_fee_share", creator, amm_config]. Bu hesap var olduğunda ve CPMM tarafından sahiplenildiğinde, onun share_rate’i kazanır. Protokolün tier’ı kendisi dokunmadan belirli bir yaratıcı üzerinde belirli bir ücret katmanı için oran müzakere etmesine izin verir.
2. AmmConfig.creator_fee_share_rate — o ücret katmanındaki her yaratıcı için varsayılan. PDA var olmadığında kullanılır.

​

Bölüşüm ne yapar

// programs/cp-swap/src/states/creator_fee_share.rs
shared_amount  = floor(creator_fee * share_rate / 1_000_000);   // protokole
creator_amount = creator_fee - shared_amount;                   // yaratıcıya

• creator_amount_{0,1} vault’lardan yaratıcının token hesaplarına aktarılır.
• shared_amount_{0,1} protocol_fees_token_{0,1} hesabına eklenir ve protokol sahibi CollectProtocolFee ile temizleyene kadar vault’ta kalır. Ayrı bir talimat ve ayrı bir sayaç yoktur.
• creator_fees_token_{0,1} sıfırlanır, tam olarak önceki gibi.

• Yuvarlama yaratıcıyı tercih eder. Protokol payı tabanlar, böylece toz yaratıcıyla kalır — protocol_fee ve fund_fee ile aynı yön, bunlar da zaten birikmiş bir ücretin payını oyarlar.
• Değer korunur. creator_amount + shared_amount == creator_fee her oran ve her ücret için, u64::MAX dahil.
• share_rate = 0 bir no-op’tür. Hem varsayılan config değeri hem de CreatorFeeShare PDA’sının yokluğu tüm yaratıcı ücretini yaratıcıyla bırakır, bu da yükseltme öncesi davranıştır.

​

Entegratörler için ne anlama gelir

• LP’ler ve fiyat hesaplama etkilenmez. Paylaşılan miktar her ikisi de zaten eğrinin vault görüşünden hariç tutulan iki sayaç arasında hareket eder (vault_amount_without_fee), böylece curve_x ve curve_y koleksiyon arasında hareket etmez. k dokunulmaz.
• creator_fees_token* okuyan bir yaratıcı-ücret tahmincisi artık ödemeyi abartır. O (creator, amm_config) çifti için gerçekten geçerli olan oranı kullanarak (1 − share_rate / 1_000_000) ile çarpın, config varsayılanını değil.
• protocol_fees_token* swap’ların dışında büyür. Protokol birikimini swap hacmine karşı uzlaştıran bir monitör her yaratıcı-ücret koleksiyonunda sıçramalar görecektir. Protokol birikimi artık yalnızca trade_fee × protocol_fee_rate değildir.
• Oran birikme ve koleksiyon arasında değişebilir. Koleksiyon sırasında okunur, böylece bir oran altında birikmiş ücretler birisi Collect* çağırdığında yürürlükte olan oran ile kapatılır.

​

Koleksiyon operasyonel akışı

​

Ücret katmanını değiştirme

• Bir havuzu bir AmmConfig’den diğerine taşımak.
• Zaten birikmiş ücretleri geriye dönük olarak yeniden fiyatlandırmak.
• protocol_owner / fund_owner imzalayan olmadan ücretleri toplamak.

​

Çalışan bir havuzdan ücretleri okuma

// Zincir dışı: her hesapta geçerli birikmiş ücretler.
// SDK düzeni dışa aktarır, `PoolState` sınıfını değil ve ücret alanları
// ...MintA / ...MintB olarak adlandırılır — ...Token0 / ...Token1 alanları yoktur.
import { CpmmPoolInfoLayout } from "@raydium-io/raydium-sdk-v2";

const pool = await connection.getAccountInfo(poolStatePda);
const decoded = CpmmPoolInfoLayout.decode(pool!.data);   // .slice(8) yok — düzen
                                                          // ayırıcıyı içerir
console.log(
  "Protokol birikmiş:",
  decoded.protocolFeesMintA.toString(),
  decoded.protocolFeesMintB.toString(),
);
console.log(
  "Fon birikmiş:",
  decoded.fundFeesMintA.toString(),
  decoded.fundFeesMintB.toString(),
);
console.log(
  "Yaratıcı birikmiş:",
  decoded.creatorFeesMintA.toString(),
  decoded.creatorFeesMintB.toString(),
);
// Yaratıcının gerçekten aldığı şey bundan eksi protokol payıdır, koleksiyon sırasında
// (creator, ammConfig) CreatorFeeShare PDA'sından (varsa) veya
// AmmConfig.creator_fee_share_rate'den çözülür. Yukarıdaki "Yaratıcı ücretinin protokol payı"
// bölümüne bakın.

// Zincir dışı: bugün etkili oranlar.
// trade_fee_rate, creator_fee_rate hacmin kesirleridir (payda 1e6).
// protocol_fee_rate, fund_fee_rate *işlem ücretinin* kesirleridir (aynı payda).
const config = await fetch("https://api-v3.raydium.io/main/cpmm-config")
  .then((r) => r.json());
// Çözülen havuzdaki `configId` config hesabının PublicKey'idir, bir dizin değil.
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 ücreti etkili:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Protokol ücreti etkili:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Fon ücreti etkili:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Yaratıcı ücreti etkili:",
  decoded.enableCreatorFee
    ? ((tier.creatorFeeRate / 1_000_000) * 100).toFixed(4) + " %"
    : "0 % (bu havuzda devre dışı)",
);

​

CLMM ve AMM v4 ile karşılaştırma

• AMM v4 sabit %0,25 işlem ücreti, farklı LP/protokol bölüşümü ve fon ücreti olmadan kullanır.
• CLMM ücretleri tick-aralığı katmanı başınadır, havuz başına değil konum başına birikir ve DecreaseLiquidity veya CollectFees aracılığıyla talep edilir.

​

Sonraki adım

• products/cpmm/math — işlem-ücret kesintisinin eğriye nasıl takıldığı.
• products/cpmm/instructions — Collect* talimat hesap listeleri, her iki yaratıcı yolunun artık gerektirdiği creator_fee_share hesabı dahil.
• algorithms/token-2022-transfer-fees — havuz işlem ücretini mint transfer ücreti ile doğru şekilde nasıl birleştireceğiniz.

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