Instruksi CPMM

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

Ringkasan instruksi

Nama Discriminator	Siapa yang menandatangani	Apa yang dilakukan
`Initialize`	pembuat pool	Buat pool CPMM baru dari dua mint dan `AmmConfig`. Tanpa izin; siapa pun dapat memanggilnya. Hardcodes `enable_creator_fee = false` pada pool baru. Akun `pool_state` dapat berupa PDA kanonik atau keypair acak segar (lihat akun Initialize).
`InitializeWithPermission`	payer + pemegang PDA `Permission`	Varian dengan izin dari `Initialize`. Pemanggil (`payer`) harus memiliki PDA `Permission` yang diturunkan dari pubkey mereka sendiri. Digunakan oleh platform yang memerlukan pembuatan pool terbatas (misalnya kelulusan LaunchLab). Memungkinkan pemanggil untuk menetapkan `creator_fee_on` (`BothToken` / `OnlyToken0` / `OnlyToken1`) dan memaksa `enable_creator_fee = true` pada pool baru. Bidang `creator` pada `pool_state` diatur ke akun `creator` yang diteruskan secara terpisah, bukan payer. Fleksibilitas PDA-kanonik-atau-keypair-acak yang sama untuk `pool_state` seperti `Initialize`.
`Deposit`	LP	Tambahkan likuiditas dalam kedua token; terima token LP.
`Withdraw`	LP	Bakar token LP; terima kedua token dasar secara pro-rata.
`SwapBaseInput`	swapper	Swap input-pasti (`amount_in` masuk, ≥ `minimum_amount_out` keluar).
`SwapBaseOutput`	swapper	Swap output-pasti (≤ `maximum_amount_in` masuk, `amount_out` keluar).
`CollectProtocolFee`	`protocol_owner` (dari `AmmConfig`)	Kumpulkan biaya protokol yang terkumpul dari vault.
`CollectFundFee`	`fund_owner` (dari `AmmConfig`)	Kumpulkan biaya dana yang terkumpul dari vault.
`CollectCreatorFee`	`pool_creator`	Kumpulkan biaya pembuat yang terkumpul (jika biaya pembuat diaktifkan).
`CollectCreatorFeePermissionless`	payer apa pun	Kumpulkan semua biaya pembuat yang terkumpul ke akun token kanonik `pool_creator`. Payer dapat membuat ATA penerima yang hilang tetapi tidak dapat mengalihkan transfer.
`UpdatePoolStatus`	`admin`	Jeda / lanjutkan operasi tertentu pada pool melalui bitmask.
`UpdateAmmConfig`	`admin`	Ubah tarif biaya atau pemilik protokol/dana pada `AmmConfig`.
`CreateAmmConfig`	`admin`	Buat tingkat biaya baru (akun `AmmConfig` baru).
`CreatePermissionPda`	`admin` atau pembuat PDA izin yang didelegasikan	Mint PDA `Permission` yang memungkinkan otoritas tertentu memanggil `InitializeWithPermission`.
`ClosePermissionPda`	`admin`	Cabut PDA `Permission` yang sebelumnya dikeluarkan.

Bitmask status: status setiap pool adalah u8 di mana bit 0 = deposit dinonaktifkan, bit 1 = withdraw dinonaktifkan, bit 2 = swap dinonaktifkan (PoolStatusBitIndex { Deposit, Withdraw, Swap } dalam program). Bit yang jelas berarti operasi diizinkan; bit yang diatur berarti dijeda. UpdatePoolStatus mengambil u8 mentah dan menimpa nilai yang ada. Bagian berikutnya membahas masing-masing secara detail. Urutan akun mengikuti IDL CPMM; SDK dan klien Rust di raydium-cp-swap/programs/cp-swap/src/instructions cocok dengan urutan ini.

`Initialize`

Buat pool CPMM baru. Argumen

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; swap ditolak sebelum ini

Akun (W = dapat ditulis, S = penandatangan)

