版本和遷移

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

速覽狀態

此表最重要的結論：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 的優勢

• 更好的默認 LP 經濟學。 CPMM 的默認 AmmConfig 將 100% 的交易費用路由給 LP（協議費用可按層級切換）。AMM v4 硬編碼 ~12% 給協議。
• 更低的資金池創建成本。 無需 OpenBook 市場。創建是一筆交易，~0.15 SOL 租賃費對比 v4 的 ~0.6 SOL。
• Token-2022。 轉賬費用鑄幣、轉賬掛鉤鑄幣（有注意事項）、機密轉賬——所有在 CPMM 上支持，在 v4 上均不支持。
• 更乾淨的集成者界面。 CPMM 有一個 Anchor-CPI 友好的已發佈 crate（raydium-cp-swap）、更簡單的賬戶列表和穩定的 IDL。AMM v4 隨附 IDL，但從未有維護的 Rust CPI crate。
• 每次交換的賬戶列表更小。 ~10 個賬戶對比 v4 的 ~17 個（後者即使不觸及也攜帶 OpenBook 市場賬戶）。

​

何時遷移值得

對於活躍交易的資金池，僅 LP 費用提升通常在幾個月內就值得遷移。其中的算術：一個每天賺取 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。對外部不可見。

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。