Instruksi CLMM

Referensi lengkap instruksi CLMM: siklus hidup pool, manajemen posisi, swap, dan aliran reward.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.

Lihat versi bahasa Inggris →

Halaman ini berpasangan dengan products/clmm/accounts (apa itu akun) dan products/clmm/math (apa itu matematika). Halaman ini adalah acuan otoritatif untuk argumen dan urutan akun; tata letak byte spesifik berasal dari IDL.

Upgrade program 2026-09 membangun kembali CLMM di Anchor 1.0.2 / Solana 3.1.10, menambahkan instruksi admin CollectExcessLamports, dan mengubah apa yang ditulis CreateAmmConfig ke dalam owner / fund_owner. Tidak ada instruksi yang menghadap pengguna yang mengubah akun, argumen, atau matematikanya. Lihat entri changelog 2026-09-30.

Upgrade program 2026-10-22 mengganti nama CreatePermissionedPool menjadi CreateCustomizablePoolV2, membuatnya dapat dipanggil oleh siapa saja, dan menghapus akun Permission beserta dua instruksi adminnya. Lihat entri changelog 2026-10-22.

​

Inventaris instruksi

Grup	Instruksi	Catatan
Admin	CreateAmmConfig	Tentukan tier biaya baru.
Admin	UpdateAmmConfig	Ubah tarif pada tier yang ada.
Admin	UpdatePoolStatus	Jeda/lanjutkan operasi pada pool.
Admin	CreateSupportMintAssociated	Daftar konfigurasi ekstensi mint Token-2022 untuk digunakan di pool CLMM.
Admin	CreateOperationAccount	Inisialisasi akun operasi tingkat program (sekali saja).
Admin	UpdateOperationAccount	Ubah daftar putih akun operasi.
Admin	CreateDynamicFeeConfig	Buat set parameter dynamic-fee yang dapat digunakan kembali di bawah indeks u16.
Admin	UpdateDynamicFeeConfig	Ubah DynamicFeeConfig yang ada. Pool yang sudah mengambil snapshotnya tidak terpengaruh.
Pool	CreatePool	Inisialisasi pool CLMM yang terikat pada AmmConfig. Jalur biaya standar, FromInput. Berdampingan dengan CreateCustomizablePool.
Pool	CreateCustomizablePool	Direkomendasikan untuk pool baru. Bentuk yang sama dengan CreatePool ditambah collect_fee_on dan flag enable_dynamic_fee yang opsional.
Pool	CreateCustomizablePoolV2	Buat pool tambahan untuk pasangan dan tier biaya yang sudah memiliki satu, menggunakan seed_index bukan nol yang disediakan klien dan dilipat ke dalam PDA pool. Tanpa izin. Disebut CreatePermissionedPool sebelum 2026-10-22.
Posisi	OpenPosition / OpenPositionV2 / OpenPositionWithToken22Nft	Mint NFT posisi. OpenPositionV2 menggantikan V1; OpenPositionWithToken22Nft mengeluarkan NFT sebagai Token-2022. Jalur V2 membekukan akun NFT hanya ketika otoritas freeze mint vault yang mendasar cocok dengan daftar restricted-issuer. Jika tidak, akun tetap tidak beku.
Posisi	IncreaseLiquidity / IncreaseLiquidityV2	Tambahkan likuiditas ke posisi yang ada.
Posisi	DecreaseLiquidity / DecreaseLiquidityV2	Hapus likuiditas; mengumpulkan biaya yang terhutang.
Posisi	ClosePosition	Bakar NFT dan tutup PersonalPositionState. Jika akun NFT beku, cair terlebih dahulu dengan PDA pool yang disediakan sebagai akun sisa.
Posisi	CloseProtocolPosition	Sapuan admin-only untuk PDA ProtocolPositionState warisan. Program saat ini tidak lagi membuat atau membaca ProtocolPositionState — instruksi ini ada semata-mata untuk mengembalikan sewa pada akun yang dibuat oleh versi program yang lebih lama.
Swap	Swap / SwapV2	Swap likuiditas konstan. Kedua varian menerapkan dynamic fee, perutean biaya satu sisi, dan pencocokan limit order; satu-satunya perbedaan adalah SwapV2 menerima mint Token-2022 (varian V1 memerlukan kedua vault menjadi SPL Token klasik).
Swap	SwapRouterBaseIn	Multi-hop, digunakan oleh router.
Limit order	OpenLimitOrder	Tempatkan order jual pada tick. Token yang tidak terisi duduk di tick; mesin pencocokan mengisinya saat harga melintasi.
Limit order	IncreaseLimitOrder	Tambahkan ke order terbuka yang ada.
Limit order	DecreaseLimitOrder	Kurangi atau batalkan order terbuka; membayar sisa yang tidak terisi ditambah output apa pun yang sudah diselesaikan.
Limit order	SettleLimitOrder	Dorong token output yang terisi ke pemilik order. Dapat dipanggil oleh pemilik atau oleh keeper operasional.
Limit order	CloseLimitOrder	Tutup akun order yang sepenuhnya dikonsumsi. Sewa selalu kembali ke owner order. Dapat dipanggil oleh pemilik atau keeper.
Biaya	CollectProtocolFee	Sapuan admin dari biaya protokol.
Biaya	CollectFundFee	Sapuan admin dari biaya dana.
Reward	InitializeReward	Lampirkan aliran reward baru ke pool.
Reward	SetRewardParams	Ubah tingkat emisi/akhir reward yang ada.
Reward	UpdateRewardInfos	Selesaikan pertumbuhan reward hingga sekarang (dipanggil oleh swap / perubahan posisi apa pun).
Reward	TransferRewardOwner	Transfer otoritas yang dapat mengatur atau menambah aliran reward.
Reward	CollectRemainingRewards	Setelah end_time aliran reward, sapukan token yang tidak dialokasikan kembali ke pendana.
Admin	CloseSupportMintAssociated	Hapus pendaftaran SupportMintAssociated mint dan kembalikan sewanya.
Admin	CollectExcessLamports	Sapukan lamport di atas minimum rent-exempt dari PoolState pool dan vault, ditambah PDA milik CLMM apa pun yang dilewatkan. admin atau dompet collect-lamports khusus. Ditambahkan 2026-09.

