Hướng dẫn CPMM

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.Xem bản tiếng Anh →

Trang này là tài liệu tham khảo hướng dẫn chính thức. Để xem mã thực tế soạn các hướng dẫn này, hãy xem products/cpmm/code-demos. Để biết ý nghĩa mã lỗi, xem reference/error-codes.Nâng cấp chương trình 2026-09 đã xây dựng lại CPMM trên Anchor 1.0.2 / Solana 3.1.10, thêm hướng dẫn quản trị viên CollectExcessLamports, loại bỏ danh sách mint Token-2022 được mã hóa cứng, và thay đổi những gì CreateAmmConfig ghi vào protocol_owner / fund_owner. Không có hướng dẫn nào hướng tới người dùng thay đổi tài khoản, đối số hoặc toán học của nó. Xem mục nhật ký thay đổi 2026-09-09.Nâng cấp 2026-10-30 thêm InitializeV2: tạo pool không cần phép, trong đó người tạo chọn có bật phí người tạo hay không và bật ở phía nào. Đây là thay đổi thuần bổ sung. Initialize, InitializeWithPermission và mọi hướng dẫn khác giữ nguyên discriminator, tài khoản và đối số. Xem mục nhật ký thay đổi 2026-10-30.

Cả hai hướng dẫn thu thập phí người tạo đã thay đổi danh sách tài khoản của chúng vào ngày 2026-09-19. CollectCreatorFee nhận creator_fee_share; CollectCreatorFeePermissionless nhận amm_config và creator_fee_share. Cả hai đều được thêm vào sau system_program, vì vậy mọi tài khoản mà máy khách hiện có đã chuyển giữ chỉ mục của nó — nhưng các tài khoản mới là bắt buộc, vì vậy giao dịch được xây dựng dựa trên bố cục cũ hơn sẽ không đủ và bị từ chối bằng AccountNotEnoughKeys (3005) của Anchor. Hai hướng dẫn quản trị viên — CreateCreatorFeeShare và CloseCreatorFeeShare — được thêm vào, và UpdateAmmConfig nhận param = 8 mới. Xem mục nhật ký thay đổi 2026-09-19.

Tóm tắt hướng dẫn

Tên Discriminator	Người ký	Chức năng
`Initialize`	người tạo pool	Tạo pool CPMM mới từ hai mint và một `AmmConfig`. Không cần phép; bất kỳ ai cũng có thể gọi nó. Mã hóa cứng `enable_creator_fee = false` trên pool mới. Tài khoản `pool_state` có thể là PDA chính tắc hoặc một keypair ngẫu nhiên mới (xem tài khoản Initialize).
`InitializeV2`	người tạo pool	Giống `Initialize`, cộng thêm đối số tùy chọn `creator_fee_on`. Không cần phép. `Some(...)` lưu `enable_creator_fee = true` với phía đã chọn; `None` lưu cùng cài đặt phí người tạo như `Initialize`. Cùng tài khoản như `Initialize` trừ sysvar `rent` ở cuối. Được thêm vào 2026-10-30.
`InitializeWithPermission`	người trả tiền + người nắm giữ PDA `Permission`	Biến thể có quyền của `Initialize`. Người gọi (`payer`) phải sở hữu PDA `Permission` được lấy từ pubkey của chính họ. Được sử dụng bởi các nền tảng cần tạo pool có cổng (ví dụ: tốt nghiệp LaunchLab). Cho phép người gọi ghim `creator_fee_on` (`BothToken` / `OnlyToken0` / `OnlyToken1`) và buộc `enable_creator_fee = true` trên pool mới. Trường `creator` trên `pool_state` được đặt thành tài khoản `creator` được chuyển riêng, không phải người trả tiền. Tính linh hoạt PDA-chính-tắc-hoặc-keypair-ngẫu nhiên tương tự cho `pool_state` như `Initialize`.
`Deposit`	LP	Thêm thanh khoản ở cả hai token; nhận token LP.
`Withdraw`	LP	Đốt token LP; nhận cả hai token cơ bản theo tỷ lệ.
`SwapBaseInput`	người hoán đổi	Hoán đổi đầu vào chính xác (`amount_in` vào, ≥ `minimum_amount_out` ra).
`SwapBaseOutput`	người hoán đổi	Hoán đổi đầu ra chính xác (≤ `maximum_amount_in` vào, `amount_out` ra).
`CollectProtocolFee`	`protocol_owner` (từ `AmmConfig`)	Quét phí giao thức tích lũy từ kho.
`CollectFundFee`	`fund_owner` (từ `AmmConfig`)	Quét phí quỹ tích lũy từ kho.
`CollectCreatorFee`	`pool_creator`	Quét phí người tạo tích lũy (nếu phí người tạo được bật), trừ đi phần chia của giao thức, được ghi vào bộ giao thức của pool.
`CollectCreatorFeePermissionless`	bất kỳ người trả tiền nào	Quét phí người tạo tích lũy đến các tài khoản token chính tắc của `pool_creator`, trừ đi phần chia giao thức tương tự. Người trả tiền có thể tạo ATA nhận thiếu nhưng không thể chuyển hướng chuyển khoản.
`UpdatePoolStatus`	`admin`	Tạm dừng / tiếp tục các hoạt động cụ thể trên pool thông qua bitmask.
`UpdateAmmConfig`	`admin`	Thay đổi tỷ lệ phí hoặc chủ sở hữu giao thức/quỹ trên `AmmConfig`.
`CreateAmmConfig`	`admin`	Tạo tầng phí mới (tài khoản `AmmConfig` mới).
`CreatePermissionPda`	`admin` hoặc người tạo PDA quyền được ủy quyền	Mint PDA `Permission` cho phép một cơ quan cụ thể gọi `InitializeWithPermission`.
`ClosePermissionPda`	`admin` hoặc người tạo PDA quyền chuyên dụng	Thu hồi PDA `Permission` được cấp trước đó. Kể từ nâng cấp 2026-09, cơ quan tạo chuyên dụng cũng có thể đóng một khoản cấp mà nó đã cấp; trước đó chỉ có quản trị viên.
`CreateSupportMintAssociated`	`admin` hoặc chủ sở hữu mint hỗ trợ chuyên dụng	Đăng ký mint Token-2022 sẽ không thành công danh sách cho phép tiện ích mở rộng, bằng cách tạo PDA `SupportMintAssociated` của nó.
`CloseSupportMintAssociated`	`admin` hoặc chủ sở hữu mint hỗ trợ chuyên dụng	Xóa đăng ký mint.
`CollectExcessLamports`	`admin` hoặc ví thu thập lamport chuyên dụng	Quét lamport vượt quá mức tối thiểu miễn phí thuê từ kho được kiểm soát bởi CPMM, mint LP và PDA. Được thêm vào 2026-09.
`CreateCreatorFeeShare`	`admin` hoặc chủ sở hữu chia sẻ phí người tạo chuyên dụng	Đặt chia sẻ giao thức tùy chỉnh của phí người tạo cho một cặp `(creator, amm_config)`, ghi đè `AmmConfig.creator_fee_share_rate`. Được thêm vào 2026-09-19.
`CloseCreatorFeeShare`	`admin` hoặc chủ sở hữu chia sẻ phí người tạo chuyên dụng	Xóa ghi đè đó; cặp quay lại mặc định cấu hình. Được thêm vào 2026-09-19.

