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 putih 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 / daftar putih yang sama dengan CreatePool.

• pool_state baru ada di alamat yang diturunkan seed_index, dengan pool_state.seed_index = seed_index.
• Semua kecocokan post-state lainnya 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].
• Tick array yang diperlukan dilewatkan dan diinisialisasi (atau dibuat di sini melalui CPI InitTickArray dalam transaksi).
• 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 otoritas pembekuan. Otoritas mint dihapus setelah NFT tunggal dimint. Mencatat otoritas pembekuan tidak mengubah status akun token NFT.
• Akun token NFT tetap tidak beku kecuali instruksi adalah OpenPositionV2 atau OpenPositionWithToken22Nft dan otoritas pembekuan mint vault cocok dengan daftar penerbit terbatas 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 mengkreditnya ke tokens_fees_owed_{0,1} / reward_amount_owed. Ini dibayarkan hanya pada DecreaseLiquidity atau CollectReward, bukan pada peningkatan.

​

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 tambahan 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, kemudian cairkan dengan PDA pool.
• Bakar NFT.
• Tutup akun token NFT dan personal_position, mengembalikan 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 jika tidak
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 arah.

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. Pencocokan limit-order — ketika jalan harga melintasi tick yang memegang pesanan limit terbuka, program pertama-tama mengisi likuiditas limit-order yang tersedia di tick itu (FIFO menurut 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. Perutean biaya satu sisi — ketika pool.fee_on = Token0Only atau Token1Only, langkah swap masih menghitung input-output perdagangan yang sama; biaya kemudian dirutkan 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 di tick yang sudah dilintasi akan segera cocok dan ditolak.

• limit_order ada, mengambil snapshot tick.order_phase dan tick.unfilled_ratio_x64 saat dibuka.
• tick.orders_amount += amount (di 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 terisi pesanan dari unfilled_ratio_x64 kohort sejak dibuka.
• Mengirim output 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   // batas

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

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

• Kurang dari 3 aliran saat ini aktif di pool.
• Pendana menyetor total_emission = emissions_per_second × (end_time − open_time) senilai token reward ke vault sebagai bagian dari instruksi ini.
• Mint reward yang masuk daftar putih per operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

• Menyelesaikan pertumbuhan reward (pola yang sama dengan biaya).
• Mentransfer jumlah yang terhutang ke ATA penerima, menolkan reward_amount_owed[i].

​

Matriks perubahan status

​

Ke mana selanjutnya

• products/clmm/code-demos — sampel TypeScript yang dapat dijalankan.
• products/clmm/fees — detail tentang akrual biaya dan reward.
• reference/error-codes — tabel kesalahan Anchor CLMM lengkap.

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