Tidak ada instruksi init-tick-array, dan tidak ada yang diperlukan. Tick array dibuat di dalam OpenPosition* / IncreaseLiquidity* oleh TickArrayState::get_or_create_tick_array, dibayar oleh payer. Lewatkan PDA tick-array (mungkin masih belum diinisialisasi, milik sistem) sebagai tick_array_lower / tick_array_upper dan program mengalokasikannya jika hilang. OpenLimitOrder melakukan hal yang sama untuk tick_array tunggalnya.

Sebagian besar instruksi admin-only (CreateAmmConfig, UpdateAmmConfig, UpdatePoolStatus, CreateOperationAccount, UpdateOperationAccount, CloseProtocolPosition) dijaga oleh pubkey admin yang dikodekan keras dalam program. CreateSupportMintAssociated / CloseSupportMintAssociated menerima pubkey admin atau kunci pemilik support-mint khusus; CollectExcessLamports menerima pubkey admin atau dompet collect-lamports khusus. Instruksi admin aliran reward (TransferRewardOwner, CollectRemainingRewards) dijaga oleh pendana reward, bukan admin program.

Akhiran V2 berarti “mendukung Token-2022 di vault / NFT, memerlukan slot bitmap-extension”. SDK memilih V2 secara default untuk pool baru.

​

CreatePool

Argumen

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

Akun (ringkas)

#	Nama	W	S	Catatan
1	pool_creator	W	S
2	amm_config			Tier biaya yang dipilih.
3	pool_state	W		init di sini.
4	token_mint_0			Diurutkan.
5	token_mint_1
6	token_vault_0	W		init di sini, dimiliki oleh PDA otoritas pool.
7	token_vault_1	W
8	observation_state	W		init di sini.
9	tick_array_bitmap	W		PDA TickArrayBitmapExtension; init di sini.
10	token_program_0			Program yang memiliki token_mint_0 — SPL Token atau Token-2022.
11	token_program_1			Program yang memiliki token_mint_1.
12	system_program
13	rent

Slot 10 dan 11 adalah per-mint, bukan “SPL Token lalu Token-2022”. Masing-masing dibatasi oleh mint::token_program pada mint yang cocok, jadi untuk pool yang token_mint_0 adalah Token-2022 dan token_mint_1 adalah SPL klasik Anda harus meneruskan Token-2022 di slot 10 dan SPL Token di slot 11. CreateCustomizablePool dan CreateCustomizablePoolV2 menggunakan dua slot yang sama.

Prekondisi

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

Postkondisi

• 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

Direkomendasikan untuk pool baru. Efek yang sama dengan CreatePool ditambah mode pengumpulan biaya per-pool dan opt-in dynamic-fee opsional.

Argumen

pub struct CreateCustomizableParams {
    pub sqrt_price_x64:    u128,
    pub collect_fee_on:    CollectFeeOn,   // FromInput | Token0Only | Token1Only
    pub enable_dynamic_fee: bool,
}

Akun — tepat 13 akun yang dideklarasikan dari CreatePool. dynamic_fee_config bukan akun yang dideklarasikan.

Ketika enable_dynamic_fee = true, DynamicFeeConfig yang akan di-snapshot harus disediakan sebagai akun sisa terakhir — handler membaca ctx.remaining_accounts.last(). Setiap PDA bypass SupportMintAssociated harus oleh karena itu datang sebelumnya, atau program mengambil snapshot akun yang salah dan gagal deserialisasi. Menghilangkannya saat flag diatur gagal dengan AccountLack.

Prekondisi — sama dengan CreatePool. Jika enable_dynamic_fee = false, tidak ada remaining_account yang diperlukan dan yang dilewatkan hanya dipindai untuk catatan support-mint.

Postkondisi

• 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 status dinolkan).
• Jika tidak: pool_state.dynamic_fee_info adalah nol (= dynamic fee tidak aktif selamanya untuk pool ini).