Bitmask trạng thái: status của mỗi pool là u8 trong đó bit 0 = deposit bị vô hiệu hóa, bit 1 = withdraw bị vô hiệu hóa, bit 2 = swap bị vô hiệu hóa (PoolStatusBitIndex { Deposit, Withdraw, Swap } trong chương trình). Bit rõ ràng có nghĩa là hoạt động được phép; bit được đặt có nghĩa là nó bị tạm dừng. UpdatePoolStatus nhận u8 thô và ghi đè giá trị hiện có. Các phần tiếp theo đi qua từng phần chi tiết. Thứ tự tài khoản tuân theo IDL CPMM; SDK và máy khách Rust trong raydium-cp-swap/programs/cp-swap/src/instructions khớp với thứ tự này.

`Initialize`

Tạo pool CPMM mới. Đối số

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; swaps rejected before this

Tài khoản (W = có thể ghi, S = người ký)

#	Tên	W	S	Ghi chú
1	`creator`	W	S	Trả tiền thuê; được ghi lại là `pool_state.pool_creator`.
2	`amm_config`			Tầng phí được chọn.
3	`authority`			PDA cơ quan toàn cầu CPMM.
4	`pool_state`	W	S*	`init`ed ở đây. Hoặc PDA chính tắc `["pool", amm_config, token_0_mint, token_1_mint]` hoặc keypair ngẫu nhiên mới — khi không phải PDA chính tắc, chương trình yêu cầu `pool_state` ký (`require_eq!(pool_account_info.is_signer, true)`). Đường dẫn keypair ngẫu nhiên cho phép người tạo tránh các nỗ lực front-running trên PDA chính tắc. Các PDA hạ lưu (`lp_mint`, `vaults`, `observation_state`) được lấy từ `pool_state.key()` dù sao.
5	`token_0_mint`			Được sắp xếp: `token_0_mint < token_1_mint`.
6	`token_1_mint`
7	`lp_mint`	W		`init`ed ở đây. Cơ quan được đặt thành `authority`.
8	`creator_token_0`	W		ATA nguồn cho `init_amount_0`.
9	`creator_token_1`	W		ATA nguồn cho `init_amount_1`.
10	`creator_lp_token`	W		ATA của người tạo trên `lp_mint`. `init` (không phải `init_if_needed`) — nó không được tồn tại trước đó, điều mà nó không thể, vì `lp_mint` được tạo trong cùng một hướng dẫn này.
11	`token_0_vault`	W		`init`ed ở đây. Sở hữu bởi `authority`.
12	`token_1_vault`	W
13	`create_pool_fee`	W		ATA đích cho `create_pool_fee` được trả bởi người tạo.
14	`observation_state`	W		`init`ed ở đây.
15	`token_program`			SPL Token (cho LP mint).
16	`token_0_program`			SPL Token hoặc Token-2022.
17	`token_1_program`			SPL Token hoặc Token-2022.
18	`associated_token_program`
19	`system_program`
20	`rent`

* pool_state chỉ ký trên đường dẫn keypair ngẫu nhiên; đường dẫn PDA chính tắc chạy mà không cần pool_state ký. Điều kiện trước

