Instruksi CLMM

​

Inventaris instruksi

​

CreatePool

sqrt_price_x64: u128           // harga awal
open_time:      u64            // swap ditolak sebelum waktu ini

• token_mint_0 < token_mint_1 menurut urutan byte.
• amm_config.disable_create_pool == false.
• Mint tidak ditolak oleh daftar izin ekstensi Token-2022.

• pool_state.sqrt_price_x64 = sqrt_price_x64, tick_current = floor(log_{1.0001}(price)).
• pool_state.liquidity = 0 (belum ada posisi).
• pool_state.fee_on = FromInput (default warisan).
• pool_state.dynamic_fee_info adalah nol (dynamic fee dinonaktifkan).

​

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 diatur ke varian CollectFeeOn yang dipilih.
• Jika dynamic fee diaktifkan: pool_state.dynamic_fee_info diinisialisasi dari DynamicFeeConfig yang disediakan (lima parameter kalibrasi disalin; bidang state dinolkan).
• Jika tidak: pool_state.dynamic_fee_info adalah nol (= dynamic fee tidak aktif selamanya untuk pool ini).

​

CreatePermissionedPool

customizable_params: CreateCustomizableParams   // struct yang sama dengan CreateCustomizablePool
seed_index:          u16                          // harus bukan nol; dilipat ke dalam seed PDA pool

• seed_index != 0. seed_index dari 0 dicadangkan untuk pool warisan dan ditolak di sini; komponen seed [0, 0] adalah apa yang membuat alamat pool warisan runtuh ke bentuk empat-seed klasik.
• PDA permission untuk payer ada (dibuat oleh admin melalui CreatePermissionPda).
• Aturan mint / allow-list yang sama dengan CreatePool.

• pool_state baru ada di alamat yang diturunkan seed_index, dengan pool_state.seed_index = seed_index.
• Semua post-state lainnya cocok dengan CreateCustomizablePool (mode biaya, dynamic fee opsional).

​

OpenPositionV2 / OpenPositionWithToken22Nft

tick_lower_index: i32
tick_upper_index: i32
tick_array_lower_start_index: i32
tick_array_upper_start_index: i32
liquidity:  u128              // L yang diinginkan (atau 0 untuk menggunakan jumlah di bawah)
amount_0_max: u64
amount_1_max: u64
with_metadata: bool           // tulis metadata NFT (Metaplex)
base_flag: Option<bool>       // true = sesuaikan dengan amount0; false = sesuaikan dengan amount1

• tick_lower < tick_upper, keduanya kelipatan pool.tick_spacing, dalam [MIN_TICK, MAX_TICK].
• Dua PDA tick-array dilewatkan. Mereka tidak perlu sudah ada — get_or_create_tick_array mengalokasikan yang hilang dengan biaya payer di dalam instruksi ini. Tidak ada instruksi init-tick-array terpisah.
• Pengguna memiliki setidaknya amount_0_max dan amount_1_max di ATA sumber.

• personal_position ada, liquidity diatur, fee_growth_inside_last diambil snapshot.
• Entri tick-array di tick_lower dan tick_upper diperbarui (liquidity_gross += L, liquidity_net ± L, snapshot pertumbuhan biaya dipertahankan).
• pool_state.liquidity += L jika posisi dalam jangkauan (tick_lower ≤ tick_current < tick_upper).
• Mint NFT posisi mencatat pool_state sebagai freeze authority. Mint authority dihapus setelah NFT tunggal dimint. Mencatat freeze authority tidak mengubah status akun token NFT.
• Akun token NFT tetap tidak beku kecuali instruksinya adalah OpenPositionV2 atau OpenPositionWithToken22Nft dan freeze authority mint vault cocok dengan daftar restricted-issuer CLMM. Hanya jalur V2 yang cocok yang membekukan akun. OpenPosition V1 tidak membekukan.

​

IncreaseLiquidityV2

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

• Mentransfer amount_0_actual / amount_1_actual dari pengguna → vault.
• Menambah personal_position.liquidity dan pool_state.liquidity (jika dalam jangkauan), dan liquidity_gross / liquidity_net tick endpoint sesuai.
• Mengumpulkan biaya dan reward yang terhutang sejak sentuhan terakhir dan mengkreditkannya ke token_fees_owed_{0,1} / reward_amount_owed. Ini dibayarkan hanya pada DecreaseLiquidity / DecreaseLiquidityV2, bukan pada peningkatan — tidak ada instruksi pengumpulan standalone.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

• Menghitung (amount_0, amount_1) untuk L yang dihapus diberikan sqrt_price_x64 saat ini.
• Menyelesaikan biaya/reward yang terkumpul sejak sentuhan terakhir, sama dengan IncreaseLiquidity.
• Mentransfer amount_0 + fees_owed_0 dan amount_1 + fees_owed_1 keluar dari vault ke pengguna.
• Mengurangi penghitung likuiditas; jika personal_position.liquidity baru == 0, posisi memenuhi syarat untuk ClosePosition.

​

ClosePosition

• NFT tidak beku: tidak ada yang diperlukan; akun pool ekstra tidak berbahaya karena handler tidak membacanya.
• NFT beku: tambahkan personal_position.pool_id sebagai akun sisa pertama. Program memuatnya sebagai PoolState dan menggunakan seed PDA-nya untuk menandatangani pencairan.

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Semua penghitung reward reward_amount_owed == 0.

• Jika akun token NFT beku, verifikasi akun sisa pertama sama dengan personal_position.pool_id, lalu cairkan dengan PDA pool.
• Bakar NFT.
• Tutup akun token NFT dan personal_position, kembalikan sewa ke nft_owner. Jika NFT posisi menggunakan Token-2022, ia juga menutup mint NFT; mint SPL Token klasik tidak dapat ditutup dan tetap dengan pasokan nol.

