CPMM talimatları

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 yetkili talimat referansıdır. Bu talimatları gerçekten oluşturan kod için bkz. products/cpmm/code-demos. Hata kodu anlamları için reference/error-codes bölümüne bakın.2026-09 program yükseltmesi CPMM’yi Anchor 1.0.2 / Solana 3.1.10 üzerine yeniden inşa etti, admin talimatı CollectExcessLamports ekledi, sabit kodlanmış Token-2022 mint beyaz listesini kaldırdı ve CreateAmmConfig’in protocol_owner / fund_owner alanlarına ne yazacağını değiştirdi. Hiçbir kullanıcı tarafından görülen talimat hesaplarını, argümanlarını veya matematiklerini değiştirmedi. 2026-09-09 changelog girişine bakın.

Her iki yaratıcı ücret toplama talimatı da 2026-09-19 tarihinde hesap listelerini değiştirdi. CollectCreatorFee creator_fee_share kazanır; CollectCreatorFeePermissionless amm_config ve creator_fee_share kazanır. Her ikisi de system_program sonrasına eklenir, bu nedenle mevcut bir istemcinin hâlihazırda geçirdiği her hesap kendi dizinini korur — ancak yeni hesaplar zorunludur, bu nedenle eski düzene karşı inşa edilen bir işlem eksik kalır ve Anchor’ın AccountNotEnoughKeys (3005) hatasıyla reddedilir. İki admin talimatı — CreateCreatorFeeShare ve CloseCreatorFeeShare — eklenir ve UpdateAmmConfig yeni bir param = 8 alır. 2026-09-19 changelog girişine bakın.

Talimat özeti

Ayırıcı adı	Kim imzalar	Ne yapar
`Initialize`	havuz yaratıcısı	İki mint ve bir `AmmConfig` adresinden yeni bir CPMM havuzu oluşturun. İzinsiz; herkes çağırabilir. Yeni havuzda `enable_creator_fee = false` sabit kodlar. `pool_state` hesabı kanonik PDA veya yeni bir rastgele anahtar olabilir (bkz. Initialize hesapları).
`InitializeWithPermission`	ödeyici + `Permission` PDA sahibi	`Initialize`’ın izinli varyantı. Çağıran (`payer`) kendi genel anahtarından türetilen bir `Permission` PDA’ya sahip olmalıdır. Havuz oluşturmayı kapılı tutması gereken platformlar tarafından kullanılır (örn. LaunchLab mezuniyetleri). Çağıranın `creator_fee_on` (`BothToken` / `OnlyToken0` / `OnlyToken1`) sabitlemesine izin verir ve yeni havuzda `enable_creator_fee = true` zorlar. Yeni havuzdaki `creator` alanı ödeyici değil, ayrı olarak geçirilen `creator` hesabına ayarlanır. `pool_state` için `Initialize` ile aynı kanonik-PDA-veya-rastgele-anahtar esnekliği.
`Deposit`	LP	Her iki tokende likidite ekleyin; LP tokenları alın.
`Withdraw`	LP	LP tokenlarını yakın; her iki temel tokeni orantılı olarak alın.
`SwapBaseInput`	takas yapan	Tam giriş takas (`amount_in` giriş, ≥ `minimum_amount_out` çıkış).
`SwapBaseOutput`	takas yapan	Tam çıkış takas (≤ `maximum_amount_in` giriş, `amount_out` çıkış).
`CollectProtocolFee`	`protocol_owner` (`AmmConfig`’ten)	Kasalardan birikmiş protokol ücretlerini temizleyin.
`CollectFundFee`	`fund_owner` (`AmmConfig`’ten)	Kasalardan birikmiş fon ücretlerini temizleyin.
`CollectCreatorFee`	`pool_creator`	Birikmiş yaratıcı ücretlerini (yaratıcı ücreti etkinleştirilmişse) temizleyin, protokolün payı net (havuzun protokol paketine kaydedilir).
`CollectCreatorFeePermissionless`	herhangi bir ödeyici	Birikmiş yaratıcı ücretlerini `pool_creator`’ün kanonik token hesaplarına temizleyin, aynı protokol payı net. Ödeyici eksik alıcı ATA’larını oluşturabilir ancak transferi yeniden yönlendiremez.
`UpdatePoolStatus`	`admin`	Bir havuzdaki belirli işlemleri bir bit maskesi aracılığıyla duraklatın / devam ettirin.
`UpdateAmmConfig`	`admin`	Bir `AmmConfig` üzerindeki ücret oranlarını veya protokol/fon sahibini değiştirin.
`CreateAmmConfig`	`admin`	Yeni bir ücret katmanı (yeni `AmmConfig` hesabı) oluşturun.
`CreatePermissionPda`	`admin` veya temsilci izin-PDA yaratıcısı	Belirli bir yetkilinin `InitializeWithPermission` çağırmasına izin veren bir `Permission` PDA’sı basın.
`ClosePermissionPda`	`admin` veya adanmış izin-PDA yaratıcısı	Daha önce verilen bir `Permission` PDA’sını iptal edin. 2026-09 yükseltmesinden bu yana adanmış yaratıcı yetkilisi verdiği bir izni de kapatabilir; bundan önce yalnızca admin tarafından yapılabiliyordu.
`CreateSupportMintAssociated`	`admin` veya adanmış destek-mint sahibi	Aksi takdirde uzantı izin listesinde başarısız olacak bir Token-2022 mint’i, `SupportMintAssociated` PDA’sını oluşturarak kaydedin.
`CloseSupportMintAssociated`	`admin` veya adanmış destek-mint sahibi	Bir mint’in kaydını kaldırın.
`CollectExcessLamports`	`admin` veya adanmış lamport toplama cüzdanı	CPMM tarafından kontrol edilen kasalardan, LP mint’lerinden ve PDA’larından kira-muaf minimumun üzerindeki lamportları temizleyin. 2026-09’da eklendi.
`CreateCreatorFeeShare`	`admin` veya adanmış yaratıcı-ücret-payı sahibi	Bir `(creator, amm_config)` çifti için yaratıcı ücretinin özel bir protokol payını ayarlayın, `AmmConfig.creator_fee_share_rate` geçersiz kılın. 2026-09-19’te eklendi.
`CloseCreatorFeeShare`	`admin` veya adanmış yaratıcı-ücret-payı sahibi	Bu geçersiz kılmayı kaldırın; çift yapılandırma varsayılanına geri döner. 2026-09-19’te eklendi.

