CPMM ücretleri

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

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

1. İşlem ücreti — AmmConfig.trade_fee_rate ile alınır ve üç hedef arasında bölünür:
   • LP payı — kasada kalır ve k değerini büyütür. LP token’ları yakarak kapalı olarak talep edilir.
   • Protokol payı — PoolState.protocol_fees_token* hesaplamalarına birikir; protocol_owner tarafından CollectProtocolFee aracılığıyla toplanır.
   • Fon payı — PoolState.fund_fees_token* hesaplamalarına birikir; 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 ile işlem ücretinden bağımsız olarak alınır, PoolState.creator_fees_token* hesaplamalarına birikir, pool_state.pool_creator tarafından CollectCreatorFee aracılığıyla toplanır. Yalnızca havuz enable_creator_fee = true ile oluşturulduğunda aktiftir.

​

Oranlar ve birimler

• trade_fee_rate işlem hacminin bir kesridir. 2500 ⇒ ilgili tarafın 0.25%‘i (giriş veya çıkış, creator_fee_on’a bağlı olarak — aşağıdaki “Ücretlerin işlemin hangi tarafından alındığı” başlığına bakınız).
• creator_fee_rate işlem hacminin bir kesridir, işlem ücretinden bağımsız olarak alınır. 1000 ⇒ ilgili tarafın 0.10%‘i.
• protocol_fee_rate ve fund_fee_rate hacimden değil, işlem ücretinin bir kesridir. 120_000 ⇒ işlem ücretinin 12%‘si.

​

Kod içindeki bölünme

// raydium-cp-swap/programs/cp-swap/src/curve/{calculator,fees}.rs'ten uyarlanmıştır.
// Gerçek kod `is_creator_fee_on_input` üzerine dal açar; 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 kovaları arasında 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 kova (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 eklenir, böylece birleşik ücrette bir kez yuvarlama yapılır, sonra orantılı
    // olarak bölünür — bu tamamen yuvarlama/verimlilik hilesidir. Bölünme 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ında tek oran olarak alınır ve creator_fee
    // eğri çıktısı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 ücreti yukarı yuvarlama yapılır, böylece havuz asla az ücret almaz.
• trade_fee (protokol, fon) alt bölünmeleri aşağı yuvarlama yapılır, böylece toplamları 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 kovası olur).
• 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ız). Oran her iki şekilde de değişmez.

​

Ücretlerin işlemin hangi tarafından alındığı

​

”Birikmiş” ücretler eğri ile nasıl etkileşim kurar

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 teklifi almak yanlıştır. getTokenAccountBalance’den bir fiyatlandırıcı oluşturursanız, havuzun onayladığı fiyatı sürekli olarak abartacaksınız. Her zaman birikmiş ücretleri çıkarınız veya SwapBaseInput / API aracılığıyla simülasyon yapınız.
• CollectProtocolFee fiyatı taşımaz. Token’ları kasadan çı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 biriktirilmez. Bunlar kasa bakiyesi içinde kapalıdır. LP’nin birikmiş LP ücretlerine hak ettiği şey, LP token’ları yakarak (yani Withdraw aracılığıyla) kullanılır — CollectLpFee yoktur.

​

Token-2022 aktarım ücretleri ile etkileşim

1. Giriş mint’inin amount_in üzerine aktarım ücreti (mint’inin ücret otoritesine).
2. Havuzun trade_fee bakiyeye (yukarıda bölündüğü gibi).
3. Çıkış mint’inin amount_out üzerine aktarım ücreti (mint’inin ücret otoritesine).

​

Yaratıcı ücreti

• Havuz oluşturmada etkinleştirilir. Initialize varsayılan olarak enable_creator_fee = false ayarlar; InitializeWithPermission aracılığıyla (LaunchLab mezuniyetleri ve diğer kontrollü yollar tarafından kullanılan) oluşturulan havuzlar enable_creator_fee = true geçebilir ve creator_fee_on seçebilir.
• Oran ücret katmanı ile paylaşılır. Oranın kendisi AmmConfig.creator_fee_rate’tir, bu konfigürasyon ile bağlı her havuz arasında aynı değer. Her havuz ardından onu ücretlendirecek mi (enable_creator_fee) ve swap’inin hangi tarafında ücretlendirecek mi (creator_fee_on) karar verir. enable_creator_fee = false olduğunda, havuzun etkili yaratıcı-ücreti oranı yapılandırma değerinden bağımsız olarak sıfırdır (kaynaktaki PoolState::adjust_creator_fee_rate bakınız).
• İşlem ücretinden bağımsız. Yaratıcı ücreti hiçbir zaman LP / protokol / fon paylarını azaltmaz — kendi oranıdır, ayrı olarak uygulanır, kendi sayaçlarında biriktirilir.
• CollectCreatorFee aracılığıyla toplanır, PoolState.pool_creator tarafından imzalanır.
• Oluşturmadan sonra yeniden etkinleştirilemez veya yeniden yönlendirilemez. enable_creator_fee = false ile başlatılan havuz asla yaratıcı ücreti almayacak; belirli bir creator_fee_on ile başlatılan havuz taraf değiştiremez.

​

Toplama operasyonel akışı

​

Ücret katmanını değiştirme

• Havuzu bir AmmConfig’ten diğerine taşımak.
• Zaten birikmiş ücretlerin fiyatını retroaktif olarak değiştirmek.
• protocol_owner / fund_owner imzacı olmadan ücretleri toplamak.

​

Çalışan havuzdan ücretleri okuma

// Off-chain: her kovada birikmiş mevcut ücretler
const pool = await connection.getAccountInfo(poolStatePda);
const decoded = PoolState.decode(pool.data);
console.log(
  "Protocol birikmiş:",
  decoded.protocolFeesToken0.toString(),
  decoded.protocolFeesToken1.toString(),
);
console.log(
  "Fon birikmiş:",
  decoded.fundFeesToken0.toString(),
  decoded.fundFeesToken1.toString(),
);
console.log(
  "Yaratıcı birikmiş:",
  decoded.creatorFeesToken0.toString(),
  decoded.creatorFeesToken1.toString(),
);

// Off-chain: bugün efektif oranlar.
// trade_fee_rate, creator_fee_rate hacim kesrleridir (payda 1e6).
// protocol_fee_rate, fund_fee_rate *işlem ücreti* kesrleridir (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 efektif:",       (tradeFeeOfVolume * lpOfTradeFee * 100).toFixed(4), "%");
console.log("Protokol ücreti efektif:", (tradeFeeOfVolume * protocolOfTradeFee * 100).toFixed(4), "%");
console.log("Fon ücreti efektif:",     (tradeFeeOfVolume * fundOfTradeFee * 100).toFixed(4), "%");
console.log(
  "Yaratıcı ücreti efektif:",
  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 kullanır, farklı LP/protokol bölünmesi ve fon ücreti yoktur.
• CLMM ücretleri işaret-aralığı katmanına, havuzda değil konuma göre biriktirilir ve DecreaseLiquidity veya CollectFees aracılığıyla talep edilir.

​

Sonra nereye

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