版本和迁移

​

一览表

这个表格最重要的一点：AMM v4 未被弃用，CPMM 是新的默认选项 —— 但它们是有意共存的。AMM v4 池拥有多年的交易历史，不会被强制迁移。选择在哪个程序上启动新池是一个建议，而不是约束。

​

AMM v4 —— 状态和发展方向

AMM v4 是原始的 Raydium 池设计：恒定乘积定价（x · y = k）。它作为混合 AMM 推出，集成了 OpenBook（原 Serum）订单簿，将曲线的部分镜像为绑定市场上的限价单。OpenBook 集成已被停用 —— 池不再与 OpenBook 共享流动性，所有交换纯粹通过 V2 交换端点针对曲线执行。如今 AMM v4 实际上是一个纯恒定乘积 AMM，OpenBook 账户保留为惰性状态。

​

冻结的内容

• 不再新增费用等级。 AMM v4 费用结构是按池设置的，在部署时确定。新池接受相同的硬编码 ~0.25% 交易费，~12% 流向协议。
• 无新功能开发。 自 CPMM 成为新默认选项以来，团队未向 AMM v4 添加新指令。该程序处于维护模式 —— 仅修复错误，不扩展功能。
• 不支持 Token-2022。 AMM v4 在 Token-2022 出现之前编写，集成从未进行过改造。Token-2022 铸币必须使用 CPMM（或在适当情况下使用 CLMM）。
• OpenBook 集成已停用。 每个 AMM v4 池仍然绑定到链上对应的 OpenBook 市场账户，但池不再在该市场上发布或维护订单。OpenBook 中断不再影响 AMM v4 交换。

​

仍在工作的内容

• 现有池正常交易。 未强制进行状态迁移；2021 年创建的 v4 池仍然是 2026 年许多高交易量交易对的活跃场所。
• LP 可以照常存入、提取和收获农场奖励。 迁移到 CPMM 是可选的。
• 聚合器仍然通过它路由。 Jupiter 和 Raydium Trade API 都将 v4 池作为一流场所进行索引。

​

何时仍使用 AMM v4

坦白说：很少。v4 是更好答案的情况很少：

• 该交易对已经有一个深度良好、交易活跃的 v4 池，你想向现有深度添加流动性而不是分割市场。

（OpenBook 集成路由不再是选择 AMM v4 的理由 —— 该集成已关闭。） 在所有其他情况下，在 CPMM 上启动新池。 查看 user-flows/choosing-a-pool-type 了解完整的决策树。

​

CPMM —— 采用曲线和 v4 → CPMM 迁移

CPMM（恒定乘积做市商，内部名称 raydium-cp-swap）在 2024 年部署，是一个干净的重写，旨在成为新的默认恒定乘积池。它在结构上是 Raydium 程序中最简单的：纯 x · y = k，无订单簿，原生 Token-2022 支持，更小的交易足迹。

​

CPMM 相比 AMM v4 的优势

• 默认 LP 经济学更好。 CPMM 的默认 AmmConfig 将 100% 的交易费路由给 LP（协议费可按等级切换）。AMM v4 硬编码 ~12% 流向协议。
• 更低的池创建成本。 无需 OpenBook 市场。创建是一笔交易，~0.15 SOL 租金 vs v4 的 ~0.6 SOL。
• Token-2022。 转账费铸币、转账钩子铸币（有注意事项）、机密转账 —— 所有这些都在 CPMM 上支持，v4 上都不支持。
• 更清晰的集成者接口。 CPMM 有一个 Anchor-CPI 友好的已发布 crate（raydium-cp-swap）、更简单的账户列表和稳定的 IDL。AMM v4 附带 IDL 但从未有过维护的 Rust CPI crate。
• 每次交换的账户列表更小。 ~10 个账户 vs v4 的 ~17 个（即使不使用 OpenBook 市场账户也会携带）。

​

何时迁移值得

对于交易活跃的池，仅 LP 费用提升通常在几个月内就能证明迁移的合理性。算术：一个每日交易量为 $X 的池赚取 0.25$X，在 v4 上给协议 0.03%（缺少的 12%）。在 CPMM 上这部分返回给 LP。一年内，这会产生有意义的复合效应。 对于低交易量的池，迁移更多是关于面向未来 —— 更好的默认值、如果需要的话 Token-2022 支持、更容易的集成。

​

迁移如何工作

没有原地升级。迁移是一个创建新池、排空旧池、填充新池的序列。完整的分步说明在 user-flows/migrate-amm-v4-to-cpmm；高层形状：

1. 为同一交易对创建新的 CPMM 池，使用你想保留的相同费用等级。
2. 协调 LP：宣布一个时间窗口，在此期间旧池被排空，新池被填充。
3. 每个 LP 从 v4 池提取并存入新的 CPMM 池。
4. （可选）设置 CPMM 端农场以吸引激励 LP 到新池。
5. 观察交易量迁移，因为聚合器向更深的池重新加权。

链本身不强制任何这些 —— Raydium 的 API 和前端只是倾向于更深的池，聚合器通过对用户最便宜的路由。

​

CLMM —— 单一程序，版本间稳定

CLMM 处于其第一个程序版本。没有 v2 —— 改进作为对同一程序 ID 的原地升级而发布（在 24 小时时间锁定多签后面），而不是作为新代。 这意味着没有 CLMM 迁移故事：现有头寸保留在原地，程序行为在升级发布时可能会微妙变化，但账户布局和 PDA 是稳定的。 CLMM 升级中已更改的内容：

