CLMM talimatları

Kapsamlı CLMM talimat referansı: havuz yaşam döngüsü, pozisyon yönetimi, swap ve ödül akışları.

Bu sayfa yapay zekâ tarafından otomatik olarak çevrilmiştir. İngilizce sürüm esas alınır.

İngilizce sürümü görüntüle →

Bu sayfa products/clmm/accounts (hesaplar nedir) ve products/clmm/math (matematik nedir) ile birlikte çalışır. Argümanlar ve hesap sıralaması için yetkilidir; belirli bayt düzenleri IDL’den gelir.

2026-09 program yükseltmesi CLMM’yi Anchor 1.0.2 / Solana 3.1.10 üzerine yeniden inşa etti, admin talimatı CollectExcessLamports ekledi ve CreateAmmConfig’in owner / fund_owner içine yazdığı şeyi değiştirdi. Hiçbir kullanıcı tarafından kullanılan talimat hesaplarını, argümanlarını veya matematiklerini değiştirmedi. 2026-09-30 changelog girişine bakın.

2026-10-22 program yükseltmesi CreatePermissionedPool’u CreateCustomizablePoolV2 olarak yeniden adlandırır, herkes tarafından çağrılabilir hale getirir ve iki admin talimatı ile Permission hesabını kaldırır. 2026-10-22 changelog girişine bakın.

​

Talimat envanteri

Grup	Talimat	Notlar
Admin	CreateAmmConfig	Yeni bir ücret katmanı tanımlayın.
Admin	UpdateAmmConfig	Mevcut bir katmandaki oranları değiştirin.
Admin	UpdatePoolStatus	Bir havuzda işlemleri duraklatın/devam ettirin.
Admin	CreateSupportMintAssociated	CLMM havuzlarında kullanılmak üzere Token-2022 mint uzantı yapılandırmasını izin listesine alın.
Admin	CreateOperationAccount	Program düzeyinde işlem hesabını başlatın (tek seferlik).
Admin	UpdateOperationAccount	İşlem hesabı beyaz listesini değiştirin.
Admin	CreateDynamicFeeConfig	u16 dizini altında yeniden kullanılabilir dinamik ücret parametresi seti oluşturun.
Admin	UpdateDynamicFeeConfig	Mevcut DynamicFeeConfig’i değiştirin. Zaten anlık görüntü alan havuzlar etkilenmez.
Havuz	CreatePool	Bir AmmConfig’e bağlı CLMM havuzu başlatın. Standart, FromInput-ücret yolu. CreateCustomizablePool ile birlikte var olur.
Havuz	CreateCustomizablePool	Yeni havuzlar için önerilir. CreatePool ile aynı şekil artı collect_fee_on ve isteğe bağlı enable_dynamic_fee bayrağı.
Havuz	CreateCustomizablePoolV2	Zaten bir havuza sahip olan bir çift ve ücret katmanı için ek bir havuz oluşturun; istemci tarafından sağlanan sıfır olmayan seed_index havuz PDA’sına katlanır. İzinsiz. 2026-10-22 öncesinde CreatePermissionedPool olarak adlandırılıyordu.
Pozisyon	OpenPosition / OpenPositionV2 / OpenPositionWithToken22Nft	Pozisyon NFT’si basın. OpenPositionV2 V1’i geçersiz kılar; OpenPositionWithToken22Nft NFT’yi Token-2022 olarak yayınlar. V2 yolları NFT hesabını yalnızca temel kasa mint’inin dondurma yetkisi kısıtlı-yayıncı listesiyle eşleştiğinde dondurur. Aksi takdirde hesap donmuş kalır.
Pozisyon	IncreaseLiquidity / IncreaseLiquidityV2	Mevcut bir pozisyona likidite ekleyin.
Pozisyon	DecreaseLiquidity / DecreaseLiquidityV2	Likiditeyi kaldırın; borçlu ücretleri topla.
Pozisyon	ClosePosition	NFT’yi yakın ve PersonalPositionState’i kapatın. NFT hesabı donmuşsa, önce havuz PDA’sı kalan hesap olarak sağlanarak çöz.
Pozisyon	CloseProtocolPosition	Eski ProtocolPositionState PDA’ları için admin tarafından yapılan temizleme. Mevcut program artık ProtocolPositionState oluşturmaz veya okumaz — bu talimat yalnızca eski program sürümleri tarafından oluşturulan hesaplardaki kirayı geri almak için vardır.
Swap	Swap / SwapV2	Sabit likidite swapı. Her iki varyant dinamik ücret, tek taraflı ücret yönlendirmesi ve limit emri eşleştirmesi uygular; tek fark SwapV2’nin Token-2022 mintlerini kabul etmesidir (V1 varyantı her iki kasanın da klasik SPL Token olmasını gerektirir).
Swap	SwapRouterBaseIn	Çok atlamalı, yönlendirici tarafından kullanılır.
Limit emri	OpenLimitOrder	Bir tick’te satış emri verin. Doldurulmayan tokenler tick’te oturur; eşleştirme motoru fiyat geçtikçe onları doldurur.
Limit emri	IncreaseLimitOrder	Mevcut açık emre ekleyin.
Limit emri	DecreaseLimitOrder	Açık emri azaltın veya iptal edin; doldurulmayan kalanı artı zaten kapatılan çıktıyı ödeyin.
Limit emri	SettleLimitOrder	Doldurulmuş çıktı tokenlerini emir sahibine gönderin. Sahibi veya operasyonel bekçi tarafından çağrılabilir.
Limit emri	CloseLimitOrder	Tamamen tüketilmiş emir hesabını kapatın. Kira her zaman emrin owner’ına döner. Sahibi veya bekçi tarafından çağrılabilir.
Ücretler	CollectProtocolFee	Protokol ücretlerinin admin tarafından yapılan taraması.
Ücretler	CollectFundFee	Fon ücretlerinin admin tarafından yapılan taraması.
Ödüller	InitializeReward	Havuza yeni bir ödül akışı ekleyin.
Ödüller	SetRewardParams	Mevcut bir ödülün emisyon oranını/sonunu değiştirin.
Ödüller	UpdateRewardInfos	Ödül büyümesini şimdi kapatın (herhangi bir swap / pozisyon değişikliği tarafından çağrılır).
Ödüller	TransferRewardOwner	Ödül akışını ayarlayabilen veya doldurabilecek yetkiyi aktarın.
Ödüller	CollectRemainingRewards	Ödül akışının end_time’ından sonra, ayrılmamış tokenları fon sağlayıcıya geri tarayın.
Admin	CloseSupportMintAssociated	Bir mint’in SupportMintAssociated kaydını kaldırın ve kirasını geri ödeyin.
Admin	CollectExcessLamports	Bir havuzun PoolState ve kasalarından kira muafiyeti minimumunun üzerindeki lamportları, artı geçirilen CLMM’ye ait herhangi bir PDA’yı tarayın. admin veya özel lamport toplama cüzdanı. 2026-09’da eklendi.

