CPMM 指令

本頁內容由 AI 自動翻譯，所有內容以英文版本為準。查看英文版 →

本頁是權威的指令參考。如需實際組成這些指令的程式碼，請參閱 products/cpmm/code-demos。如需錯誤代碼含義，請參閱 reference/error-codes。2026-09 程式升級在 Anchor 1.0.2 / Solana 3.1.10 上重建了 CPMM，新增了管理員指令 CollectExcessLamports，移除了硬編碼的 Token-2022 鑄幣廠白名單，並改變了 CreateAmmConfig 寫入 protocol_owner / fund_owner 的內容。沒有使用者面向的指令改變其帳戶、參數或數學。請參閱 2026-09-09 變更日誌條目。

兩個建立者費用收集指令在 2026-09-19 改變了其帳戶列表。 CollectCreatorFee 新增 creator_fee_share；CollectCreatorFeePermissionless 新增 amm_config 和 creator_fee_share。兩者都附加在 system_program 之後，因此現有用戶端已傳遞的每個帳戶都保持其索引 — 但新帳戶是強制性的，所以針對舊版配置構建的交易帳戶數量不足，會被 Anchor 的 AccountNotEnoughKeys（3005）拒絕。新增了兩個管理員指令 — CreateCreatorFeeShare 和 CloseCreatorFeeShare — 並且 UpdateAmmConfig 採用新的 param = 8。請參閱 2026-09-19 變更日誌條目。

指令摘要

判別器名稱	誰簽署	它做什麼
`Initialize`	池建立者	從兩個鑄幣廠和一個 `AmmConfig` 建立新的 CPMM 池。無需許可；任何人都可以呼叫。在新池上硬編碼 `enable_creator_fee = false`。`pool_state` 帳戶可以是規範 PDA 或新的隨機金鑰對（參閱 Initialize 帳戶）。
`InitializeWithPermission`	支付者 + `Permission` PDA 的持有者	`Initialize` 的許可變體。呼叫者（`payer`）必須擁有從其自己的公鑰衍生的 `Permission` PDA。由需要受限池建立的平台使用（例如 LaunchLab 畢業）。讓呼叫者固定 `creator_fee_on`（`BothToken` / `OnlyToken0` / `OnlyToken1`）並在新池上強制 `enable_creator_fee = true`。`pool_state` 上的 `creator` 欄位設定為單獨傳遞的 `creator` 帳戶，而不是支付者。與 `Initialize` 相同的規範 PDA 或隨機金鑰對靈活性用於 `pool_state`。
`Deposit`	LP	在兩個代幣中新增流動性；接收 LP 代幣。
`Withdraw`	LP	燒毀 LP 代幣；按比例接收兩個基礎代幣。
`SwapBaseInput`	交換者	精確輸入交換（`amount_in` 進入，≥ `minimum_amount_out` 出去）。
`SwapBaseOutput`	交換者	精確輸出交換（≤ `maximum_amount_in` 進入，`amount_out` 出去）。
`CollectProtocolFee`	`protocol_owner`（來自 `AmmConfig`）	從保管庫清掃累積的協議費用。
`CollectFundFee`	`fund_owner`（來自 `AmmConfig`）	從保管庫清掃累積的基金費用。
`CollectCreatorFee`	`pool_creator`	清掃累積的建立者費用（如果啟用了建立者費用），扣除協議的份額，該份額被記入池的協議桶。
`CollectCreatorFeePermissionless`	任何支付者	將累積的建立者費用清掃到 `pool_creator` 的規範代幣帳戶，扣除相同的協議份額。支付者可以建立缺失的收款人 ATA，但無法重定向轉帳。
`UpdatePoolStatus`	`admin`	通過位元遮罩暫停/恢復池上的特定操作。
`UpdateAmmConfig`	`admin`	變更費率或 `AmmConfig` 上的協議/基金所有者。
`CreateAmmConfig`	`admin`	建立新的費用層級（新 `AmmConfig` 帳戶）。
`CreatePermissionPda`	`admin` 或委派的許可 PDA 建立者	鑄造 `Permission` PDA，允許特定授權呼叫 `InitializeWithPermission`。
`ClosePermissionPda`	`admin` 或專用許可 PDA 建立者	撤銷先前發行的 `Permission` PDA。自 2026-09 升級以來，專用建立者授權也可以關閉它發行的授權；在此之前僅限管理員。
`CreateSupportMintAssociated`	`admin` 或專用支援鑄幣廠所有者	通過建立其 `SupportMintAssociated` PDA 來登記否則會失敗擴展允許清單的 Token-2022 鑄幣廠。
`CloseSupportMintAssociated`	`admin` 或專用支援鑄幣廠所有者	移除鑄幣廠的登記。
`CollectExcessLamports`	`admin` 或專用收集 lamports 錢包	從 CPMM 控制的保管庫、LP 鑄幣廠和 PDA 清掃超過租金豁免最低額的 lamports。新增於 2026-09。
`CreateCreatorFeeShare`	`admin` 或專用建立者費用份額所有者	為一個 `(creator, amm_config)` 對設定自訂協議份額的建立者費用，覆蓋 `AmmConfig.creator_fee_share_rate`。新增於 2026-09-19。
`CloseCreatorFeeShare`	`admin` 或專用建立者費用份額所有者	移除該覆蓋；該對回退到設定預設值。新增於 2026-09-19。