#	Nama	W	S	Catatan
1	`creator`	W	S	Membayar sewa; dicatat sebagai `pool_state.pool_creator`.
2	`amm_config`			Tingkat biaya yang dipilih.
3	`authority`			PDA otoritas global CPMM.
4	`pool_state`	W	S*	`init`ed di sini. Baik PDA kanonik `["pool", amm_config, token_0_mint, token_1_mint]` atau keypair acak segar — ketika bukan PDA kanonik, program memerlukan `pool_state` untuk menandatangani (`require_eq!(pool_account_info.is_signer, true)`). Jalur keypair acak memungkinkan pembuat menghindari upaya front-running pada PDA kanonik. PDA hilir (`lp_mint`, `vaults`, `observation_state`) diturunkan dari `pool_state.key()` baik cara.
5	`token_0_mint`			Diurutkan: `token_0_mint < token_1_mint`.
6	`token_1_mint`
7	`lp_mint`	W		`init`ed di sini. Otoritas diatur ke `authority`.
8	`creator_token_0`	W		ATA sumber untuk `init_amount_0`.
9	`creator_token_1`	W		ATA sumber untuk `init_amount_1`.
10	`creator_lp_token`	W		Tujuan untuk LP (dibuat jika hilang).
11	`token_0_vault`	W		`init`ed di sini. Dimiliki oleh `authority`.
12	`token_1_vault`	W
13	`create_pool_fee`	W		ATA tujuan untuk `create_pool_fee` yang dibayar oleh pembuat.
14	`observation_state`	W		`init`ed di sini.
15	`token_program`			SPL Token (untuk LP mint).
16	`token_0_program`			SPL Token atau Token-2022.
17	`token_1_program`			SPL Token atau Token-2022.
18	`associated_token_program`
19	`system_program`
20	`rent`

* pool_state menandatangani hanya pada jalur keypair acak; jalur PDA kanonik berjalan tanpa pool_state menandatangani. Kondisi Pra

