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.
このページは AI による自動翻訳です。すべての内容は英語版を正とします。英語版を表示 →
これはドキュメントの変更履歴です。プロジェクト公開以降のページ更新の記録です。プロトコル自体の歴史的なタイムラインについては、
introduction/history-and-milestones をご参照ください。各エントリには日付、影響を受けたチャプターの一覧、変更のトリガー、そしてオンチェーン状態とプログラムソースの照合日が含まれています。未リリース — CLMM:リミットオーダー、片側フィー、ダイナミックフィー
次回の CLMM リリースでは、プールレベルの機能が3つ追加されます。これらはプール作成時にオプトインする方式で、既存のプールおよびポジションとの後方互換性があります。インテグレーター向け TL;DR
- リミットオーダーが CLMM のファーストクラスプリミティブとして追加されました。LP は対応プールでシングルティックオーダーを開くことができ、スワップがそのティックを通過した際に FIFO で約定します。オーナーがオンラインでなくても、オフチェーンキーパー(
limit_order_admin)が約定済み出力を決済できます。7つの新しい SDK メソッド(openLimitOrder、increaseLimitOrder、decreaseLimitOrder、settleLimitOrder、closeLimitOrder、closeAllLimitOrder、settleAllLimitOrder)と、/limit-order/以下の3つの新しい Temp API エンドポイント(アクティブオーダー、ユーザー別履歴、PDA 別イベントログ)でフロー全体をカバーしています。 - **片側フィー(
CollectFeeOn)**により、プールはインプット側からスワップフィーを徴収(レガシー、モード0)、常にtoken_0から徴収(モード1)、常にtoken_1から徴収(モード2)のいずれかを選択できます。ペアの片側が標準の会計トークンである場合に有用です。 - ダイナミックフィーにより、プールはボラティリティトラッキングのサーチャージにオプトインできます。このサーチャージは急速なティック移動に応じて上昇し、時間とともに減衰します。ティアごとの
DynamicFeeConfigとプールごとのDynamicFeeInfoによってキャリブレーションされます。新しい/main/clmm-dynamic-configエンドポイントでティアリストを取得できます。 - 新しいインストラクション
CreateCustomizablePoolにより、プール作成時に上記3つの設定をすべて公開できます。従来のCreatePoolは、デフォルトフィー・リミットオーダーなしのプールに引き続き利用できます。 - インデクサーの破壊的変更:
PoolState上のディレクション別ボリュームカウンター(swap_in_amount_token_{0,1}、swap_out_amount_token_{0,1})および累積フィーカウンター(total_fees_token_{0,1}、total_fees_claimed_token_{0,1})は、fee_onとdynamic_fee_infoの領域を確保するためにパディングに格納されました。これらのフィールドを直接読み取っているインデクサーは、オンチェーンのObservationリングまたは API に移行する必要があります。
これが重要な理由(トレーダー・LP・インテグレーター向け)
- トレーダーは、ロングテールおよびイベント駆動ペアでよりタイトなクオートを得られます。ダイナミックフィーにより、LP がレンジを広げることなく、プールがテイカーからのボラティリティサーチャージを吸収できます。また、リミットオーダーのラダーにより、レンジ全体の資本を投入せずに特定の価格でオンチェーン流動性が深まります。
- LP は、集中レンジとフルレンジポジションに加えて第3の戦略が得られます。特定価格のオーダーをパーキングし、価格がそこに到達したら約定し、クォートトークンに決済できます。約定済み部分については、アクティブなリバランスは不要です。
- インテグレーターはダイナミックフィープールを決定論的にモデル化できます。アルゴリズムとパラメータは完全オンチェーンで、キャリブレーションティアはクエリ可能であり、スワップパスの形状は変わりません(各ステップのフィーのみが変動します)。
プログラムの変更点
新しいアカウント
DynamicFeeConfig— ティアごとのキャリブレーションレコード(フィルター期間、減衰期間、削減係数、ダイナミックフィー制御、最大ボラティリティアキュムレーター)。CreateDynamicFeeConfig(管理者)で作成され、ダイナミックフィーが有効な場合にCreateCustomizablePoolから参照されます。LimitOrderState— オーダーごとのアカウント(PDA シード:[owner, limit_order_nonce, order_nonce])。プール、ティック、サイド、インプット量、未約定比率、FIFO コホートフェーズ、および帳簿管理スナップショットを保持します。ライフサイクルは暗黙的(filled_amountvstotal_amount、およびアカウントの存在):Open → Filled → Settled → Closed。LimitOrderNonce— (owner, nonce_index) ごとに単調増加するカウンターで、リミットオーダー PDA シードを取得します。nonce_index: u8により、同じオーナーが最大256の独立したノンスストリームにオーダーを分割できます。
PoolState の再構成
| フィールドグループ | 旧レイアウト | 新レイアウト |
|---|---|---|
| ディレクション別ボリュームカウンター | swap_in_amount_token_0、swap_out_amount_token_0、swap_in_amount_token_1、swap_out_amount_token_1 | padding5: [u128; 4] に統合 |
| 累積フィーカウンター | total_fees_token_0、total_fees_claimed_token_0、total_fees_token_1、total_fees_claimed_token_1 | padding6: [u64; 4] に統合 |
| 片側フィー | — | fee_on: u8 (0 = FromInput、1 = Token0Only、2 = Token1Only) |
| ダイナミックフィー | — | dynamic_fee_info: DynamicFeeInfo(埋め込み) |
PoolState から Observation リングまたは API に切り替えてください。廃止されたカウンターは既存プールでゼロ化されないため(最後に保持していた値を保持します)、アップグレード後に読み取ると古いデータが返されます。
TickState の追加(破壊的変更なし)
TickState の末尾にある一部のパディングを置き換える形で、末尾に4つの新しいフィールドが追加されます。
order_phase: u64— このティックでのリミットオーダーコホートを区別するカウンター。orders_amount: u64— このティックのすべてのオープンオーダーによってコミットされた合計インプット(すべてが完全に未約定ではありません)。part_filled_orders_remaining: u64— スワップによって現在消費されているコホートで、まだ未約定のインプット。unfilled_ratio_x64: u128— 各オーダーの約定シェアを計算するために使用される Q64.64 比率。
新しいインストラクション
CreateDynamicFeeConfig(管理者) — キャリブレーション済みのDynamicFeeConfigティアを作成します。Authority:CreateAmmConfigと同じトレジャリーマルチシグ。UpdateDynamicFeeConfig(管理者) — 既存ティアのパラメータを更新します。CreateCustomizablePool—collect_fee_on、enable_dynamic_fee、dynamic_fee_configを公開するプール作成エントリーポイントです。CreatePoolと共存し、新しい設定が必要な新規プールにはCreateCustomizablePoolを推奨します。OpenLimitOrder— シングルティックリミットオーダーを開きます。LimitOrderNonceをバンプし、LimitOrderStateを確保し、ティックの FIFO コホートにオーダーを登録します。IncreaseLimitOrder/DecreaseLimitOrder— オーダーの未約定部分を調整します。完全に約定済みのオーダーに対してはInvalidOrderPhaseでリバートします。SettleLimitOrder— 約定済み出力をオーナーの ATA に送信します。呼び出し元はオーナーまたはプールのlimit_order_adminキーパーのいずれかです。CloseLimitOrder— 完全決済済みのオーダーをクローズしてレントを回収します。
SwapV2 の動作変更
スワップパスの形状自体は変わりませんが、処理中に次の3つのことが起こります。
- ダイナミックフィー(有効な場合):各ステップでプールの
DynamicFeeInfoが更新され(減衰 → 蓄積 → 上限)、そのステップのベースフィーにサーチャージが加算されます。 - リミットオーダーマッチング(ステップがオープンオーダーを持つ初期化済みティックを通過する場合):スワップインプットの一部が FIFO でそのティックのコホートを約定するために消費され、
unfilled_ratio_x64がアトミックに更新されます。 - 片側フィールーティング(
fee_on != 0の場合):スワップの方向に関係なく、インプット側からではなくtoken_0またはtoken_1からフィーが徴収されます。
新しいエラーコード
このリリースでErrorCode 列挙型が番号付けし直されました。5つのレガシーバリアント(LOK、ZeroMintAmount、InvalidLiquidity、TransactionTooOld、InvalidRewardDesiredAmount)が削除され、11の新しいバリアントが追加されました。Anchor は列挙型の順序に従って 6000 からエラーに番号を付けるため、削除された位置以降のすべてのエラーコードがシフトしています。数値コードをハードコードしているクライアントは再マッピングが必要です。
新しいコードは以下のとおりです。
6040OrderAlreadyFilled6041InvalidOrderPhase6042InvalidLimitOrderAmount6043OrderPhaseSaturated6044InvalidDynamicFeeConfigParams6045InvalidFeeOn6046ZeroSqrtPrice6047ZeroLiquidity6048MissingBaseFlag6049MissingMintAccount6050MissingTokenProgram2022
SDK の変更点(@raydium-io/raydium-sdk-v2)
raydium.clmmの新しいメソッド:createCustomizablePool、openLimitOrder、increaseLimitOrder、decreaseLimitOrder、settleLimitOrder、settleAllLimitOrder、closeLimitOrder、closeAllLimitOrder。raydium.apiの新しい REST ヘルパー:getClmmDynamicConfigs、getClmmLimitOrderConfigs。- 新しい型:
CollectFeeOn列挙型、DynamicFeeConfig、DynamicFeeInfo、LimitOrderState、LimitOrderConfig。 - 内部再編成:
utils/がlibraries/に移動しました。パッケージのバレルは変わりません。@raydium-io/raydium-sdk-v2/utils/...以下の深いインポートのみ…/libraries/...に更新が必要です。
products/clmm/code-demos にあります。
API の変更点
api-v3—/main/以下に2つの新しいエンドポイント:GET /main/clmm-dynamic-config—DynamicFeeConfigティアのリスト。GET /main/clmm-limit-order-config— プールごとのリミットオーダー設定。
temp-api-v1—/limit-order/以下に3つの新しいエンドポイント:GET /limit-order/order/list?wallet=…— ウォレットの現在パーキング中のオーダー(オープンおよび部分約定済み。インデクサーの Redis キャッシュから提供。totalAmount/filledAmount/pendingSettleで両フェーズをカバー)。GET /limit-order/history/order/list-by-user?wallet=…— ウォレットの過去のリミットオーダー履歴。オプションフィルター:poolId、mint1、mint2、hideCancel。nextPageId/size(最大100)によるカーソルページネーション。GET /limit-order/history/event/list-by-pda?pda=…— 1つまたは複数のカンマ区切りリミットオーダー PDA の PDA ごとのイベントログ(open/increase/decrease/settle/close)。nextPageId/size(最大100)によるカーソルページネーション。
Authority の範囲
limit_order_admin はオフチェーンの運用キーパーであり、マルチシグではありません。既存のオーダーに対して SettleLimitOrder と CloseLimitOrder のみを呼び出すことができ、決済の出力は常にオーナーの ATA に送られます。プールフィールドの変更、オーダーのオープンや変更、その他への署名はできません。管理キーとマルチシグ → CLMM をご参照ください。
更新されたページ
products/clmm/overview— 「新機能」セクションの追加と次のステップへのポインターの更新。products/clmm/accounts— 3つの新しいアカウント、移行警告付きのPoolState再構成、TickStateの追加、新しい PDA ヘルパー。products/clmm/instructions— 7つの新しいインストラクション、SwapV2動作の補足、ステート変更マトリクスの更新。products/clmm/fees— 片側フィーセクション、パラメータテーブル付きのダイナミックフィーセクション。products/clmm/math— リミットオーダーマッチングの疑似コード、ダイナミックフィーの導出。products/clmm/code-demos—createCustomizablePoolデモ、リミットオーダーの完全なウォークスルー、新しい注意点。algorithms/clmm-math— マルチティックスワップループでのリミットオーダーマッチングとダイナミックフィーへのクロスリファレンス。sdk-api/typescript-sdk— CLMM モジュール追加セクション、utils/→libraries/移行ノート。api-reference/openapi/api-v3.yaml— レスポンススキーマ付きの2つの新しいエンドポイント。api-reference/openapi/temp-api-v1.yaml— 3つの新しいリミットオーダーエンドポイント(/limit-order/order/list、/limit-order/history/order/list-by-user、/limit-order/history/event/list-by-pda)とそのリクエスト・レスポンススキーマ。api-reference/api-v3/overview— 新しい CLMM 設定エンドポイントに関するノート。api-reference/temp-api-v1/overview— 新しいアクティブオーダー、ユーザー別履歴、PDA 別イベントエンドポイントに関するノート。reference/error-codes— 11の新しい CLMM エラーコード(6040〜6050)と5つの削除されたレガシーコード。削除ポイント以降の数値コードがシフトしています。security/admin-and-multisig— 新しいDynamicFeeConfig管理者行とlimit_order_adminキーパー行、および制限付き Authority の説明。
raydium-clmmソース。@raydium-io/raydium-sdk-v2ソース。api-v3およびtemp-api-v1ソース。
2026-04-26 — 初回公開
Raydium ドキュメントセットの初回公開リリースです。 照合済み:- Solana mainnet-beta 上のライブプログラムデプロイメント。
@raydium-io/raydium-sdk-v2@0.2.42-alpha。- 2026年4月時点の Raydium 公開ドキュメントおよびオンチェーン参照。
ドキュメントの規約
- バージョニング:このドキュメントはカレンダーベースのバージョニング(YYYY-MM-DD)を使用しています。各更新はファイルの先頭に新しいエントリを作成します。
- 照合日:各エントリには、コンテンツがオンチェーン / API 状態およびプログラムソースと最後に照合された日時が記録されています。記載がない場合は、エントリのメイン日付を想定してください。
- 破壊的変更:影響を受けるページのボックス警告で明示され、以下のエントリでタグ付けされています。
- 対象範囲:この変更履歴はドキュメントセット自体を対象としています。プロトコル自体の歴史的なタイムラインは
introduction/history-and-milestonesにあり、「Raydium で X が起きたのはいつか」の情報源です。
修正
このドキュメントに誤りを見つけた場合は、ドキュメントリポジトリで Issue またはプルリクエストを開いてください。修正はこの変更履歴に記録されます。関連リンク
introduction/history-and-milestones— プロトコル自体のタイムライン。security/audits— 監査履歴。ray/protocol-fees— プロトコルフィーの配分。reference/program-addresses— プログラム ID の情報源。


