CLMM talimatları

​

Talimat envanteri

​

CreatePool

sqrt_price_x64: u128           // başlangıç fiyatı
open_time:      u64            // bu zamandan önce swap'lar reddedilir

• Bayt sırasına göre token_mint_0 < token_mint_1.
• amm_config.disable_create_pool == false.
• Mint’ler Token-2022 uzantı izin listesi tarafından reddedilmemiş olmalıdır.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (henüz pozisyon yok).
• pool_state.fee_on = FromInput (eski varsayılan).
• pool_state.dynamic_fee_info sıfırlanmış (dinamik ücret devre dışı).

​

CreateCustomizablePool

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

• pool_state.fee_on, seçilen CollectFeeOn varyantına ayarlanır.
• Dinamik ücret etkinleştirildiyse: pool_state.dynamic_fee_info, sağlanan DynamicFeeConfig’den başlatılır (beş kalibrasyon parametresi kopyalanır; durum alanları sıfırlanır).
• Aksi takdirde: pool_state.dynamic_fee_info sıfırlanır (= bu havuz için dinamik ücret sonsuza kadar etkin değil).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // istenen L (veya aşağıdaki miktarları kullanmak için 0)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // NFT meta verilerini yaz (Metaplex)
base_flag: Option<bool>       // true = amount0'a göre ayarla; false = amount1'e göre ayarla

• tick_lower < tick_upper, her ikisi de pool.tick_spacing’in katları olmalı ve [MIN_TICK, MAX_TICK] aralığında olmalıdır.
• Gerekli tick dizileri iletilmiş ve başlatılmış olmalıdır (veya işlem içinde InitTickArray CPI aracılığıyla burada oluşturulmuş olmalıdır).
• Kullanıcı, kaynak ATA’larında en az amount_0_max ve amount_1_max kadar token bulundurmalıdır.

• personal_position mevcut, liquidity ayarlı, fee_growth_inside_last anlık görüntü alınmış.
• tick_lower ve tick_upper’daki tick-array girişleri güncellendi (liquidity_gross += L, liquidity_net ± L, ücret büyüme anlık görüntüleri korunuyor).
• Pozisyon aralık içindeyse (tick_lower ≤ tick_current < tick_upper) pool_state.liquidity += L.

​

IncreaseLiquidityV2

liquidity: u128
amount_0_max: u64
amount_1_max: u64
base_flag: Option<bool>

• amount_0_actual / amount_1_actual’ı kullanıcıdan vault’lara aktarır.
• personal_position.liquidity ve pool_state.liquidity’yi (aralık içindeyse) ve buna göre uç nokta tick liquidity_gross / liquidity_net’i artırır.
• Son dokunuştan bu yana biriken ücret ve ödülleri dengeler ve bunları tokens_fees_owed_{0,1} / reward_amount_owed’a yazar. Bunlar yalnızca DecreaseLiquidity veya CollectReward’da ödenir, artırmada değil.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Mevcut sqrt_price_x64’e göre kaldırılan L için (amount_0, amount_1)’i hesaplar.
• Son dokunuştan bu yana biriken ücret/ödülleri IncreaseLiquidity ile aynı şekilde dengeler.
• amount_0 + fees_owed_0 ve amount_1 + fees_owed_1’i vault’lardan kullanıcıya aktarır.
• Likidite sayaçlarını azaltır; yeni personal_position.liquidity == 0 ise pozisyon ClosePosition için uygun hale gelir.

​

ClosePosition

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Tüm ödül sayaçları reward_amount_owed == 0.

• NFT’yi yakar.
• NFT mint hesabını ve personal_position hesabını kapatır, kira bedelini payer’a iade eder.

​

SwapV2

amount: u64                  // is_base_input=true ise girdi, aksi takdirde çıktı
other_amount_threshold: u64  // minimum çıktı veya maksimum girdi
sqrt_price_limit_x64: u128   // sabit sınır; 0 ⇒ sınırsız
is_base_input: bool

• pool_state.status swap’a izin veriyor olmalıdır.
• now >= open_time.
• sqrt_price_limit_x64, yön için sqrt_price_x64’ün doğru tarafında olmalıdır.