Tick dizisi başlatma talimatı yoktur ve buna gerek yoktur. Tick dizisi içinde oluşturulur OpenPosition* / IncreaseLiquidity* tarafından TickArrayState::get_or_create_tick_array aracılığıyla, payer tarafından ödenir. (Muhtemelen hala başlatılmamış, sistem tarafından sahip olunan) tick dizisi PDA’sını tick_array_lower / tick_array_upper olarak geçirin ve program eksikse onu tahsis eder. OpenLimitOrder tek tick_array’i için aynı şeyi yapar.

Çoğu admin tarafından yapılan talimat (CreateAmmConfig, UpdateAmmConfig, UpdatePoolStatus, CreateOperationAccount, UpdateOperationAccount, CloseProtocolPosition) program’ın sabit kodlanmış admin genel anahtarı tarafından kapılanır. CreateSupportMintAssociated / CloseSupportMintAssociated admin genel anahtarını veya özel bir destek-mint sahibi anahtarını kabul eder; CollectExcessLamports admin genel anahtarını veya özel bir lamport toplama cüzdanını kabul eder. Ödül akışı admin talimatları (TransferRewardOwner, CollectRemainingRewards) program admini tarafından değil, ödül fon sağlayıcısı tarafından kapılanır.

V2 soneki “Token-2022’yi kasalar / NFT’de destekler, bitmap-uzantı slotu gerektirir” anlamına gelir. SDK yeni havuzlar için varsayılan olarak V2’yi seçer.

​

CreatePool

Argümanlar

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

Hesaplar (kısaltılmış)

#	Ad	W	S	Notlar
1	pool_creator	W	S
2	amm_config			Seçilen ücret katmanı.
3	pool_state	W		Burada init.
4	token_mint_0			Sıralanmış.
5	token_mint_1
6	token_vault_0	W		Burada init, havuz yetkisi PDA’sı tarafından sahip olunan.
7	token_vault_1	W
8	observation_state	W		Burada init.
9	tick_array_bitmap	W		TickArrayBitmapExtension PDA’sı; burada init.
10	token_program_0			token_mint_0’ı sahip olan program — SPL Token veya Token-2022.
11	token_program_1			token_mint_1’i sahip olan program.
12	system_program
13	rent

Slotlar 10 ve 11 mint başına, “SPL Token sonra Token-2022” değildir. Her biri eşleşen mint’teki mint::token_program tarafından kısıtlanır, bu nedenle token_mint_0’ı Token-2022 ve token_mint_1’i klasik SPL olan bir havuz için slot 10’a Token-2022 ve slot 11’e SPL Token geçirmelisiniz. CreateCustomizablePool ve CreateCustomizablePoolV2 aynı iki slotu kullanır.

Ön koşullar

• token_mint_0 < token_mint_1 bayt sırasına göre.
• amm_config.disable_create_pool == false.
• Mintler Token-2022 uzantı izin listesi tarafından reddedilmez.

Son koşullar

• 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

Yeni havuzlar için önerilir. CreatePool ile aynı etki artı havuz başına ücret toplama modu ve isteğe bağlı dinamik ücret katılımı.

Argümanlar

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

Hesaplar — CreatePool’un tam olarak 13 beyan edilen hesabı. dynamic_fee_config beyan edilen bir hesap değildir.

enable_dynamic_fee = true olduğunda, anlık görüntü alınacak DynamicFeeConfig son remaining_account olarak sağlanmalıdır — işleyici ctx.remaining_accounts.last() okur. Herhangi bir SupportMintAssociated bypass PDA’sı bu nedenle önce gelmelidir, aksi takdirde program yanlış hesabın anlık görüntüsünü alır ve deserialization başarısız olur. Bayrak ayarlanmışken onu atlama AccountLack ile başarısız olur.

Ön koşullar — CreatePool ile aynı. enable_dynamic_fee = false ise, remaining_account gerekli değildir ve geçirilen herhangi biri yalnızca destek-mint kayıtları için taranır.

Son koşullar

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

fee_on ve dinamik ücret etkinleştirme biti yalnızca havuz oluşturma sırasında ayarlanır. Yerinde yükseltme yoktur — eski CreatePool aracılığıyla oluşturulan havuzlar geriye dönük olarak dinamik ücret veya tek taraflı ücret kazanamaz. Yeni dağıtımlar varsayılan olarak bu talimata geçmelidir.

​

CreateCustomizablePoolV2