狀態位元遮罩：每個池的 status 是一個 u8，其中位 0 = 禁用存款，位 1 = 禁用提取，位 2 = 禁用交換（程式中的 PoolStatusBitIndex { Deposit, Withdraw, Swap }）。清除位表示允許操作；設定位表示暫停。UpdatePoolStatus 採用原始 u8 並覆蓋現有值。下一節詳細介紹每一個。帳戶順序遵循 CPMM IDL；SDK 和 raydium-cp-swap/programs/cp-swap/src/instructions 中的 Rust 用戶端符合此順序。

`Initialize`

建立新的 CPMM 池。參數

init_amount_0: u64
init_amount_1: u64
open_time:     u64   // Unix 時間戳；此之前的交換被拒絕

帳戶（W = 可寫，S = 簽署者）

#	名稱	W	S	備註
1	`creator`	W	S	支付租金；記錄為 `pool_state.pool_creator`。
2	`amm_config`			選定的費用層級。
3	`authority`			CPMM 全域授權 PDA。
4	`pool_state`	W	S*	在此 `init`。要麼是規範 PDA `["pool", amm_config, token_0_mint, token_1_mint]` 要麼是新的隨機金鑰對 — 當不是規範 PDA 時，程式要求 `pool_state` 簽署（`require_eq!(pool_account_info.is_signer, true)`）。隨機金鑰對路徑讓建立者躲避規範 PDA 上的搶先交易嘗試。下游 PDA（`lp_mint`、`vaults`、`observation_state`）無論如何都從 `pool_state.key()` 衍生。
5	`token_0_mint`			已排序：`token_0_mint < token_1_mint`。
6	`token_1_mint`
7	`lp_mint`	W		在此 `init`。授權設定為 `authority`。
8	`creator_token_0`	W		`init_amount_0` 的來源 ATA。
9	`creator_token_1`	W		`init_amount_1` 的來源 ATA。
10	`creator_lp_token`	W		建立者在 `lp_mint` 上的 ATA。`init`（不是 `init_if_needed`）— 它必須不存在，這是不可能的，因為 `lp_mint` 在同一指令中建立。
11	`token_0_vault`	W		在此 `init`。由 `authority` 擁有。
12	`token_1_vault`	W
13	`create_pool_fee`	W		建立者支付的 `create_pool_fee` 的目標 ATA。
14	`observation_state`	W		在此 `init`。
15	`token_program`			SPL Token（用於 LP 鑄幣廠）。
16	`token_0_program`			SPL Token 或 Token-2022。
17	`token_1_program`			SPL Token 或 Token-2022。
18	`associated_token_program`
19	`system_program`
20	`rent`