Durum bit maskesi: her havuzun status alanı bir u8 olup, bit 0 = depozito devre dışı, bit 1 = çekilme devre dışı, bit 2 = takas devre dışı (PoolStatusBitIndex { Deposit, Withdraw, Swap } programda). Temiz bir bit işlemin izin verildiği anlamına gelir; ayarlanmış bir bit duraklatıldığı anlamına gelir. UpdatePoolStatus ham bir u8 alır ve mevcut değerin üzerine yazar. Sonraki bölümler her birini ayrıntılı olarak ele alır. Hesap sıralaması CPMM IDL’sini izler; SDK ve raydium-cp-swap/programs/cp-swap/src/instructions içindeki Rust istemcisi bu sırayı eşleştirir.

`Initialize`

Yeni bir CPMM havuzu oluşturun. Argümanlar

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix zaman damgası; bu tarihten önce takaslar reddedilir

Hesaplar (W = yazılabilir, S = imzalayan)

#	Ad	W	S	Notlar
1	`creator`	W	S	Kirayı öder; `pool_state.pool_creator` olarak kaydedilir.
2	`amm_config`			Seçilen ücret katmanı.
3	`authority`			CPMM global yetki PDA’sı.
4	`pool_state`	W	S*	Burada `init` edilir. Ya kanonik PDA `["pool", amm_config, token_0_mint, token_1_mint]` ya da yeni bir rastgele anahtar — kanonik PDA olmadığında, program `pool_state`’in imzalamasını gerektirir (`require_eq!(pool_account_info.is_signer, true)`). Rastgele anahtar yolu, yaratıcının kanonik PDA’da ön çalıştırma girişimlerinden kaçınmasına izin verir. Aşağı akış PDA’ları (`lp_mint`, `vaults`, `observation_state`) her iki durumda da `pool_state.key()` adresinden türetilir.
5	`token_0_mint`			Sıralanmış: `token_0_mint < token_1_mint`.
6	`token_1_mint`
7	`lp_mint`	W		Burada `init` edilir. Yetki `authority` olarak ayarlanır.
8	`creator_token_0`	W		`init_amount_0` için kaynak ATA.
9	`creator_token_1`	W		`init_amount_1` için kaynak ATA.
10	`creator_lp_token`	W		`lp_mint` üzerinde yaratıcının ATA’sı. `init` (değil `init_if_needed`) — zaten var olmamalıdır, olamaz, çünkü `lp_mint` bu aynı talimatta oluşturulur.
11	`token_0_vault`	W		Burada `init` edilir. `authority` tarafından sahiplenilir.
12	`token_1_vault`	W
13	`create_pool_fee`	W		Yaratıcı tarafından ödenen `create_pool_fee` için hedef ATA.
14	`observation_state`	W		Burada `init` edilir.
15	`token_program`			SPL Token (LP mint için).
16	`token_0_program`			SPL Token veya Token-2022.
17	`token_1_program`			SPL Token veya Token-2022.
18	`associated_token_program`
19	`system_program`
20	`rent`

* pool_state yalnızca rastgele anahtar yolunda imzalar; kanonik-PDA yolu pool_state imzalaması olmadan çalışır. Ön koşullar

