> ## 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.

# 版本和遷移

> Raydium 每個程序的發布版本歷史、各代的棄用狀態，以及在版本之間的實用遷移路徑。

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

  [查看英文版 →](/protocol-overview/versions-and-migration)
</Info>

<Info>
  Raydium 已運行了五年。其中多個程序已進行到第三或第四代。此頁面從運營者的角度說明「我應該使用哪個程序版本、舊版本的狀態如何，以及如果我目前運行舊版本，如何從 A 遷移到 B」。
</Info>

## 速覽狀態

| 程序            | 當前版本   | 已棄用   | 新部署          | 現有實例               |
| ------------- | ------ | ----- | ------------ | ------------------ |
| **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`](/zh-Hant/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`](/zh-Hant/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`](https://github.com/raydium-io/raydium-idl/blob/master/raydium_clmm/raydium_clmm.json) 存儲庫（見 [`sdk-api/anchor-idl`](/zh-Hant/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`](/zh-Hant/products/farm-staking/accounts) 和 [`products/farm-staking/instructions`](/zh-Hant/products/farm-staking/instructions)。

## LaunchLab——單一程序，不斷演進的配置

LaunchLab 在其第一個程序版本上。像 CLMM 一樣，改進作為 24 小時時間鎖定後的原地升級發送——而非新代。

通過升級演進的內容：

* **創建者費用槽。** 添加以便啟動可將畢業後 CPMM 交易費用的一部分路由到原始創建者。見 [`products/launchlab/creator-fees`](/zh-Hant/products/launchlab/creator-fees)。
* **曲線公式可配置性。** 原始硬編碼二次；現在 `LaunchConfig` 從一小組曲線形狀中選擇。

現有 LaunchLab 啟動不受升級影響——一旦啟動初始化，其參數在畢業前凍結。

## 跨程序版本兼容性

集成者經常遇到的幾個跨產品兼容性注意事項：

* **CLMM `SwapV2` 與 `Swap` 不同指令。** 如果你的客戶端僅使用 `Swap`，它將以沉默的方式誤處理 Token-2022 轉賬費用——數學相差費用金額。更新為 `SwapV2`。
* **Farm v6 質押與 CLMM 頭寸**不以 LP 代幣質押的方式支持。CLMM 頭寸是 NFT，而非可互換 LP 代幣。CLMM 有自己的原生獎勵機制——見 [`products/clmm/fees`](/zh-Hant/products/clmm/fees)。
* **由 Token-2022 鑄幣支持的 CPMM 資金池在農場中僅在 Farm v6 上工作。** v3 和 v5 拒絕 Token-2022 質押鑄幣。
* **AMM v4 資金池從不具有 Token-2022 LP 鑄幣。** 如果你看到一個，它是假的——AMM v4 不支持該組合。

## 進一步閱讀

* [`introduction/history-and-milestones`](/zh-Hant/introduction/history-and-milestones) ——時間順序發布時間軸和每個版本何時推出的原因。
* [`user-flows/migrate-amm-v4-to-cpmm`](/zh-Hant/user-flows/migrate-amm-v4-to-cpmm) ——v4 → CPMM 移動的運營手冊。
* [`user-flows/choosing-a-pool-type`](/zh-Hant/user-flows/choosing-a-pool-type) ——新資金池部署的決策樹。
* [`products/farm-staking/accounts`](/zh-Hant/products/farm-staking/accounts) ——v3 / v5 / v6 並排模式。
* [`reference/changelog`](/zh-Hant/reference/changelog) ——隨著程序版本演進，此文檔中改變了什麼。

來源：

* 上述內聯引用的按產品章節頁面。
* [Raydium SDK v2](https://github.com/raydium-io/raydium-sdk-V2) ——版本感知分派邏輯確認給定資金池屬於哪個程序。
* [`reference/program-addresses`](/zh-Hant/reference/program-addresses) ——每個版本的規範 ID。