* pool_state 僅在隨機金鑰對路徑上簽署；規範 PDA 路徑在沒有 pool_state 簽署的情況下執行。 前置條件

鑄幣廠已排序（token_0_mint < token_1_mint 按位元組順序）。
兩個鑄幣廠都不使用 CPMM 允許清單外的擴展（TransferFeeConfig、MetadataPointer、TokenMetadata、InterestBearingConfig、ScaledUiAmount）— 參閱 products/cpmm/accounts。其 SupportMintAssociated PDA（種子 [b"support_mint", mint]）存在的鑄幣廠跳過擴展檢查 — 但你必須將該 PDA 附加到 remaining_accounts。程式只掃描你傳遞的帳戶，從不自己載入 PDA，所以依賴登記而不提供帳戶仍然會失敗，出現 NotSupportMint（6007）。順序無關緊要（按鑰匙匹配）；為每個需要繞過的鑄幣廠傳遞一個條目。該登記是自 2026-09 升級移除硬編碼四鑄幣廠白名單以來唯一的繞過。
creator 在各自的 ATA 中至少有 init_amount_0 和 init_amount_1。
amm_config.disable_create_pool == false。

後置條件

pool_state.lp_supply = sqrt(init_amount_0 * init_amount_1) — 完整平方根。建立者被鑄造 lp_supply − 100；100 個鎖定的基礎單位被計入 lp_supply 但從不鑄造。
因此 lp_mint.supply == pool_state.lp_supply − 100 在池的整個生命週期內。所有 LP 份額數學（存款、提取）除以 lp_supply，所以使用該欄位，不要替換鑄幣廠的鏈上供應。如果 sqrt(...) < 100 則回退 InitLpAmountTooLess。
observation_state 已初始化；observation_index = 0 和 pool_id = pool_state.key()。
create_pool_fee lamports 從建立者轉移到接收者並同步為原生 SOL（它是 wSOL ATA）。
池的狀態位元遮罩是 0（存款/提取/交換全部啟用）。
enable_creator_fee = false 和 creator_fee_on = BothToken。Initialize 不支援啟用建立者費用 — 該路徑是 InitializeWithPermission。
如果呼叫者傳遞的值 <= block_timestamp，open_time 被提升到 block_timestamp + 1。交換在 open_time 之前被拒絕；存款和提取立即工作。

常見錯誤（完整清單在 reference/error-codes）

InvalidInput — 鑄幣廠未排序或相同鑄幣廠。
NotSupportMint — 被阻止的 Token-2022 擴展。
ExceededSlippage — 很少；如果 init_amount_0/1 由於小數位數不匹配導致零 LP。

`Deposit`

按池的比例在兩個代幣中新增流動性。參數

lp_token_amount:   u64   // 要鑄造給 LP 的 LP 代幣數量
maximum_token_0:   u64
maximum_token_1:   u64

帳戶

#	名稱	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

數學

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // 側面 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")             // 側面 1 相同

兩個值得釘住的細節：按比例基礎是費用排除保管庫總額（vault_amount_without_fee，即原始餘額減去累積的協議、基金和建立者計數器），而不是原始保管庫餘額；滑點上限針對支付者實際轉移的內容進行檢查，在 Token-2022 轉移費用被新增後，而不是針對總保管庫移動。 k 的比例沒有變化 — 兩個總額和 lp_supply 按相同因子縮放。 後置條件

lp_supply += lp_token_amount。
vault_0 += needed_token_0（扣除輸入上任何 Token-2022 轉移費用）。
vault_1 += needed_token_1（扣除輸入上任何 Token-2022 轉移費用）。

常見錯誤 — ExceededSlippage、ZeroTradingTokens、InvalidStatus（如果存款被暫停）。

`Withdraw`

燒毀 LP 代幣並按比例接收兩個基礎代幣。參數

lp_token_amount:   u64
minimum_token_0:   u64
minimum_token_1:   u64

帳戶