fee_on dan bit enablement dynamic-fee diatur hanya saat pembuatan pool. Tidak ada upgrade in-place — pool yang dibuat melalui CreatePool warisan tidak dapat secara retroaktif mendapatkan dynamic fee atau biaya satu sisi. Deployment baru harus default ke instruksi ini.

​

CreateCustomizablePoolV2

Baik CreatePool maupun CreateCustomizablePool menurunkan pool PDA dari ["pool", amm_config, token_mint_0, token_mint_1], sehingga ada tepat satu alamat pool kanonik per triple (config, mint0, mint1) — inisialisasi kedua pada seed yang sama akan gagal. CreateCustomizablePoolV2 menghilangkan batasan tersebut dengan melipat seed_index: u16 yang disediakan klien ke dalam seed pool PDA, memungkinkan beberapa pool untuk pasangan dan tier biaya yang sama — masing-masing di alamatnya sendiri. Siapa pun dapat memanggilnya.

Segala hal lain tentang pool identik dengan CreateCustomizablePool: ia mengambil CreateCustomizableParams yang sama dan mendukung biaya satu sisi serta opsi dynamic-fee.

Hingga upgrade 2026-10-22, instruksi ini disebut CreatePermissionedPool dan memerlukan pembayar untuk memegang PDA Permission yang dikeluarkan admin. Upgrade tersebut mengganti namanya, menghapus akun permission, dan menghapus mesin permission. Diskriminator berubah seiring dengan nama, jadi klien yang dibangun terhadap CreatePermissionedPool harus dibangun ulang.

Argumen

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

Akun

#	Nama	W	S	Catatan
1	payer	W	S	Membayar sewa untuk setiap akun baru. Dompet apa pun.
2	pool_creator			Dicatat sebagai pool_state.owner. Mungkin berbeda dari payer. Bukan penanda tangan dan tidak diperiksa.
3	amm_config			Tier biaya yang diikat pool.
4	pool_state	W		init di ["pool", amm_config, token_mint_0, token_mint_1, seed_index.to_le_bytes()].
5	token_mint_0			Harus diurutkan sebelum token_mint_1.
6	token_mint_1
7	token_vault_0	W		PDA ["pool_vault", pool_state, token_mint_0].
8	token_vault_1	W		PDA ["pool_vault", pool_state, token_mint_1].
9	observation_state	W		PDA ["observation", pool_state].
10	tick_array_bitmap	W		PDA ["pool_tick_array_bitmap_extension", pool_state].
11	token_program_0			Program yang memiliki token_mint_0.
12	token_program_1			Program yang memiliki token_mint_1.
13	system_program
14	rent

remaining_accounts: PDA registri support-mint ketika mint Token-2022 membutuhkannya, dan DynamicFeeConfig terakhir ketika enable_dynamic_fee = true — seperti dalam CreateCustomizablePool.

Prekondisi

• seed_index != 0. seed_index bernilai 0 dicadangkan untuk pool warisan dan ditolak di sini; komponen seed [0, 0] adalah yang membuat alamat pool warisan runtuh ke bentuk empat-seed klasik.
• Tidak ada pool yang sudah ada di alamat yang diturunkan.
• Aturan mint / allow-list yang sama dengan CreatePool.

Postkondisi

• 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).

Karena pool_creator tidak diperiksa, pembayar apa pun dapat menulis alamat apa pun ke dalam pool_state.owner. Alamat tersebut dapat memanggil InitializeReward di pool, tetapi itu bukan bukti siapa yang membuat pool. Integrator tidak boleh memberi label atau menentukan peringkat pool V2 berdasarkan owner mereka.

​

OpenPositionV2 / OpenPositionWithToken22Nft

Buat posisi baru di dalam pool yang sudah ada.

Argumen

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

Akun — kedua varian memiliki daftar akun yang berbeda. OpenPositionV2 mendeklarasikan 22; OpenPositionWithToken22Nft mendeklarasikan 20.

OpenPositionV2, secara berurutan:

#	Nama	W	S	Catatan
1	payer	W	S
2	position_nft_owner
3	position_nft_mint	W	S	Keypair segar.
4	position_nft_account	W		ATA pemilik untuk NFT.
5	metadata_account	W		PDA metadata Metaplex. Dideklarasikan tanpa syarat, bahkan ketika with_metadata = false.
6	pool_state	W
7	protocol_position			Vestigial; akun UncheckedAccount baca-saja.
8	tick_array_lower	W		Dibuat di sini jika belum diinisialisasi.
9	tick_array_upper	W		Sama.
10	personal_position	W		Dibuat di sini.
11	token_account_0	W		ATA sumber pengguna.
12	token_account_1	W
13	token_vault_0	W
14	token_vault_1	W
15	rent
16	system_program
17	token_program
18	associated_token_program
19	metadata_program			Metaplex Token Metadata.
20	token_program_2022
21	vault_0_mint
22	vault_1_mint

OpenPositionWithToken22Nft adalah daftar yang sama dengan metadata_account (5) dan metadata_program (19) dihapus — ia menulis metadata posisi melalui ekstensi metadata Token-2022 pada mint NFT sebagai gantinya — menghasilkan 20 akun. position_nft_mint adalah Signer biasa dan position_nft_account adalah UncheckedAccount.

