版本與遷移

Raydium 各程式的發行版本歷史、各代的棄用狀態，以及版本間的實際遷移路徑。

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

查看英文版 →

Raydium 已運行五年。其中幾個程式已進入第三或第四代。本頁從運營者的角度說明「我應該使用哪個程式版本、舊版本的狀態如何，以及如果我目前運行舊版本，該如何升級」。

​

狀態一覽

程式	目前版本	已棄用	新部署	現有實例
AMM v4	v4（單一代）	否	不建議但接受	完全可運作
CPMM	v1	—	建議預設	完全可運作
CLMM	v1	—	建議用於範圍流動性提供者	完全可運作
Farm	v6	v3、v5	僅 v6	v3 + v5 逐步淘汰中（主要為唯讀）
LaunchLab	v1	—	建議用於新啟動	完全可運作

此表最重要的結論：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 年許多高交易量交易對的活躍場所。
• 流動性提供者可以照常存入、提取和收穫農場獎勵。 遷移至 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 的優勢

• 預設流動性提供者經濟學更佳。 CPMM 的預設 AmmConfig 將 100% 的交易費路由給流動性提供者（協議費可按層級切換）。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 市場帳戶也會攜帶）。

​

何時遷移值得

對於交易活躍的池，流動性提供者費用提升本身通常在幾個月內就能證明遷移的合理性。算術：一個每日交易量為 $X 的池賺取 0.25$X，在 v4 上給予協議 0.03%（缺少的 12%）。在 CPMM 上，這回到流動性提供者。一年內，這會複利增長。

對於低交易量的池，遷移更多是關於面向未來 — 更好的預設值、如果需要 Token-2022 支援、更容易的整合。

​

遷移如何運作

沒有就地升級。遷移是一個創建新池、排空舊池、填充新池的序列。完整的逐步說明在 user-flows/migrate-amm-v4-to-cpmm；高層形狀：

1. 為相同交易對創建新的 CPMM 池，使用你想保留的相同費用層級。
2. 協調流動性提供者：宣佈一個時間窗口，在此期間舊池被排空，新池被填充。
3. 每個流動性提供者從 v4 池提取並存入新的 CPMM 池。
4. （可選）設置 CPMM 端農場以吸引激勵流動性提供者進入新池。
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 條目。
• CreateCustomizablePoolV2（2026-10-22）：CreatePermissionedPool 被重命名並變為無許可；Permission 帳戶和 CreatePermissionPda / ClosePermissionPda 被移除。調用舊指令的池創建者必須針對新 IDL 重建。無帳戶佈局變化。請參閱 changelog 條目。

IDL 位於專用 raydium-idl 儲存庫（請參閱 sdk-api/anchor-idl）。如果你針對當前程式運行較舊的 SDK，最壞的情況是缺少新指令。

​

Farm v3 → v5 → v6

在所有 Raydium 程式中，Farm 具有最明確的版本歷史和唯一的強制遷移路徑。三代是具有單獨程式 ID 和單獨狀態佈局的單獨程式。

​

代

版本	發佈	狀態	關鍵功能
v3	2021	逐步淘汰。 現有農場運行；不接受新農場。	單一獎勵流。基於槽位的發放。
v5	2022 年 10 月	逐步淘汰。 現有農場運行；不接受新農場。	最多 2 個獎勵流。基於槽位的發放。整數 per_second。
v6	2024	目前。 所有新農場。	最多 5 個獎勵流。牆鐘發放。Q64.64 定點 per_second。Token-2022 質押 + 獎勵支援。

​

為什麼存在三代

• 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。
• 使用 CLMM 部位的 Farm v6 質押 不支援 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。