#	名稱	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 個帳戶與 Deposit 相同，lp_mint 是可寫的，因為 LP 代幣被燒毀。Withdraw 另外採用第 14 個帳戶 memo_program（受限 address = memo::ID）— Deposit 不採用。13 帳戶 Withdraw 失敗 Anchor 反序列化，所以 LP 無法退出。數學

total_0 = vault_0 − protocol_fees_0 − fund_fees_0 − creator_fees_0    // 側面 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")       // 側面 1 相同

// 與 Deposit 相同：基礎是費用排除保管庫總額，下限針對 LP 實際接收的內容進行檢查，在轉移費用後。

後置條件

lp_supply -= lp_token_amount。
保管庫發送 out_token_0 / out_token_1（總額；使用者接收扣除任何 Token-2022 轉移費用的淨額）。

`SwapBaseInput`

精確輸入交換。參數

amount_in:            u64
minimum_amount_out:   u64

帳戶

#	名稱	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

順序輸入 → 輸出是按使用者的方向，而不是按池的規範 token_0 / token_1。程式通過匹配鑄幣廠來確定哪個保管庫是哪個。數學 — 參閱 products/cpmm/math。 前置條件

open_time <= now。
pool_status 允許交換。
對於此授權，兩個鑄幣廠都未暫停或凍結。
amount_in > 0。

常見錯誤

ExceededSlippage — amount_out < minimum_amount_out。
ZeroTradingTokens — 交易四捨五入為零。
NotApproved — 池通過 UpdatePoolStatus 暫停交換。
InvalidInput — 鑄幣廠與池的任一保管庫鑄幣廠不匹配。

`SwapBaseOutput`

精確輸出交換。參數

max_amount_in:  u64
amount_out:     u64

帳戶 — 與 SwapBaseInput 相同。數學 — 反向曲線與上限，參閱 products/cpmm/math。 常見錯誤 — ExceededSlippage（gross_in > max_amount_in）、ZeroTradingTokens、InvalidInput、NotApproved。

`CollectProtocolFee`

從保管庫清掃累積的協議費用到協議目標。參數 — 無。帳戶

#	名稱	W	S	備註
1	`owner`		S	必須等於 `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`

效果

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

曲線有效餘額沒有變化（累積費用已被排除）。 常見錯誤 — InvalidOwner（6001）如果簽署者既不是 amm_config.protocol_owner 也不是程式管理員。（此路徑上沒有 NotApproved。）

`CollectFundFee`

與 CollectProtocolFee 相同的形狀，但由 amm_config.fund_owner 簽署 — 或再次由程式管理員簽署 — 並將 fund_fees_* 計數器歸零。錯誤簽署者上相同的 InvalidOwner。

`CollectCreatorFee`

由 pool_state.pool_creator 簽署。它結算累積的建立者費用並將建立者的部分轉移到建立者的代幣帳戶。參數 — 無。帳戶

#	名稱	W	S	備註
1	`creator`	W	S	受限 `address = pool_state.pool_creator`。
2	`authority`			CPMM 全域保管庫授權 PDA。
3	`pool_state`	W		持有累積的建立者費用計數器。
4	`amm_config`			受限 `address = pool_state.amm_config`。攜帶預設 `creator_fee_share_rate`。
5	`token_0_vault`	W		必須符合池的代幣 0 保管庫。
6	`token_1_vault`	W		必須符合池的代幣 1 保管庫。
7	`vault_0_mint`			必須符合 `token_0_vault.mint`。
8	`vault_1_mint`			必須符合 `token_1_vault.mint`。
9	`creator_token_0`	W		代幣 0 建立者部分的目標。
10	`creator_token_1`	W		代幣 1 建立者部分的目標。
11	`token_0_program`			SPL Token 或 Token-2022，符合代幣 0。
12	`token_1_program`			SPL Token 或 Token-2022，符合代幣 1。
13	`associated_token_program`
14	`system_program`
15	`creator_fee_share`			新增於 2026-09-19，附加在 `system_program` 之後。PDA 在 `["creator_fee_share", creator, amm_config]`。必須在每次呼叫時傳遞，但不需要存在 — 當它為空或不由 CPMM 擁有時，程式回退到 `amm_config.creator_fee_share_rate`。種子約束仍然適用，所以地址必須是規範 PDA。

