CLMM talimatları

​

Talimat envanteri

​

CreatePool

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

• token_mint_0 < token_mint_1 bayt sırasına göre.
• amm_config.disable_create_pool == false.
• Mint’ler Token-2022 uzantı 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’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).

​

CreatePermissionedPool

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

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

• Yeni pool_state seed_index-türetilmiş adresinde vardır; 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ın (Metaplex)
base_flag: Option<bool>       // true = amount0'a sığdır; false = amount1'e sığdır

• tick_lower < tick_upper, her ikisi pool.tick_spacing’in katları, [MIN_TICK, MAX_TICK] içinde.
• İki tick-array PDA’sı geçirilir. Zaten var olması gerekmez — get_or_create_tick_array eksik olanı bu talimat içinde payer’ın masrafına ayırır. Ayrı bir init-tick-array talimatı yoktur.
• Kullanıcı kaynak ATA’larında en az amount_0_max ve amount_1_max vardır.

• personal_position vardır; liquidity ayarlanır; fee_growth_inside_last anlık görüntü alınır.
• Tick-array girdileri tick_lower ve tick_upper’da 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’i 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’inin 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’ı kullanıcı → kasalar’dan aktarır.
• personal_position.liquidity ve pool_state.liquidity (aralıkta ise) artırır ve uç nokta-tick liquidity_gross / liquidity_net’i buna göre artırır.
• Son dokunuştan bu yana borçlu ücretleri ve ödülleri toplar ve token_fees_owed_{0,1} / reward_amount_owed’e kredi verir. Bunlar yalnızca DecreaseLiquidity / DecreaseLiquidityV2’de ödenir; artışta değil — bağımsız bir toplama talimatı yoktur.

​

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) 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’i 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ı işleyici bunu okumadığı için zararsızdır.
• Donmuş NFT: personal_position.pool_id’yi 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’ye eşit olduğunu doğrular; ardından havuz PDA’sı ile çözer.
• NFT’yi yakar.
• NFT token hesabını ve personal_position’ı kapatır; kirayı nft_owner’a geri öder. 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 swap’a izin verir.
• now >= open_time.
• sqrt_price_limit_x64 yön için sqrt_price_x64’ün doğru tarafındadır.

1. Dinamik ücret ek ücreti — pool.dynamic_fee_info sıfır değilse, program son swap’tan bu yana geçilen tick mesafesini kullanarak volatilite biriktiricisini günceller (filtre/bozunma kuralları products/clmm/fees’den) ve AmmConfig.trade_fee_rate’nin üzerine dynamic_fee_component ekler. Toplam ücret %10 ile sınırlanı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 tarafından), ardından LP likidite eğrisi boyunca ilerler. Doldurulmuş tutarlar tick.unfilled_ratio_x64 ve tick.part_filled_orders_remaining’i 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’de is_fee_on_input(zero_for_one) ve is_fee_on_token0(zero_for_one) bakın.

​

OpenLimitOrder

nonce_index:    u8       // kullanıcının seçtiği nonce-hesap 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ı
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’ın doğru tarafında (token0 satmak → tick mevcut üzerinde olmalı ve tersi). Zaten geçilmiş bir tick’te satmak hemen eşleştirilir ve reddedilir.

• limit_order vardır; tick.order_phase ve tick.unfilled_ratio_x64’ü açık zamanda anlık görüntü alır.
• tick.orders_amount += amount (mevcut kohortda).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent yayınlanır.

​

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’ı sahibi ATA’sından input_vault’a aktarır.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // geri çekilecek giriş-token tutarı (max = doldurulmayan kalan)
amount_min: u64    // giriş tarafı çekilişinde kayma tabanı

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

​

SettleLimitOrder

• (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64) kullanarak kümülatif çıkış borçlu tutarını hesaplar.
• Deltayı output_token_account’a aktarır.
• limit_order.settled_output’u günceller.
• Emri kapatmaz; kalan giriş karşısında hala açıktır.

​

CloseLimitOrder

• Emrin sıfır doldurulmayan kalanı vardır (ya amount == total_amount dolduruldu ve kapatıldı, ya da sahibi daha önce emri sıfıra azalttı ve kapatmayı unuttu).

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

​

CreateDynamicFeeConfig (admin)

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

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee