Hướng dẫn CPMM

Mọi hướng dẫn trên chương trình CPMM, với các đối số, danh sách tài khoản, điều kiện trước/sau và các lỗi có thể xảy ra.

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.

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).
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*	inited ở đâ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		inited ở đâ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		inited ở đâ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		inited ở đâ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 — đường dẫn đó là InitializeWithPermission.
• 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.

​

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		inited 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		inited 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
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:

• raydium-io/raydium-cp-swap — instructions
• Raydium SDK v2 — @raydium-io/raydium-sdk-v2