AMM v4 命令

すべての AMM v4 命令、その引数、期待されるプール・OpenBook アカウント、および各命令の前提条件・事後条件。

このページは AI による自動翻訳です。すべての内容は英語版を正とします。

英語版を表示 →

2026-07 プログラムアップグレード以降、AMM v4 の OpenBook / Serum 依存関係は削除されました。レガシー v1 の SwapBaseIn / SwapBaseOut、Deposit、Withdraw 命令は古いアカウントレイアウトを保持しており、後方互換性のためにマーケットアカウントは古い位置で受け入れられていますが、検証または使用されなくなりました（CPI は発行されません）。新しい統合では V2 スワップエントリポイントを使用してください。これらはマーケットアカウントを完全に省略します。いくつかの命令は削除され、リバートするようになりました。変更ログエントリを参照してください。以下のアカウントリストは Raydium SDK のフィールド名を使用しています。基礎となる IDL は時々 serum_* プレフィックスを使用します。

​

命令インベントリ

グループ	命令	タグ	注記
プールライフサイクル	Initialize2	1	唯一のプール作成命令（UI は新規プールのデフォルトを CPMM に設定）。
リクイディティ	Deposit	3	リクイディティを追加し、LP を受け取ります。レイアウトは変更なし（マーケットアカウントは無視）。
リクイディティ	Withdraw	4	LP をバーン、両側を按分で受け取ります。レイアウトは変更なし（マーケットアカウントは無視）。
スワップ	SwapBaseIn	9	正確な入力スワップ。v1 レイアウトは変更なし。マーケットアカウントは受け入れられますが無視されます。
スワップ	SwapBaseOut	11	正確な出力スワップ。上記と同じ。
スワップ	SwapBaseInV2	16	推奨。 マーケットアカウントなしの正確な入力スワップ。
スワップ	SwapBaseOutV2	17	推奨。 マーケットアカウントなしの正確な出力スワップ。
メンテナンス	SetParams	6	管理者：プールパラメータを変更します。レイアウト + param 値が変更されました（破壊的変更）。
メンテナンス	WithdrawPnl	7	累積プロトコル PnL をスイープします。アカウントレイアウトが変更されました（破壊的変更）。
メンテナンス	CreateConfigAccount	14	管理者：プログラムレベルの AmmConfig PDA を初期化します。
メンテナンス	UpdateConfigAccount	15	管理者：プログラムレベルの設定パラメータを変更します。

SDK はユーザー向け命令のビルダーのみを公開しています。メンテナンス命令は通常、Raydium キーパーによって呼び出されます。

削除済み / 呼び出し不可（unimplemented! でリバートし、クライアントビルダーは削除されました）：Initialize（タグ 0、Initialize2 を使用）、MonitorStep（2）、MigrateToOpenBook（5）、WithdrawSrm（8）、PreInitialize（10、Initialize2 を使用）、SimulateInfo（12）、AdminCancelOrders（13）。

​

Initialize2

既存の OpenBook マーケットにバインドされた新しい AMM v4 プールをブートストラップします。

引数

nonce:        u8
open_time:    u64
init_pc_amount:   u64
init_coin_amount: u64

アカウント（書き込み可能 W、署名者 S）

#	名前	W	S	注記
1	token_program			SPL Token。
2	system_program
3	rent
4	amm	W		AmmInfo アカウント（シード付きキー）。
5	amm_authority			プログラム PDA。
6	amm_open_orders	W		OpenBook OpenOrders（シード付き）。
7	lp_mint	W
8	coin_mint
9	pc_mint
10	pool_coin_token_account	W
11	pool_pc_token_account	W
12	pool_withdraw_queue	W
13	pool_target_orders_account	W
14	pool_lp_token_account	W		作成者の LP ATA。
15	pool_temp_lp_token_account	W		スクラッチアカウント。
16	market_program			OpenBook プログラム。
17	market			OpenBook マーケット。
18	user_wallet	W	S	作成者。レントと初期デポジットに資金を提供します。
19	user_token_coin	W
20	user_token_pc	W

事後条件

• lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN。ここで INIT_BURN ≈ 100 LP ユニットは流通から除外されます。
• OpenBook オーダーは投稿されません（オーダーブックグリッドは削除されました）。market_program / market は引き続き渡されますが、参照フィールドとしてのみ保存されます。coin_lot_size / pc_lot_size / min_size は 0 に初期化されます。

一般的なエラー — InvalidInput（小数点の不一致、ソート順序が正しくない）、NotAllowed。

​

Deposit

リクイディティを追加します。

引数