Mint’ler sıralanmıştır (token_0_mint < token_1_mint bayt sırasına göre).
Hiçbir mint, CPMM izin listesi dışında bir uzantı kullanmaz (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — bkz. products/cpmm/accounts. SupportMintAssociated PDA’sı (tohum [b"support_mint", mint]) olan bir mint uzantı kontrolünü atlar — ancak bu PDA’yı remaining_accounts adresine eklemelisiniz. Program yalnızca geçirdiğiniz hesapları tarar ve PDA’yı asla kendisi yüklemez, bu nedenle hesabı sağlamadan kayıt defterine güvenmek yine de NotSupportMint (6007) ile başarısız olur. Sıra önemli değildir (eşleştirme anahtarla yapılır); bypass gereken her mint için bir giriş geçirin. Bu kayıt defteri, 2026-09 yükseltmesi sabit kodlanmış dört mint beyaz listesini kaldırdığından beri tek bypass’tır.
creator ilgili ATA’larda en az init_amount_0 ve init_amount_1 öğesine sahiptir.
amm_config.disable_create_pool == false.

Son koşullar

pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — tam karekök. Yaratıcı lp_supply − 100 basılır; kilitli 100 temel birim lp_supply içinde sayılır ancak asla basılmaz.
Yani havuzun ömrü boyunca lp_mint.supply == pool_state.lp_supply − 100. Tüm LP-pay matematiği (depozito, çekilme) lp_supply ile bölünür, bu nedenle bu alanı kullanın ve mint’in zincir üstü arzını yerine koymayın. sqrt(...) < 100 ise InitLpAmountTooLess ile geri döner.
observation_state başlatılır; observation_index = 0 ve pool_id = pool_state.key().
create_pool_fee lamportları yaratıcıdan alıcıya aktarılır ve yerel SOL olarak senkronize edilir (wSOL ATA’sıdır).
Havuzun durum bit maskesi 0 (depozito / çekilme / takas tümü etkindir).
enable_creator_fee = false ve creator_fee_on = BothToken. Initialize yaratıcı ücretini etkinleştirmeyi desteklemez — bu yol InitializeWithPermission adresine gider.
open_time, çağıran <= block_timestamp değeri geçtiyse block_timestamp + 1 olarak yükseltilir. Takaslar open_time tarihinden önce reddedilir; depozitolar ve çekilmeler hemen çalışır.

Yaygın hatalar (tam liste reference/error-codes adresinde)

InvalidInput — mint’ler sıralanmamış veya özdeş mint’ler.
NotSupportMint — engellenen Token-2022 uzantısı.
ExceededSlippage — nadiren; init_amount_0/1 ondalık uyuşmazlığı nedeniyle sıfır LP ile sonuçlanırsa.

`Deposit`

Havuza orantılı olarak her iki tokende likidite ekleyin. Argümanlar

lp_token_amount:   u64   // LP'ye basılacak kaç LP tokeni
maximum_token_0:   u64
maximum_token_1:   u64

Hesaplar

#	Ad	W	S
1	`owner`		S
2	`authority`
3	`pool_state`	W
4	`owner_lp_token`	W
5	`token_0_account`	W
6	`token_1_account`	W
7	`token_0_vault`	W
8	`token_1_vault`	W
9	`token_program`
10	`token_program_2022`
11	`vault_0_mint`
12	`vault_1_mint`
13	`lp_mint`	W

Matematik

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // taraf 1 için aynı

needed_token_0 = ceil(lp_token_amount * total_0 / lp_supply)
transfer_0     = needed_token_0 + inverse_transfer_fee(needed_token_0) // Token-2022
require(transfer_0 <= maximum_token_0, "ExceededSlippage")             // taraf 1 için aynı

Sabitlenmeye değer iki ayrıntı: orantılı taban ücret hariç kasa toplamıdır (vault_amount_without_fee, yani ham bakiye eksi birikmiş protokol, fon ve yaratıcı sayaçları), ham kasa bakiyesi değil; ve kayma sınırı, ödeyicinin gerçekten aktardığı şeye karşı kontrol edilir, Token-2022 transfer ücreti eklendikten sonra, brüt kasa hareketi değil. k’nin orantılılığında değişiklik yok — hem toplamlar hem de lp_supply aynı faktörle ölçeklenir. Son koşullar

lp_supply += lp_token_amount.
vault_0 += needed_token_0 (giriş üzerindeki herhangi bir Token-2022 transfer ücreti net).
vault_1 += needed_token_1 (giriş üzerindeki herhangi bir Token-2022 transfer ücreti net).

Yaygın hatalar — ExceededSlippage, ZeroTradingTokens, depozito duraklatılmışsa InvalidStatus.

`Withdraw`

LP tokenlarını yakın ve her iki temel tokeni orantılı olarak alın. Argümanlar

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

Hesaplar

#	Ad	W	S
1	`owner`		S
2	`authority`
3	`pool_state`	W
4	`owner_lp_token`	W
5	`token_0_account`	W
6	`token_1_account`	W
7	`token_0_vault`	W
8	`token_1_vault`	W
9	`token_program`
10	`token_program_2022`
11	`vault_0_mint`
12	`vault_1_mint`
13	`lp_mint`	W
14	`memo_program`

İlk 13 hesap Deposit ile aynıdır ve LP tokenları yakıldığı için lp_mint yazılabilirdir. Withdraw ek olarak 14. hesabı alır, memo_program (kısıtlı address = memo::ID) — Deposit almaz. 13 hesaplı bir Withdraw Anchor seri durumdan çıkarmada başarısız olur, bu nedenle LP çıkamaz. Matematik

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // taraf 1 için aynı

out_token_0     = min(total_0, floor(lp_token_amount * total_0 / lp_supply))
receive_token_0 = out_token_0 − transfer_fee(out_token_0)             // Token-2022
require(receive_token_0 >= minimum_token_0, "ExceededSlippage")       // taraf 1 için aynı

// Deposit'te olduğu gibi: taban ücret hariç kasa toplamıdır ve taban
// LP'nin gerçekten aldığı şeye karşı kontrol edilir, transfer ücreti sonrası.

Son koşullar

lp_supply -= lp_token_amount.
Kasalar out_token_0 / out_token_1 gönderir (brüt; kullanıcı herhangi bir Token-2022 transfer ücreti net alır).

`SwapBaseInput`

Tam giriş takas. Argümanlar

amount_in:            u64
minimum_amount_out:   u64

Hesaplar

#	Ad	W	S
1	`payer`		S
2	`authority`
3	`amm_config`
4	`pool_state`	W
5	`input_token_account`	W
6	`output_token_account`	W
7	`input_vault`	W
8	`output_vault`	W
9	`input_token_program`
10	`output_token_program`
11	`input_token_mint`
12	`output_token_mint`
13	`observation_state`	W

Sıralama giriş → çıkış kullanıcının yönüne göre, havuzun kanonik token_0 / token_1 değerine göre değil. Program mint’leri eşleştirerek hangi kasanın hangisi olduğunu anlar. Matematik — bkz. products/cpmm/math. Ön koşullar

open_time <= now.
pool_status takasa izin verir.
Bu yetki için hiçbir mint duraklatılmamış veya dondurulmamış.
amount_in > 0.

Yaygın hatalar

ExceededSlippage — amount_out < minimum_amount_out.
ZeroTradingTokens — ticaret sıfıra yuvarlanır.
NotApproved — havuz UpdatePoolStatus aracılığıyla takaslar için duraklatılmıştır.
InvalidInput — mint’ler havuzun kasa mint’lerinden hiçbiriyle eşleşmez.

`SwapBaseOutput`

Tam çıkış takas. Argümanlar

max_amount_in:  u64
amount_out:     u64

Hesaplar — SwapBaseInput ile aynı. Matematik — ters eğri tavana sahip, bkz. products/cpmm/math. Yaygın hatalar — ExceededSlippage (gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

`CollectProtocolFee`

Kasalardan protokol hedefine birikmiş protokol ücretlerini temizleyin. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`owner`		S	`amm_config.protocol_owner` veya programın sabit kodlanmış admin anahtarı ile eşleşmelidir.
2	`authority`
3	`pool_state`	W
4	`amm_config`
5	`token_0_vault`	W
6	`token_1_vault`	W
7	`vault_0_mint`
8	`vault_1_mint`
9	`recipient_token_0_account`	W
10	`recipient_token_1_account`	W
11	`token_program`
12	`token_program_2022`

Etki

transfer pool_state.protocol_fees_token0 from vault_0 to recipient_0
transfer pool_state.protocol_fees_token1 from vault_1 to recipient_1
pool_state.protocol_fees_token0 = 0
pool_state.protocol_fees_token1 = 0

Eğrinin etkin bakiyelerinde değişiklik yok (birikmiş ücretler zaten hariç tutulmuştu). Yaygın hata — InvalidOwner (6001) imzalayan amm_config.protocol_owner veya program admin değilse. (Bu yolda NotApproved yoktur.)

`CollectFundFee`

CollectProtocolFee ile aynı şekil ancak amm_config.fund_owner tarafından imzalanır — veya yine program admin — ve fund_fees_* sayaçlarını sıfırlar. Yanlış imzalayan üzerinde aynı InvalidOwner.

`CollectCreatorFee`

pool_state.pool_creator tarafından imzalanır. Birikmiş yaratıcı ücretini kapatır ve yaratıcının kısmını yaratıcının token hesaplarına aktarır. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`creator`	W	S	Kısıtlı `address = pool_state.pool_creator`.
2	`authority`			CPMM global kasa yetki PDA’sı.
3	`pool_state`	W		Birikmiş yaratıcı-ücret sayaçlarını tutar.
4	`amm_config`			Kısıtlı `address = pool_state.amm_config`. Varsayılan `creator_fee_share_rate` taşır.
5	`token_0_vault`	W		Havuzun token 0 kasası ile eşleşmelidir.
6	`token_1_vault`	W		Havuzun token 1 kasası ile eşleşmelidir.
7	`vault_0_mint`			`token_0_vault.mint` ile eşleşmelidir.
8	`vault_1_mint`			`token_1_vault.mint` ile eşleşmelidir.
9	`creator_token_0`	W		Token 0’ın yaratıcı kısmı için hedef.
10	`creator_token_1`	W		Token 1’in yaratıcı kısmı için hedef.
11	`token_0_program`			SPL Token veya Token-2022, token 0 ile eşleşir.
12	`token_1_program`			SPL Token veya Token-2022, token 1 ile eşleşir.
13	`associated_token_program`
14	`system_program`
15	`creator_fee_share`			2026-09-19’te eklendi, `system_program` sonrasına eklendi. `["creator_fee_share", creator, amm_config]` adresindeki PDA. Her çağrıda geçirilmelidir, ancak var olması gerekli değildir — boş olduğunda veya CPMM tarafından sahiplenilmediğinde program `amm_config.creator_fee_share_rate` adresine geri döner. Tohum kısıtlaması yine de geçerlidir, bu nedenle adres kanonik PDA olmalıdır.

Etki

share_rate = creator_fee_share.share_rate   (hesap varsa)
           | amm_config.creator_fee_share_rate   (aksi takdirde)

shared_i  = floor(creator_fees_token_i * share_rate / 1_000_000)
creator_i = creator_fees_token_i - shared_i

transfer creator_i from vault_i to creator_token_i
pool_state.protocol_fees_token_i += shared_i     // kasada kalır
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

Protokolün payı burada kasadan asla çıkmaz — protokol ücreti olarak yeniden etiketlenir ve CollectProtocolFee için bekler. Her iki sayaç zaten eğrinin kasa görüşünden hariç tutulmuştur, bu nedenle havuzun fiyatı hareket etmez. Tam türetme products/cpmm/fees adresinde. Yaygın hatalar — her iki yaratıcı sayacı da sıfır olduğunda NoFeeCollect (bölünmeden önce kontrol edilir), çözümlenen share_rate 1_000_000 aşarsa InvalidInput (6003), payı protocol_fees_token_* adresine kaydetmek taşarsa MathOverflow (6011) ve creator_fee_share kanonik PDA değilse Anchor’ın ConstraintSeeds hatası.

`CollectCreatorFeePermissionless`

Herkes yaratıcı-ücret toplamasını tetikleyebilir. Talimat her zaman yaratıcının kısmını pool_state.pool_creator tarafından sahiplenilen kanonik ilişkili token hesaplarına gönderir; çağıran başka bir yaratıcı veya hedef seçemez. Her iki ATA eksikse, ödeyici oluşturulmasını finanse eder. Orijinal CollectCreatorFee çağrılabilir kalır, bu nedenle kendi koleksiyonunu imzalamak isteyen bir yaratıcı yine de yapabilir. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`payer`	W	S	Herhangi bir imzalayan; eksik yaratıcı ATA’larını finanse eder.
2	`creator`			`pool_state.pool_creator` ile eşleşmelidir; imzalamaz.
3	`authority`			CPMM global kasa yetki PDA’sı.
4	`pool_state`	W		Birikmiş yaratıcı-ücret sayaçlarını tutar.
5	`token_0_vault`	W		Havuzun token 0 kasası ile eşleşmelidir.
6	`token_1_vault`	W		Havuzun token 1 kasası ile eşleşmelidir.
7	`vault_0_mint`			`token_0_vault.mint` ile eşleşmelidir.
8	`vault_1_mint`			`token_1_vault.mint` ile eşleşmelidir.
9	`creator_token_0`	W		`vault_0_mint` için yaratıcının kanonik ATA’sı; eksikse oluşturulur.
10	`creator_token_1`	W		`vault_1_mint` için yaratıcının kanonik ATA’sı; eksikse oluşturulur.
11	`token_0_program`			SPL Token veya Token-2022, token 0 ile eşleşir.
12	`token_1_program`			SPL Token veya Token-2022, token 1 ile eşleşir.
13	`associated_token_program`			Eksik alıcı ATA’sını oluşturur.
14	`system_program`			`payer` adresinden hesap oluşturmayı finanse eder.
15	`amm_config`			2026-09-19’te eklendi, `system_program` sonrasına eklendi. Kısıtlı `address = pool_state.amm_config`.
16	`creator_fee_share`			2026-09-19’te eklendi, en sona eklendi. `CollectCreatorFee` ile aynı PDA ve aynı isteğe bağlı-varlık kuralı.

İki yeni hesap araya eklenmez, system_program sonrasına eklenir. payer adresinden system_program adresine kadar her hesap yükseltmeden önce sahip olduğu konumu korur, bu nedenle kırılma temiz bir kırılmadır: yükseltme öncesi on dört hesaplı düzene karşı inşa edilen bir işlem kasaları yapılandırma hesapları olarak yanlış okumaz — yalnızca çok az hesap geçirir ve Anchor onu, herhangi bir kısıtlama çalışmadan önce AccountNotEnoughKeys (3005) ile reddeder. Hesaplar yine de zorunludur, bu nedenle her ikisini de sona ekleyin ve IDL’yi yenileyin; eski düzen için bir uyumluluk yolu yoktur.

Etki — yukarıdaki CollectCreatorFee ile aynı: pay creator_fee_share veya amm_config adresinden çözümlenir, protokolün kısmı protocol_fees_token_{0,1} adresine kaydedilir, yaratıcının kısmı yaratıcı ATA’larına aktarılır, her iki yaratıcı sayacı sıfırlanır ve recent_epoch güncellenir. Her iki sayaç da sıfır olduğunda NoFeeCollect döndürür.

`UpdatePoolStatus`

Bir havuzdaki bireysel işlemleri duraklatın veya devam ettirin. status alanı bir bit maskesidir:

Bit	Bayrak	Ayarlandığında etki
0	`DEPOSIT_DISABLED`	`Deposit` `NotApproved` ile reddeder.
1	`WITHDRAW_DISABLED`	`Withdraw` reddeder.
2	`SWAP_DISABLED`	`SwapBaseInput` / `SwapBaseOutput` reddeder.

Argümanlar

status: u8      // yeni bit maskesi

Hesaplar

#	Ad	W	S	Notlar
1	`authority`		S	CPMM programındaki admin anahtarı ile eşleşmelidir.
2	`pool_state`	W

Admin anahtarı programa derlenmiş bir genel anahtar (crate::admin::ID), BPF yükseltme yetkilisi değil — değiştirmek program yükseltmesi gerektirir. Değer için reference/program-addresses adresine ve kim tuttuğu için security/admin-and-multisig adresine bakın.

`CreateAmmConfig`

Yeni bir ücret katmanı oluşturun. Argümanlar

index:             u16
trade_fee_rate:    u64
protocol_fee_rate: u64
fund_fee_rate:     u64
create_pool_fee:   u64
creator_fee_rate:  u64

Hesaplar

#	Ad	W	S	Notlar
1	`owner`	W	S	Admin.
2	`amm_config`	W		Burada `init` edilir.
3	`system_program`

Ön koşullar

Aynı index ile mevcut AmmConfig yok.
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

2026-09’da değişti: yeni yapılandırmanın ücret sahipleri artık imzalayıcıdan gelmez. create_amm_config artık programın sabit kodlanmış protocol_fee_owner::ID adresini protocol_owner adresine ve fund_fee_owner::ID adresini fund_owner adresine yazar, bunun yerine admin imzalayıcının anahtarını her ikisine de kopyalar. Adresler reference/program-addresses adresindedir.Sonuçlar: yeni oluşturulan AmmConfig üzerindeki ücretler, admin’in yerine adanmış ücret cüzdanlarında yer alır. Admin, koleksiyon için kabul edilen bir imzalayan olarak kalır — CollectProtocolFee / CollectFundFee amm_config.protocol_owner / fund_owner veya crate::admin::ID adresini kabul eder — bu nedenle hiçbir şey temizlemek için döndürülmesi gerekmez; değişen tek şey, varsayılan olarak gelirlerin nereye gittiğidir. Mevcut AmmConfig hesapları yeniden yazılmaz — bunlarda depolanan her şey yine de yönetir, bu nedenle her zaman hesaptan protocol_owner / fund_owner adresini okuyun, her iki değeri de varsaymayın. UpdateAmmConfig parametreleri 3 ve 4 yine de onları döndürür.

`UpdateAmmConfig`

Mevcut bir AmmConfig üzerindeki ücret oranlarını veya sahipliği değiştirin. Bir param: u8 (hangi alanı güncelleyin) ve bir value: u64 alır. Tam gönderme tablosu:

param = 0 → trade_fee_rate (iddia eder trade_fee_rate + creator_fee_rate < 1_000_000)
param = 1 → protocol_fee_rate (iddia eder ≤ 1_000_000 ve + fund_fee_rate ≤ 1_000_000)
param = 2 → fund_fee_rate (iddia eder ≤ 1_000_000 ve + protocol_fee_rate ≤ 1_000_000)
param = 3 → protocol_owner. Yeni anahtar value adresinde değil: remaining_accounts[0] adresine ekleyin (salt okunur iyidir). Varsayılan genel anahtar olmamalıdır ve hesabı atlayan bir unwrap() adresinde panik yapar.
param = 4 → fund_owner. 3 ile aynı mekanizma.
param = 5 → create_pool_fee
param = 6 → disable_create_pool (sıfır olmayan herhangi bir value devre dışı bırakır)
param = 7 → creator_fee_rate (iddia eder creator_fee_rate + trade_fee_rate < 1_000_000)
param = 8 → creator_fee_share_rate (iddia eder ≤ 1_000_000). 2026-09-19’te eklendi. Protokolün bu katmandaki yaratıcı ücretinin varsayılan payı; bkz. products/cpmm/fees. Ticaret ücretini bölen protocol_fee_rate ile ilgili değildir.

Başka herhangi bir param InvalidInput döndürür. Değişiklikler admin tarafından imzalanır ve bu AmmConfig adresine bağlı her havuzu sonraki takasta etkiler. Geçiş yok; havuzlar yeni değerleri okur.

`CreateCreatorFeeShare`

Bir (creator, amm_config) çifti için yaratıcı ücretinin özel bir protokol payını ayarlayın, bu ücret katmanında o yaratıcının sahip olduğu her havuz için AmmConfig.creator_fee_share_rate adresini geçersiz kılın. 2026-09-19 yaratıcı-ücret-payı yükseltmesinde eklendi. Argümanlar

share_rate: u64   // yaratıcı ücretinin protokol payı, FEE_RATE_DENOMINATOR = 1_000_000 üzerinde

Hesaplar

#	Ad	W	S	Notlar
1	`owner`	W	S	CPMM program admin veya adanmış yaratıcı-ücret-payı sahibi olmalıdır — bkz. `reference/program-addresses`. Başka herhangi bir imzalayan `InvalidOwner` (`6001`) ile başarısız olur. Kirayı öder.
2	`creator`			Oranın geçerli olduğu havuz yaratıcısı. Kontrol edilmez — mevcut bir havuz yaratıcısı olması gerekmez ve imzalamaz.
3	`amm_config`			Oranın geçerli olduğu ücret katmanı.
4	`creator_fee_share`	W		`["creator_fee_share", creator, amm_config]` adresinde burada `init` edilir, `space = 145`.
5	`system_program`

Ön koşullar

share_rate <= 1_000_000, aksi takdirde InvalidInput (6003).
PDA zaten var olmamalıdır — Anchor’ın init aynı çift için ikinci çağrıda başarısız olur. Bir oranı değiştirmek için hesabı kapatın ve yeniden oluşturun.

Son koşullar

creator_fee_share bump, creator, amm_config ve share_rate adresini depolar.
amm_config altında creator tarafından oluşturulan bir havuzda sonraki her CollectCreatorFee / CollectCreatorFeePermissionless, yapılandırma yerine bu hesaptan payı çözümler.

Havuz yaratıcısı bu talimata taraf değildir ve imzalamaz. Oran koleksiyon zamanında okunur, bu nedenle ücretler zaten tahakkuk ettikten sonra oluşturulan bir geçersiz kılma da o birikmiş bakiyeye uygulanır.

`CloseCreatorFeeShare`

Geçersiz kılmayı kaldırın. Çift AmmConfig.creator_fee_share_rate adresine geri döner. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`owner`	W	S	`CreateCreatorFeeShare` ile aynı iki kabul edilen imzalayan; kirayı alır.
2	`creator`			Oranın geçerli olduğu havuz yaratıcısı.
3	`amm_config`			Oranın geçerli olduğu ücret katmanı.
4	`creator_fee_share`	W		`owner` adresine kapatılır. Çift için kanonik PDA olmalıdır.
5	`system_program`

Son koşullar

Hesap kapatılır ve lamportları owner adresine gider.
Bu çift için koleksiyonlar AmmConfig.creator_fee_share_rate adresinden payı çözümler — UpdateAmmConfig param 8 ayarlanmadığı sürece 0 olan.

`CollectExcessLamports`

CPMM’nin kontrol ettiği hesaplarda kira-muaf minimumun üzerinde oturan lamportların admin taraması. 2026-09 yükseltmesinde eklendi, böylece protokol SIMD-0437 kira azaltmasının her adımdan sonra hesaplarda bıraktığı aşırı finansmanı geri alabilir. Yalnızca fazlalık hareket eder. Token bakiyeleri, hesap verileri, sahipleri, havuz durumu ve eğri dokunulmaz ve talimat zaten minimumda olan bir hesaba karşı bir no-op’tir — bu nedenle her dağıtım adımından sonra yeniden çalıştırmak güvenlidir. Argümanlar — hiçbiri. Hesaplar

#	Ad	W	S	Notlar
1	`collect_lamports_wallet`	W	S	Her temizlenen lamport için hedef. CPMM program admin veya adanmış lamport toplama cüzdanı olmalıdır — bkz. `reference/program-addresses`. Başka herhangi bir imzalayan `InvalidOwner` ile başarısız olur.
2	`authority`			Tohum `[b"vault_and_lp_mint_auth_seed"]` adresindeki CPMM kasa-ve-LP-mint yetki PDA’sı. Token-program CPI’larını imzalar.
3	`token_program`			SPL Token.
4	`token_program_2022`			Token-2022. Her ikisi de koşulsuz olarak gereklidir; program kaynak hesaba göre seçer.
5..	`remaining_accounts`	W		Temizlenecek `M` kaynak hesabı, herhangi bir sayı, herhangi bir sıra.

Sıralama düzeltmesi, 2026-09-19. Program artık remaining_accounts üzerinde iki geçiş yapar — her token-program CPI’sı ilk, sonra CPMM tarafından sahiplenilen PDA’ların doğrudan borçları. Bunları iç içe geçirmek, bir PDA bir CPI’dan önce borçlandırıldığında çalışma zamanının UnbalancedInstruction (“hesap bakiyeleri toplamı talimat öncesi ve sonrası eşleşmez”) ile iptal edildi, çünkü çağıranın bekleyen lamport değişiklikleri yalnızca bir CPI gerçekten taşıdığında hesaplara boşaltılır. Çağıranlar listeyi kendileri gruplandırmak veya sıralamak zorunda değildir.

Her kaynak hesabı nasıl işlenir Program kaynak hesabın owner adresine göre gönderir:

Kaynak hesap sahibi	İşleme
SPL Token veya Token-2022, yerel olmayan token hesabı veya mint — havuz kasaları ve LP mint’leri	CPI `WithdrawExcessLamports` (token-program ayırıcı `38`), `authority` tarafından imzalanır.
SPL Token veya Token-2022, yerel (wSOL) token hesabı	`WithdrawExcessLamports` yerel hesapları reddeder. Program `SyncNative` CPI’sı yapar, sarılı `amount` ne kadar büyüdüğünü ölçer, tam o delta için `UnwrapLamports` (ayırıcı `45`) yapar, sonra sarılı bakiyenin ön-senkronizasyon değerine eşit olmasını gerektirir — aksi takdirde `LamportsCalculateError` (`6015`). Bir SOL tarafı havuz kasası bu nedenle tam likiditeyi tutar.
CPMM programının kendisi — `PoolState`, `AmmConfig`, `ObservationState`, `Permission`, `SupportMintAssociated`	Program hesabı doğrudan `rent.minimum_balance(data_len)` adresine borçlandırır.
Başka bir şey	Sessizce atlanır. Hata yok, lamport hareket yok.

Sınırsız bir remaining_accounts listesi aldığı için, işlem boyutu gerçek sınırdır — solana-fundamentals/rent-and-reclaimable-rent adresinde açıklanan cüzdan tarafı tarama ile aynı kısıtlama. Yaygın hatalar — InvalidOwner (6001, yanlış imzalayan), LamportsCalculateError (6015, wSOL gidiş-dönüş sıfıra net olmadı) ve program tarafından sahiplenilen yoldan bir hesap kendi kira minimumundan daha az tuttuğunda InsufficientFunds. SDK oluşturucu yok. @raydium-io/raydium-sdk-v2 bu talimat için bir oluşturucu göndermez ve raydium-sdk-V2-demo deposu da göndermez — bu bir admin yoludur. El ile kodlayın, solana-fundamentals/rent-and-reclaimable-rent adresindeki cüzdan tarafı tarama talimatı gibi.

Durum değişikliği matrisi

Talimat	`lp_supply`	Kasa bakiyeleri	Birikmiş-ücret alanları	`observation`
`Initialize`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeWithPermission`	+ init LP	+ `init_amount_{0,1}`	0	init
`Deposit`	+	+ her ikisi	—	—
`Withdraw`	−	− her ikisi	—	—
`SwapBaseInput`	—	+ giriş, − çıkış	+ `trade_fee` protokol/fon’a bölünür; etkinse + `creator_fee`	+ (aralık geçtiyse)
`SwapBaseOutput`	—	+ giriş, − çıkış	+ `trade_fee` protokol/fon’a bölünür; etkinse + `creator_fee`	+ (aralık geçtiyse)
`CollectProtocolFee`	—	− (protokol paketleri tarafından)	`protocol_*` → 0	—
`CollectFundFee`	—	− (fon paketleri tarafından)	`fund_*` → 0	—
`CollectCreatorFee`	—	− (yalnızca yaratıcının kısmı)	`creator_` → 0; `protocol_` += paylaşılan kısım	—
`CollectCreatorFeePermissionless`	—	− (yalnızca yaratıcının kısmı)	`creator_` → 0; `protocol_` += paylaşılan kısım	—
`UpdatePoolStatus`	—	—	—	—
`CreateCreatorFeeShare`	—	—	—	—
`CloseCreatorFeeShare`	—	—	—	—
`CollectExcessLamports`	—	— (token bakiyeleri değişmez)	—	—

Sonraki adım

products/cpmm/code-demos — yukarıdakiler için çalıştırılabilir TypeScript örnekleri.
reference/error-codes — tam Anchor hata tablosu.
products/cpmm/fees — Collect*Fee talimatlarının boşalttığı ücret-tahakkuk modeli.

Kaynaklar:

Products

Algorithms

Talimat özeti

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Durum değişikliği matrisi

Sonraki adım

​Talimat özeti

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​CreateCreatorFeeShare

​CloseCreatorFeeShare

​CollectExcessLamports

​Durum değişikliği matrisi

​Sonraki adım

Talimat özeti

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Durum değişikliği matrisi

Sonraki adım