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ünür:
   • LP payı — vault’ta kalır ve k’yi büyütür. LP token’larını yakarak örtülü olarak talep edilir.
   • Protokol payı — PoolState.protocol_fees_token* hesabına tahakkuk eder; protocol_owner tarafından CollectProtocolFee aracılığıyla toplanır.
   • Fon payı — PoolState.fund_fees_token* hesabına tahakkuk eder; fund_owner tarafından CollectFundFee aracılığıyla toplanır.
2. Yaratıcı ücreti (isteğe bağlı, havuz başına) — AmmConfig.creator_fee_rate oranında işlem ücretinden bağımsız olarak alınır ve PoolState.creator_fees_token* hesabına tahakkuk eder. Yaratıcı bunu CollectCreatorFee aracılığıyla toplayabilir veya herhangi bir ödeyici hedef kısıtlı CollectCreatorFeePermissionless yolunu tetikleyebilir. Yalnızca havuz enable_creator_fee = true ile oluşturulduğunda etkindir.

​

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 alındığı taraf” 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 hacmin değil, işlem ücretinin kesirleridir. 120_000 ⇒ işlem ücretinin %12’si.

​

Bölünüş, kodda

// raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs'den parafraz.
// Gerçek kod `is_creator_fee_on_input` üzerinde dallanır; her iki dal da
// yaratıcı_ücreti'nin asla trade_fee'nin bir dilimi olmadığı değişmezini korur.

const FEE_RATE_DENOMINATOR_VALUE: u64 = 1_000_000;

pub struct FeeBreakdown {
    pub amount_in_after_fees: u64,    // girdiden tüm giriş tarafı ücretleri çıkarıldıktan sonra
    pub amount_out_after_fees: u64,   // çıkıştan alınan herhangi bir yaratıcı ücreti çıkarıldıktan sonra
    pub trade_fee:    u64,            // → aşağıda LP / protokol / fon hesaplarına bölünü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 yuvarlanır, sonra
    // orantılı olarak bölünür — bu tamamen yuvarlama/verimlilik numarasıdır. Bölünüş
    // 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ı ücreti çıkış tarafına yönlendirdiğinde,
    // trade_fee giriş tarafından 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ş tarafındaki toplam ücret yukarı yuvarlanır, böylece havuz asla eksik ücret almaz.
• trade_fee’nin alt bölünüşleri (protokol, fon) aşağı yuvarlanır, böylece toplamları trade_fee’yi aşmaz; kalan LP payıdır.
• lp_share = trade_fee − protocol_fee − fund_fee (creator_fee kendi hesabı olduğu için çıkarılmaz).
• Yaratıcı ücreti PoolState.creator_fee_on’a bağlı olarak giriş veya çıkış tarafından alınır (sonraki bölüme bakın). Oran her iki şekilde de değişmez.

​

Ücretlerin alındığı taraf

​

”Tahakkuk eden” ü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 onayladığı fiyatı tutarlı olarak abartacaksınız. Her zaman tahakkuk eden ü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 tahakkuk etmez. 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 trade_fee’si kalana karşı (yukarıda bölünmüş).
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çirebilir 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 alıp almayacağına (enable_creator_fee) ve swap’in hangi tarafından alacağına (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 tahakkuk eder.
• CollectCreatorFee veya CollectCreatorFeePermissionless aracılığıyla toplanır. 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.
• Oluşturulduktan sonra yeniden etkinleştirilemez veya yeniden yönlendirilmez. enable_creator_fee = false ile başlatılan bir havuz asla yaratıcı ücreti almayacak; belirli bir creator_fee_on ile başlatılan bir havuz taraf değiştiremez.

​

Koleksiyon operasyonel akışı

​

Ücret katmanını değiştirme

• Bir havuzu bir AmmConfig’den diğerine taşımak.
• Zaten tahakkuk eden ü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 tahakkuk eden geçerli ücretler
const pool = await connection.getAccountInfo(poolStatePda);
const decoded = PoolState.decode(pool.data);
console.log(
  "Protokol tahakkuk:",
  decoded.protocolFeesToken0.toString(),
  decoded.protocolFeesToken1.toString(),
);
console.log(
  "Fon tahakkuk:",
  decoded.fundFeesToken0.toString(),
  decoded.fundFeesToken1.toString(),
);
console.log(
  "Yaratıcı tahakkuk:",
  decoded.creatorFeesToken0.toString(),
  decoded.creatorFeesToken1.toString(),
);

// 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());
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 ü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 farklı bir LP/protokol bölünüşü ve fon ücreti olmayan sabit %0,25 işlem ücreti kullanır.
• CLMM ücretleri tick-aralığı katmanı başına, havuz başına değil konum başına tahakkuk eder ve DecreaseLiquidity veya CollectFees aracılığıyla talep edilir.

​

Sonraki adımlar

• products/cpmm/math — işlem-ücreti kesintisinin eğriye nasıl takıldığı.
• products/cpmm/instructions — Collect* talimatı hesap listeleri.
• algorithms/token-2022-transfer-fees — havuz işlem ücreti ile mint transfer ücretini 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