Mint được sắp xếp (token_0_mint < token_1_mint theo thứ tự byte).
Không mint nào sử dụng tiện ích mở rộng ngoài danh sách cho phép CPMM (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — xem products/cpmm/accounts. Mint có PDA SupportMintAssociated (seed [b"support_mint", mint]) tồn tại sẽ bỏ qua kiểm tra tiện ích mở rộng — nhưng bạn phải thêm PDA đó vào remaining_accounts. Chương trình chỉ quét các tài khoản bạn chuyển và không bao giờ tải PDA tự nó, vì vậy dựa vào sổ đăng ký mà không cung cấp tài khoản vẫn thất bại với NotSupportMint (6007). Thứ tự không quan trọng (khớp theo khóa); chuyển một mục cho mỗi mint cần bỏ qua. Sổ đăng ký đó là bỏ qua duy nhất kể từ khi nâng cấp 2026-09 loại bỏ danh sách mint bốn được mã hóa cứng.
creator có ít nhất init_amount_0 và init_amount_1 trong các ATA tương ứng.
amm_config.disable_create_pool == false.

Điều kiện sau

pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — căn bậc hai đầy đủ. Người tạo được mint lp_supply − 100; 100 đơn vị cơ sở bị khóa được tính trong lp_supply nhưng không bao giờ được mint.
Vì vậy lp_mint.supply == pool_state.lp_supply − 100 trong suốt vòng đời của pool. Tất cả toán học chia sẻ LP (deposit, withdraw) chia cho lp_supply, vì vậy hãy sử dụng trường đó và không thay thế cung cấp trên chuỗi của mint. Hoàn nguyên với InitLpAmountTooLess nếu sqrt(...) < 100.
observation_state được khởi tạo; observation_index = 0 và pool_id = pool_state.key().
Lamport create_pool_fee được chuyển từ người tạo đến người nhận và được đồng bộ hóa dưới dạng SOL gốc (nó là ATA wSOL).
Bitmask trạng thái của pool là 0 (deposit / withdraw / swap đều được bật).
enable_creator_fee = false và creator_fee_on = BothToken. Initialize không hỗ trợ bật phí người tạo. Sử dụng InitializeV2 để bật nó mà không cần cấp quyền.
open_time được tăng lên block_timestamp + 1 nếu người gọi chuyển giá trị <= block_timestamp. Swap bị từ chối trước open_time; deposit và withdrawal hoạt động ngay lập tức.

Lỗi phổ biến (danh sách đầy đủ trong reference/error-codes)

InvalidInput — mint không được sắp xếp, hoặc mint giống hệt nhau.
NotSupportMint — tiện ích mở rộng Token-2022 bị chặn.
ExceededSlippage — hiếm khi; nếu init_amount_0/1 dẫn đến LP bằng không do không khớp số thập phân.

`InitializeV2`

Tạo pool CPMM mới và chọn cài đặt phí người tạo của nó. Được thêm vào trong nâng cấp 2026-10-30. InitializeV2 chạy cùng luồng tạo như Initialize. Khác biệt duy nhất là những gì nó ghi vào enable_creator_fee và creator_fee_on trên pool mới. Trước hướng dẫn này, chỉ InitializeWithPermission mới có thể tạo pool với phí người tạo được bật, và đường dẫn đó cần PDA Permission do quản trị viên cấp. Đối số

init_amount_0:  u64
init_amount_1:  u64
open_time:      u64                    // Unix timestamp; swaps rejected before this
creator_fee_on: Option<CreatorFeeOn>   // None = creator fee off
                                       // Some(BothToken | OnlyToken0 | OnlyToken1) = creator fee on

CreatorFeeOn là một enum Borsh, vì vậy đối số được mã hóa thành một byte tag cho Option, cộng thêm một byte biến thể khi nó là Some:

Giá trị	Byte	Được lưu trên `pool_state`
`None`	`00`	`enable_creator_fee = false`, `creator_fee_on = 0` (`BothToken`)
`Some(BothToken)`	`01 00`	`enable_creator_fee = true`, `creator_fee_on = 0`
`Some(OnlyToken0)`	`01 01`	`enable_creator_fee = true`, `creator_fee_on = 1`
`Some(OnlyToken1)`	`01 02`	`enable_creator_fee = true`, `creator_fee_on = 2`

Bất kỳ byte nào khác đều làm thất bại quá trình deserialize đối số của Anchor trước khi handler chạy. Discriminator: initialize_v2 → [67, 153, 175, 39, 218, 16, 38, 32]. Tài khoản (W = có thể ghi, S = người ký) 19 tài khoản đầu tiên giống hệt Initialize, theo cùng thứ tự. InitializeV2 chỉ bỏ sysvar rent ở cuối.

#	Tên	W	S	Ghi chú
1	`creator`	W	S	Trả tiền thuê, phí tạo pool và thanh khoản ban đầu. Được ghi lại là `pool_state.pool_creator`, vì vậy phí người tạo đi đến người ký này.
2	`amm_config`			Tầng phí được chọn. `creator_fee_rate` của nó là mức phí mà pool tính.
3	`authority`			PDA cơ quan toàn cầu CPMM.
4	`pool_state`	W	S*	PDA chính tắc hoặc keypair ngẫu nhiên mới, giống hệt như trên `Initialize`.
5	`token_0_mint`			Được sắp xếp: `token_0_mint < token_1_mint`.
6	`token_1_mint`
7	`lp_mint`	W		`init`ed ở đây.
8	`creator_token_0`	W		Tài khoản nguồn cho `init_amount_0`.
9	`creator_token_1`	W		Tài khoản nguồn cho `init_amount_1`.
10	`creator_lp_token`	W		ATA của người tạo trên `lp_mint`. `init`ed ở đây.
11	`token_0_vault`	W		`init`ed ở đây.
12	`token_1_vault`	W
13	`create_pool_fee`	W		Đích cho `create_pool_fee`.
14	`observation_state`	W		`init`ed ở đây.
15	`token_program`			SPL Token (cho LP mint).
16	`token_0_program`			SPL Token hoặc Token-2022.
17	`token_1_program`			SPL Token hoặc Token-2022.
18	`associated_token_program`
19	`system_program`

* pool_state chỉ ký trên đường dẫn keypair ngẫu nhiên. remaining_accounts hoạt động giống như trên Initialize: thêm PDA SupportMintAssociated cho bất kỳ mint Token-2022 nào cần bỏ qua sổ đăng ký.

Vì 19 tài khoản đầu tiên khớp nhau, bạn có thể điều chỉnh một trình xây dựng Initialize hiện có: thay đổi discriminator, thêm các byte creator_fee_on và bỏ rent. Nếu bạn giữ rent, Anchor chuyển nó qua như một mục remaining_accounts, và lần quét support-mint bỏ qua nó vì nó không phải là tài khoản do CPMM sở hữu. Dù vậy, hãy bỏ nó để tiết kiệm một vị trí tài khoản.

Điều kiện trước — giống như Initialize. Không có kiểm tra quyền và không có ràng buộc mới nào đối với creator_fee_on. Điều kiện sau — giống như Initialize, ngoại trừ:

enable_creator_fee và creator_fee_on được đặt từ đối số, như trong bảng trên.
pool_creator luôn là creator đang ký. Trên InitializeWithPermission, người tạo là một tài khoản riêng biệt, không ký; trên InitializeV2, nó không thể được đặt thành bất kỳ ai khác.

Bật phí người tạo không chọn mức phí của nó. Pool tính AmmConfig.creator_fee_rate của tầng phí mà nó liên kết. Trên một tầng có mức phí đó là 0, pool được bật sẽ không tích lũy gì. Hãy đọc cấu hình trước khi chọn tầng. Lựa chọn này cũng là vĩnh viễn: không có hướng dẫn nào thay đổi enable_creator_fee hoặc creator_fee_on sau khi tạo. Xem products/cpmm/fees.

Khi phí được bật, các swap tích lũy nó vào creator_fees_token_{0,1}. Người tạo thu thập nó thông qua CollectCreatorFee hoặc CollectCreatorFeePermissionless, và phần chia cho giao thức từ nâng cấp 2026-09-19 được áp dụng như bình thường. Lỗi phổ biến — giống như Initialize.

`Deposit`

Thêm thanh khoản với cả hai token theo tỷ lệ của pool. Arguments

lp_token_amount:   u64   // how many LP tokens to mint to the LP
maximum_token_0:   u64
maximum_token_1:   u64

Accounts

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

Math

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

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")             // same for side 1

Hai chi tiết cần lưu ý: cơ sở tính theo tỷ lệ là tổng vault không tính phí (vault_amount_without_fee, tức là số dư thô trừ đi các bộ đếm phí protocol, fund và creator), không phải số dư vault thô; và giới hạn slippage được kiểm tra so với những gì người trả tiền thực sự chuyển, sau khi phí chuyển Token-2022 được thêm vào, không phải so với chuyển động vault tổng. Không có thay đổi đối với tính tỷ lệ của k — cả tổng và lp_supply đều được chia tỷ lệ theo cùng một hệ số. Postconditions

lp_supply += lp_token_amount.
vault_0 += needed_token_0 (sau khi trừ bất kỳ phí chuyển Token-2022 nào trên đầu vào).
vault_1 += needed_token_1 (sau khi trừ bất kỳ phí chuyển Token-2022 nào trên đầu vào).

Common errors — ExceededSlippage, ZeroTradingTokens, InvalidStatus nếu deposit bị tạm dừng.

`Withdraw`

Đốt token LP và nhận cả hai token cơ bản theo tỷ lệ. Arguments

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

Accounts

#	Name	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`

13 account đầu tiên giống hệt với Deposit, và lp_mint có thể ghi được vì token LP được đốt. Withdraw còn yêu cầu thêm account thứ 14, memo_program (bị ràng buộc address = memo::ID) — Deposit không có. Một Withdraw với 13 account sẽ thất bại khi Anchor deserialize, vì vậy LP không thể thoát. Math

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // same for side 1

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")       // same for side 1

// As with Deposit: the base is the fee-excluded vault total, and the floor is
// checked against what the LP actually receives, after the transfer fee.

Postconditions

lp_supply -= lp_token_amount.
Vault gửi out_token_0 / out_token_1 (tổng; người dùng nhận được sau khi trừ bất kỳ phí chuyển Token-2022 nào).

`SwapBaseInput`

Swap với đầu vào chính xác. Arguments

amount_in:            u64
minimum_amount_out:   u64

Accounts

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

Thứ tự input → output được xác định bởi hướng của người dùng, không phải bởi token_0 / token_1 chính tắc của pool. Chương trình xác định vault nào là gì bằng cách so khớp mint. Math — xem products/cpmm/math. Preconditions

open_time <= now.
pool_status cho phép swap.
Không mint nào bị tạm dừng hoặc đóng băng cho authority này.
amount_in > 0.

Common errors

ExceededSlippage — amount_out < minimum_amount_out.
ZeroTradingTokens — giao dịch làm tròn thành không.
NotApproved — pool bị tạm dừng cho swap thông qua UpdatePoolStatus.
InvalidInput — mint không khớp với bất kỳ mint vault nào của pool.

`SwapBaseOutput`

Swap với đầu ra chính xác. Arguments

max_amount_in:  u64
amount_out:     u64

Accounts — giống như SwapBaseInput. Math — đường cong ngược với ceiling, xem products/cpmm/math. Common errors — ExceededSlippage (gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

`CollectProtocolFee`

Quét phí protocol tích lũy từ vault đến điểm đến của protocol. Arguments — không có. Accounts

#	Name	W	S	Notes
1	`owner`		S	Phải bằng `amm_config.protocol_owner` hoặc khóa admin được mã hóa cứng của chương trình.
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`

Effect

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

Không có thay đổi đối với số dư hiệu quả của đường cong (phí tích lũy đã được loại trừ). Common error — InvalidOwner (6001) nếu người ký không phải là amm_config.protocol_owner cũng không phải là admin chương trình. (Không có NotApproved trên đường dẫn này.)

`CollectFundFee`

Cùng hình dạng với CollectProtocolFee nhưng được ký bởi amm_config.fund_owner — hoặc, một lần nữa, admin chương trình — và đặt lại các bộ đếm fund_fees_*. Cùng InvalidOwner khi người ký sai.

`CollectCreatorFee`

Được ký bởi pool_state.pool_creator. Nó thanh toán phí creator tích lũy và chuyển phần của creator đến các account token của creator. Arguments — không có. Accounts

#	Name	W	S	Notes
1	`creator`	W	S	Bị ràng buộc `address = pool_state.pool_creator`.
2	`authority`			PDA vault authority toàn cầu CPMM.
3	`pool_state`	W		Giữ các bộ đếm phí creator tích lũy.
4	`amm_config`			Bị ràng buộc `address = pool_state.amm_config`. Mang `creator_fee_share_rate` mặc định.
5	`token_0_vault`	W		Phải khớp với vault token 0 của pool.
6	`token_1_vault`	W		Phải khớp với vault token 1 của pool.
7	`vault_0_mint`			Phải khớp với `token_0_vault.mint`.
8	`vault_1_mint`			Phải khớp với `token_1_vault.mint`.
9	`creator_token_0`	W		Điểm đến cho phần token 0 của creator.
10	`creator_token_1`	W		Điểm đến cho phần token 1 của creator.
11	`token_0_program`			SPL Token hoặc Token-2022, khớp với token 0.
12	`token_1_program`			SPL Token hoặc Token-2022, khớp với token 1.
13	`associated_token_program`
14	`system_program`
15	`creator_fee_share`			Thêm vào 2026-09-19, được thêm sau `system_program`. PDA tại `["creator_fee_share", creator, amm_config]`. Phải được truyền vào mỗi lần gọi, nhưng không bắt buộc phải tồn tại — khi nó trống hoặc không được sở hữu bởi CPMM, chương trình sẽ quay lại `amm_config.creator_fee_share_rate`. Ràng buộc seed vẫn áp dụng, vì vậy địa chỉ phải là PDA chính tắc.

Effect

share_rate = creator_fee_share.share_rate   (if the account exists)
           | amm_config.creator_fee_share_rate   (otherwise)

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     // stays in the vault
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

Phần của protocol không bao giờ rời khỏi vault ở đây — nó được gắn nhãn lại thành phí protocol và chờ CollectProtocolFee. Cả hai bộ đếm đã được loại trừ khỏi cách nhìn của đường cong đối với vault, vì vậy giá của pool không thay đổi. Đạo hàm đầy đủ trong products/cpmm/fees. Common errors — NoFeeCollect khi cả hai bộ đếm creator đều bằng không (được kiểm tra trước khi chia), InvalidInput (6003) nếu share_rate được giải quyết vượt quá 1_000_000, MathOverflow (6011) nếu ghi lại phần chia sẻ sẽ tràn protocol_fees_token_*, và lỗi ConstraintSeeds của Anchor nếu creator_fee_share không phải là PDA chính tắc.

`CollectCreatorFeePermissionless`

Bất kỳ ai cũng có thể kích hoạt việc thu phí creator. Instruction luôn gửi phần của creator đến các associated token account chính thức được sở hữu bởi pool_state.pool_creator; người gọi không thể chọn creator hoặc đích đến khác. Nếu một trong hai ATA bị thiếu, payer sẽ tài trợ cho việc tạo nó. CollectCreatorFee gốc vẫn có thể gọi được, vì vậy một creator muốn ký cho việc thu phí của riêng họ vẫn có thể làm được. Arguments — không có. Accounts

#	Name	W	S	Notes
1	`payer`	W	S	Bất kỳ signer nào; tài trợ cho việc tạo ATA creator bị thiếu.
2	`creator`			Phải bằng `pool_state.pool_creator`; không ký.
3	`authority`			CPMM global vault authority PDA.
4	`pool_state`	W		Giữ các bộ đếm phí creator tích lũy.
5	`token_0_vault`	W		Phải khớp với token 0 vault của pool.
6	`token_1_vault`	W		Phải khớp với token 1 vault của pool.
7	`vault_0_mint`			Phải khớp với `token_0_vault.mint`.
8	`vault_1_mint`			Phải khớp với `token_1_vault.mint`.
9	`creator_token_0`	W		ATA chính thức của creator cho `vault_0_mint`; được tạo nếu bị thiếu.
10	`creator_token_1`	W		ATA chính thức của creator cho `vault_1_mint`; được tạo nếu bị thiếu.
11	`token_0_program`			SPL Token hoặc Token-2022, khớp với token 0.
12	`token_1_program`			SPL Token hoặc Token-2022, khớp với token 1.
13	`associated_token_program`			Tạo ATA người nhận bị thiếu.
14	`system_program`			Tài trợ cho việc tạo account từ `payer`.
15	`amm_config`			Thêm vào 2026-09-19, được thêm sau `system_program`. Constrained `address = pool_state.amm_config`.
16	`creator_fee_share`			Thêm vào 2026-09-19, được thêm cuối cùng. Cùng PDA và cùng quy tắc tồn tại tùy chọn như trên `CollectCreatorFee`.

Hai account mới được thêm sau system_program, không được chèn vào. Mỗi account từ payer đến system_program giữ vị trí mà nó có trước khi nâng cấp, vì vậy sự ngắt quãng là sạch sẽ: một transaction được xây dựng dựa trên bố cục mười bốn account trước khi nâng cấp sẽ không đọc nhầm vault thành config — nó chỉ đơn giản là truyền quá ít account và Anchor từ chối nó với AccountNotEnoughKeys (3005) trước khi bất kỳ constraint nào chạy. Các account vẫn là bắt buộc, vì vậy hãy thêm cả hai và làm mới IDL; không có đường dẫn tương thích cho bố cục cũ.

Effect — giống hệt với CollectCreatorFee ở trên: share được giải quyết từ creator_fee_share hoặc amm_config, phần của protocol được ghi vào protocol_fees_token_{0,1}, phần của creator được chuyển đến creator ATA, cả hai bộ đếm creator được đặt lại về 0, và recent_epoch được cập nhật. Trả về NoFeeCollect khi cả hai bộ đếm đều bằng 0.

`UpdatePoolStatus`

Tạm dừng hoặc tiếp tục các hoạt động riêng lẻ trên một pool. Trường status là một bitmask:

Bit	Flag	Hiệu ứng khi được đặt
0	`DEPOSIT_DISABLED`	`Deposit` từ chối với `NotApproved`.
1	`WITHDRAW_DISABLED`	`Withdraw` từ chối.
2	`SWAP_DISABLED`	`SwapBaseInput` / `SwapBaseOutput` từ chối.

Arguments

status: u8      // new bitmask

Accounts

#	Name	W	S	Notes
1	`authority`		S	Phải khớp với admin key trên CPMM program.
2	`pool_state`	W

Admin key là một pubkey được biên dịch vào program (crate::admin::ID), không phải BPF upgrade authority — thay đổi nó yêu cầu nâng cấp program. Xem reference/program-addresses để biết giá trị và security/admin-and-multisig để biết ai giữ nó.

`CreateAmmConfig`

Tạo một fee tier mới. Arguments

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

Accounts

#	Name	W	S	Notes
1	`owner`	W	S	Admin.
2	`amm_config`	W		`init`ed tại đây.
3	`system_program`

Preconditions

Không có AmmConfig hiện tại nào có cùng index.
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

Thay đổi vào 2026-09: các fee owner của config mới không còn đến từ signer. create_amm_config hiện ghi protocol_fee_owner::ID được hardcode của program vào protocol_owner và fund_fee_owner::ID vào fund_owner, thay vì sao chép key của admin signer vào cả hai. Các địa chỉ nằm trong reference/program-addresses.Hậu quả: phí trên một AmmConfig mới được tạo sẽ đi vào các ví phí chuyên dụng thay vì của admin. Admin vẫn là một signer được chấp nhận cho việc thu phí — CollectProtocolFee / CollectFundFee chấp nhận amm_config.protocol_owner / fund_owner hoặc crate::admin::ID — vì vậy không có gì phải xoay vòng để quét; những gì thay đổi chỉ là nơi các khoản thu nhập đi theo mặc định. Các account AmmConfig hiện tại không được viết lại — bất kỳ điều gì được lưu trữ trên chúng vẫn chi phối, vì vậy luôn đọc protocol_owner / fund_owner từ account thay vì giả định bất kỳ giá trị nào. Các tham số UpdateAmmConfig 3 và 4 vẫn xoay vòng chúng.

`UpdateAmmConfig`

Thay đổi fee rate hoặc quyền sở hữu trên một AmmConfig hiện tại. Lấy một param: u8 (trường nào để cập nhật) và một value: u64. Bảng dispatch đầy đủ:

param = 0 → trade_fee_rate (asserts trade_fee_rate + creator_fee_rate < 1_000_000)
param = 1 → protocol_fee_rate (asserts ≤ 1_000_000 và + fund_fee_rate ≤ 1_000_000)
param = 2 → fund_fee_rate (asserts ≤ 1_000_000 và + protocol_fee_rate ≤ 1_000_000)
param = 3 → protocol_owner. Key mới không nằm trong value: thêm nó như remaining_accounts[0] (read-only là được). Nó không được là default pubkey, và bỏ qua account sẽ panic trên một unwrap().
param = 4 → fund_owner. Cơ chế giống như 3.
param = 5 → create_pool_fee
param = 6 → disable_create_pool (bất kỳ value khác 0 nào sẽ vô hiệu hóa)
param = 7 → creator_fee_rate (asserts creator_fee_rate + trade_fee_rate < 1_000_000)
param = 8 → creator_fee_share_rate (asserts ≤ 1_000_000). Thêm vào 2026-09-19. Share mặc định của protocol của phí creator trên tier này; xem products/cpmm/fees. Nó không liên quan đến protocol_fee_rate, cái mà chia trade fee.

Bất kỳ param nào khác trả về InvalidInput. Các thay đổi được ký bởi admin và ảnh hưởng đến mỗi pool được ràng buộc với AmmConfig này trên swap tiếp theo. Không có migration; các pool chỉ đơn giản đọc các giá trị mới.

`CreateCreatorFeeShare`

Đặt một share tùy chỉnh của protocol cho phí creator cho một cặp (creator, amm_config), ghi đè AmmConfig.creator_fee_share_rate cho mỗi pool mà creator sở hữu trên fee tier đó. Thêm vào nâng cấp creator-fee-share 2026-09-19. Arguments

share_rate: u64   // share của protocol CỦA phí creator, trên FEE_RATE_DENOMINATOR = 1_000_000

Accounts

#	Name	W	S	Notes
1	`owner`	W	S	Phải là CPMM program admin hoặc dedicated creator-fee-share owner — xem `reference/program-addresses`. Bất kỳ signer nào khác sẽ thất bại với `InvalidOwner` (`6001`). Trả tiền thuê.
2	`creator`			Pool creator mà rate áp dụng cho. Unchecked — nó không phải là một pool creator hiện tại, và nó không ký.
3	`amm_config`			Fee tier mà rate áp dụng cho.
4	`creator_fee_share`	W		`init`ed tại đây tại `["creator_fee_share", creator, amm_config]`, `space = 145`.
5	`system_program`

Preconditions

share_rate <= 1_000_000, nếu không InvalidInput (6003).
PDA không được tồn tại — Anchor’s init thất bại trên lệnh gọi thứ hai cho cùng một cặp. Để thay đổi rate, hãy đóng account và tạo lại nó.

Postconditions

creator_fee_share lưu trữ bump, creator, amm_config và share_rate.
Mỗi CollectCreatorFee / CollectCreatorFeePermissionless tiếp theo trên một pool được tạo bởi creator dưới amm_config giải quyết share từ account này thay vì config.

Pool creator không phải là một bên trong instruction này và không ký nó. Rate được đọc tại thời điểm thu phí, vì vậy một override được tạo sau khi phí đã tích lũy áp dụng cho số dư tích lũy đó.

`CloseCreatorFeeShare`

Loại bỏ override. Cặp quay lại AmmConfig.creator_fee_share_rate. Arguments — không có. Accounts

#	Name	W	S	Notes
1	`owner`	W	S	Cùng hai signer được chấp nhận như `CreateCreatorFeeShare`; nhận tiền thuê.
2	`creator`			Pool creator mà rate áp dụng cho.
3	`amm_config`			Fee tier mà rate áp dụng cho.
4	`creator_fee_share`	W		Đóng cho `owner`. Phải là canonical PDA cho cặp.
5	`system_program`

Postconditions

Account được đóng và lamports của nó đi đến owner.
Thu phí cho cặp đó giải quyết share từ amm_config.creator_fee_share_rate lại — cái mà là 0 trừ khi một admin đã đặt UpdateAmmConfig param 8.

`CollectExcessLamports`

Quét lamports của admin nằm trên mức tối thiểu miễn phí thuê trên các tài khoản mà CPMM kiểm soát. Được thêm vào trong bản nâng cấp 2026-09 để giao thức có thể thu hồi quỹ dư thừa mà SIMD-0437 rent reduction để lại trên các tài khoản được tạo trước mỗi bước. Chỉ phần dư thừa được di chuyển. Số dư token, dữ liệu tài khoản, chủ sở hữu, trạng thái pool và đường cong không bị ảnh hưởng, và lệnh này là no-op đối với tài khoản đã ở mức tối thiểu của nó — vì vậy nó an toàn để chạy lại sau mỗi bước triển khai. Arguments — không có. Accounts

#	Name	W	S	Notes
1	`collect_lamports_wallet`	W	S	Đích đến cho mỗi lamport được quét. Phải là admin chương trình CPMM hoặc ví collect-lamports chuyên dụng — xem `reference/program-addresses`. Bất kỳ người ký nào khác sẽ thất bại với `InvalidOwner`.
2	`authority`			PDA quyền vault-and-LP-mint của CPMM tại seed `[b"vault_and_lp_mint_auth_seed"]`. Nó ký các CPI của token-program.
3	`token_program`			SPL Token.
4	`token_program_2022`			Token-2022. Cả hai đều được yêu cầu vô điều kiện; chương trình chọn theo tài khoản nguồn.
5..	`remaining_accounts`	W		`M` tài khoản nguồn để quét, bất kỳ số lượng, bất kỳ thứ tự.

Sửa lỗi thứ tự, 2026-09-19. Chương trình hiện thực hiện hai lần quét remaining_accounts — mỗi CPI token-program trước, sau đó là các khoản ghi nợ trực tiếp của các PDA do CPMM sở hữu. Xen kẽ chúng sẽ hủy bỏ với UnbalancedInstruction của runtime (“tổng số dư tài khoản trước và sau lệnh không khớp”) bất cứ khi nào một PDA được ghi nợ trước một CPI, vì các thay đổi lamport đang chờ xử lý của người gọi chỉ được xóa vào tài khoản mà CPI thực sự thực hiện. Người gọi không phải tự mình nhóm hoặc sắp xếp danh sách.

Cách xử lý mỗi tài khoản nguồn Chương trình phân loại dựa trên owner của tài khoản nguồn:

Chủ sở hữu tài khoản nguồn	Xử lý
SPL Token hoặc Token-2022, tài khoản token không phải native hoặc mint — pool vaults và LP mints	CPI `WithdrawExcessLamports` (discriminant token-program `38`), được ký bởi `authority`.
SPL Token hoặc Token-2022, tài khoản token native (wSOL)	`WithdrawExcessLamports` từ chối các tài khoản native. Chương trình CPIs `SyncNative`, đo lường `amount` được bao bọc tăng bao nhiêu, `UnwrapLamports` (discriminant `45`) cho chính xác delta đó, sau đó yêu cầu số dư được bao bọc bằng giá trị trước đồng bộ của nó — nếu không `LamportsCalculateError` (`6015`). Do đó, pool vault phía SOL giữ toàn bộ than流động tính của nó.
Chính chương trình CPMM — `PoolState`, `AmmConfig`, `ObservationState`, `Permission`, `SupportMintAssociated`	Chương trình ghi nợ tài khoản trực tiếp xuống `rent.minimum_balance(data_len)`.
Bất cứ điều gì khác	Bỏ qua im lặng. Không có lỗi, không có lamports được di chuyển.

Vì nó nhận một danh sách remaining_accounts không giới hạn, kích thước giao dịch là giới hạn thực tế — cùng một ràng buộc như quét phía ví được mô tả trong solana-fundamentals/rent-and-reclaimable-rent. Lỗi phổ biến — InvalidOwner (6001, người ký sai), LamportsCalculateError (6015, vòng wSOL không bằng không), và InsufficientFunds từ đường dẫn do chương trình sở hữu khi tài khoản giữ ít hơn mức tối thiểu thuê của chính nó. Không có SDK builder. @raydium-io/raydium-sdk-v2 không cung cấp builder cho lệnh này, và raydium-sdk-V2-demo repo cũng không — đó là một đường dẫn admin. Mã hóa nó bằng tay, theo cách quét phía ví trong solana-fundamentals/rent-and-reclaimable-rent làm cho lệnh token-program.

Ma trận thay đổi trạng thái

Instruction	`lp_supply`	Vault balances	Accrued-fee fields	`observation`
`Initialize`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeV2`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeWithPermission`	+ init LP	+ `init_amount_{0,1}`	0	init
`Deposit`	+	+ both	—	—
`Withdraw`	−	− both	—	—
`SwapBaseInput`	—	+ in, − out	+ `trade_fee` chia thành protocol/fund; + `creator_fee` nếu được bật	+ (nếu khoảng thời gian đã trôi qua)
`SwapBaseOutput`	—	+ in, − out	+ `trade_fee` chia thành protocol/fund; + `creator_fee` nếu được bật	+ (nếu khoảng thời gian đã trôi qua)
`CollectProtocolFee`	—	− (theo protocol buckets)	`protocol_*` → 0	—
`CollectFundFee`	—	− (theo fund buckets)	`fund_*` → 0	—
`CollectCreatorFee`	—	− (chỉ theo phần của creator)	`creator_` → 0; `protocol_` += phần được chia sẻ	—
`CollectCreatorFeePermissionless`	—	− (chỉ theo phần của creator)	`creator_` → 0; `protocol_` += phần được chia sẻ	—
`UpdatePoolStatus`	—	—	—	—
`CreateCreatorFeeShare`	—	—	—	—
`CloseCreatorFeeShare`	—	—	—	—
`CollectExcessLamports`	—	— (số dư token không thay đổi)	—	—

Bước tiếp theo

products/cpmm/code-demos — các mẫu TypeScript có thể chạy được cho các mẫu trên.
reference/error-codes — bảng lỗi Anchor hoàn chỉnh.
products/cpmm/fees — mô hình accrual phí mà các lệnh Collect*Fee xả.

Nguồn:

Products

Algorithms

Tóm tắt hướng dẫn

`Initialize`

`InitializeV2`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Ma trận thay đổi trạng thái

Bước tiếp theo

​Tóm tắt hướng dẫn

​Initialize

​InitializeV2

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​CreateCreatorFeeShare

​CloseCreatorFeeShare

​CollectExcessLamports

​Ma trận thay đổi trạng thái

​Bước tiếp theo

Tóm tắt hướng dẫn

`Initialize`

`InitializeV2`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

Ma trận thay đổi trạng thái

Bước tiếp theo