效果

share_rate = creator_fee_share.share_rate   (如果帳戶存在)
           | amm_config.creator_fee_share_rate   (否則)

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     // 留在保管庫中
pool_state.creator_fees_token_i   = 0
pool_state.recent_epoch = current epoch

協議的份額在此處從不離開保管庫 — 它被重新標記為協議費用並等待 CollectProtocolFee。兩個計數器已被排除在曲線對保管庫的看法之外，所以池的價格不會移動。完整推導在 products/cpmm/fees。 常見錯誤 — 當兩個建立者計數器都為零時 NoFeeCollect（在分割前檢查），InvalidInput（6003）如果解析的 share_rate 超過 1_000_000，MathOverflow（6011）如果預訂份額會溢出 protocol_fees_token_*，以及 Anchor 的 ConstraintSeeds 錯誤如果 creator_fee_share 不是規範 PDA。

`CollectCreatorFeePermissionless`

任何人都可以觸發建立者費用收集。指令始終將建立者的部分發送到由 pool_state.pool_creator 擁有的規範關聯代幣帳戶；呼叫者無法選擇另一個建立者或目標。如果任一 ATA 缺失，支付者為其建立提供資金。原始 CollectCreatorFee 仍然可呼叫，所以想要為自己的收集簽署的建立者仍然可以。參數 — 無。帳戶

#	名稱	W	S	備註
1	`payer`	W	S	任何簽署者；為缺失的建立者 ATA 提供資金。
2	`creator`			必須等於 `pool_state.pool_creator`；不簽署。
3	`authority`			CPMM 全域保管庫授權 PDA。
4	`pool_state`	W		持有累積的建立者費用計數器。
5	`token_0_vault`	W		必須符合池的代幣 0 保管庫。
6	`token_1_vault`	W		必須符合池的代幣 1 保管庫。
7	`vault_0_mint`			必須符合 `token_0_vault.mint`。
8	`vault_1_mint`			必須符合 `token_1_vault.mint`。
9	`creator_token_0`	W		建立者的 `vault_0_mint` 規範 ATA；如果缺失則建立。
10	`creator_token_1`	W		建立者的 `vault_1_mint` 規範 ATA；如果缺失則建立。
11	`token_0_program`			SPL Token 或 Token-2022，符合代幣 0。
12	`token_1_program`			SPL Token 或 Token-2022，符合代幣 1。
13	`associated_token_program`			建立缺失的收款人 ATA。
14	`system_program`			從 `payer` 為帳戶建立提供資金。
15	`amm_config`			新增於 2026-09-19，附加在 `system_program` 之後。受限 `address = pool_state.amm_config`。
16	`creator_fee_share`			新增於 2026-09-19，附加在最後。與 `CollectCreatorFee` 上相同的 PDA 和相同的可選存在規則。

兩個新帳戶附加在 system_program 之後，而非插入。從 payer 到 system_program 的每個帳戶都保持升級前的位置，所以這個破壞是乾淨的：針對升級前十四帳戶配置構建的交易不會誤讀保管庫為設定帳戶 — 它只是傳遞的帳戶太少，Anchor 在任何約束執行之前就以 AccountNotEnoughKeys（3005）拒絕它。這些帳戶仍然是強制性的，所以請附加兩者並刷新 IDL；舊版配置沒有相容路徑。

效果 — 與上面的 CollectCreatorFee 相同：份額從 creator_fee_share 或 amm_config 解析，協議的部分被記入 protocol_fees_token_{0,1}，建立者的部分被轉移到建立者 ATA，兩個建立者計數器被歸零，recent_epoch 被更新。當兩個計數器都為零時返回 NoFeeCollect。

`UpdatePoolStatus`

暫停或恢復池上的個別操作。status 欄位是一個位元遮罩：

