CLMM talimatları

​

Talimat envanteri

​

CreatePool

sqrt_price_x64: u128           // başlangıç fiyatı
open_time:      u64            // bu saatten önce swaplar reddedilir

• token_mint_0 < token_mint_1 bayt sırasına göre.
• amm_config.disable_create_pool == false.
• Mint’ler Token-2022 uzantısı izin listesi tarafından reddedilmez.

• 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ırlanır (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ştirilirse: pool_state.dynamic_fee_info sağlanan DynamicFeeConfig öğesinden 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).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // CreateCustomizablePool ile aynı yapı
seed_index:          u16                          // sıfır olmayan olmalıdır; havuz PDA seed'lerine katlanır

• seed_index != 0. 0 değerindeki seed_index eski havuzlar için ayrılmıştır ve burada reddedilir; [0, 0] seed bileşeni, eski bir havuz adresinin klasik dört seed formuna çökmesini sağlayan şeydir.
• payer için permission PDA’sı var (yönetici tarafından CreatePermissionPda aracılığıyla oluşturulmuş).
• CreatePool ile aynı mint / izin listesi kuralları.

• Yeni bir pool_state seed_index türetilmiş adresinde var; pool_state.seed_index = seed_index.
• Diğer tüm son durum CreateCustomizablePool ile eşleşir (ücret modu, isteğe bağlı dinamik ücret).

​

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 tutarları 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 sığdır; false = amount1'e sığdır

• tick_lower < tick_upper, her ikisi de pool.tick_spacing katları, [MIN_TICK, MAX_TICK] içinde.
• Gerekli tick dizileri geçilir ve başlatılır (veya işlemde InitTickArray CPI aracılığıyla burada oluşturulur).
• Kullanıcı kaynak ATA’larında en az amount_0_max ve amount_1_max öğesine sahiptir.

• personal_position var, liquidity ayarlanmış, fee_growth_inside_last anlık görüntüsü alınmış.
• Tick dizisi girdileri tick_lower ve tick_upper öğelerinde güncellenir (liquidity_gross += L, liquidity_net ± L, ücret büyümesi anlık görüntüleri korunur).
• pool_state.liquidity += L pozisyon aralıkta ise (tick_lower ≤ tick_current < tick_upper).
• Pozisyon NFT mint’i pool_state öğesini dondurma yetkilisi olarak kaydeder. Mint yetkilisi tek NFT basıldıktan sonra kaldırılır. Dondurma yetkilisini kaydetmek NFT token hesabının durumunu değiştirmez.
• NFT token hesabı, talimat OpenPositionV2 veya OpenPositionWithToken22Nft ve kasa mint’lerinden herhangi birinin dondurma yetkilisi CLMM’nin kısıtlı yayıncı listesiyle eşleşmediği sürece donmuş kalır. Yalnızca eşleşen V2 yolu hesabı dondurur. OpenPosition V1 dondurmaz.

​

IncreaseLiquidityV2

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

• amount_0_actual / amount_1_actual öğesini kullanıcıdan → kasalara aktarır.
• personal_position.liquidity ve pool_state.liquidity (aralıkta ise) ve uç nokta tick’i liquidity_gross / liquidity_net öğesini artırır.
• Son dokunuştan bu yana borçlu olunan ücretleri ve ödülleri toplar ve tokens_fees_owed_{0,1} / reward_amount_owed öğesine kredi verir. Bunlar yalnızca DecreaseLiquidity veya CollectReward öğesinde ödenir, artışta değil.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Geçerli sqrt_price_x64 verilen kaldırılan L için (amount_0, amount_1) öğesini hesaplar.
• Son dokunuştan bu yana tahakkuk eden ücretleri/ödülleri kapatır; IncreaseLiquidity ile aynı.
• amount_0 + fees_owed_0 ve amount_1 + fees_owed_1 öğesini kasalardan 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

• Donmuş olmayan NFT: hiçbiri gerekli değil; ekstra havuz hesabı zararsızdır çünkü işleyici onu okumaz.
• Donmuş NFT: personal_position.pool_id öğesini ilk kalan hesap olarak ekleyin. Program bunu PoolState olarak yükler ve çözmek için PDA seed’lerini kullanır.

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

• NFT token hesabı donmuşsa, ilk kalan hesabın personal_position.pool_id öğesine eşit olduğunu doğrular, sonra havuz PDA’sı ile çözer.
• NFT’yi yakar.
• NFT token hesabını ve personal_position öğesini kapatır; kirayı nft_owner öğesine geri verir. Pozisyon NFT’si Token-2022 kullanıyorsa, NFT mint’ini de kapatır; klasik SPL Token mint’leri kapatılamaz ve sıfır arzla kalır.

​

SwapV2

amount: u64                  // is_base_input=true ise giriş, aksi takdirde çıkış
other_amount_threshold: u64  // min çıkış veya max giriş
sqrt_price_limit_x64: u128   // sabit sınır; 0 ⇒ sınırsız
is_base_input: bool