Hem CreatePool hem de CreateCustomizablePool, pool PDA’sını ["pool", amm_config, token_mint_0, token_mint_1] adresinden türetir; bu nedenle her (config, mint0, mint1) üçlüsü için tam olarak bir kanonik pool adresi vardır — aynı seed’lerle ikinci bir init başarısız olur. CreateCustomizablePoolV2 bu kısıtlamayı kaldırarak, istemci tarafından sağlanan seed_index: u16 değerini pool PDA seed’lerine katarak aynı çift ve ücret katmanı için birden fazla pool oluşturmaya izin verir — her biri kendi adresinde. Herkes bunu çağırabilir.

Pool hakkındaki diğer her şey CreateCustomizablePool ile aynıdır: aynı CreateCustomizableParams parametrelerini alır ve tek taraflı ücret ile dinamik ücret seçeneğini destekler.

2026-10-22 yükseltmesine kadar bu talimat CreatePermissionedPool olarak adlandırılıyordu ve ödeyicinin yönetici tarafından verilen bir Permission PDA’sına sahip olmasını gerektiriyordu. Yükseltme adını değiştirdi, permission hesabını kaldırdı ve izin mekanizmasını sildi. Ayırıcı adla birlikte değişti, bu nedenle CreatePermissionedPool karşısında oluşturulan istemcilerin yeniden oluşturulması gerekir.

Argümanlar

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

Hesaplar

#	Ad	W	S	Notlar
1	payer	W	S	Her yeni hesap için kirayı öder. Herhangi bir cüzdan.
2	pool_creator			pool_state.owner olarak kaydedilir. payer ile farklı olabilir. İmzalayan değil ve kontrol edilmez.
3	amm_config			Pool’un bağlandığı ücret katmanı.
4	pool_state	W		["pool", amm_config, token_mint_0, token_mint_1, seed_index.to_le_bytes()] adresinde init.
5	token_mint_0			token_mint_1 öncesinde sıralanmalı.
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			token_mint_0’ı sahiplenen program.
12	token_program_1			token_mint_1’i sahiplenen program.
13	system_program
14	rent

remaining_accounts: Token-2022 mint’i gerektiğinde destek-mint kayıt defteri PDA’ları ve enable_dynamic_fee = true olduğunda DynamicFeeConfig son — CreateCustomizablePool’da olduğu gibi.

Ön Koşullar

• seed_index != 0. seed_index değeri 0 eski pool’lar için ayrılmıştır ve burada reddedilir; [0, 0] seed bileşeni, eski bir pool adresinin klasik dört seed formuna çökmesini sağlayan şeydir.
• Türetilen adresinde henüz pool yok.
• CreatePool ile aynı mint / izin listesi kuralları.

Son Koşullar

• Yeni bir pool_state, seed_index-türetilmiş adresinde pool_state.seed_index = seed_index ile var.
• Diğer tüm son durumlar CreateCustomizablePool ile eşleşir (ücret modu, isteğe bağlı dinamik ücret).

pool_creator kontrol edilmediğinden, herhangi bir ödeyici pool_state.owner’a herhangi bir adres yazabilir. Bu adres pool’da InitializeReward’ı çağırabilir, ancak bu pool’u kimin oluşturduğunun kanıtı değildir. Entegratörler V2 pool’larını owner değerine göre etiketlemeli veya sıralamaktan kaçınmalıdır.

​

OpenPositionV2 / OpenPositionWithToken22Nft

Mevcut bir pool içinde yeni bir pozisyon oluşturun.

Argümanlar

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 (Metaplex)
base_flag: Option<bool>       // true = amount0'a uydur; false = amount1'e uydur

Hesaplar — iki varyant farklı hesap listelerine sahiptir. OpenPositionV2 22 tane bildirir; OpenPositionWithToken22Nft 20 tane bildirir.

OpenPositionV2, sırasıyla:

#	Ad	W	S	Notlar
1	payer	W	S
2	position_nft_owner
3	position_nft_mint	W	S	Yeni keypair.
4	position_nft_account	W		NFT için sahibinin ATA’sı.
5	metadata_account	W		Metaplex meta veri PDA’sı. with_metadata = false olduğunda bile koşulsuz olarak bildirilir.
6	pool_state	W
7	protocol_position			Kalıntı; salt okunur UncheckedAccount.
8	tick_array_lower	W		Başlatılmamışsa burada oluşturulur.
9	tick_array_upper	W		Aynı.
10	personal_position	W		Burada oluşturulur.
11	token_account_0	W		Kullanıcı kaynak ATA’sı.
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, metadata_account (5) ve metadata_program (19) kaldırılmış aynı listedir — bunun yerine pozisyonun meta verilerini NFT mint’indeki Token-2022 meta veri uzantısı aracılığıyla yazar — 20 hesap verir. position_nft_mint’i basit bir Signer ve position_nft_account’ı bir UncheckedAccount’tır.

tick_array_bitmap_extension her iki varyant üzerinde de bildirilmiş bir hesap değildir. Pozisyonun aralığı pool’un satır içi tick_array_bitmap (±512 tick dizileri) dışına düştüğünde, TickArrayBitmapExtension PDA’sını ["pool_tick_array_bitmap_extension", pool_state] seed’lerinde remaining_accounts[0] olarak ekleyin.

Matematik — bkz. products/clmm/math. base_flag verildiğinde, program liquidity veya (amount_0_max, amount_1_max) değerlerini gerçek L ve tüketilen gerçek token tutarlarına çözer.

Ön Koşullar

• tick_lower < tick_upper, her ikisi de pool.tick_spacing’in katları, [MIN_TICK, MAX_TICK] içinde.
• İki tick-array PDA’sı geçirilir. Bunlar zaten var olmak zorunda değildir — 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 tutarına sahiptir.

Son Koşullar