位	旗標	設定時的效果
0	`DEPOSIT_DISABLED`	`Deposit` 以 `NotApproved` 拒絕。
1	`WITHDRAW_DISABLED`	`Withdraw` 拒絕。
2	`SWAP_DISABLED`	`SwapBaseInput` / `SwapBaseOutput` 拒絕。

參數

status: u8      // 新位元遮罩

帳戶

#	名稱	W	S	備註
1	`authority`		S	必須符合 CPMM 程式上的管理員鑰匙。
2	`pool_state`	W

管理員鑰匙是編譯到程式中的公鑰（crate::admin::ID），而不是 BPF 升級授權 — 改變它需要程式升級。參閱 reference/program-addresses 以獲取值，以及 security/admin-and-multisig 以了解誰持有它。

`CreateAmmConfig`

建立新的費用層級。參數

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

帳戶

#	名稱	W	S	備註
1	`owner`	W	S	管理員。
2	`amm_config`	W		在此 `init`。
3	`system_program`

前置條件

沒有具有相同 index 的現有 AmmConfig。
protocol_fee_rate + fund_fee_rate <= FEE_RATE_DENOMINATOR_VALUE。

在 2026-09 中改變：新設定的費用所有者不再來自簽署者。 create_amm_config 現在將程式的硬編碼 protocol_fee_owner::ID 寫入 protocol_owner 和 fund_fee_owner::ID 寫入 fund_owner，而不是將管理員簽署者的鑰匙複製到兩者。地址在 reference/program-addresses。後果：新建立的 AmmConfig 上的費用落入專用費用錢包，而不是管理員的。管理員確實仍然是收集的接受簽署者 — CollectProtocolFee / CollectFundFee 接受 amm_config.protocol_owner / fund_owner 或 crate::admin::ID — 所以沒有什麼必須旋轉來清掃；改變的只是預設情況下收益去向的位置。現有 AmmConfig 帳戶不被重寫 — 無論在它們上儲存什麼仍然管理，所以始終從帳戶讀取 protocol_owner / fund_owner 而不是假設任一值。UpdateAmmConfig 參數 3 和 4 仍然旋轉它們。

`UpdateAmmConfig`

改變現有 AmmConfig 上的費率或所有權。採用 param: u8（要更新的欄位）和 value: u64。完整分派表：

param = 0 → trade_fee_rate（斷言 trade_fee_rate + creator_fee_rate < 1_000_000）
param = 1 → protocol_fee_rate（斷言 ≤ 1_000_000 和 + fund_fee_rate ≤ 1_000_000）
param = 2 → fund_fee_rate（斷言 ≤ 1_000_000 和 + protocol_fee_rate ≤ 1_000_000）
param = 3 → protocol_owner。新鑰匙不在 value 中：將其附加為 remaining_accounts[0]（唯讀沒問題）。它不能是預設公鑰，省略帳戶會在 unwrap() 上恐慌。
param = 4 → fund_owner。與 3 相同的機制。
param = 5 → create_pool_fee
param = 6 → disable_create_pool（任何非零 value 禁用）
param = 7 → creator_fee_rate（斷言 creator_fee_rate + trade_fee_rate < 1_000_000）
param = 8 → creator_fee_share_rate（斷言 ≤ 1_000_000）。新增於 2026-09-19。協議在此層級上建立者費用的預設份額；參閱 products/cpmm/fees。它與 protocol_fee_rate 無關，後者分割交易費用。

任何其他 param 返回 InvalidInput。變更由管理員簽署並影響綁定到此 AmmConfig 的每個池在下一次交換時。沒有遷移；池簡單地讀取新值。

`CreateCreatorFeeShare`

為一個 (creator, amm_config) 對設定自訂協議份額的建立者費用，覆蓋 AmmConfig.creator_fee_share_rate 用於該費用層級上該建立者擁有的每個池。新增於 2026-09-19 建立者費用份額升級。參數

share_rate: u64   // 協議在建立者費用中的份額，超過 FEE_RATE_DENOMINATOR = 1_000_000

