Instruksi CLMM

​

Daftar instruksi

​

CreatePool

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

• token_mint_0 < token_mint_1 berdasarkan 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 lama).
• pool_state.dynamic_fee_info dinolkan (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 diberikan (lima parameter kalibrasi disalin; kolom state dinolkan).
• Jika tidak: pool_state.dynamic_fee_info dinolkan (= dynamic fee tidak aktif selamanya untuk pool ini).

​

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 merupakan kelipatan dari pool.tick_spacing, berada dalam rentang [MIN_TICK, MAX_TICK].
• Tick array yang diperlukan sudah 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 snapshotnya.
• Entri tick-array pada tick_lower dan tick_upper diperbarui (liquidity_gross += L, liquidity_net ± L, snapshot pertumbuhan fee dipertahankan).
• pool_state.liquidity += L jika posisi berada dalam rentang (tick_lower ≤ tick_current < tick_upper).

​

IncreaseLiquidityV2

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

• Mentransfer amount_0_actual / amount_1_actual dari pengguna ke vault.
• Menaikkan personal_position.liquidity dan pool_state.liquidity (jika dalam rentang), serta liquidity_gross / liquidity_net pada tick ujung posisi.
• Mengumpulkan fee dan reward yang terutang sejak sentuhan terakhir dan mengkreditkannya ke tokens_fees_owed_{0,1} / reward_amount_owed. Jumlah tersebut baru dibayarkan saat DecreaseLiquidity atau CollectReward, bukan saat penambahan.

​

DecreaseLiquidityV2

liquidity: u128
amount_0_min: u64
amount_1_min: u64

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

​

ClosePosition

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

• Membakar NFT.
• Menutup akun mint NFT dan akun personal_position, mengembalikan rent ke payer.

​

SwapV2

amount: u64                  // input jika is_base_input=true, output jika sebaliknya
other_amount_threshold: u64  // minimum output atau maksimum input
sqrt_price_limit_x64: u128   // batas keras; 0 ⇒ tidak dibatasi
is_base_input: bool

• pool_state.status mengizinkan swap.
• now >= open_time.
• sqrt_price_limit_x64 berada di sisi yang benar dari sqrt_price_x64 untuk arah yang dipilih.

1. Surcharge dynamic fee — jika pool.dynamic_fee_info bukan nol, program memperbarui akumulator volatilitas menggunakan jarak tick yang dilalui sejak swap terakhir (dengan aturan filter/peluruhan dari products/clmm/fees) dan menambahkan dynamic_fee_component di atas AmmConfig.trade_fee_rate. Total fee dibatasi pada 10% (MAX_FEE_RATE_NUMERATOR / 1_000_000).
2. Pencocokan limit order — saat perjalanan harga melintasi tick yang memiliki limit order terbuka, program pertama-tama mengisi likuiditas limit order yang tersedia pada tick tersebut (FIFO berdasarkan order_phase), lalu melanjutkan sepanjang kurva likuiditas LP. Jumlah yang terisi memperbarui tick.unfilled_ratio_x64 dan tick.part_filled_orders_remaining untuk penyelesaian selanjutnya; order itu sendiri tetap tidak terselesaikan hingga pemiliknya memanggil SettleLimitOrder.
3. Routing fee satu sisi — saat pool.fee_on = Token0Only atau Token1Only, langkah swap tetap menghitung pertukaran input-output yang sama; fee kemudian diarahkan ke sisi yang dikonfigurasi. Untuk arah di mana sisi fee yang dikonfigurasi adalah output, fee dikurangi dari output swap (pengguna menerima out − fee); untuk arah di mana sisi fee adalah input, perilakunya sama 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 wallet)
zero_for_one:   bool     // true: jual token0 untuk token1; false: jual token1 untuk token0
tick_index:     i32      // harus merupakan kelipatan dari pool.tick_spacing
amount:         u64      // jumlah token input

• tick_index % pool.tick_spacing == 0 dan berada dalam rentang [MIN_TICK, MAX_TICK].
• tick_index berada di sisi kanan pool.tick_current untuk arah yang dipilih (menjual token0 → tick harus di atas tick saat ini, dan sebaliknya). Menjual pada tick yang sudah dilewati akan langsung dicocokkan dan ditolak.
• pool_state.status mengizinkan operasi limit order (bit 5).

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

​

IncreaseLimitOrder

amount: u64    // jumlah token input tambahan

• limit_order.owner == signer.
• Order masih berada dalam kohort yang sama (tick.order_phase == limit_order.order_phase). Jika kohort sudah mulai terisi, order tersebut sebagian diselesaikan — pemanggil sebaiknya memanggil DecreaseLimitOrder atau SettleLimitOrder terlebih dahulu untuk maju ke depan.

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

​

DecreaseLimitOrder

amount:     u64    // jumlah token input yang ditarik (maks = sisa yang belum terisi)
amount_min: u64    // batas slippage minimum pada penarikan sisi input

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

​

SettleLimitOrder

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

​

CloseLimitOrder

• Order memiliki sisa yang belum terisi sebesar nol (baik amount == total_amount sudah terisi dan diselesaikan, atau pemilik sebelumnya mengurangi order ke nol dan lupa menutupnya).

• Menutup limit_order; rent dikirimkan ke limit_order.owner.

​

CreateDynamicFeeConfig (admin)

index:                       u16
filter_period:               u16   // detik; mis. 30
decay_period:                u16   // detik; mis. 600. Harus > filter_period
reduction_factor:            u16   // 1..10_000; mis. 5_000 = retensi 50% per jendela peluruhan
dynamic_fee_control:         u32   // 1..100_000; gain pada kurva volatilitas-ke-fee
max_volatility_accumulator:  u32   // batas atas

​

UpdateDynamicFeeConfig (admin)

​

CollectProtocolFee / CollectFundFee

​

InitializeReward

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

• Kurang dari 3 aliran yang saat ini aktif pada pool.
• Funder menyetor total_emission = emissions_per_second × (end_time − open_time) token reward ke vault sebagai bagian dari instruksi ini.
• Mint reward diizinkan oleh operation_state.

​

SetRewardParams

​

UpdateRewardInfos

​

CollectReward

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

​

Matriks perubahan state

​

Langkah selanjutnya

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

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