Các lệnh CPMM

​

Tóm tắt lệnh

​

Initialize

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

• 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. Một 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 nối PDA đó vào remaining_accounts. Chương trình chỉ quét các tài khoản bạn truyề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); truyề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.

• 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à 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. Hoán đổi bị từ chối trước open_time; deposit và withdraw hoạt động ngay lập tức.

• 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 zero LP do không khớp số thập phân.

​

Deposit

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

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // tương tự cho 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")             // tương tự cho side 1

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

​

Withdraw

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // tương tự cho 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")       // tương tự cho side 1

// Như với Deposit: cơ sở là tổng vault không bao gồm phí, và sàn được
// kiểm tra so với những gì LP thực sự nhận được, sau khi phí chuyển.

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

​

SwapBaseInput

amount_in:            u64
minimum_amount_out:   u64

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

• 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 hoán đổi thông qua UpdatePoolStatus.
• InvalidInput — mint không khớp với bất kỳ mint vault nào của pool.

​

SwapBaseOutput

max_amount_in:  u64
amount_out:     u64

​

CollectProtocolFee

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

​

CollectFundFee

​

CollectCreatorFee

share_rate = creator_fee_share.share_rate   (nếu tài khoản tồn tại)
           | amm_config.creator_fee_share_rate   (nếu không)

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     // ở lại trong vault
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

​

CollectCreatorFeePermissionless

​

UpdatePoolStatus

status: u8      // bitmask mới

​

CreateAmmConfig

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

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

​

UpdateAmmConfig

• param = 0 → trade_fee_rate (khẳng định trade_fee_rate + creator_fee_rate < 1_000_000)
• param = 1 → protocol_fee_rate (khẳng định ≤ 1_000_000 và + fund_fee_rate ≤ 1_000_000)
• param = 2 → fund_fee_rate (khẳng định ≤ 1_000_000 và + protocol_fee_rate ≤ 1_000_000)
• param = 3 → protocol_owner. Khóa mới không nằm trong value: nối nó dưới dạng remaining_accounts[0] (chỉ đọc là được). Nó không được là pubkey mặc định, và bỏ qua tài khoản sẽ hoảng sợ 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 không nào sẽ vô hiệu hóa)
• param = 7 → creator_fee_rate (khẳng định creator_fee_rate + trade_fee_rate < 1_000_000)
• param = 8 → creator_fee_share_rate (khẳng định ≤ 1_000_000). Được thêm vào 2026-09-19. Phần chia sẻ mặc định của giao thức của phí người tạo trên tầng này; xem products/cpmm/fees. Nó không liên quan đến protocol_fee_rate, chia phí giao dịch.

​

CreateCreatorFeeShare

share_rate: u64   // chia sẻ của giao thức CỦA phí người tạo, trên FEE_RATE_DENOMINATOR = 1_000_000

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

• 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 sẽ giải quyết chia sẻ từ tài khoản này thay vì cấu hình.

​

CloseCreatorFeeShare

• Tài khoản được đóng và lamport của nó đi đến owner.
• Bộ sưu tập cho cặp đó giải quyết chia sẻ từ amm_config.creator_fee_share_rate một lần nữa — đó là 0 trừ khi admin đã đặt UpdateAmmConfig param 8.

​

CollectExcessLamports

​

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