1. Dinamik ücret ek bedeli — pool.dynamic_fee_info sıfır değilse, program son swap’tan bu yana kat edilen tick mesafesini kullanarak volatilite akümülatörünü günceller (products/clmm/fees içindeki filtre/bozunma kurallarıyla) ve AmmConfig.trade_fee_rate’in üzerine bir dynamic_fee_component ekler. Toplam ücret %10 ile sınırlıdır (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Limit emir eşleştirme — fiyat yürüyüşü açık limit emirleri barındıran bir tick’i geçtiğinde, program önce o tick’teki mevcut limit emri likiditesini (order_phase’e göre FIFO) doldurur, ardından LP likidite eğrisi boyunca devam eder. Doldurulan miktarlar, sonraki uzlaşma için tick.unfilled_ratio_x64 ve tick.part_filled_orders_remaining’i günceller; emirlerin kendisi, sahibi SettleLimitOrder’ı çağırana kadar harcanmamış kalır.
3. Tek taraflı ücret yönlendirmesi — pool.fee_on = Token0Only veya Token1Only olduğunda, swap adımı aynı girdi-çıktı ticaretini hesaplar; ücret daha sonra yapılandırılmış tarafa yönlendirilir. Yapılandırılmış ücret tarafının çıktı olduğu yönler için ücret, swap çıktısından düşülür (kullanıcı çıktı − ücret alır); girdi olduğu yönler için davranış FromInput ile eşleşir. PoolState üzerindeki is_fee_on_input(zero_for_one) ve is_fee_on_token0(zero_for_one) yöntemlerine bakın.

​

OpenLimitOrder

nonce_index:    u8       // kullanıcının seçtiği nonce-account indeksi (cüzdan başına 0..255)
zero_for_one:   bool     // true: token0'ı token1 için sat; false: token1'i token0 için sat
tick_index:     i32      // pool.tick_spacing'in katı olmalıdır
amount:         u64      // girdi token miktarı

• tick_index % pool.tick_spacing == 0 ve [MIN_TICK, MAX_TICK] aralığında olmalıdır.
• tick_index, seçilen yön için pool.tick_current’ın doğru tarafında olmalıdır (token0 satışı → tick mevcut tick’in üzerinde olmalı, tersi de geçerli). Zaten geçilmiş bir tick’te satış yapmak anında eşleşmeye yol açacağından reddedilir.
• pool_state.status, limit emir işlemine izin veriyor olmalıdır (bit 5).

• limit_order mevcut, açılış zamanında tick.order_phase ve tick.unfilled_ratio_x64’ün anlık görüntüsünü alıyor.
• tick.orders_amount += amount (mevcut kohortta).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent yayımlandı.

​

IncreaseLimitOrder

amount: u64    // ek girdi token miktarı

• limit_order.owner == signer.
• Emir hâlâ aynı kohortta (tick.order_phase == limit_order.order_phase). Kohort doldurmaya başlamışsa, emir kısmen uzlaşılmıştır — çağıran önce ilerlemek için DecreaseLimitOrder veya SettleLimitOrder’ı çağırmalıdır.

• amount’ı sahip ATA’sından input_vault’a aktarır.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // geri çekilecek girdi token miktarı (maksimum = doldurulmamış kalan)
amount_min: u64    // girdi tarafı geri çekimi için slippage tabanı

• Açılıştan bu yana kohortun unfilled_ratio_x64’ünden emrin doldurulan miktarını yeniden hesaplar.
• Doldurulan çıktıyı output_token_account’a gönderir.
• Doldurulmamış girdiden amount kadarını input_token_account’a geri gönderir.
• limit_order’ı buna göre günceller. Yeni doldurulmamış kalan sıfırsa, program hesabı kapatır ve kira bedelini owner’a iade eder.

​

SettleLimitOrder

• (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64) kullanılarak borçlu birikimli çıktıyı hesaplar.
• Deltayı output_token_account’a aktarır.
• limit_order.settled_output’u günceller.
• Emri kapatmaz; kalan girdi için hâlâ açıktır.

​

CloseLimitOrder

• Emrin doldurulmamış kalanı sıfırdır (ya amount == total_amount dolduruldu ve uzlaşıldı, ya da sahip daha önce emri sıfıra düşürüp kapatmayı unuttu).

• limit_order’ı kapatır; kira bedeli limit_order.owner’a gönderilir.

​

CreateDynamicFeeConfig (yönetici)

index:                       u16
filter_period:               u16   // saniye; örn. 30
decay_period:                u16   // saniye; örn. 600. filter_period'dan büyük olmalıdır
reduction_factor:            u16   // 1..10_000; örn. 5_000 = bozunma penceresi başına %50 saklama
dynamic_fee_control:         u32   // 1..100_000; volatilite-ücret eğrisindeki kazanım
max_volatility_accumulator:  u32   // tavan

​

UpdateDynamicFeeConfig (yönetici)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

open_time:     u64
end_time:      u64
emissions_per_second_x64: u128   // Q64.64

• Havuzda şu anda 3’ten az aktif akış var.
• Fon sağlayıcı, bu talimatın bir parçası olarak vault’a total_emission = emissions_per_second × (end_time − open_time) değerinde ödül tokeni yatırır.
• operation_state uyarınca beyaz listedeki ödül mint’i.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Ödül büyümesini dengeler (ücretlerle aynı model).
• Borçlu miktarı alıcı ATA’sına aktarır, reward_amount_owed[i]’yi sıfırlar.

​

Durum değişikliği matrisi

​

Sonraki adımlar

• products/clmm/code-demos — çalıştırılabilir TypeScript örnekleri.
• products/clmm/fees — ücret ve ödül tahakkuku hakkında ayrıntılar.
• reference/error-codes — eksiksiz CLMM Anchor hata tablosu.

• raydium-io/raydium-clmm — programs/amm/src/instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2