• personal_position var, liquidity ayarlanmış, fee_growth_inside_last anlık görüntüsü alınmış.
• tick_lower ve tick_upper adreslerindeki tick-array girdileri güncellendi (liquidity_gross += L, liquidity_net ± L, ücret-büyüme anlık görüntüleri korunmuş).
• pool_state.liquidity += L eğer pozisyon aralık içindeyse (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 vault mint’lerinden herhangi birinin dondurma yetkilisi CLMM’nin kısıtlı-yayıncı listesiyle eşleşmediği sürece dondurulmamış kalır. Yalnızca bu eşleşen V2 yolu hesabı dondurur. OpenPosition V1 dondurmaz.

Yaygın hatalar — TickInvalidOrder (tick_lower >= tick_upper), TickAndSpacingNotMatch (bir uç nokta tick_spacing’in katı değil), InvalidTickIndex ([MIN_TICK, MAX_TICK] dışında), MissingTickArrayBitmapExtensionAccount (aralık satır içi bitmap dışında ve uzantı eklenmedi), NotApproved (pool_state.status açmayı engeller), ZeroAmountSpecified.

Pozisyon dondurma, bildirilmiş talimat hesapları veya argümanları eklemez. İstemciler bu pozisyonları mevcut V2 düzenleriyle açabilir. Davranış zincir üzerinde vault_0_mint ve vault_1_mint adresinden seçilir.

​

IncreaseLiquidityV2

Zaten açık olan bir pozisyona likidite ekleyin.

Argümanlar

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

Hesaplar — 15 tane ve OpenPosition adresinden türetilemez: rent yok, system_program yok, associated_token_program yok ve meta veri hesabı yok.

#	Ad	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

Pozisyonun aralığı satır içi bitmap dışında olduğunda TickArrayBitmapExtension PDA’sını remaining_accounts[0] olarak başına ekleyin.

Etki

• amount_0_actual / amount_1_actual tutarını kullanıcıdan → vault’lara aktarır.
• personal_position.liquidity ve pool_state.liquidity (aralık içindeyse) artırır ve uç nokta-tick liquidity_gross / liquidity_net değerlerini buna göre günceller.
• Son dokunuştan bu yana ödenmesi gereken ücretleri ve ödülleri toplar ve bunları token_fees_owed_{0,1} / reward_amount_owed değerlerine yatırır. Bunlar yalnızca DecreaseLiquidity / DecreaseLiquidityV2 üzerinde ödenir, artış üzerinde değil — bağımsız bir toplama talimatı yoktur.

​

DecreaseLiquidityV2

Bir pozisyondan likidite kaldırın.

Argümanlar

liquidity: u128
amount_0_min: u64
amount_1_min: u64

Hesaplar — 16 tane ve IncreaseLiquidityV2 ile aynı şekil veya sırada değil: personal_position ve pool_state değiştirilmiş, vault’lar tick dizilerinden önce gelir, kullanıcı tarafı hesapları recipient_token_account_* olarak adlandırılır ve ekstra bir memo_program vardır.

#	Ad	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

Kalan hesaplar — toplanmakta olan her aktif ödül için üç tane, reward_token_vault(W), recipient_token_account(W), reward_vault_mint sırasında. Pozisyonun aralığı satır içi bitmap dışında olduğunda TickArrayBitmapExtension PDA’sını başına ekleyin.

Bu aynı zamanda tek ücret ve ödül toplama yoludur. Pozisyonu değiştirmeden toplamak için liquidity = 0, amount_0_min = 0, amount_1_min = 0 ile çağırın.

Etki

• Kaldırılan L için geçerli sqrt_price_x64 verildiğinde (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 tutarlarını vault’lardan kullanıcıya aktarır.
• Likidite sayaçlarını azaltır; yeni personal_position.liquidity == 0 ise, pozisyon ClosePosition için uygun hale gelir.

Slippage — amount_0_min ve amount_1_min, kullanıcının çıkış tarafında Token-2022 transfer ücretleri net olarak kabul ettiği minimumlar.

​

ClosePosition

Position NFT’sini yakın ve PersonalPositionState’i kapat.

Bildirilen hesaplar

#	Ad	W	S	Notlar
1	nft_owner	W	S	NFT token hesabını tutmalı; miktar 1 olmalı.
2	position_nft_mint	W		personal_position.nft_mint ile eşleşmeli.
3	position_nft_account	W		NFT sahibinin hesabı; klasik SPL Token veya Token-2022 olabilir.
4	personal_position	W		nft_owner’a kapatılır.
5	system_program			Position state’i kapatır.
6	token_program			NFT mint ve token hesabına sahip olmalı.

Kalan hesaplar

• Donmamış NFT: hiçbiri gerekli değil; ekstra pool hesabı zararsızdır çünkü işleyici onu okumaz.
• Donmuş NFT: personal_position.pool_id’yi ilk kalan hesap olarak ekleyin. Program bunu PoolState olarak yükler ve çözme işlemini imzalamak için PDA seed’lerini kullanır.

Ön koşullar

• personal_position.liquidity == 0.
• tokens_fees_owed_{0,1} == 0.
• Tüm reward sayaçları reward_amount_owed == 0.

(Yani, önce her şeyi toplayın ve sıfıra düşürün.)

Etki

• NFT token hesabı donmuşsa, ilk kalan hesabın personal_position.pool_id’ye eşit olduğunu doğrular, ardından pool PDA’sı ile çözer.
• NFT’yi yakar.
• NFT token hesabını ve personal_position’ı kapatır, kirayı nft_owner’a geri öder. Position NFT Token-2022 kullanıyorsa, NFT mint’ini de kapatır; klasik SPL Token mint’leri kapatılamaz ve sıfır arz ile kalır.

Çözme, yakma ve kapatma atomiktir. NFT bu adımlar arasında aktarılabilir hale gelemez.

Koşullu istemci uyumluluğu — bildirilen IDL düzeni değişmez, bu nedenle eski istemciler mevcut ve donmamış pozisyonları kapatmaya devam eder. Pool kalan hesabını atlayan eski bir oluşturucu, donmuş bir pozisyonu kapatırken AccountLack ile başarısız olur. Her kapatma için pool’u geçmek en basit uyumlu stratejidir.

​

SwapV2

Likidite eğrisini takip edin; is_base_input’e bağlı olarak tam giriş veya tam çıkış.

Argümanlar

amount: u64                  // is_base_input=true ise giriş, aksi halde çı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

Hesaplar (özet)

#	Ad	W	S	Notlar
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 (bazı Token-2022 yolları için gerekli).
12	input_vault_mint, output_vault_mint			V2.
13	tick_array_bitmap_extension (isteğe bağlı)	W		Swap uzantıya girerse.
14+	tick_array (kalan)	W		Yürüyüşün beklenen aralığını kapsayacak kadar dizi.

Çağıranlar, beklenen swap yürüyüşünü kapsayan sıralanmış bir tick dizi listesi geçerler; program ihtiyaç duyduğu kadarını kullanır. SDK bu listeyi PoolUtils.computeAmountOutFormat veya API’nin quote uç noktası aracılığıyla hesaplar.

Ön koşullar

• 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ında.

Yaygın hatalar — TooLittleOutputReceived (tam giriş slippage), TooMuchInputPaid (tam çıkış slippage), SqrtPriceLimitOverflow, NotEnoughTickArrayAccount, InvalidFirstTickArrayAccount, MissingTickArrayBitmapExtensionAccount, LiquidityInsufficient, NotApproved (swap biti pool_state.status’ta ayarlanmış). CLMM’nin ExceededSlippage varyantı yoktur — bu ad CPMM’nindir — ve TickArrayNotFound yoktur.

SwapV2’nin çağıranların bilmesi gereken dahili işlemleri (2025 sonrası sürüm):

1. Dinamik ücret ek ücreti — pool.dynamic_fee_info sıfır değilse, program volatilite biriktiricisini son swap’tan bu yana geçilen tick mesafesi kullanarak günceller (ücret products/clmm/fees kurallarından filtre/bozunma ile) ve AmmConfig.trade_fee_rate’in üzerine bir dynamic_fee_component ekler. Toplam ücret %10 ile sınırlandırılı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 by order_phase), ardından LP likidite eğrisi boyunca devam eder. Doldurulmuş miktarlar tick.unfilled_ratio_x64 ve tick.part_filled_orders_remaining’i 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ılmış tarafa yönlendirilir. Yapılandırılmış ücret tarafının çıkış olduğu yönler için, ücret swap çıkışından düşülür (kullanıcı out − fee alır); giriş olduğu yönler için davranış FromInput ile eşleşir. PoolState’deki is_fee_on_input(zero_for_one) ve is_fee_on_token0(zero_for_one)’a bakın.

Swap (V1) SwapV2 ile aynı dinamik ücreti, tek taraflı ücret yönlendirmesini ve limit emri eşleştirmesini uygular; eksik olduğu tek özellik Token-2022 desteğidir — her iki vault da klasik SPL Token olmalı. Herhangi bir Token-2022 mint’i olan pool’lar SwapV2 aracılığıyla swap edilmelidir. Toplayıcı ve SDK zaten her CLMM bacağı için V2’yi tercih eder, bu nedenle çağıranların mint türüne göre dallanması gerekmez.

​

OpenLimitOrder

Belirli bir tick’te satış emri verin. Emir, tick başına FIFO kohortunda oturur ve fiyat geçtikçe doldurulur.

Argümanlar

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 miktarı

Hesaplar (özet)

#	Ad	W	S	Notlar
1	payer	W	S	Emir sahibi; kirayı öder.
2	pool_state	W
3	tick_array	W		tick_index’i içeren tick dizisi.
4	limit_order_nonce	W		PDA. init_if_needed — bu nonce_index altında kullanıcının ilk emrinde oluşturulur.
5	limit_order	W		PDA. Burada init.
6	input_token_account	W		Kullanıcının giriş ATA’sı. frozen için kontrol edilir.
7	output_token_account	W		Kullanıcının çıkış ATA’sı. Açılışta borçlandırılmaz — program daha sonra doldurmanın teslim edilebileceğini doğrulayabilmesi için gerekli (yani frozen değil).
8	input_vault	W		Pool giriş vault’u.
9	output_vault	W		Pool çıkış vault’u. output_token_account / output_vault_mint kontrolleri için çıkış mint’ini tanımlar.
10	input_vault_mint			Token-2022 ücret işleme.
11	output_vault_mint			Çıkış tarafının mint’i (donma-kontrol eşleştirmesi).
12	input_token_program			SPL veya Token-2022.
13	system_program			limit_order, limit_order_nonce ve — gerekirse — tick_array tahsisini finanse eder.

Kalan hesaplar — [0] tick_array_bitmap_extension, yalnızca başlangıç indeksi pool’un satır içi bitmap’inin dışına düşen bir tick dizisini başlatırken gerekli. Aksi takdirde hiçbir şey geçmeyin.

rent hesabı yoktur: yapı system_program’da biter, 13 bildirilen hesap. Konumda 14’te dolaşan bir rent, tam olarak isteğe bağlı bitmap uzantısının okunduğu yere iner, bu nedenle emir satır içi bitmap’inin dışında bir tick dizisinin ilk kez oluşturulması gerekene kadar çalışıyor gibi görünür — ve sonra başarısız olur.

Hesap listesi değişikliği (2026-07 sürümü). OpenLimitOrder artık giriş tarafına ek olarak çıkış tarafı hesaplarını da alır — output_token_account, output_vault ve output_vault_mint. Bunlar yalnızca doğrulama için kullanılır: program sahibinin giriş veya çıkış token hesabı donmuşsa emri reddeder. Bu, doldurmanın gerçekten sahibinin çıkış ATA’sına kapatılabileceğini garanti eder; bu, izin listesi / varsayılan donmuş Token-2022 mint’leri (örn. izinli tokenlar) için önemlidir; burada bir hesap henüz çözülmemiş olabilir. Eski tek taraflı hesap listesine karşı oluşturulan istemciler üç çıkış hesabını eklemelidir.

Ön koşullar

• Ne input_token_account ne de output_token_account donmuş değil (aksi takdirde NotApproved).
• pool_state.status hem swap (bit 4) hem de limit-order (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 sağ tarafında (token0 satışı → tick mevcut üzerinde olmalı, ve tersi). Zaten geçilmiş bir tick’te satış hemen eşleştirilir ve reddedilir.

Sonrası koşullar

• limit_order var, açılış zamanında tick.order_phase ve tick.unfilled_ratio_x64’ü anlık görüntüler.
• tick.orders_amount += amount (mevcut kohortda).
• limit_order_nonce.order_nonce += 1.
• OpenLimitOrderEvent yayınlanır.

Yaygın hatalar — NotApproved (giriş veya çıkış token hesabı donmuş, veya pool swap / limit-order devre dışı), ZeroAmountSpecified (giriş tarafı transfer ücreti sonrası amount == 0), InvalidLimitOrderAmount (miktar o tick’te 1 temel birim altında çıkış üretir veya u64 taşar), InvalidTickIndex ([MIN_TICK, MAX_TICK] dışında, veya seçilen yön için tick_current’ın yanlış tarafında), TickAndSpacingNotMatch (tick_index % pool.tick_spacing != 0), OrderPhaseSaturated.

​

IncreaseLimitOrder

Mevcut açık emre ekleyin. Yalnızca emrin owner’ı tarafından çağrılabilir.

Argümanlar

amount: u64    // ek giriş-token miktarı

Hesaplar — 8, yalnızca giriş tarafı. Nonce hesabını, üç çıkış tarafı hesabını ve system_program’ı bırakır.

#	Ad	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

Ön koşullar

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

Etki

• amount’ı sahibinin ATA’sından input_vault’a aktarır.
• limit_order.total_amount += amount; tick.orders_amount += amount.

​

DecreaseLimitOrder

Açık bir emri azaltın veya tamamen iptal edin. Doldurulmamış kalanı sahibine geri öder, artı geçmiş kısmi doldurmalarla zaten kapatılmış herhangi bir çıkış.

Argümanlar

amount:     u64    // çekilecek giriş-token miktarı (max = doldurulmamış kalan)
amount_min: u64    // giriş tarafı çekme işleminde slippage tabanı

Hesaplar — hem giriş hem de çıkış token tarafları:

#	Ad	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

Etki

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

​

SettleLimitOrder

Doldurulmuş çıkış tokenlerini siparişin doldurulmamış kalanını değiştirmeden sahibine gönderin. auto_withdraw keeper’ları uzun süreli kısmi doldurmaları damla-ödeme yapmak istediğinde kullanışlıdır.

Çağıran — siparişin owner’ı veya programın limit_order_admin’i (otomatik keeper döngüsü çalıştıran çevrimdışı operasyonel sıcak cüzdan). Keeper’ın başka yetkisi yoktur — kullanıcı fonlarını siparişin owner ATA’sına doldurulmuş çıkışı göndermek dışında hareket ettiremez.

Hesaplar

#	Ad	W	S	Notlar
1	signer		S	owner veya limit_order_admin
2	pool_state
3	tick_array
4	limit_order	W
5	output_token_account	W		Sahibinin çıkış ATA’sı.
6	output_vault	W		Pool çıkış kasası.
7	output_vault_mint
8	output_token_program

Etki

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

​

CloseLimitOrder

Tamamen tüketilmiş bir sipariş hesabını kapatın. Kira, kim imzalarsa imzasın her zaman limit_order.owner’a iade edilir.

Çağıran — owner veya limit_order_admin.

Ön koşullar

• Siparişin sıfır doldurulmamış kalanı vardır (ya amount == total_amount doldurulmuş ve kapatılmış, ya da sahip daha önce siparişi sıfıra düşürmüş ve kapatmayı unutmuş).

Etki

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

​

CreateDynamicFeeConfig (yönetici)

Bir u16 indeksi altında yeniden kullanılabilir bir parametre seti oluşturun.

Argümanlar

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 = decay penceresi başına %50 tutma
dynamic_fee_control:         u32   // 1..100_000; volatilite-ücret eğrisinde kazanç
max_volatility_accumulator:  u32   // tavan

Hesaplar

#	Ad	W	S	Notlar
1	owner	W	S	Sabit kodlanmış yönetici pubkey’i.
2	dynamic_fee_config	W		PDA, burada init edilir.
3	system_program

Yaygın hatalar — decay_period <= filter_period ise veya herhangi bir 0 değerli alan sınırların dışındaysa InvalidDynamicFeeConfigParams.

​

UpdateDynamicFeeConfig (yönetici)

Mevcut bir DynamicFeeConfig’i değiştirin. Oluşturma zamanında yapılandırmayı zaten anlık görüntüsü alan havuzlar geriye dönük olarak güncellenmez; yalnızca bu yapılandırmaya başvuran yeni oluşturulan havuzlar yeni değerleri alacaktır.

Argümanlar — CreateDynamicFeeConfig ile aynı beş kalibrasyon alanı (filter_period, decay_period, reduction_factor, dynamic_fee_control, max_volatility_accumulator); index oluşturma sırasında sabitlenir ve burada yeniden geçirilmez.

​

CollectProtocolFee / CollectFundFee

Havuzun kasalarından tahakkuk eden protokol/fon ücretlerini bir alıcıya taraklayın, karşılık gelen PoolState.protocol_fees_* / fund_fees_* alanlarını sıfırlayın. Bu CPMM’nin düzeni değildir — CLMM’nin authority hesabı yoktur ve alıcı alanları recipient_token_{0,1}_account yerine recipient_token_account_{0,1} olarak adlandırılır.

Argümanlar — amount_0_requested: u64, amount_1_requested: u64.

#	Ad	W	S	Notlar
1	owner		S	amm_config.owner (veya fon varyantı için amm_config.fund_owner), veya program yöneticisi; aksi takdirde 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

2026-09’da değiştirildi: yeni yapılandırmalar artık ücret sahiplerini imzalayanlardan almaz. create_amm_config artık programın sabit kodlanmış protocol_fee_owner::ID’sini owner’a ve fund_fee_owner::ID’sini fund_owner’a yazar. Daha önce, yönetici imzalayanın anahtarını her ikisine de kopyalardı. Mainnet’te bunlar zaten mevcut 21 yapılandırmanın tümünde depolanan aynı anahtarlardır. Adresler reference/program-addresses içindedir.

Yukarıdaki kabul edilen imzalayanlar değişmemiştir. Yönetici hala herhangi bir yapılandırmadan toplayabilir ve mevcut AmmConfig hesapları yeniden yazılmaz. Hesaptan owner / fund_owner’ı okuyun, her iki değeri de varsaymak yerine. UpdateAmmConfig parametreleri 3 ve 4 hala onları döndürür.

​

CollectExcessLamports

CLMM’nin kontrol ettiği hesaplardaki kira-muaf minimumun üzerindeki lamportların yönetici taraması. SIMD-0437 kira azaltması her adımdan önce oluşturulan hesaplarda bıraktığı aşırı finansmanı geri almak için 2026-09 yükseltmesinde eklendi.

Yalnızca fazlalık hareket eder. Token bakiyeleri, hesap verileri, sahipleri, havuz durumu ve fiyat eğrisi dokunulmaz. Zaten minimumda olan bir hesap olduğu gibi bırakılır, bu nedenle her dağıtım adımından sonra talimat güvenle yeniden çalıştırılabilir.

Argümanlar: hiçbiri.

Hesaplar

#	Ad	W	S	Notlar
1	collect_lamports_wallet	W	S	Her taranmış lamportı alır. CLMM program yöneticisi veya özel lamport-toplama cüzdanı olmalıdır (bkz. reference/program-addresses). Başka herhangi bir imzalayan NotApproved ile başarısız olur.
2	pool_state	W		Taranmakta olan havuz. PDA tohumları token-program CPI’larını imzalar ve hesap her zaman kendisi taranır.
3	token_program			SPL Token.
4	token_program_2022			Token-2022. Her iki program da gereklidir; talimat kaynak hesap başına birini seçer.
5..	remaining_accounts	W		M kaynak hesabı, herhangi bir sayı, herhangi bir sıra.

Kapsam: çağrı başına bir havuz. CLMM’nin program genelinde kasa yetkisi yoktur. Her havuzun kasaları kendi PoolState’i tarafından sahiplenilir. Bu nedenle her token-program kaynağının slot 2’de pool_state’i yetkili olarak olması gerekir: token_vault_0, token_vault_1 veya o havuzun ödül kasalarından biri. Başka bir havuzun kasasını veya bir kullanıcının token hesabını geçerseniz, token programının sahip kontrolü başarısız olur ve tüm talimat geri döner. Atlanmaz. Pozisyon NFT mintleri taranmaz, çünkü mint yetkisi pozisyon açıldığında iptal edilir.

Her kaynak hesabın nasıl işlendiği

Program remaining_accounts üzerinde iki geçiş yapar: önce her token-program CPI’sı, sonra doğrudan borçlar. İkisini araya sokmak çalışma zamanının UnbalancedInstruction hatasıyla iptal olur, bu nedenle sıra programda sabitlenir ve listeyi kendiniz sıralamanız gerekmez.

Geçiş	Kaynak hesap sahibi	İşleme
1	SPL Token veya Token-2022, yerel olmayan token hesabı	CPI WithdrawExcessLamports (token-program ayırıcı 38), pool_state tarafından imzalanmış.
1	SPL Token veya Token-2022, yerel (wSOL) token hesabı	WithdrawExcessLamports yerel hesapları reddeder. Program SyncNative’i CPI’lar, sarılı amount’un ne kadar büyüdüğünü ölçer ve tam o delta için UnwrapLamports (ayırıcı 45) çağırır. Daha sonra sarılı bakiyenin ön-senkronizasyon değerine eşit olmasını gerektirir, aksi takdirde LamportsCalculateError (6052) ile başarısız olur. SOL tarafı havuz kasası tam likiditeyi tutar.
2	pool_state (slot 2)	Doğrudan rent.minimum_balance(data_len) kadar borçlandırılır.
2	CLMM programı: AmmConfig, ObservationState, TickArrayBitmapExtension, TickArrayState, PersonalPositionState, LimitOrderState ve benzeri	Doğrudan rent.minimum_balance(data_len) kadar borçlandırılır. Hesap slot 2’deki havuza ait olmak zorunda değildir.
—	Başka herhangi bir şey	Sessizce atlanır. Hata yok, lamport hareket yok.

Geçiş 2, bir kullanıcının kirasını ödediği hesapları kapsar. Burada geçirilen bir PersonalPositionState veya LimitOrderState, diğer herhangi bir CLMM tarafından sahip olunan hesap gibi fazlalığından vazgeçer. Kira-muaf kalır ve verilerini tutar. Daha sonra kapatıldığında, sahip o noktada hesabın tuttuğu her şeyi geri alır; bu, bir tarama sonrasında geçerli kira minimumdur.

İşlem boyutu, bir çağrıya kaç kaynağın sığabileceğinin gerçek sınırıdır. Bu, solana-fundamentals/rent-and-reclaimable-rent içinde açıklanan cüzdan tarafı tarama ile aynı kısıtlamadır.

Yaygın hatalar:

• NotApproved (6000): yanlış imzalayan.
• LamportsCalculateError (6052): wSOL gidiş-dönüş sıfıra net olmadı.
• Bir token-program sahip-uyuşmazlığı hatası: bir token kaynağı pool_state tarafından sahip değildir.
• InsufficientFunds: bir programa ait hesap kendi kira minimumundan daha az tutar.

SDK oluşturucu yok. @raydium-io/raydium-sdk-v2 bu yönetici yolu için bir oluşturucu göndermez. IDL’den elle kodlayın.

​

InitializeReward

Bir havuza yeni bir ödül akışı ekleyin. Aynı anda en fazla 3 akış etkin olabilir.

Argümanlar — tek bir yapı, param: InitializeRewardParam:

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

Tel kodlaması üç alanın arka arkaya olmasıdır, bu nedenle elle oluşturulan bir talimat etkilenmez — ancak IDL tarafından yönlendirilen bir istemci üç konumsal argüman yerine bir param nesnesi geçmelidir.

Hesaplar

#	Ad	W	S	Notlar
1	reward_funder	W	S
2	funder_token_account	W
3	amm_config
4	pool_state	W
5	operation_state			Ödül oluşturmayı kapılayan CLMM işlem durumu PDA’sı.
6	reward_token_mint
7	reward_token_vault	W		Burada init edilir.
8	reward_token_program
9	system_program, rent

Ön koşullar

• Havuzda 3’ten az akış şu anda etkindir.
• Funder, bu talimatın bir parçası olarak total_emission = emissions_per_second × (end_time − open_time) değerinde ödül tokenini kasaya yatırır.
• operation_state başına beyaz listeye alınmış ödül mint’i.

​

SetRewardParams

Mevcut bir ödül akışını genişletin, doldurabilir veya emisyon oranını değiştirin. Tipik olarak havuz yaratıcısı veya Raydium multisig tarafından çağrılır. Kısıtlamalar zincir üzerinde yaşar: genellikle end_time’ı genişletebilir veya emisyonları artırabilir, geriye dönük olarak küçültemezsiniz. operation_state’in sahip listesini kontrol edin.

​

UpdateRewardInfos

Saf muhasebe — reward_growth_global_x64’ü geçerli zamana emissions_per_second × Δt / liquidity çarparak kapatır. Likiditeye dokunan her talimat tarafından dahili olarak çağrılır. Dış aktörler (UI’lar, kranklar) bazen bunu tetiklemek istediğinden, bağımsız bir talimat olarak açığa çıkarılır.

​

Ödülleri toplama

Bağımsız bir ödül toplama talimatı yoktur. Program CollectReward giriş noktasını açığa çıkarmaz ve yayınlanan IDL’nin de hiçbiri yoktur.

Bir pozisyona borçlu olunan ödüller DecreaseLiquidity / DecreaseLiquidityV2 tarafından ödenir. Pozisyonu değiştirmeden toplamak için liquidity = 0, amount_0_min = 0, amount_1_min = 0 ile çağırın. Ödül kasaları ve alıcı hesapları remaining_accounts’a etkin ödül başına üçlü gruplar halinde, reward_token_vault(W), recipient_token_account(W), reward_vault_mint sırasında gider.

CollectRemainingRewards farklı bir şeydir: ödül funder’ının, bir akışın end_time’ından sonra, herhangi bir pozisyona tahsis edilmemiş tokenları taramasına izin verir.

​

Durum değişim matrisi

Talimat	pool.liquidity	pool.fee_growth_global	pool.reward_growth_global	personal_position.liquidity	Tick dizisi
CreatePool	0	0	—	—	—
OpenPosition	+ aralıkta ise	—	—	yeni	liquidity_gross/net ekle
IncreaseLiquidity	+ aralıkta ise	borçlu olanı kapat	borçlu olanı kapat	+	ayarla
DecreaseLiquidity	− aralıkta ise	borçlu olanı kapat	borçlu olanı kapat	−	ayarla
ClosePosition	—	—	—	yok edildi	—
SwapV2	± geçişlerde	+	—	—	geç ve dış tarafı çevir; limit-order kohortlarını eşleştir
OpenLimitOrder	—	—	—	—	hedef tick’te orders_amount += amount
IncreaseLimitOrder	—	—	—	—	orders_amount += amount
DecreaseLimitOrder	—	—	—	—	orders_amount -=, kohortu kapatabilir
SettleLimitOrder	—	—	—	—	— (tick’te salt okunur)
CloseLimitOrder	—	—	—	—	—
CreateCustomizablePool	0	0	—	—	—
UpdateRewardInfos	—	—	+	—	—
CollectExcessLamports	—	—	—	—	— (yalnızca lamports; token bakiyeleri değişmez)

​

Sonraki adımlar

• products/clmm/code-demos — çalıştırılabilir TypeScript örnekleri.
• products/clmm/fees — işlem ücreti ve ödül tahakkuku hakkında ayrıntılar.
• reference/error-codes — tam CLMM Anchor hata tablosu.

Kaynaklar:

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