max_coin_amount: u64
max_pc_amount:   u64
base_side:       u64    // 0 = coin ベース、1 = pc ベース
// （一部の SDK バリアントは other_amount_min も受け入れます）

アカウント（簡略版）

#	名前	W	S
1	token_program
2	amm	W
3	amm_authority
4	amm_open_orders
5	amm_target_orders	W
6	lp_mint	W
7	pool_coin_token_account	W
8	pool_pc_token_account	W
9	market
10	user_coin_token_account	W
11	user_pc_token_account	W
12	user_lp_token_account	W
13	user_owner		S

計算 — 標準的な按分。プールの有効リザーブ（ボルト + オンブック）を使用して、SDK は指定された LP 量を生成する coin/pc ペアを計算し、max_* に対してチェックします。どちらかの側がキャップを超える場合、ExceededSlippage でリバートします。

​

Withdraw

LP をバーン、両側を受け取ります。

引数

amount: u64    // バーンする LP

アカウント — Deposit と同じですが方向が逆です。lp_mint はバーン用に書き込み可能で、ユーザー ATA はレシーバーです。アカウントレイアウトは変更されていません（マーケットアカウントは引き続き位置的に渡され、無視されます）。OpenBook からのセットル手順はなくなりました。按分計算はボルト残高を直接使用します。

​

SwapBaseIn

正確な入力スワップ。常にAMM パススワップです（OpenBook マッチングを経由しません）。

新しいコードでは V2 バリアントを使用してください。 AMM v4 の OpenBook 依存関係が削除されたため、V1 エントリポイント（SwapBaseIn、SwapBaseOut）は引き続き完全な 17 アカウントリスト（またはオプションのターゲットオーダーアカウント付きで 18）を期待していますが、OpenBook/マーケットアカウントは位置的に受け入れられ、無視されます — 検証されず、CPI は発行されません。間違ったアカウント数を渡すと引き続き WrongAccountsNumber でリバートしますが、マーケットアカウント内容はチェックされなくなりました。新しい統合では SwapBaseInV2 / SwapBaseOutV2 を使用してください。これらはより小さなアカウントリストを取り、今日の正規実行パスを表しています。V1 フォームは完全性のため、および既存のオンチェーントランザクションを読むためにここに記載されています。

引数

amount_in:            u64
minimum_amount_out:   u64

アカウント（簡略版）

#	名前	W	S
1	token_program
2	amm	W
3	amm_authority
4	amm_open_orders	W
5	amm_target_orders	W
6	pool_coin_token_account	W
7	pool_pc_token_account	W
8	market_program
9	market	W
10	market_bids	W
11	market_asks	W
12	market_event_queue	W
13	market_coin_vault	W
14	market_pc_vault	W
15	market_vault_signer
16	user_source_token_account	W
17	user_dest_token_account	W
18	user_owner		S

計算 — products/amm-v4/math を参照してください。

前提条件

• amm.status はスワップを許可します（ステータスビットマスクのビット 0 が設定されていません）。
• amm.state_data.pool_open_time <= now。
• amount_in > 0。
• user_source_token_account は少なくとも amount_in を保有しています。

事後条件

• ユーザーはソーストークンの amount_in を失い、デストトークンの amount_out ≥ minimum_amount_out を獲得します。
• need_take_pnl_* はプロトコル手数料シェアだけ増加します。
• 注記：state_data.swap_*_in_amount / swap_*_out_amount 分析カウンターは更新されなくなりました — それらの値は凍結されています。ボリューム分析にはトレードログを使用してください。

一般的なエラー — ExceededSlippage、InvalidInput、InvalidStatus、NotAllowed（coin/pc ミント同一）。

​

SwapBaseOut

正確な出力、SwapBaseIn の逆。同じアカウント。

引数

max_amount_in: u64
amount_out:    u64

​

SwapBaseInV2 / SwapBaseOutV2

OpenBook アカウントを完全にスキップするバリアントスワップエントリポイント（タグ 16 / 17）。計算は V1 パスと同じですが、アカウントリストは AMM 側とユーザーだけに縮小します — 8 アカウント、amm_open_orders は渡されません：

#	名前	W	S
1	token_program
2	amm	W
3	amm_authority
4	pool_coin_token_account	W
5	pool_pc_token_account	W
6	user_source_token_account	W
7	user_dest_token_account	W
8	user_owner		S

プールリザーブはボルト残高（保留中の PnL を除く）になるため、クォート計算は簡潔で v1 パスと同じです。V2 を使用してコンピュートを節約し、（現在無視されている）マーケットアカウントの渡却を避けてください。Raydium ルーターは AMM v4 を経由してルーティングする場合、常に V2 フォームを使用します。