tick_array_bitmap_extension bukan akun yang dideklarasikan di kedua varian. Ketika jangkauan posisi berada di luar tick_array_bitmap inline pool (±512 tick array), tambahkan PDA TickArrayBitmapExtension di seed ["pool_tick_array_bitmap_extension", pool_state] sebagai remaining_accounts[0].

Matematika — lihat products/clmm/math. Diberikan base_flag, program menyelesaikan baik liquidity atau (amount_0_max, amount_1_max) menjadi L aktual dan jumlah token aktual yang dikonsumsi.

Prekondisi

• 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 di 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.

Postkondisi

• personal_position ada, liquidity diatur, fee_growth_inside_last difoto.
• 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 instruksinya 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.

Kesalahan umum — TickInvalidOrder (tick_lower >= tick_upper), TickAndSpacingNotMatch (titik akhir bukan kelipatan tick_spacing), InvalidTickIndex (di luar [MIN_TICK, MAX_TICK]), MissingTickArrayBitmapExtensionAccount (jangkauan di luar bitmap inline dan ekstensi tidak ditambahkan), NotApproved (pool_state.status memblokir pembukaan), ZeroAmountSpecified.

Pembekuan posisi tidak menambahkan akun instruksi yang dideklarasikan atau argumen. Klien dapat membuka posisi ini dengan tata letak V2 yang ada. Perilaku dipilih on-chain dari vault_0_mint dan vault_1_mint.

​

IncreaseLiquidityV2

Tambahkan likuiditas ke posisi yang sudah terbuka.

Argumen

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

Akun — 15, dan tidak dapat diturunkan dari OpenPosition: tidak ada rent, tidak ada system_program, tidak ada associated_token_program dan tidak ada akun metadata.

#	Nama	W	S
1	nft_owner		S
2	nft_account
3	pool_state	W
4	protocol_position
5	personal_position	W
6	tick_array_lower	W
7	tick_array_upper	W
8	token_account_0	W
9	token_account_1	W
10	token_vault_0	W
11	token_vault_1	W
12	token_program
13	token_program_2022
14	vault_0_mint
15	vault_1_mint

Tambahkan PDA TickArrayBitmapExtension di depan sebagai remaining_accounts[0] ketika jangkauan posisi berada di luar bitmap inline.

Efek

• 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 titik akhir sesuai kebutuhan.
• 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 mandiri.

​

DecreaseLiquidityV2

Hapus likuiditas dari posisi.

Argumen

liquidity: u128
amount_0_min: u64
amount_1_min: u64

Akun — 16, dan bukan bentuk atau urutan yang sama dengan IncreaseLiquidityV2: personal_position dan pool_state ditukar, vault datang sebelum tick array, akun sisi pengguna dinamai recipient_token_account_*, dan ada memo_program tambahan.

#	Nama	W	S
1	nft_owner		S
2	nft_account
3	personal_position	W
4	pool_state	W
5	protocol_position
6	token_vault_0	W
7	token_vault_1	W
8	tick_array_lower	W
9	tick_array_upper	W
10	recipient_token_account_0	W
11	recipient_token_account_1	W
12	token_program
13	token_program_2022
14	memo_program
15	vault_0_mint
16	vault_1_mint

Akun yang tersisa — tiga per reward aktif yang dikumpulkan, dalam urutan reward_token_vault(W), recipient_token_account(W), reward_vault_mint. Tambahkan PDA TickArrayBitmapExtension di depan ketika jangkauan posisi berada di luar bitmap inline.

Ini juga satu-satunya cara untuk mengumpulkan biaya dan reward. Untuk mengumpulkan tanpa mengubah posisi, panggilnya dengan liquidity = 0, amount_0_min = 0, amount_1_min = 0.

Efek

• 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 == 0 baru, posisi memenuhi syarat untuk ClosePosition.

Slippage — amount_0_min dan amount_1_min adalah minimum yang diterima pengguna bersih dari biaya transfer Token-2022 di sisi output.

​

ClosePosition

Bakar NFT posisi dan tutup PersonalPositionState.

Akun yang dideklarasikan

#	Name	W	S	Catatan
1	nft_owner	W	S	Harus memiliki akun token NFT dengan jumlah 1.
2	position_nft_mint	W		Harus cocok dengan personal_position.nft_mint.
3	position_nft_account	W		Akun pemilik NFT; dapat berupa SPL Token klasik atau Token-2022.
4	personal_position	W		Ditutup ke nft_owner.
5	system_program			Menutup state posisi.
6	token_program			Harus memiliki mint NFT dan akun token.

Akun yang tersisa

• NFT yang tidak dibekukan: tidak ada yang diperlukan; akun pool tambahan tidak berbahaya karena handler tidak membacanya.
• NFT yang dibekukan: tambahkan personal_position.pool_id sebagai akun yang tersisa pertama. Program memuat sebagai PoolState dan menggunakan seed PDA-nya untuk menandatangani pencairan.

Kondisi awal

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

