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.

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 một 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. Cố định `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`	payer + người nắm giữ PDA `Permission`	Biến thể có phép của `Initialize`. Người gọi (`payer`) phải sở hữu một PDA `Permission` được dẫn xuất từ pubkey của họ. Được sử dụng bởi các nền tảng cần tạo pool có kiểm soát (ví dụ: LaunchLab graduations). 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 truyền riêng biệt, không phải payer. Cùng tính linh hoạt PDA-chính-tắc-hoặc-keypair-ngẫu-nhiên 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 swap	Swap đầu vào chính xác (`amount_in` vào, ≥ `minimum_amount_out` ra).
`SwapBaseOutput`	người swap	Swap đầ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ừ vault.
`CollectFundFee`	`fund_owner` (từ `AmmConfig`)	Quét phí quỹ tích lũy từ vault.
`CollectCreatorFee`	`pool_creator`	Quét phí người tạo tích lũy (nếu phí người tạo được bật).
`CollectCreatorFeePermissionless`	bất kỳ payer nào	Quét tất cả 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`. Payer 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 một tầng phí mới (tài khoản `AmmConfig` mới).
`CreatePermissionPda`	`admin` hoặc người tạo PDA phép được ủy quyền	Mint một PDA `Permission` cho phép một quyền hạn cụ thể gọi `InitializeWithPermission`.
`ClosePermissionPda`	`admin`	Thu hồi một PDA `Permission` đã phát hành trước đó.

Bitmask trạng thái: status của mỗi pool là một 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 lấy một 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 CPMM IDL; SDK và client Rust trong raydium-cp-swap/programs/cp-swap/src/instructions khớp với thứ tự này.

`Initialize`

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

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix timestamp; swap bị từ chối trước thời điểm này

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 quyền hạn 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 một 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 dẫn xuất 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. Quyền hạn đượ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		Đích cho LP (được tạo nếu thiếu).
11	`token_0_vault`	W		`init`ed ở đây. Được 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 phần mở rộng ngoài danh sách cho phép CPMM (TransferFeeConfig, MetadataPointer, TokenMetadata, InterestBearingConfig, ScaledUiAmount) — xem products/cpmm/accounts. Một danh sách cho phép nhỏ cho mỗi mint bên trong chương trình bỏ qua kiểm tra để onboarding từng trường hợp.
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 tồn tại với lp_supply = sqrt(init_amount_0 * init_amount_1) − LOCKED_LP.
Người khởi động LP của LOCKED_LP (100 lamport của token LP) bị khóa vĩnh viễn trong pool — pool_state.lp_supply ghi lại liquidity − 100 trong khi 100 đơn vị LP vẫn ngoài lưu thông, ngăn pool bị thoát hết và chia cho không.
observation_state được khởi tạo; observation_index = 0 và pool_id = pool_state.key().
create_pool_fee lamport đượ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à một 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 truyền một giá trị <= block_timestamp. Swap bị từ chối trước open_time; deposit và withdraw 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 nhau.
NotSupportMint — phần 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 ở cả hai token theo tỷ lệ với pool. Đối số

lp_token_amount:   u64   // bao nhiêu token LP để mint cho LP
maximum_token_0:   u64
maximum_token_1:   u64

Tài khoản

#	Tên	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

Toán học

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")

Không thay đổi tính tỷ lệ của k — cả vault và lp_supply được mở rộng theo cùng một hệ số. Điều kiện sau

lp_supply += lp_token_amount.
vault_0 += needed_token_0 (ròng của bất kỳ phí chuyển Token-2022 nào trên đầu vào).
vault_1 += needed_token_1 (ròng của bất kỳ phí chuyển Token-2022 nào trên đầu vào).

Lỗi phổ biến — 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ệ. Đối số

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

Tài khoản

#	Tên	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

(Giống hệt như Deposit; lp_mint có thể ghi vì token LP được đốt.) Toán học

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")

Điều kiện sau

lp_supply -= lp_token_amount.
Vault gửi out_token_0 / out_token_1 (tổng; người dùng nhận ròng của bất kỳ phí chuyển Token-2022 nào).

`SwapBaseInput`

Swap đầu vào chính xác. Đối số

amount_in:            u64
minimum_amount_out:   u64

Tài khoản

#	Tên	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 là theo hướng của người dùng, không phải theo token_0 / token_1 chính tắc của pool. Chương trình tìm ra vault nào là cái nào bằng cách khớp mint. Toán học — xem products/cpmm/math. Điều kiện trước

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 quyền hạn này.
amount_in > 0.

Lỗi phổ biến

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 đầu ra chính xác. Đối số

max_amount_in:  u64
amount_out:     u64

Tài khoản — giống như SwapBaseInput. Toán học — đường cong nghịch đảo với trần, xem products/cpmm/math. Lỗi phổ biến — ExceededSlippage (gross_in > max_amount_in), ZeroTradingTokens, InvalidInput, NotApproved.

`CollectProtocolFee`

Quét phí giao thức tích lũy từ vault đến đích giao thức. Đối số — không có. Tài khoản

#	Tên	W	S
1	`owner`		S	Phải khớp với `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`

Hiệu ứng

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 thay đổi số dư hiệu quả của đường cong (phí tích lũy đã bị loại trừ). Lỗi phổ biến — NotApproved nếu người ký không phải là protocol_owner.

`CollectFundFee`

Cùng hình dạng như CollectProtocolFee nhưng được ký bởi fund_owner và đặt lại các bộ đếm fund_fees_*.

`CollectCreatorFee`

Được ký bởi pool_state.pool_creator. Nó chuyển toàn bộ số dư creator_fees_token_0 và creator_fees_token_1 đến các tài khoản token của người tạo, sau đó đặt lại cả hai bộ đếm. Nó trả về NoFeeCollect khi cả hai bộ đếm bằng không.

`CollectCreatorFeePermissionless`

Bất kỳ ai cũng có thể kích hoạt việc thu thập phí người tạo. Hướng dẫn luôn gửi toàn bộ số dư tích lũy đến các tài khoản token liên kết chính tắc được sở hữu bởi pool_state.pool_creator; người gọi không thể chọn người tạo hoặc đích khác. Nếu bất kỳ ATA nào bị thiếu, payer tài trợ việc tạo của nó. CollectCreatorFee gốc vẫn có thể gọi được, vì vậy các client hiện có vẫn tương thích. Đối số — không có. Tài khoản

#	Tên	W	S	Ghi chú
1	`payer`	W	S	Bất kỳ người ký nào; tài trợ ATA người tạo bị thiếu.
2	`creator`			Phải bằng `pool_state.pool_creator`; không ký.
3	`authority`			PDA quyền hạn vault toàn cầu CPMM.
4	`pool_state`	W		Giữ các bộ đếm phí người tạo tích lũy.
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		ATA chính tắc của người tạo cho `vault_0_mint`; được tạo nếu thiếu.
10	`creator_token_1`	W		ATA chính tắc của người tạo cho `vault_1_mint`; được tạo nếu 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 nhận bị thiếu.
14	`system_program`			Tài trợ tạo tài khoản từ `payer`.

Hiệu ứng

Chuyển tất cả creator_fees_token_0 và creator_fees_token_1 từ vault pool đến ATA người tạo.
Đặt lại cả hai bộ đếm phí người tạo và cập nhật pool_state.recent_epoch.
Trả về NoFeeCollect khi cả hai bộ đếm bằng không.

`UpdatePoolStatus`

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

Bit	Cờ	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.

Đối số

status: u8      // bitmask mới

Tài khoản

#	Tên	W	S
1	`authority`		S	Phải khớp với khóa admin trên chương trình CPMM.
2	`pool_state`	W

Khóa admin là quyền hạn nâng cấp trên chương trình CPMM — trong thực tế, multisig Raydium. Xem security/admin-and-multisig.

`CreateAmmConfig`

Tạo một tầng phí mới. Đối số

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

Tài khoản

#	Tên	W	S
1	`owner`	W	S	Admin.
2	`amm_config`	W		`init`ed ở đây.
3	`system_program`

Điều kiện trước

Không có AmmConfig hiện có với cùng index.
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE.

`UpdateAmmConfig`

Thay đổi tỷ lệ phí hoặc quyền sở hữu trên một AmmConfig hiện có. Lấy một param: u8 (discriminator cho trường nào cần cập nhật) và một value: u64. Ngữ nghĩa giá trị cho mỗi param nằm trong nguồn; thường:

param = 0 → trade_fee_rate
param = 1 → protocol_fee_rate
param = 2 → fund_fee_rate
param = 3 → new_protocol_owner (chuyển byte Pubkey dưới dạng reinterpret)
param = 4 → new_fund_owner
param = 5 → create_pool_fee
param = 6 → disable_create_pool

Các thay đổi được ký bởi admin và ảnh hưởng đến mọi pool liên kết với AmmConfig này trên swap tiếp theo. Không có di chuyển; pool chỉ đơn giản đọc các giá trị mới.

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

Hướng dẫn	`lp_supply`	Số dư Vault	Trường phí tích lũy	`observation`
`Initialize`	+ init LP	+ `init_amount_{0,1}`	0	init
`InitializeWithPermission`	+ init LP	+ `init_amount_{0,1}`	0	init
`Deposit`	+	+ cả hai	—	—
`Withdraw`	−	− cả hai	—	—
`SwapBaseInput`	—	+ in, − out	+ `trade_fee` chia thành giao thức/quỹ; + `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 giao thức/quỹ; + `creator_fee` nếu được bật	+ (nếu khoảng thời gian đã trôi qua)
`CollectProtocolFee`	—	− (theo bucket giao thức)	`protocol_*` → 0	—
`CollectFundFee`	—	− (theo bucket quỹ)	`fund_*` → 0	—
`CollectCreatorFee`	—	− (theo bucket người tạo)	`creator_*` → 0	—
`CollectCreatorFeePermissionless`	—	− (theo bucket người tạo)	`creator_*` → 0	—
`UpdatePoolStatus`	—	—	—	—

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

Nguồn:

Products

Algorithms

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

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

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

Tiếp theo

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

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

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

​Tiếp theo

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

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

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

Tiếp theo