• SwapV2 指令添加以正确支持 Token-2022 转账费数学。旧的 Swap 仍可调用；新集成应针对 SwapV2。
• 奖励流扩展 —— RewardInfo 槽位计数被提升（原始 3 → 目前仍为 3，但预留模式被收紧）。无需数据迁移。
• Tick 数组压缩 —— 内部优化以减少交换跨越许多 tick 时的 CU。外部不可见。
• Anchor 1.0 重建（2026-09-30）：从 Anchor 0.32.1 迁移到 1.0.2 并添加管理员 CollectExcessLamports。没有用户面向的指令或账户布局更改。查看 changelog 条目。

IDL 存在于专用的 raydium-idl 仓库中（查看 sdk-api/anchor-idl）。如果你使用较旧的 SDK 针对当前程序运行，最坏的情况是缺少新指令。

​

Farm v3 → v5 → v6

在所有 Raydium 程序中，Farm 有最明确的版本历史和唯一的强制迁移路径。三代是具有单独程序 ID 和单独状态布局的单独程序。

​

代

​

为什么存在三代

• v3 → v5：需要多个并发奖励流（例如，双激励农场）。v3 的单流设计无法在不重新设计的情况下支持它。
• v5 → v6：v5 的 u64 整数发放率限制了最小可表达速率为”每秒 1 个代币单位”。对于 9 位小数的铸币，那是 1 lamport/秒 —— 对于低发放程序来说太粗糙了。v6 的 Q64.64 分数速率修复了这个问题。v6 还将基于槽位的更新提升为挂钟，并添加了 Token-2022 支持。

​

各代间保持不变的内容

• “存入 LP、累积每股计数器、在提取时领取”的会计模式在 v3/v5/v6 中是相同的。数学不变；只有速率计数器的精度和支持的流数量不同。
• UserStake（v3/v5）和 UserLedger（v6）在概念上是相同的记录，布局不同。SDK 规范化两者。

​

迁移路径

农场版本间没有原地迁移。要从 v3/v5 迁移到 v6：

1. 等待现有农场的发放结束（或运行完毕）。
2. 质押者在旧农场上提取并领取待处理奖励。
3. 农场运营者针对相同的质押铸币创建新的 v6 农场。
4. 质押者重新质押到新农场。

链上的现实是两个不相关的农场账户。在两个农场中都有质押的用户有两个 UserLedger（v6）/ UserStake（v5）记录。

​

v3 和 v5 的”逐步停用”意味着什么

• v3 和 v5 程序仍然部署且可调用。现有农场仍然可以分配待处理奖励并接受提取。
• Raydium UI 仍然显示具有活跃奖励的 v3 和 v5 农场；一旦 v3/v5 农场的 end_time 通过，UI 将其从”活跃”中隐藏但保持可领取。
• 团队不会创建新的 v3/v5 农场。“创建农场”的 SDK 助手仅路由到 v6。
• v3 和 v5 接收安全升级但不接收功能工作。如果发现关键错误，会修复；如果功能可能有用，会添加到 v6。

每个版本的完整详情在 products/farm-staking/accounts 和 products/farm-staking/instructions。

​

LaunchLab —— 单一程序，演进配置

LaunchLab 处于其第一个程序版本。像 CLMM 一样，改进作为 24 小时时间锁定后面的原地升级而发布 —— 不是作为新代。 通过升级演进的内容：

• 创建者费用槽位。 添加以便启动可以将启动后 CPMM 交易费的一部分路由给原始创建者。查看 products/launchlab/creator-fees。
• 曲线公式可配置性。 原本硬编码为二次；现在 LaunchConfig 从一小组曲线形状中选择。

现有的 LaunchLab 启动不受升级影响 —— 一旦启动被初始化，其参数在毕业前被冻结。

​

跨程序版本兼容性

集成者经常遇到的几个跨产品兼容性注意事项：

• CLMM SwapV2 与 Swap 指令不同。 如果你的客户端仅支持 Swap，它会无声地误处理 Token-2022 转账费 —— 数学错误了费用金额。更新到 SwapV2。
• Farm v6 质押与 CLMM 头寸不像 LP 代币质押那样受支持。CLMM 头寸是 NFT，不是可互换的 LP 代币。CLMM 有自己的原生奖励机制 —— 查看 products/clmm/fees。
• 由 Token-2022 铸币支持的 CPMM 池仅在 Farm v6 上的农场中工作。 v3 和 v5 拒绝 Token-2022 质押铸币。
• AMM v4 池从不有 Token-2022 LP 铸币。 如果你看到一个，它是假的 —— AMM v4 不支持该组合。

​

阅读更多内容

• introduction/history-and-milestones —— 时间顺序发布时间表和每个版本何时推出的原因。
• user-flows/migrate-amm-v4-to-cpmm —— v4 → CPMM 迁移的运营者手册。
• user-flows/choosing-a-pool-type —— 新池部署的决策树。
• products/farm-staking/accounts —— v3 / v5 / v6 的并排模式。
• reference/changelog —— 随着程序版本演进，本文档中发生了什么变化。

来源：

• 上面内联引用的各产品章节页面。
• Raydium SDK v2 —— 版本感知调度逻辑确认给定池属于哪个程序。
• reference/program-addresses —— 每个版本的规范 ID。