CPMM 指令

本页内容由 AI 自动翻译，所有内容以英文版本为准。查看英文版 →

本页是权威的指令参考。如需实际编写这些指令的代码，请参阅 products/cpmm/code-demos。错误代码含义见 reference/error-codes。2026-09 程序升级在 Anchor 1.0.2 / Solana 3.1.10 上重建了 CPMM，添加了管理员指令 CollectExcessLamports，移除了硬编码的 Token-2022 mint 白名单，并改变了 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`	池创建者	从两个 mint 和一个 `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` 或专用支持 mint 所有者	通过创建其 `SupportMintAssociated` PDA 来注册否则会失败扩展允许列表的 Token-2022 mint。
`CloseSupportMintAssociated`	`admin` 或专用支持 mint 所有者	移除 mint 的注册。
`CollectExcessLamports`	`admin` 或专用收集 lamport 钱包	从 CPMM 控制的金库、LP mint 和 PDA 中清扫超过租金豁免最低值的 lamport。添加于 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 mint）。
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 签名。 前置条件

Mint 已排序（token_0_mint < token_1_mint 按字节顺序）。
两个 mint 都不使用 CPMM 允许列表外的扩展（TransferFeeConfig、MetadataPointer、TokenMetadata、InterestBearingConfig、ScaledUiAmount）— 见 products/cpmm/accounts。其 SupportMintAssociated PDA（种子 [b"support_mint", mint]）存在的 mint 跳过扩展检查 — 但你必须将该 PDA 附加到 remaining_accounts。程序仅扫描你传递的账户，从不自己加载 PDA，所以依赖注册表而不提供账户仍会失败，返回 NotSupportMint（6007）。顺序无关紧要（按密钥匹配）；为每个需要绕过的 mint 传递一个条目。该注册表是唯一的绕过，因为 2026-09 升级移除了硬编码的四个 mint 白名单。
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，所以使用该字段，不要替换 mint 的链上供应。如果 sqrt(...) < 100 则回退为 InitLpAmountTooLess。
observation_state 被初始化；observation_index = 0 和 pool_id = pool_state.key()。
create_pool_fee lamport 从创建者转移到接收者并同步为原生 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 — mint 未排序或相同。
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。程序通过匹配 mint 来确定哪个金库是哪个。数学 — 见 products/cpmm/math。 前置条件

open_time <= now。
pool_status 允许交换。
对于此权限，两个 mint 都未暂停或冻结。
amount_in > 0。

常见错误

ExceededSlippage — amount_out < minimum_amount_out。
ZeroTradingTokens — 交易舍入为零。
NotApproved — 池通过 UpdatePoolStatus 暂停交换。
InvalidInput — mint 不匹配池的任一金库 mint。

`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

曲线有效余额没有变化（累积费用已被排除）。 常见错误 — 如果签名者既不是 amm_config.protocol_owner 也不是程序管理员，则 InvalidOwner（6001）。（此路径上没有 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（在分割前检查），如果解析的 share_rate 超过 1_000_000 则 InvalidInput（6003），如果预订份额会溢出 protocol_fees_token_* 则 MathOverflow（6011），以及如果 creator_fee_share 不是规范 PDA 则 Anchor 的 ConstraintSeeds 错误。

`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。
每个后续的 CollectCreatorFee / CollectCreatorFeePermissionless 在由 creator 在 amm_config 下创建的池上从此账户解析份额，而不是配置。

池创建者不是此指令的一方，也不签名。费率在收集时读取，所以在费用已经累积后创建的覆盖适用于该累积余额。

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

后置条件

账户被关闭，其 lamport 去到 owner。
该对的收集再次从 amm_config.creator_fee_share_rate 解析份额 — 除非管理员已设置 UpdateAmmConfig 参数 8，否则为 0。

`CollectExcessLamports`

管理员清扫 CPMM 控制的账户上超过租金豁免最低值的 lamport。添加于 2026-09 升级，以便协议可以回收 SIMD-0437 租金减少在每个步骤后在升级前创建的账户上留下的过度资金。只有超额移动。代币余额、账户数据、所有者、池状态和曲线保持不变，指令对已在最低值的账户是无操作 — 所以在每个推出步骤后重新运行是安全的。参数 — 无。账户

#	名称	W	S	备注
1	`collect_lamports_wallet`	W	S	每个清扫的 lamport 的目标。必须是 CPMM 程序管理员或专用收集 lamport 钱包 — 见 `reference/program-addresses`。任何其他签名者失败，返回 `InvalidOwner`。
2	`authority`			CPMM 金库和 LP mint 权限 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，非原生代币账户或 mint — 池金库和 LP mint	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)`。
其他任何东西	静默跳过。无错误，无 lamport 移动。

因为它接受无界的 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`	+	+ 两者	—	—
`Withdraw`	−	− 两者	—	—
`SwapBaseInput`	—	+ 输入，− 输出	+ `trade_fee` 分割为协议/基金；+ `creator_fee` 如果启用	+ （如果间隔已过）
`SwapBaseOutput`	—	+ 输入，− 输出	+ `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`

状态变化矩阵

后续步骤