このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →
このページはドキュメントの唯一の正規アーキテクチャ図です。 他のすべての章はシステムを再描画するのではなく、ここにリンクバックします。プログラムIDはこのページに埋め込まれていません。
reference/program-addressesに存在するため、正確に1か所で更新できます。Raydiumの実態
Raydiumは1つのプログラムではありません。Solana上の独立したオンチェーンプログラムのセットであり、共通のオフチェーン基盤（REST API、TypeScript SDK、IDLレジストリ）と少数の規約（オーソリティPDA、フィー設定アカウント、管理マルチシグ）を共有しています。ユーザーインタラクション（スワップ、デポジット、ファーム報酬の請求）は、これらのプログラムのいずれか1つにルーティングされます。オフチェーン基盤があるからこそ、それらが1つの製品のように感じられるのです。 オンチェーンフットプリントは4種類のプログラムに分類されます：- AMMプログラム — 4つの独立したプールプログラム、それぞれ独自のフォーマットと価格設定ロジックを持つ：
- AMM v4 — オリジナルの定積AMMです。当初はOpenBook（旧Serum）マーケットにカーブをミラーリングするハイブリッド設計でしたが、OpenBook統合はその後無効化され、プールは現在曲線に対する純粋なAMMとして動作します。多くの主要ペアで最も流動性が深いベニューです。
- CPMM — Solana上にネイティブに構築された単純な定積AMM（
x · y = k）で、Token-2022の第一級サポートを備えています。新しい定積プールに推奨されるプログラムです。 - CLMM — Uniswap v3スタイルの集中流動性AMM。流動性は価格範囲に提供され、フィーはポジションごとに発生し、状態はティックと
sqrt_price_x64を中心に構成されます。 - Stable AMM — ルーターがステーブルコイン相関ペアに使用する薄い流動性のStableSwapスタイルプログラム（AMM v4からフォークされ、ルックアップテーブル価格曲線を使用）。現在、UIでは第一級のプール作成オプションとして表示されていません。
- 報酬分配 — Farm（v3 / v5 / v6、v6がアクティブ世代、v3/v5は段階的廃止のみ）。
- トークンローンチ — LaunchLab、ボンディングカーブプログラム。新しく初期化されたローンチはCPMMに卒業します。レガシーAMM v4マイグレーション命令は既存のローンチ状態用に残されています。
- 流動性プリミティブ — AMMルーティング（4つのAMMプログラムにCPIする単一トランザクション内のオンチェーン複数プールルーター）およびLP-Lock / Burn & Earn（LPポジションをロックしながらフィー請求を開いたままにする）。
正規ダイアグラム
このダイアグラムが捉えている主要な不変量：- AMMプログラムはピアです。 CPMMはCLMMに呼び出しません。CLMMはAMM v4に呼び出しません。Stable AMMは独立したプログラムです。1つのプール上の直接スワップは、正確に1つのAMMプログラムに接触します。複数のAMMを単一トランザクション内で構成する唯一のプログラムはAMMルーティングであり、ルートがプールタイプを横切る場合、必要に応じてAMM v4 / CPMM / CLMM / Stable AMMにCPIします。
- SDKとTransaction APIは構成レイヤーであり、プログラムではありません。 Web UIまたはアグリゲーターが「3つのプールを通じたスワップ」トランザクションを構築する場合、SDK（クライアント側）またはTransaction API（サーバー側）は、REST APIから取得した見積もりを使用して命令を一緒に縫い合わせます。チェーンは、N個の命令を持つ単一のSolanaトランザクションを見ます。オーケストレータープログラムが全体のフローを所有することはありません。
- AMM v4のOpenBook配線は無効です。 AMM v4はOpenBookにバインドされた唯一のAMMでしたが、統合は無効化されました。プールはもはやOpenBookに流動性を共有せず、
MonitorStepはもはやクランクされず、OpenBookの停止は現在のスワップトラフィックに影響を与えません。マーケットアカウントは後方互換性のためプールのAmmInfoに残りますが、未使用の状態を参照します。CPMM、CLMM、およびStable AMMはCLOB依存性を持ったことがありません。 - 新しいLaunchLabプールはCPMMに卒業します。 初期化には
migrate_type = CPSWAPが必要です。MigrateToAmmは既存のレガシー状態用に残されています。2026-08-17アップグレード前、CPMMマイグレーションはcreator_scaleをクリエイター用に別途ロックしました。その後に実行されたマイグレーションは、それをplatform_scaleと組み合わせて、1つのプラットフォーム所有のロックLP位置にします。以前のFee Keyは変更されません。 - LP-Lockはラッパーであり、5番目のAMMではありません。 これはクリエイターの代わりにPDAの下でLPポジションを保持するため、基礎となるフィーは流動性を引き出す能力を公開することなく請求できます。これはCPMMおよびCLMMプール上に構成されます。
- オフチェーン基盤は相互に補完します。 REST APIはキャッシング付きの読み取り専用です。Transaction APIはサーバー側で署名準備完了トランザクションを構築します。SDKはクライアント側で構築します。3つすべてが同じIDLレジストリをスキーマの真実のソースとして依存しています。
データフロー：CPMMスワップ、エンドツーエンド
図を具体的にするために、ユーザーがRaydium UIからCPMMプール上でUSDC → RAYをスワップするときに何が起こるかを示します。（AMM v4とCLMMは必要なアカウントが異なりますが、高レベルの形状は異なりません。）- 見積もりリクエスト（オフチェーン）。 UIは
GET https://api-v3.raydium.io/compute/swap-base-inを入力ミント、出力ミント、金額、およびスリッページ許容度で呼び出します。APIはインデクサーを参照し、ルート（複数のプールを通じた可能性がある）を選択し、見積もりとクライアントが必要とするプログラムID、プールID、およびフィーアカウントのリストを返します。 - トランザクション構築（クライアント + SDK）。 クライアントは見積もりを
raydium-sdk-v2に渡します。SDKは必要なすべてのPDA（オーソリティPDA、プール状態、オブザベーション、ボルト —products/cpmm/accountsを参照）を解決し、ユーザーの関連トークンアカウントを注入し（不足している場合は関連トークンプログラムで作成）、未署名のTransactionを発行します。 - ウォレット署名。 ユーザーのウォレットがトランザクションに署名します。ここにRaydium固有のものはありません。これは標準的なSolanaウォレットフローです。
- オンチェーン実行。 署名されたトランザクションはRaydium CPMMプログラムにヒットします。これは（a）プール状態を検証し、（b）プールのフィー設定で定積曲線を適用し、（c）SPL Token / Token-2022へのCPIを介してユーザーのATAとプールボルト間でトークンを移動し、（d）TWAPの
observationアカウントを更新し、（e）返します。 - インデクサー取り込み。 Solana RPC数スロット後、プログラムログを公開します。Raydiumのインデクサーはそれらを解析し、プールのリザーブ、24時間ボリューム、およびAPRを更新し、更新された値を次の
/pools/info/idsリクエストに提供します。
共有インフラストラクチャ
いくつかのプリミティブはすべての製品で使用され、後の章が再定義なしで参照できるように一度名前を付ける価値があります。詳細はprotocol-overview/shared-infrastructureに存在します。これはインデックスです。
オフチェーン基盤：API vs SDK vs IDL
これら3つはしばしば混同されます。それらは異なることを行います：- REST API（
api-v3.raydium.io）はオンチェーン状態の読み取り中心のキャッシュビューと見積もりエンジンです。どのプールが存在するか、リザーブが何であるか、APRがどのように見えるか、スワップの最適なルートが何であるかを教えてくれます。トランザクションを構築しません。 - TypeScript SDK（
@raydium-io/raydium-sdk-v2）はトランザクションビルダーです。すべてのプログラムのアカウントレイアウトと命令フォーマットを知っています。命令を構成する前にRPCから新鮮な状態を取得し（APIからではなく）、正確なトランザクションに署名できるようにします。見積もりが必要な場合にのみAPIと通信します。 - IDLレジストリは、上記の両方が依存するスキーマです。Raydiumプログラムへの Rust CPIを書いている場合、IDLは契約です。TS統合を書いている場合、SDKを通じて間接的にIDLを使用しています。
各章の位置付け
上記のダイアグラムは、ドキュメント全体で縮小形で繰り返されます。各部分の完全な説明がどこに存在するかを示しているため、詳細に掘り下げることができます：- オンチェーンプログラム：
products/の下の製品ごとに1つの章。各章は同じテンプレートに従います（概要 → アカウント → 数学 → 命令 → フィー → コードデモ）。 - 共有クロスプログラムプリミティブ：
protocol-overview/shared-infrastructureおよび繰り返される数学用のalgorithms/（定積、集中流動性、曲線価格設定）。 - オフチェーン基盤：
sdk-api/には完全なSDKおよびREST APIリファレンス、およびsdk-api/anchor-idlとsdk-api/rust-cpiがあります。 - ユーザーレベルのフロー（プール作成、スワップ、LP、報酬請求、トークンローンチ）：
user-flows/。 - 他のチーム向けの統合パターン（アグリゲーター、ウォレット、ボット）：
integration-guides/。 - セキュリティ基盤、管理キー、既知のリスク、監査：
security/。 - バージョン付き変更とAMM v4 → CPMM / Farm v3 → v6マイグレーションストーリー：
protocol-overview/versions-and-migration。
このダイアグラムの非目標
意図的な省略がいくつかあるため、誰もそこにあるもの以上に読み込みません：- 価格オラクルなし。 Raydiumはコア AMM価格設定のためにPyth、Switchboard、または外部オラクルに依存しません。見積もりはオンチェーンリザーブから来ます。
observationアカウントは、他のコントラクトがRaydium TWAPを読み取ることができるように存在します。Raydium自体はそれを必要としません。 - オンチェーントークン投票プログラムなし。 フィー設定更新やプログラムアップグレードなどの管理アクションはマルチシグによって実行されます。マルチシグキーとローテーションポリシーは
security/admin-and-multisigにあります。 - ブリッジなし。 Raydiumはsolana-nativeです。クロスチェーンフローは統合者の問題であり、このダイアグラムの外に存在します。
reference/program-addressesこのページ全体で参照される正規プログラムID用- github.com/raydium-io/raydium-sdk-V2
- github.com/raydium-io/raydium-idl