バージョンと移行

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は5年の歴史があります。その複数のプログラムは3世代目または4世代目にあります。このページはオペレータの視点から「どのプログラムバージョンを使うべきか、古いバージョンのステータスはどうなっているか、今日古いバージョンで運用していれば、AからBへどのように移行するか」という問いに答えます。

​

概況

この表から最も重要な結論は1つです。AMM v4は廃止予定ではなく、CPMMが新しいデフォルトですが、意図的に共存しています。AMM v4プールは数年分の取引履歴があり、強制的に移行されることはありません。新しいプールをどのプログラムで起動するかは、推奨事項であって制約ではありません。

​

AMM v4 — ステータスと方向性

AMM v4は元々のRaydiumプール設計：定積自動マーケットメイカー（x · y = k）です。OpenBook（旧Serum）オーダーブックとの統合を特徴とするハイブリッドAMMとして起動しました。曲線の一部を関連するマーケットのリミットオーダーとして反映していました。OpenBook統合はその後無効化されました — プールはOpenBookとリクイディティを共有しなくなり、すべてのスワップはV2スワップエンドポイントを経由して曲線に対して純粋に実行されます。今日のAMM v4は、実質的には不活性な状態として保持されているOpenBookアカウントを備えた純粋な定積AMMです。

​

凍結されたもの

• 新しい手数料階層はありません。 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サポート、小さなトランザクション足跡。

​

AMM v4に対するCPMMの利点

• デフォルトでより良いLPエコノミクス。 CPMMのデフォルトAmmConfigは取引手数料の100%をLPにルーティングします（プロトコル手数料は階層ごとにオンオフ可能）。AMM v4はプロトコルへ約12%をハードコードしています。
• 低いプール作成コスト。 OpenBookマーケットは不要です。作成は1トランザクション、約0.15 SOLのレント対v4の約0.6 SOL。
• Token-2022。 転送手数料ミント、転送フックミント（注意点あり）、機密転送 — すべてCPMMでサポート、v4ではありません。
• よりクリーンなインテグレータ表面。 CPMMはAnchor-CPI対応の公開クレート（raydium-cp-swap）、シンプルなアカウントリスト、安定したIDLを持っています。AMM v4はIDLを出荷していますが、メンテナンスされたRust CPIクレートはありませんでした。
• スワップごとのアカウントリストが小さい。 10アカウント対v4の17（OpenBookマーケットアカウントを使用しない場合でも繰り越すもの）。

​

移行が価値のある場合

アクティブに取引されているプール場合、LPフィーの上昇だけで通常数ヶ月以内に移行を正当化します。算術：日次ボリューム$Xで0.25%を稼いでいるプールはv4でプロトコルに0.03%を与えます（欠落している12%）。CPMMではそれはLPに戻ります。1年にわたれば、それはかなり複合化します。 低ボリュームプールの場合、移行はより将来への防衛に関するもの — より良いデフォルト、必要に応じてToken-2022サポート、より簡単な統合。

​

移行の仕組み

インプレースアップグレードはありません。移行は新規プール作成、旧プール排出、新規プール再注入シーケンスです。完全なステップバイステップはuser-flows/migrate-amm-v4-to-cpmmにあります；高水準の形状：

1. 同じペア、同じ手数料階層でCPMMプールを新規作成します。
2. LPを調整：旧プールが排出され新プールにシード提供される期間の発表。
3. 各LPがv4プールから引き出し、新CPMMプールにデポジット。
4. （オプション）新プールへのインセンティブLP取得を促すためにCPMM側ファームをセットアップ。
5. より深いプールへの重み付け変更のようにボリュームが移行していくのを監視。

チェーン自体はこれのいずれも強制しません — RaydiumのAPIとフロントエンドはより深いプールを優遇し、アグリゲータはユーザーにとって最も安いものを経由します。

​

CLMM — 単一プログラム、バージョン全体で安定

CLMMは最初のプログラムバージョンです。v2はありません — 改善は新しい世代ではなく、同じプログラムIDへのインプレースアップグレード（24h時間ロック付きマルチシグの背後）として出荷されました。 つまり、CLMMマイグレーションストーリーはありません：既存ポジションは存在する場所に留まり、プログラムの動作はアップグレードが出荷されると微妙に変わる可能性がありますが、アカウントレイアウトとPDAは安定しています。 CLMMアップグレード全体で変わったもの：

• SwapV2命令はToken-2022転送手数料計算を正しくサポートするために追加されました。旧Swapはまだ呼び出し可能です；新規統合はSwapV2をターゲットにすべき。
• 報酬ストリーム拡張 — RewardInfoスロットカウントがバンプされました（元の3→現在も3ですが、予約パターンは厳しくされました）。データ移行は必要ありません。
• ティック配列圧縮 — 多くのティックを横切るスワップでCUを削減するための内部最適化。外部的には不可視。

IDLは専用のraydium-idlリポジトリに存在します（sdk-api/anchor-idl参照）。古いSDKで現在のプログラムに対して実行している場合、最悪のケースは新しい命令が不足することです。

​

Farm v3 → v5 → v6

すべてのRaydiumプログラムの中で、Farmは最も明示的なバージョン履歴と唯一の強制移行パスを持っています。3つの世代は異なるプログラムID and 異なる状態レイアウトの別々のプログラムです。

​

世代

​

なぜ3つの世代が存在するのか

• v3 → v5：複数の同時報酬ストリームが必要でした（例：デュアルインセンティブファーム）。v3の単一ストリーム設計は再設計なしに対応できませんでした。
• v5 → v6：v5のu64整数排出レートは表現可能な最小レートを「1トークンユニット毎秒」でキャップします。9小数ミントの場合、それは1ラムポート/秒 — 低排出プログラムには粗すぎます。v6のQ64.64分数レートはこれを修正します。v6はスロットベース更新をウォールクロックに引き上げ、Token-2022サポートも追加しました。

​

世代全体で変わらないもの

• 「LPをデポジット、シェア当たりカウンターを獲得、引き出し時にクレイム」会計パターンはv3/v5/v6全体で同一です。数学は変わりません；レートカウンターの精度とサポートされるストリーム数のみ。
• UserStake（v3/v5）とUserLedger（v6）は概念的に同じレコード、異なるレイアウト。SDKは両方を正規化します。

​

移行パス

ファームバージョン間のインプレース移行はありません。v3/v5からv6に移行するには：

1. 既存ファームの排出が終わるまで待つ（またはそれらを実行する）。
2. ステーカーが旧ファームで引き出し、保留中報酬をクレイム。
3. ファームオペレータが同じステーキングミントに対してv6ファームを新規作成。
4. ステーカーが新ファームに再ステーク。

オンチェーンの現実は2つの無関係なファームアカウント。両方にステークがあるユーザーは2つの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のように、改善は24h時間ロックの背後でインプレースアップグレードとして出荷されます — 新しい世代ではなく。 アップグレード全体で進化したもの：

• クリエータ手数料スロット。 ローンチがグラデーション後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ミントを持つことはありません。 1つを見た場合、偽物です — 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。