• pool_state.status swapa izin verir.
• now >= open_time.
• sqrt_price_limit_x64 yön için sqrt_price_x64 öğesinin doğru tarafında.

1. Dinamik ücret ek ücreti — pool.dynamic_fee_info sıfır değilse, program son swaptan bu yana geçilen tick mesafesini kullanarak oynaklık biriktiricisini günceller (filtre/bozunma kuralları products/clmm/fees öğesinden) ve AmmConfig.trade_fee_rate öğesinin üzerine dynamic_fee_component ekler. Toplam ücret %10 ile sınırlandırılır (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Limit emri eşleştirmesi — fiyat yürüyüşü açık limit emirleri tutan bir tick’i geçtiğinde, program önce o tick’te mevcut limit emri likiditeyi doldurur (FIFO order_phase öğesine göre), sonra LP likidite eğrisi boyunca ilerler. Doldurulmuş tutarlar tick.unfilled_ratio_x64 ve tick.part_filled_orders_remaining öğesini daha sonraki kapatma için günceller; emirler kendileri sahibi SettleLimitOrder çağırana kadar harcı olmaz.
3. Tek taraflı ücret yönlendirmesi — pool.fee_on = Token0Only veya Token1Only olduğunda, swap adımı yine de aynı giriş-çıkış ticaretini hesaplar; ücret daha sonra yapılandırılan tarafa yönlendirilir. Yapılandırılan ücret tarafının çıkış olduğu yönler için, ücret swap çıkışından düşülür (kullanıcı out − fee alır); yapılandırılan tarafın giriş olduğu yönler için davranış FromInput ile eşleşir. PoolState öğesinde is_fee_on_input(zero_for_one) ve is_fee_on_token0(zero_for_one) öğesine bakın.

​

OpenLimitOrder

nonce_index:    u8       // kullanıcının seçilen nonce hesabı dizini (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 katı olmalıdır
amount:         u64      // giriş token tutarı

• Ne input_token_account ne de output_token_account donmuş değildir (aksi takdirde NotApproved).
• pool_state.status hem swap (bit 4) hem de limit emri (bit 5) işlemlerine izin verir (aksi takdirde NotApproved).
• tick_index % pool.tick_spacing == 0 ve [MIN_TICK, MAX_TICK] içinde.
• tick_index seçilen yön için pool.tick_current öğesinin sağ tarafında (token0 satışı → tick geçerli olmalıdır, ve tersi). Zaten geçilmiş bir tick’te satış hemen eşleştirilir ve reddedilir.

• limit_order var; açılış zamanında tick.order_phase ve tick.unfilled_ratio_x64 anlık görüntüsü alınmış.
• tick.orders_amount += amount (geçerli kohortunda).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent yayınlandı.

​

IncreaseLimitOrder

amount: u64    // ek giriş token tutarı

• limit_order.owner == signer.
• Emir hala aynı kohortda (tick.order_phase == limit_order.order_phase). Kohort zaten doldurulmaya başlamışsa, emir kısmen kapatılmıştır — çağıran önce DecreaseLimitOrder veya SettleLimitOrder çağırmalıdır.

• amount öğesini sahibi ATA’sından input_vault öğesine aktarır.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // çekilecek giriş token tutarı (max = doldurulmayan kalan)
amount_min: u64    // giriş tarafı çekme işleminde kayma tabanı

• Emrin doldurulmuş tutarını açılıştan bu yana kohortun unfilled_ratio_x64 öğesinden yeniden hesaplar.
• Doldurulmuş çıktıyı output_token_account öğesine gönderir.
• amount doldurulmayan girişi input_token_account öğesine geri gönderir.
• limit_order öğesini buna göre günceller. Yeni doldurulmayan kalan sıfırsa, program hesabı kapatır ve kirayı owner öğesine geri verir.

​

SettleLimitOrder

• (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64) kullanarak borçlu olunan kümülatif çıktıyı hesaplar.
• Deltayı output_token_account öğesine aktarır.
• limit_order.settled_output öğesini günceller.
• Emri kapatmaz; kalan giriş karşısında hala açıktır.

​

CloseLimitOrder

• Emrin sıfır doldurulmayan kalanı var (amount == total_amount doldurulmuş ve kapatılmış veya sahibi daha önce emri sıfıra azaltmış ve kapatmayı unutmuş).

• limit_order öğesini kapatır; kira limit_order.owner öğesine 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 tutma
dynamic_fee_control:         u32   // 1..100_000; oynaklık-ücret eğrisinde kazanç
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 akış etkin.
• Fon sağlayıcı bu talimatın bir parçası olarak total_emission = emissions_per_second × (end_time − open_time) değerinde ödül tokenini kasaya yatırır.
• operation_state başına beyaz listeye alınan ödül mint’i.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Ödül büyümesini kapatır (ücretler ile aynı desen).
• Borçlu tutarı alıcı ATA’sına aktarır; reward_amount_owed[i] öğesini sıfırlar.

​

Durum değişikliği matrisi

​

Sonraki adım

• 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 — kapsamlı CLMM Anchor hata tablosu.

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