(Yaitu, kumpulkan semuanya dan kurangi ke nol terlebih dahulu.)

Efek

• Jika akun token NFT dibekukan, verifikasi akun yang tersisa 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, juga tutup mint NFT; mint SPL Token klasik tidak dapat ditutup dan tetap dengan pasokan nol.

Pencairan, pembakaran, dan penutupan bersifat atomik. NFT tidak dapat menjadi dapat ditransfer di antara langkah-langkah tersebut.

Pemutus klien bersyarat — tata letak IDL yang dideklarasikan tidak berubah, sehingga klien lama terus menutup posisi yang ada dan tidak dibekukan. Pembangun lama yang menghilangkan akun pool yang tersisa gagal dengan AccountLack saat menutup posisi yang dibekukan. Melewatkan pool untuk setiap penutupan adalah strategi yang paling kompatibel.

​

SwapV2

Berjalan di sepanjang kurva likuiditas; input tepat atau output tepat tergantung pada is_base_input.

Argumen

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

Akun (ringkas)

#	Name	W	S	Catatan
1	payer		S
2	amm_config
3	pool_state	W
4	input_token_account	W
5	output_token_account	W
6	input_vault	W
7	output_vault	W
8	observation_state	W
9	token_program
10	token_program_2022			V2.
11	memo_program			V2 (diperlukan untuk beberapa jalur Token-2022).
12	input_vault_mint, output_vault_mint			V2.
13	tick_array_bitmap_extension (opsional)	W		Jika swap masuk ke ekstensi.
14+	tick_array (yang tersisa)	W		Array yang cukup untuk mencakup rentang yang diharapkan dari jalan.

Pemanggil melewatkan daftar tick array berperingkat yang mencakup jalan swap yang diharapkan; program menggunakan sebanyak yang diperlukan. SDK menghitung daftar ini melalui PoolUtils.computeAmountOutFormat atau endpoint quote API.

Kondisi awal

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

Kesalahan umum — TooLittleOutputReceived (slippage exact-in), TooMuchInputPaid (slippage exact-out), SqrtPriceLimitOverflow, NotEnoughTickArrayAccount, InvalidFirstTickArrayAccount, MissingTickArrayBitmapExtensionAccount, LiquidityInsufficient, NotApproved (bit swap diatur pada pool_state.status). CLMM tidak memiliki varian ExceededSlippage — nama itu milik CPMM — dan tidak ada TickArrayNotFound.

Apa yang dilakukan SwapV2 secara internal yang harus diketahui pemanggil (rilis pasca-2025):

1. Surcharge biaya dinamis — jika pool.dynamic_fee_info bukan nol, program memperbarui akumulator volatilitas menggunakan jarak tick yang dilalui 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 limit order 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 diisi memperbarui tick.unfilled_ratio_x64 dan tick.part_filled_orders_remaining untuk penyelesaian nanti; order 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 perdagangan input-output 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.

Swap (V1) mengimplementasikan biaya dinamis yang sama, perutean biaya satu sisi, dan pencocokan limit order seperti SwapV2; satu-satunya fitur yang tidak dimilikinya adalah dukungan Token-2022 — kedua vault harus berupa SPL Token klasik. Pool dengan mint Token-2022 apa pun harus ditukar melalui SwapV2. Agregator dan SDK sudah lebih memilih V2 untuk setiap leg CLMM sehingga pemanggil tidak perlu bercabang pada jenis mint.

​

OpenLimitOrder

Tempatkan pesanan jual pada tick tertentu. Pesanan duduk di kohort FIFO per-tick dan diisi saat harga berjalan melewati.

Argumen

nonce_index:    u8       // indeks akun nonce pilihan 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

Akun (ringkas)

#	Name	W	S	Catatan
1	payer	W	S	Pemilik pesanan; membayar sewa.
2	pool_state	W
3	tick_array	W		Array tick yang berisi tick_index.
4	limit_order_nonce	W		PDA. init_if_needed — dibuat pada pesanan pertama pengguna di bawah nonce_index ini.
5	limit_order	W		PDA. init di sini.
6	input_token_account	W		ATA input pengguna. Diperiksa untuk frozen.
7	output_token_account	W		ATA output pengguna. Tidak didebit saat dibuka — diperlukan hanya agar program dapat mengonfirmasi bahwa itu bukan frozen (yaitu pengisian dapat dikirimkan nanti).
8	input_vault	W		Vault input pool.
9	output_vault	W		Vault output pool. Mengidentifikasi mint output untuk pemeriksaan output_token_account / output_vault_mint.
10	input_vault_mint			Penanganan biaya Token-2022.
11	output_vault_mint			Mint dari sisi output (pemeriksaan pasangan beku).
12	input_token_program			SPL atau Token-2022.
13	system_program			Mendanai limit_order, limit_order_nonce dan — jika diperlukan — alokasi tick_array.

Akun yang tersisa — [0] tick_array_bitmap_extension, diperlukan hanya saat menginisialisasi array tick yang indeks awalnya berada di luar bitmap inline pool. Jangan lewatkan apa pun sebaliknya.