引数は V1 フォームと同じです（SwapBaseInV2 の場合は amount_in / minimum_amount_out、SwapBaseOutV2 の場合は max_amount_in / amount_out）。

​

MonitorStep およびその他の削除された命令

削除済み — 呼び出し不可。 2026-07 アップグレード以降、MonitorStep（タグ 2）はプログラムから削除され、呼び出された場合リバートします（unimplemented!）。クライアントビルダーも削除されました。同じことが MigrateToOpenBook（5）、WithdrawSrm（8）、SimulateInfo（12）、AdminCancelOrders（13）、およびレガシー Initialize（0）/ PreInitialize（10）プール作成エントリポイントに適用されます — 代わりに Initialize2 を使用してください。

歴史的に、MonitorStep はプールの OpenBook インタラクションをクランクしました：満たされたオーダーをセットル（OpenBook CPI を経由してマーケットボルトからプールボルトに収益を移動）、古いオーダーをキャンセル、target_orders と amm_open_orders の間のギャップを閉じるために新しいオーダーを投稿しました。OpenBook 依存関係が削除されたため、クランクするものはなく、命令は削除されました。引き続き呼び出すキーパーまたは統合は、呼び出しを削除する必要があります。

​

WithdrawPnl / TakePnl

累積プロトコル手数料の管理者スイープ。

引数

• WithdrawPnl は引数を取りません。need_take_pnl_* を読み、正確な金額を移動します。

破壊的変更（管理者のみ）。 アカウントリストは 17（+1 オプション）から10に削減されました — amm_open_orders と 6 つのマーケットアカウントすべてが削除されました — 互換性パースなし。古いレイアウトはミスアライン（古い #5 は amm_open_orders、現在は pool_coin_token_account）し、InvalidCoinVault などのエラーで失敗します。管理者ツールは更新する必要があります。

アカウント（新しい 10 アカウントレイアウト）

#	名前	W	S
1	token_program
2	amm	W
3	amm_config
4	amm_authority
5	pool_coin_token_account	W
6	pool_pc_token_account	W
7	pnl_coin_token_account	W		レシピエント。
8	pnl_pc_token_account	W
9	pnl_owner		S	管理者マルチシグ。
10	amm_target_orders	W

効果

• need_take_pnl_coin を pool_coin_token_account から pnl_coin_token_account に転送します。
• pc についても同じ。
• need_take_pnl_coin と need_take_pnl_pc をゼロにします。
• ロジック変更：ボルト残高が累積 PnL をカバーするのに不十分な場合、命令は TakePnlError を直接返します（オーダーブック状態を操作しなくなりました）。

累積 PnL は既に不変から除外されているため、リザーブに変更はありません。

​

SetParams

Raydium マルチシグによって呼び出される管理者パラメータ変更。引数は param: u8 タグ + ペイロードです。

破壊的変更（管理者のみ）。 アカウントリストは [amm (W), admin (S)] だけに削減されました（権限、オープンオーダー、ターゲットオーダー、ボルト、およびすべてのマーケットアカウントが削除されました）。param 列挙型は番号が付け直され、トリミングされました：Status = 0、State = 1、Fees = 2（以前は 9）、SetOpenTime = 3（以前は 11）。すべてのオーダーブックグリッドパラメータと AmmOwner、LastOrderDistance、UpdateOpenOrder が削除され、SetParamsInstruction 構造体は new_pubkey と last_order_distance をドロップしました。管理者ツールは更新する必要があります。

​

状態変更マトリックス

OpenBook 列は削除されました — どの命令もオーダーブックに触れなくなりました。

命令	lp_mint 供給	ボルト	PnL カウンター
Initialize2	初期供給が作成者にミント	+ init_coin_amount、+ init_pc_amount	0
Deposit	+	+ 両側	—
Withdraw	−	− 両側	—
SwapBaseIn / SwapBaseInV2	—	+ in、− out	+ pnl シェア
SwapBaseOut / SwapBaseOutV2	—	+ in、− out	+ pnl シェア
WithdrawPnl	—	−（pnl スイープ）	0
SetParams	—	—	—

​

次のステップ

• products/amm-v4/code-demos — スワップと LP フローの TypeScript 例。
• products/amm-v4/fees — WithdrawPnl の詳細と手数料分割。
• reference/error-codes — 前方参照テーブル（AMM v4 エラーはそのページに記載されています）。

ソース：

• Raydium AMM プログラム — raydium-io/raydium-amm
• Raydium SDK v2 Liquidity モジュール
• OpenBook プログラム — マーケット側のアカウント検証