Mint diurutkan (token_0_mint < token_1_mint berdasarkan urutan byte).
Tidak ada mint yang menggunakan ekstensi di luar daftar izin CPMM (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — lihat products/cpmm/accounts. Daftar izin per-mint kecil di dalam program melewati pemeriksaan untuk onboarding kasus per kasus.
creator memiliki setidaknya init_amount_0 dan init_amount_1 di ATA masing-masing.
amm_config.disable_create_pool == false.

Kondisi Pasca

pool_state ada dengan lp_supply = sqrt(init_amount_0 * init_amount_1) − LOCKED_LP.
Pemula LP LOCKED_LP (100 lamport token LP) secara permanen terkunci di pool — pool_state.lp_supply mencatat liquidity − 100 sementara 100 unit LP tetap di luar sirkulasi, mencegah pool sepenuhnya dikuras dan membagi dengan nol.
observation_state diinisialisasi; observation_index = 0 dan pool_id = pool_state.key().
create_pool_fee lamport ditransfer dari pembuat ke penerima dan disinkronkan sebagai SOL asli (ini adalah ATA wSOL).
Bitmask status pool adalah 0 (deposit / withdraw / swap semuanya diaktifkan).
enable_creator_fee = false dan creator_fee_on = BothToken. Initialize tidak mendukung pengaktifan biaya pembuat — jalur itu adalah InitializeWithPermission.
open_time ditingkatkan ke block_timestamp + 1 jika pemanggil melewatkan nilai <= block_timestamp. Swap ditolak sebelum open_time; deposit dan penarikan bekerja segera.

Kesalahan Umum (daftar lengkap di reference/error-codes)

InvalidInput — mint tidak diurutkan, atau mint identik.
NotSupportMint — ekstensi Token-2022 yang diblokir.
ExceededSlippage — jarang; jika init_amount_0/1 menghasilkan LP nol karena ketidakcocokan desimal.

`Deposit`

Tambahkan likuiditas dalam kedua token sebanding dengan pool. Argumen

lp_token_amount:   u64   // berapa banyak token LP untuk mint ke LP
maximum_token_0:   u64
maximum_token_1:   u64

Akun

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

Matematika

needed_token_0 = ceil(lp_token_amount * vault_0 / lp_supply)
needed_token_1 = ceil(lp_token_amount * vault_1 / lp_supply)
require(needed_token_0 <= maximum_token_0, "ExceededSlippage")
require(needed_token_1 <= maximum_token_1, "ExceededSlippage")

Tidak ada perubahan pada proporsionalitas k — kedua vault dan lp_supply diskalakan dengan faktor yang sama. Kondisi Pasca

lp_supply += lp_token_amount.
vault_0 += needed_token_0 (bersih dari biaya transfer Token-2022 apa pun pada input).
vault_1 += needed_token_1 (bersih dari biaya transfer Token-2022 apa pun pada input).

Kesalahan Umum — ExceededSlippage, ZeroTradingTokens, InvalidStatus jika deposit dijeda.

`Withdraw`

Bakar token LP dan terima kedua token dasar secara pro-rata. Argumen

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

Akun

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

(Identik dengan Deposit; lp_mint dapat ditulis karena token LP dibakar.) Matematika

out_token_0 = floor(lp_token_amount * vault_0 / lp_supply)
out_token_1 = floor(lp_token_amount * vault_1 / lp_supply)
require(out_token_0 >= minimum_token_0, "ExceededSlippage")
require(out_token_1 >= minimum_token_1, "ExceededSlippage")

Kondisi Pasca

lp_supply -= lp_token_amount.
Vault mengirim out_token_0 / out_token_1 (kotor; pengguna menerima bersih dari biaya transfer Token-2022 apa pun).

`SwapBaseInput`

Swap input-pasti. Argumen

amount_in:            u64
minimum_amount_out:   u64

Akun

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

Urutan input → output adalah berdasarkan arah pengguna, bukan token_0 / token_1 kanonik pool. Program mengetahui vault mana yang mana dengan mencocokkan mint. Matematika — lihat products/cpmm/math. Kondisi Pra

open_time <= now.
pool_status memungkinkan swap.
Tidak ada mint yang dijeda atau dibekukan untuk otoritas ini.
amount_in > 0.

Kesalahan Umum

ExceededSlippage — amount_out < minimum_amount_out.
ZeroTradingTokens — perdagangan dibulatkan menjadi nol.
NotApproved — pool dijeda untuk swap melalui UpdatePoolStatus.
InvalidInput — mint tidak cocok dengan salah satu mint vault pool.

`SwapBaseOutput`

Swap output-pasti. Argumen

max_amount_in:  u64
amount_out:     u64

Akun — sama dengan SwapBaseInput. Matematika — kurva terbalik dengan ceiling, lihat products/cpmm/math. Kesalahan Umum — ExceededSlippage (gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

`CollectProtocolFee`

Kumpulkan biaya protokol yang terkumpul dari vault ke tujuan protokol. Argumen — tidak ada. Akun

#	Nama	W	S
1	`owner`		S	Harus cocok dengan `amm_config.protocol_owner`.
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`

Efek

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

Tidak ada perubahan pada saldo efektif kurva (biaya yang terkumpul sudah dikecualikan). Kesalahan Umum — NotApproved jika penandatangan bukan protocol_owner.

`CollectFundFee`

Bentuk yang sama dengan CollectProtocolFee tetapi ditandatangani oleh fund_owner dan menolkan penghitung fund_fees_*.

`CollectCreatorFee`

Ditandatangani oleh pool_state.pool_creator. Ini mentransfer saldo creator_fees_token_0 dan creator_fees_token_1 penuh ke akun token pembuat, kemudian menolkan kedua penghitung. Ini mengembalikan NoFeeCollect ketika kedua penghitung adalah nol.

`CollectCreatorFeePermissionless`

Siapa pun dapat memicu pengumpulan biaya pembuat. Instruksi selalu mengirim saldo yang terkumpul penuh ke akun token terkait kanonik yang dimiliki oleh pool_state.pool_creator; pemanggil tidak dapat memilih pembuat atau tujuan lain. Jika salah satu ATA hilang, payer mendanai pembuatannya. CollectCreatorFee asli tetap dapat dipanggil, jadi klien yang ada tetap kompatibel. Argumen — tidak ada. Akun

#	Nama	W	S	Catatan
1	`payer`	W	S	Penandatangan apa pun; mendanai ATA pembuat yang hilang.
2	`creator`			Harus sama dengan `pool_state.pool_creator`; tidak menandatangani.
3	`authority`			PDA otoritas vault global CPMM.
4	`pool_state`	W		Menyimpan penghitung biaya pembuat yang terkumpul.
5	`token_0_vault`	W		Harus cocok dengan vault token 0 pool.
6	`token_1_vault`	W		Harus cocok dengan vault token 1 pool.
7	`vault_0_mint`			Harus cocok dengan `token_0_vault.mint`.
8	`vault_1_mint`			Harus cocok dengan `token_1_vault.mint`.
9	`creator_token_0`	W		ATA kanonik pembuat untuk `vault_0_mint`; dibuat jika hilang.
10	`creator_token_1`	W		ATA kanonik pembuat untuk `vault_1_mint`; dibuat jika hilang.
11	`token_0_program`			SPL Token atau Token-2022, cocok dengan token 0.
12	`token_1_program`			SPL Token atau Token-2022, cocok dengan token 1.
13	`associated_token_program`			Membuat ATA penerima yang hilang.
14	`system_program`			Mendanai pembuatan akun dari `payer`.

Efek

Mentransfer semua creator_fees_token_0 dan creator_fees_token_1 dari vault pool ke ATA pembuat.
Menolkan kedua penghitung biaya pembuat dan memperbarui pool_state.recent_epoch.
Mengembalikan NoFeeCollect ketika kedua penghitung adalah nol.

`UpdatePoolStatus`

Jeda atau lanjutkan operasi individual pada pool. Bidang status adalah bitmask:

Bit	Flag	Efek ketika diatur
0	`DEPOSIT_DISABLED`	`Deposit` menolak dengan `NotApproved`.
1	`WITHDRAW_DISABLED`	`Withdraw` menolak.
2	`SWAP_DISABLED`	`SwapBaseInput` / `SwapBaseOutput` menolak.

Argumen

status: u8      // bitmask baru

Akun

#	Nama	W	S
1	`authority`		S	Harus cocok dengan kunci admin pada program CPMM.
2	`pool_state`	W

Kunci admin adalah otoritas upgrade pada program CPMM — dalam praktik, multisig Raydium. Lihat security/admin-and-multisig.

`CreateAmmConfig`

Buat tingkat biaya baru. Argumen

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

Akun

#	Nama	W	S
1	`owner`	W	S	Admin.
2	`amm_config`	W		`init`ed di sini.
3	`system_program`

Kondisi Pra

Tidak ada AmmConfig yang ada dengan index yang sama.
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

`UpdateAmmConfig`

Ubah tarif biaya atau kepemilikan pada AmmConfig yang ada. Mengambil param: u8 (discriminator untuk bidang mana yang akan diperbarui) dan value: u64. Semantik nilai per param ada di sumber; umumnya:

param = 0 → trade_fee_rate
param = 1 → protocol_fee_rate
param = 2 → fund_fee_rate
param = 3 → new_protocol_owner (lewatkan byte Pubkey sebagai reinterpret)
param = 4 → new_fund_owner
param = 5 → create_pool_fee
param = 6 → disable_create_pool

Perubahan ditandatangani oleh admin dan mempengaruhi setiap pool yang terikat pada AmmConfig ini pada swap berikutnya. Tidak ada migrasi; pool hanya membaca nilai baru.

Matriks perubahan status

Instruksi	`lp_supply`	Saldo Vault	Bidang biaya yang terkumpul	`observation`
`Initialize`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeWithPermission`	+ init LP	+ `init_amount_{0,1}`	0	init
`Deposit`	+	+ kedua	—	—
`Withdraw`	−	− kedua	—	—
`SwapBaseInput`	—	+ in, − out	+ `trade_fee` dibagi menjadi protokol/dana; + `creator_fee` jika diaktifkan	+ (jika interval berlalu)
`SwapBaseOutput`	—	+ in, − out	+ `trade_fee` dibagi menjadi protokol/dana; + `creator_fee` jika diaktifkan	+ (jika interval berlalu)
`CollectProtocolFee`	—	− (oleh bucket protokol)	`protocol_*` → 0	—
`CollectFundFee`	—	− (oleh bucket dana)	`fund_*` → 0	—
`CollectCreatorFee`	—	− (oleh bucket pembuat)	`creator_*` → 0	—
`CollectCreatorFeePermissionless`	—	− (oleh bucket pembuat)	`creator_*` → 0	—
`UpdatePoolStatus`	—	—	—	—

Ke mana selanjutnya

products/cpmm/code-demos — sampel TypeScript yang dapat dijalankan untuk di atas.
reference/error-codes — tabel kesalahan Anchor lengkap.
products/cpmm/fees — model akrual biaya yang dikuras oleh instruksi Collect*Fee.

Sumber:

Products

Algorithms

Ringkasan instruksi

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

Matriks perubahan status

Ke mana selanjutnya

​Ringkasan instruksi

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​Matriks perubahan status

​Ke mana selanjutnya

Ringkasan instruksi

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

Matriks perubahan status

Ke mana selanjutnya