Tidak ada akun rent: struct berakhir di system_program, 13 akun yang dideklarasikan. rent yang tersesat di posisi 14 mendarat tepat di mana ekstensi bitmap opsional dibaca, sehingga pesanan tampak berfungsi sampai pertama kali array tick di luar bitmap inline harus dibuat — dan kemudian gagal.

Perubahan daftar akun (rilis 2026-07). OpenLimitOrder sekarang juga mengambil akun sisi output — output_token_account, output_vault, dan output_vault_mint — selain sisi input. Mereka digunakan hanya untuk validasi: program menolak pesanan jika akun token input atau output pemilik dibekukan. Ini menjamin bahwa pengisian benar-benar dapat diselesaikan ke ATA output pemilik, yang penting untuk mint Token-2022 dengan daftar izin / beku default (misalnya token berlisensi) di mana akun mungkin belum dicairkan. Klien yang dibangun terhadap daftar akun satu sisi yang lebih lama harus menambahkan tiga akun output.

Kondisi awal

• Baik input_token_account maupun output_token_account tidak dibekukan (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 dicocokkan segera dan ditolak.

Kondisi akhir

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

Kesalahan umum — NotApproved (akun token input atau output dibekukan, atau pool memiliki swap / limit-order dinonaktifkan), ZeroAmountSpecified (amount == 0 setelah biaya transfer sisi input), InvalidLimitOrderAmount (jumlah akan menghasilkan output di bawah 1 unit dasar pada tick itu, atau overflow u64), InvalidTickIndex (di luar [MIN_TICK, MAX_TICK], atau di sisi yang salah dari tick_current untuk arah yang dipilih), TickAndSpacingNotMatch (tick_index % pool.tick_spacing != 0), OrderPhaseSaturated.

​

IncreaseLimitOrder

Tambahkan ke pesanan terbuka yang ada. Hanya dapat dipanggil oleh owner pesanan.

Argumen

amount: u64    // jumlah token input tambahan

Akun — 8, hanya sisi input. Ini menghilangkan akun nonce, ketiga akun sisi output dan system_program.

#	Name	W	S
1	owner		S
2	pool_state	W
3	tick_array	W
4	limit_order	W
5	input_token_account	W
6	input_vault	W
7	input_vault_mint
8	input_token_program

Kondisi awal

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

Efek

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

​

DecreaseLimitOrder

Kurangi atau batalkan sepenuhnya pesanan terbuka. Membayar sisa yang tidak diisi kembali ke pemilik, ditambah output apa pun yang sudah diselesaikan oleh pengisian parsial sebelumnya.

Argumen

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

Akun — kedua sisi token input dan output:

#	Name	W	S
1	owner		S
2	pool_state	W
3	tick_array	W
4	limit_order	W
5	input_token_account	W
6	output_token_account	W
7	input_vault	W
8	output_vault	W
9	input_vault_mint, output_vault_mint
10	token_program, token_program_2022

Efek

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

​

SettleLimitOrder

Dorong token output yang telah terisi ke pemilik tanpa mengubah sisa order yang belum terisi. Berguna ketika keeper auto_withdraw ingin melakukan pembayaran bertahap untuk pengisian parsial jangka panjang.

Pemanggil — baik owner order, atau limit_order_admin program (dompet operasional panas off-chain yang menjalankan loop keeper otomatis). Keeper tidak memiliki otoritas lain — tidak dapat memindahkan dana pengguna di luar mendorong output terisi ke ATA owner order.

Akun

#	Nama	W	S	Catatan
1	signer		S	pemilik atau limit_order_admin
2	pool_state
3	tick_array
4	limit_order	W
5	output_token_account	W		ATA output pemilik.
6	output_vault	W		Vault output pool.
7	output_vault_mint
8	output_token_program

Efek

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

​

CloseLimitOrder

Tutup akun order yang sepenuhnya dikonsumsi. Sewa selalu dikembalikan ke limit_order.owner terlepas dari siapa yang menandatangani.

Pemanggil — baik owner atau limit_order_admin.

Prasyarat

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

Efek

• Menutup limit_order; sewa dikirim ke limit_order.owner.

​

CreateDynamicFeeConfig (admin)

Buat set parameter yang dapat digunakan kembali di bawah indeks u16.

Argumen

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 decay
dynamic_fee_control:         u32   // 1..100_000; gain pada kurva volatilitas-ke-biaya
max_volatility_accumulator:  u32   // batas atas

Akun

#	Nama	W	S	Catatan
1	owner	W	S	Pubkey admin yang dikodekan keras.
2	dynamic_fee_config	W		PDA, init di sini.
3	system_program

Kesalahan umum — InvalidDynamicFeeConfigParams jika decay_period <= filter_period atau bidang bernilai 0 di luar batas.

​

UpdateDynamicFeeConfig (admin)

Ubah DynamicFeeConfig yang ada. Pool yang sudah mengambil snapshot konfigurasi saat pembuatan tidak diperbarui secara retroaktif; hanya pool yang baru dibuat yang mereferensikan konfigurasi ini akan mengambil nilai baru.

Argumen — lima bidang kalibrasi yang sama seperti CreateDynamicFeeConfig (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator); index ditetapkan saat pembuatan dan tidak dilewatkan ulang di sini.

​

CollectProtocolFee / CollectFundFee

Kumpulkan biaya protokol/dana yang terkumpul dari vault pool ke penerima, mengosongkan bidang PoolState.protocol_fees_* / fund_fees_* yang sesuai. Ini bukan tata letak CPMM — CLMM tidak memiliki akun authority, dan bidang penerima dinamai recipient_token_account_{0,1} bukan recipient_token_{0,1}_account.

Argumen — amount_0_requested: u64, amount_1_requested: u64.

#	Nama	W	S	Catatan
1	owner		S	amm_config.owner (atau amm_config.fund_owner untuk varian dana), atau admin program; jika tidak NotApproved.
2	pool_state	W
3	amm_config			address = pool_state.amm_config.
4	token_vault_0	W
5	token_vault_1	W
6	vault_0_mint
7	vault_1_mint
8	recipient_token_account_0	W
9	recipient_token_account_1	W
10	token_program
11	token_program_2022

Berubah di 2026-09: konfigurasi baru tidak lagi mengambil pemilik biaya dari penandatangan. create_amm_config sekarang menulis protocol_fee_owner::ID program yang dikodekan keras ke dalam owner dan fund_fee_owner::ID ke dalam fund_owner. Sebelumnya, ia menyalin kunci penandatangan admin ke keduanya. Di mainnet ini adalah kunci yang sama yang sudah disimpan di semua 21 konfigurasi yang ada. Alamat ada di reference/program-addresses.

Penandatangan yang diterima di atas tidak berubah. Admin masih dapat mengumpulkan dari konfigurasi apa pun, dan akun AmmConfig yang ada tidak ditulis ulang. Baca owner / fund_owner dari akun daripada mengasumsikan nilai apa pun. Parameter UpdateAmmConfig 3 dan 4 masih memutar keduanya.

​

CollectExcessLamports

Penyapuan admin lamport di atas minimum bebas sewa pada akun yang dikendalikan CLMM. Ini ditambahkan dalam upgrade 2026-09 untuk mengklaim pendanaan berlebih yang pengurangan sewa SIMD-0437 tinggalkan pada akun yang dibuat sebelum setiap langkah.

Hanya kelebihan yang bergerak. Saldo token, data akun, pemilik, status pool, dan kurva harga tidak tersentuh. Akun yang sudah mencapai minimumnya dibiarkan apa adanya, sehingga instruksi dapat dijalankan kembali dengan aman setelah setiap peluncuran.

Argumen: tidak ada.

Akun

#	Nama	W	S	Catatan
1	collect_lamports_wallet	W	S	Menerima setiap lamport yang disapu. Harus menjadi admin program CLMM atau dompet kumpul-lamport khusus (lihat reference/program-addresses). Penandatangan lain apa pun gagal dengan NotApproved.
2	pool_state	W		Pool yang disapu. Benih PDA-nya menandatangani CPI program token, dan akun selalu disapu sendiri.
3	token_program			SPL Token.
4	token_program_2022			Token-2022. Kedua program diperlukan; instruksi memilih satu per akun sumber.
5..	remaining_accounts	W		M akun sumber, jumlah berapa pun, urutan berapa pun.

Cakupan: satu pool per panggilan. CLMM tidak memiliki otoritas vault program-lebar. Vault setiap pool dimiliki oleh PoolState-nya sendiri. Setiap sumber program token harus memiliki pool_state di slot 2 sebagai otoritasnya: token_vault_0, token_vault_1, atau salah satu vault reward pool itu. Jika Anda melewatkan vault pool lain atau akun token pengguna, pemeriksaan pemilik program token gagal dan seluruh instruksi kembali. Ini tidak dilewati. Mint NFT posisi tidak dapat disapu, karena otoritas mint-nya dibatalkan saat posisi dibuka.

Cara setiap akun sumber ditangani

Program membuat dua lintasan atas remaining_accounts: setiap CPI program token terlebih dahulu, kemudian debit langsung. Menyelipkan keduanya membatalkan dengan kesalahan UnbalancedInstruction runtime, jadi urutan ditetapkan dalam program dan Anda tidak harus mengurutkan daftar sendiri.

Lintasan	Pemilik akun sumber	Penanganan
1	SPL Token atau Token-2022, akun token non-native	CPI WithdrawExcessLamports (diskriminan program token 38), ditandatangani oleh pool_state.
1	SPL Token atau Token-2022, native (wSOL) akun token	WithdrawExcessLamports menolak akun native. Program CPI SyncNative, mengukur berapa banyak amount yang dibungkus tumbuh, dan memanggil UnwrapLamports (diskriminan 45) untuk delta yang tepat. Kemudian memerlukan saldo yang dibungkus sama dengan nilai pra-sinknya, atau gagal dengan LamportsCalculateError (6052). Vault pool sisi SOL menyimpan likuiditas penuhnya.
2	pool_state (slot 2)	Didebit langsung ke rent.minimum_balance(data_len).
2	Program CLMM: AmmConfig, ObservationState, TickArrayBitmapExtension, TickArrayState, PersonalPositionState, LimitOrderState, dan sebagainya	Didebit langsung ke rent.minimum_balance(data_len). Akun tidak harus milik pool di slot 2.
—	Apa pun yang lain	Dilewati diam-diam. Tidak ada kesalahan, tidak ada lamport yang bergerak.

Lintasan 2 mencakup akun yang sewanya dibayar pengguna. PersonalPositionState atau LimitOrderState yang dilewatkan di sini melepaskan kelebihannya seperti akun milik CLMM lainnya. Tetap bebas sewa dan menyimpan datanya. Ketika kemudian ditutup, pemilik mendapatkan kembali apa pun yang dipegang akun pada saat itu, yang setelah penyapuan adalah minimum sewa saat ini.

Ukuran transaksi adalah batas nyata pada berapa banyak sumber yang cocok dalam satu panggilan. Ini adalah batasan yang sama dengan penyapuan sisi dompet yang dijelaskan dalam solana-fundamentals/rent-and-reclaimable-rent.

Kesalahan umum:

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

Tidak ada pembangun SDK. @raydium-io/raydium-sdk-v2 tidak mengirimkan pembangun untuk jalur admin ini. Enkode dengan tangan dari IDL.

​

InitializeReward

Tambahkan aliran reward baru ke pool. Hingga 3 aliran dapat aktif sekaligus.

Argumen — satu struct, param: InitializeRewardParam:

pub struct InitializeRewardParam {
    pub open_time:                u64,
    pub end_time:                 u64,
    pub emissions_per_second_x64: u128,   // Q64.64
}

Pengkodean wire adalah tiga bidang berturut-turut, jadi instruksi yang dibangun dengan tangan tidak terpengaruh — tetapi klien yang didorong IDL harus melewatkan satu objek param daripada tiga argumen posisional.

Akun

#	Nama	W	S	Catatan
1	reward_funder	W	S
2	funder_token_account	W
3	amm_config
4	pool_state	W
5	operation_state			PDA status operasi CLMM gating pembuatan reward.
6	reward_token_mint
7	reward_token_vault	W		init di sini.
8	reward_token_program
9	system_program, rent

Prasyarat

• Kurang dari 3 aliran saat ini aktif di pool.
• Funder 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

Perpanjang, isi ulang, atau ubah tingkat emisi pada aliran reward yang ada. Biasanya dipanggil oleh pembuat pool atau multisig Raydium. Batasan hidup on-chain: Anda biasanya dapat memperpanjang end_time atau meningkatkan emisi, bukan menyusutnya secara retroaktif. Periksa daftar pemilik operation_state.

​

UpdateRewardInfos

Pembukuan murni — menyelesaikan reward_growth_global_x64 ke waktu saat ini dengan mengalikan emissions_per_second × Δt / liquidity. Dipanggil secara internal oleh setiap instruksi yang menyentuh likuiditas. Diekspos sebagai instruksi mandiri karena aktor eksternal (UI, crank) kadang-kadang ingin memicunya.

​

Mengumpulkan reward

Tidak ada instruksi kumpul-reward mandiri. Program tidak mengekspos entrypoint CollectReward, dan IDL yang dipublikasikan juga tidak memilikinya.

Reward yang diterima posisi dibayarkan oleh DecreaseLiquidity / DecreaseLiquidityV2. Untuk mengumpulkan tanpa mengubah posisi, panggilnya dengan liquidity = 0, amount_0_min = 0, amount_1_min = 0. Vault reward dan akun penerima masuk remaining_accounts dalam grup tiga per reward aktif, dalam urutan reward_token_vault(W), recipient_token_account(W), reward_vault_mint.

CollectRemainingRewards adalah hal yang berbeda: memungkinkan reward funder, setelah end_time aliran, menyapu token yang tidak pernah dialokasikan ke posisi apa pun.

​

Matriks perubahan state

Instruksi	pool.liquidity	pool.fee_growth_global	pool.reward_growth_global	personal_position.liquidity	Tick array
CreatePool	0	0	—	—	—
OpenPosition	+ jika dalam range	—	—	baru	tambah liquidity_gross/net
IncreaseLiquidity	+ jika dalam range	settle owed	settle owed	+	sesuaikan
DecreaseLiquidity	− jika dalam range	settle owed	settle owed	−	sesuaikan
ClosePosition	—	—	—	dihapus	—
SwapV2	± pada crossings	+	—	—	cross & flip outside; match limit-order cohorts
OpenLimitOrder	—	—	—	—	orders_amount += amount pada target tick
IncreaseLimitOrder	—	—	—	—	orders_amount += amount
DecreaseLimitOrder	—	—	—	—	orders_amount -=, mungkin tutup cohort
SettleLimitOrder	—	—	—	—	— (read-only pada tick)
CloseLimitOrder	—	—	—	—	—
CreateCustomizablePool	0	0	—	—	—
UpdateRewardInfos	—	—	+	—	—
CollectExcessLamports	—	—	—	—	— (lamports saja; saldo token tidak berubah)

​

Langkah selanjutnya

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

Sumber:

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