帳戶

#	名稱	W	S	備註
1	`owner`	W	S	必須是 CPMM 程式管理員或專用建立者費用份額所有者 — 參閱 `reference/program-addresses`。任何其他簽署者失敗，出現 `InvalidOwner`（`6001`）。支付租金。
2	`creator`			費率適用的池建立者。未檢查 — 它不必是現有池建立者，也不簽署。
3	`amm_config`			費率適用的費用層級。
4	`creator_fee_share`	W		在 `["creator_fee_share", creator, amm_config]` 處 `init`，`space = 145`。
5	`system_program`

前置條件

share_rate <= 1_000_000，否則 InvalidInput（6003）。
PDA 不能已存在 — Anchor 的 init 在同一對的第二次呼叫時失敗。要改變費率，關閉帳戶並重新建立。

後置條件

creator_fee_share 儲存 bump、creator、amm_config 和 share_rate。
在該費用層級上由 creator 建立的池上的每個後續 CollectCreatorFee / CollectCreatorFeePermissionless 從此帳戶解析份額，而不是設定。

池建立者不是此指令的一方，也不簽署它。費率在收集時讀取，所以在費用已經累積後建立的覆蓋也適用於該累積餘額。

`CloseCreatorFeeShare`

移除覆蓋。該對回退到 AmmConfig.creator_fee_share_rate。參數 — 無。帳戶

#	名稱	W	S	備註
1	`owner`	W	S	與 `CreateCreatorFeeShare` 相同的兩個接受簽署者；接收租金。
2	`creator`			費率適用的池建立者。
3	`amm_config`			費率適用的費用層級。
4	`creator_fee_share`	W		關閉到 `owner`。必須是該對的規範 PDA。
5	`system_program`

後置條件

帳戶被關閉，其 lamports 去往 owner。
該對的收集再次從 amm_config.creator_fee_share_rate 解析份額 — 除非管理員已設定 UpdateAmmConfig 參數 8，否則為 0。

`CollectExcessLamports`

管理員清掃 CPMM 控制的帳戶上超過租金豁免最低額的 lamports。新增於 2026-09 升級，以便協議可以回收 SIMD-0437 租金減少在每個步驟之前建立的帳戶上留下的過度資金。只有超額移動。代幣餘額、帳戶資料、所有者、池狀態和曲線保持不變，指令對已在其最低值的帳戶是無操作 — 所以在每個推出步驟後重新執行是安全的。參數 — 無。帳戶

#	名稱	W	S	備註
1	`collect_lamports_wallet`	W	S	每個清掃 lamport 的目標。必須是 CPMM 程式管理員或專用收集 lamports 錢包 — 參閱 `reference/program-addresses`。任何其他簽署者失敗，出現 `InvalidOwner`。
2	`authority`			CPMM 保管庫和 LP 鑄幣廠授權 PDA，種子 `[b"vault_and_lp_mint_auth_seed"]`。它簽署代幣程式 CPI。
3	`token_program`			SPL Token。
4	`token_program_2022`			Token-2022。兩者都無條件要求；程式按來源帳戶選擇。
5..	`remaining_accounts`	W		`M` 個要清掃的來源帳戶，任何數量，任何順序。

排序修復，2026-09-19。 程式現在對 remaining_accounts 進行兩次傳遞 — 每個代幣程式 CPI 首先，然後是 CPMM 擁有的 PDA 的直接借記。當 PDA 在 CPI 之前被借記時，它們會中止，出現執行時的 UnbalancedInstruction（「指令前後帳戶餘額總和不匹配」），因為呼叫者的待處理 lamport 變更只在 CPI 實際執行時才被刷新到帳戶。呼叫者不必自己對清單進行分組或排序。

每個來源帳戶的處理方式 程式根據來源帳戶的 owner 進行分派：