​

SwapV2

amount: u64                  // input jika is_base_input=true, output sebaliknya
other_amount_threshold: u64  // min out atau max in
sqrt_price_limit_x64: u128   // batas keras; 0 ⇒ tidak terbatas
is_base_input: bool

• pool_state.status memungkinkan swap.
• now >= open_time.
• sqrt_price_limit_x64 berada di sisi yang benar dari sqrt_price_x64 untuk arahnya.

1. Surcharge dynamic fee — jika pool.dynamic_fee_info bukan nol, program memperbarui akumulator volatilitas menggunakan jarak tick yang dilintasi sejak swap terakhir (dengan aturan filter/decay dari products/clmm/fees) dan menambahkan dynamic_fee_component di atas AmmConfig.trade_fee_rate. Total biaya dibatasi pada 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Limit-order matching — ketika berjalan harga melintasi tick yang memegang pesanan limit terbuka, program pertama-tama mengisi likuiditas limit-order yang tersedia di tick itu (FIFO oleh order_phase), kemudian melanjutkan di sepanjang kurva likuiditas LP. Jumlah yang terisi memperbarui tick.unfilled_ratio_x64 dan tick.part_filled_orders_remaining untuk penyelesaian nanti; pesanan itu sendiri tetap tidak dihabiskan sampai pemiliknya memanggil SettleLimitOrder.
3. Single-sided fee routing — ketika pool.fee_on = Token0Only atau Token1Only, langkah swap masih menghitung perdagangan input-output yang sama; biaya kemudian dirutekan ke sisi yang dikonfigurasi. Untuk arah di mana sisi biaya yang dikonfigurasi adalah output, biaya dikurangi dari output swap (pengguna menerima out − fee); untuk arah di mana itu adalah input, perilaku cocok dengan FromInput. Lihat is_fee_on_input(zero_for_one) dan is_fee_on_token0(zero_for_one) pada PoolState.

​

OpenLimitOrder

nonce_index:    u8       // indeks akun nonce yang dipilih pengguna (0..255 per dompet)
zero_for_one:   bool     // true: jual token0 untuk token1; false: jual token1 untuk token0
tick_index:     i32      // harus kelipatan pool.tick_spacing
amount:         u64      // jumlah token input

• Baik input_token_account maupun output_token_account tidak beku (jika tidak NotApproved).
• pool_state.status memungkinkan operasi swap (bit 4) dan limit-order (bit 5) (jika tidak NotApproved).
• tick_index % pool.tick_spacing == 0 dan dalam [MIN_TICK, MAX_TICK].
• tick_index berada di sisi kanan pool.tick_current untuk arah yang dipilih (menjual token0 → tick harus di atas saat ini, dan sebaliknya). Menjual pada tick yang sudah dilintasi akan cocok segera dan ditolak.

• limit_order ada, mengambil snapshot tick.order_phase dan tick.unfilled_ratio_x64 saat pembukaan.
• tick.orders_amount += amount (dalam kohort saat ini).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent dipancarkan.

​

IncreaseLimitOrder

amount: u64    // jumlah token input tambahan

• limit_order.owner == signer.
• Pesanan masih dalam kohort yang sama (tick.order_phase == limit_order.order_phase). Jika kohort sudah mulai terisi, pesanan sebagian diselesaikan — pemanggil harus memanggil DecreaseLimitOrder atau SettleLimitOrder terlebih dahulu untuk maju.

• Mentransfer amount dari ATA pemilik ke input_vault.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

amount:     u64    // jumlah token input untuk ditarik (maks = sisa yang tidak terisi)
amount_min: u64    // lantai slippage pada penarikan sisi input

• Menghitung ulang jumlah yang terisi pesanan dari unfilled_ratio_x64 kohort sejak pembukaan.
• Mengirim output yang terisi ke output_token_account.
• Mengirim amount input yang tidak terisi kembali ke input_token_account.
• Memperbarui limit_order sesuai. Jika sisa yang tidak terisi baru adalah nol, program menutup akun dan mengembalikan sewa ke owner.

​

SettleLimitOrder

• Menghitung output kumulatif yang terhutang menggunakan (limit_order.unfilled_ratio_x64, tick.unfilled_ratio_x64).
• Mentransfer delta ke output_token_account.
• Memperbarui limit_order.settled_output.
• Tidak menutup pesanan; masih terbuka terhadap input yang tersisa.

​

CloseLimitOrder

• Pesanan memiliki sisa yang tidak terisi nol (baik amount == total_amount terisi dan diselesaikan, atau pemilik sebelumnya mengurangi pesanan ke nol dan lupa menutup).

• Menutup limit_order; sewa dikirim ke limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // detik; misalnya 30
decay_period:                u16   // detik; misalnya 600. Harus > filter_period
reduction_factor:            u16   // 1..10_000; misalnya 5_000 = 50% retensi per jendela decay
dynamic_fee_control:         u32   // 1..100_000; gain pada kurva volatilitas-ke-biaya
max_volatility_accumulator:  u32   // plafon

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

CollectExcessLamports

• NotApproved (6000): penandatangan yang salah.
• LamportsCalculateError (6052): putaran wSOL tidak netto ke nol.
• Kesalahan ketidakcocokan pemilik token-program: sumber token tidak dimiliki oleh pool_state.
• InsufficientFunds: akun yang dimiliki program menyimpan kurang dari minimum sewa-nya sendiri.

​

InitializeReward