來源帳戶所有者	處理
SPL Token 或 Token-2022，非原生代幣帳戶或鑄幣廠 — 池保管庫和 LP 鑄幣廠	CPI `WithdrawExcessLamports`（代幣程式判別器 `38`），由 `authority` 簽署。
SPL Token 或 Token-2022，原生（wSOL）代幣帳戶	`WithdrawExcessLamports` 拒絕原生帳戶。程式 CPI `SyncNative`，測量包裝 `amount` 增長了多少，`UnwrapLamports`（判別器 `45`）正好是那個增量，然後要求包裝餘額等於其預同步值 — 否則 `LamportsCalculateError`（`6015`）。SOL 側池保管庫因此保持其完整流動性。
CPMM 程式本身 — `PoolState`、`AmmConfig`、`ObservationState`、`Permission`、`SupportMintAssociated`	程式直接將帳戶借記到 `rent.minimum_balance(data_len)`。
任何其他	無聲跳過。沒有錯誤，沒有 lamports 移動。

因為它採用無界 remaining_accounts 清單，交易大小是真正的限制 — 與 solana-fundamentals/rent-and-reclaimable-rent 中描述的錢包側清掃相同的約束。 常見錯誤 — InvalidOwner（6001，錯誤簽署者）、LamportsCalculateError（6015，wSOL 往返沒有淨為零）和 InsufficientFunds 來自程式擁有的路徑，當帳戶持有少於其自己的租金最低額時。 沒有 SDK 構建器。 @raydium-io/raydium-sdk-v2 不提供此指令的構建器，raydium-sdk-V2-demo 儲存庫也不提供 — 它是管理員路徑。手動編碼，就像 solana-fundamentals/rent-and-reclaimable-rent 中的錢包側清掃對代幣程式指令所做的那樣。

狀態變更矩陣

指令	`lp_supply`	保管庫餘額	累積費用欄位	`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` 分割為協議/基金；+ `creator_fee`（如果啟用）	+（如果間隔已過）
`SwapBaseOutput`	—	+ in, − out	+ `trade_fee` 分割為協議/基金；+ `creator_fee`（如果啟用）	+（如果間隔已過）
`CollectProtocolFee`	—	−（按協議桶）	`protocol_*` → 0	—
`CollectFundFee`	—	−（按基金桶）	`fund_*` → 0	—
`CollectCreatorFee`	—	−（僅按建立者部分）	`creator_` → 0；`protocol_` += 共享部分	—
`CollectCreatorFeePermissionless`	—	−（僅按建立者部分）	`creator_` → 0；`protocol_` += 共享部分	—
`UpdatePoolStatus`	—	—	—	—
`CreateCreatorFeeShare`	—	—	—	—
`CloseCreatorFeeShare`	—	—	—	—
`CollectExcessLamports`	—	—（代幣餘額不變）	—	—

下一步去哪裡

products/cpmm/code-demos — 上述的可執行 TypeScript 範例。
reference/error-codes — 完整的 Anchor 錯誤表。
products/cpmm/fees — Collect*Fee 指令排出的費用累積模型。

來源：

產品

演算法

指令摘要

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

狀態變更矩陣

下一步去哪裡

​指令摘要

​Initialize

​Deposit

​Withdraw

​SwapBaseInput

​SwapBaseOutput

​CollectProtocolFee

​CollectFundFee

​CollectCreatorFee

​CollectCreatorFeePermissionless

​UpdatePoolStatus

​CreateAmmConfig

​UpdateAmmConfig

​CreateCreatorFeeShare

​CloseCreatorFeeShare

​CollectExcessLamports

​狀態變更矩陣

​下一步去哪裡

指令摘要

`Initialize`

`Deposit`

`Withdraw`

`SwapBaseInput`

`SwapBaseOutput`

`CollectProtocolFee`

`CollectFundFee`

`CollectCreatorFee`

`CollectCreatorFeePermissionless`

`UpdatePoolStatus`

`CreateAmmConfig`

`UpdateAmmConfig`

`CreateCreatorFeeShare`

`CloseCreatorFeeShare`

`CollectExcessLamports`

狀態變更矩陣

下一步去哪裡