AMM v4 アカウント

AMM v4 プールの完全なアカウント構成 — AmmInfo、TargetOrders、OpenOrders、ボルト、LP ミント、オーソリティ — およびプールがバインドされている OpenBook アカウント。

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

英語版を表示 →

2026-07 アップグレード以降、AMM v4 の OpenBook / Serum 依存関係は 削除されました — 命令がもう OpenBook の状態を読み書きすることはありません。以下のマーケット アカウントは、レガシー v1 命令レイアウト上の位置プレースホルダーとして（受け入れられるが無視される）、および AmmInfo の参照フィールドとしてのみ保持されます。V2 スワップ エントリポイントを使用してください。これらのアカウントを完全に省略します。このページは、古いトランザクションを読むために、アカウントを「プール所有」と「OpenBook（レガシー）」セクションにグループ化しています。

​

インベントリ

AMM v4 プールは作成時に 1 つのバインドされたマーケットを AmmInfo に記録します。全体像は以下の通りです：

カテゴリ	アカウント	オーナー	役割
プール	AmmInfo	AMM v4 プログラム	プール状態：蓄積されたフィー、ステータス、ボルトへの参照（およびレガシー フィールドとしてマーケット）。
プール	amm_authority	AMM v4 プログラム	プログラム所有の PDA。ボルト移動に署名します。すべての AMM v4 プール間で共有されます。
プール	amm_open_orders	OpenBook	レガシー OpenOrders 参照。プログラムによってもう読み書きされません。v1 レイアウトで位置的に渡されます。
プール	amm_target_orders	AMM v4 プログラム	レガシー ターゲット オーダー アカウント。WithdrawPnl（アカウント #10）で参照されていますが、グリッドは構築されません。
プール	pool_coin_token_account	SPL Token	プールのコイン側ボルト（amm_authority の ATA）。
プール	pool_pc_token_account	SPL Token	プールの pc 側ボルト。
プール	lp_mint	SPL Token	ファンジブル LP ミント。
プール	pool_withdraw_queue	AMM v4 プログラム	レガシー キュー。遅延引き出し用。ゼロ長に保たれます。
プール	pool_temp_lp	AMM v4 プログラム	補助 LP アカウント。
レガシー（OpenBook）	serum_market	OpenBook	バインドされたマーケット。v1 レイアウトで渡されますが、もう検証または使用されません。
レガシー	serum_bids、serum_asks	OpenBook	ビッド/アスク キュー。無視されます。
レガシー	serum_event_queue	OpenBook	保留中のイベント。無視されます。
レガシー	serum_coin_vault、serum_pc_vault	SPL Token	マーケット レベルのボルト。無視されます。
レガシー	serum_vault_signer	OpenBook	マーケット レベルの PDA。無視されます。

注：「serum」プレフィックスは、後方互換性のため AMM v4 の IDL とフィールド名に保持されています。これらのアカウントは OpenBook 削除後、もう機能していません。

​

AmmInfo

プールのルート状態アカウント。プールと OpenBook 参照の両方をインラインで保持するため、大きい（≈ 752 バイト）です。

// programs/amm/src/state.rs (abridged; field order / names follow the IDL)
pub struct AmmInfo {
    pub status: u64,           // bitmask: swap/deposit/withdraw/crank enabled
    pub nonce:  u64,           // bump used to derive amm_authority
    pub order_num: u64,
    pub depth: u64,
    pub coin_decimals: u64,
    pub pc_decimals:   u64,
    pub state:         u64,    // internal state machine
    pub reset_flag:    u64,
    pub min_size:      u64,
    pub vol_max_cut_ratio: u64,
    pub amount_wave: u64,
    pub coin_lot_size: u64,    // legacy (OpenBook lot size); now initialized to 0
    pub pc_lot_size:   u64,    // legacy; now initialized to 0
    pub min_price_multiplier: u64,
    pub max_price_multiplier: u64,
    pub sys_decimal_value: u64,

    pub fees: Fees,            // trade/protocol/fund fee rates
    pub state_data: StateData,

    // Pool-owned accounts:
    pub coin_vault: Pubkey,
    pub pc_vault:   Pubkey,
    pub coin_vault_mint: Pubkey,
    pub pc_vault_mint:   Pubkey,
    pub lp_mint:  Pubkey,
    pub open_orders: Pubkey,   // pool's OpenOrders on OpenBook
    pub market: Pubkey,        // OpenBook market
    pub market_program: Pubkey, // OpenBook program ID
    pub target_orders: Pubkey,
    pub withdraw_queue: Pubkey,
    pub lp_vault:       Pubkey, // = pool_temp_lp
    pub owner: Pubkey,          // admin (multisig)
    pub lp_reserve: u64,
    pub padding: [u64; 3],
}

pub struct Fees {
    pub min_separate_numerator:   u64,     // 5
    pub min_separate_denominator: u64,     // 10_000
    pub trade_fee_numerator:      u64,     // 25  → used by OpenBook integration
    pub trade_fee_denominator:    u64,     // 10_000
    pub pnl_numerator:            u64,     // 12  → protocol's share OF the swap fee
    pub pnl_denominator:          u64,     // 100 → so 12/100 = 12% of fee, = 0.03% of volume
    pub swap_fee_numerator:       u64,     // 25  → 0.25% gross swap fee
    pub swap_fee_denominator:     u64,     // 10_000
}

pub struct StateData {
    pub need_take_pnl_coin: u64,        // still updated — accrued protocol fee (coin side)
    pub need_take_pnl_pc:   u64,        // still updated — accrued protocol fee (pc side)
    pub total_pnl_pc:   u64,            // DEPRECATED — no longer updated
    pub total_pnl_coin: u64,            // DEPRECATED — no longer updated
    pub pool_open_time: u64,            // still used — pool open timestamp
    pub padding: [u64; 2],              // reserved
    pub orderbook_to_init_time: u64,    // DEPRECATED — no longer updated
    pub swap_coin_in_amount: u128,      // DEPRECATED — volume counters frozen
    pub swap_pc_out_amount:  u128,      // DEPRECATED
    pub swap_acc_pc_fee:    u64,        // DEPRECATED
    pub swap_pc_in_amount:  u128,       // DEPRECATED
    pub swap_coin_out_amount: u128,     // DEPRECATED
    pub swap_acc_coin_fee:  u64,        // DEPRECATED
}

構造体の レイアウトは変更されていません（バイト互換）ため、既存のデシリアライザーは動作し続けますが、OpenBook 削除後、上記の DEPRECATED とマークされたフィールドは もう書き込まれません — swap_* ボリューム カウンターは最後の値で凍結されます。ボリューム分析には、これらのフィールドではなくトレード ログを使用してください。need_take_pnl_* と pool_open_time のみがアクティブに保持されます。

インテグレーター向けフィールド：

• coin_vault、pc_vault — プールの SPL Token ボルト。coin は Serum/OpenBook 規約により token_0（ベース）、pc は token_1（クォート）です。
• coin_decimals、pc_decimals — ミントに対応します。
• open_orders、target_orders、market — レガシー参照フィールド。AmmInfo に存在し、v1 命令レイアウトで位置的に渡されますが、プログラムはもう読み取りまたは検証しません。V2 スワップ エントリポイントはこれらを省略します。
• fees.swap_fee_numerator / swap_fee_denominator — 合計トレード フィー。デフォルト 25 / 10_000 = 0.25%。
• status — 操作をゲートするビットマスク。AdminSetStatus 経由で管理者が設定可能です。
• state_data.need_take_pnl_* — 蓄積された総フィーと掃引されたもの間のデルタ。TakePnl はこれらをゼロにします。

​

OpenBook 配線

削除されました。 OpenBook / Serum 依存関係はプログラムから削除されました（2026-07 アップグレード）。このセクションで説明されているアカウントはもう検証または使用されません。AmmInfo の参照フィールドおよびレガシー v1 命令レイアウトの位置プレースホルダーとして残ります。V2 スワップ エントリポイント（SwapBaseInV2 / SwapBaseOutV2）を使用してください。これらのアカウントを完全にスキップします。

レガシー v1 SwapBaseIn / SwapBaseOut、Deposit、または Withdraw 命令を呼び出すとき、アカウント 数 は古いレイアウトと一致する必要があります（マーケット アカウントは歴史的位置を占めます）が、その 内容はもう確認されません — CPI は発行されません。新しいコードは V2 スワップ バリアントを使用する必要があります。これらはこれらのアカウントをまったく取りません。

const market = ...;  // OpenBook market PublicKey

// Fields OpenBook exposes on its market account:
const marketDecoded = OpenBookMarket.decode(marketAccountData);
const {
  bids:           serumBids,
  asks:           serumAsks,
  eventQueue:     serumEventQueue,
  requestQueue:   serumRequestQueue,
  baseVault:      serumCoinVault,
  quoteVault:     serumPcVault,
  vaultSignerNonce,
} = marketDecoded;

const serumVaultSigner = PublicKey.createProgramAddressSync(
  [market.toBuffer(), u64ToBytes(vaultSignerNonce)],
  OPENBOOK_PROGRAM_ID,
);

AMM の amm_open_orders は OpenBook 所有のアカウント。このマーケット上のプールのリミット オーダー状態を保持します：アクティブなオーダー、決済残高、リファラーなど。amm_target_orders は AMM 側：プログラムが現在ポストされているものと安価に比較でき、差分をプレイス / キャンセルできるように、AMM の 意図された グリッド（各オーダー スロットの価格/サイズ）を保持します。

​

オーソリティ PDA

AMM v4 プログラム全体に対して、正確に 1 つの amm_authority PDA があります。そのシードは単純です（["amm authority"]）。そのバンプはすべての AmmInfo に保存されます。このオーソリティはすべての AMM v4 プールのすべてのトークン移動に署名します。

const AMM_V4_PROGRAM_ID = new PublicKey(
  "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
);
const [ammAuthority] = PublicKey.findProgramAddressSync(
  [Buffer.from("amm authority")],
  AMM_V4_PROGRAM_ID,
);

OpenBook 操作に署名するために、プールごとに導出される別の プール スコープ オーソリティがあります（amm_authority 上記は実際にこのプログラムの設計ではその両方をカバーします。異なるバージョンは異なる導出を使用したため、コード内の特定のプールの AmmInfo.nonce を確認してください）。

​

ボルト

プールの SPL Token ボルトは、owner が amm_authority である標準的なトークン アカウントです。ATA ではありません — それらのアドレスは Initialize で ["amm_associated_seed", coin_mint_or_pc_mint, market, amm_id] シードで導出される特定の PDA です。アドレスは AmmInfo に保存されます。導出は 1 回限りの好奇心です。

Token-2022 は サポートされていません。プログラムはすべてのボルト移動に対して SPL Token のプログラム ID をハードコードします。AMM v4 プールを Token-2022 ミントにバインドしようとすると、Initialize で失敗します。

​

LP ミント

オーソリティが amm_authority である古典的な SPL Token ミント。総供給はプールの LP 所有権を追跡します。LP を焼却すると、両方のボルトからトークンが比例的に返されます。AMM v4 は CPMM より前のため、プール状態に lp_supply ミラーはありません — ミントのオンチェーン供給を直接読み取ってください。

​

ステータス ビットマスク

AmmInfo.status は操作をゲートします。ビット（位置はプログラム バージョン間で異なる可能性があります — ソースで確認してください）：

ビット	フラグ	効果
0	SWAP_DISABLED	Swap* は拒否します。
1	DEPOSIT_DISABLED	Deposit は拒否します。
2	WITHDRAW_DISABLED	Withdraw は拒否します。
3	CLMM_LIKE_MIGRATE	ops で使用される移行ゲート フラグ。

Raydium マルチシグは SetParams（param = Status で）経由でこれらを設定します。（AdminCancelOrders は削除されました。）

​

オブザベーション / オラクル

AMM v4 には専用のオブザベーション アカウントがありません。 オンチェーン TWAP が必要な他のプロトコルは、通常 OpenBook のブック クロッシングを間接的に消費するか、オフチェーンを読み取ります。Raydium TWAP とプログラム サポートが必要な場合は、CPMM または CLMM を使用してください。

​

スクラッチからプールのアカウントを導出する

AMM v4 は決定論的なペアごと PDA 用に設計されていません（Solana 規約より前）。正規の amm_id は シード キーペア です。以下で導出されます：

ammId = createWithSeed(
  owner: ammAuthority,
  seed:  marketPubkey.toBase58().slice(0, 32),
  programId: AMM_V4_PROGRAM_ID,
)

同じシード キー パターンは amm_open_orders、amm_target_orders、amm_withdraw_queue、pool_temp_lp、pool_coin_token_account、pool_pc_token_account、および lp_mint に適用されます。SDK と API はこれらを事前計算します。raydium-sdk-v2 の Liquidity.getAssociatedPoolKeys を参照してください。

実際には、インテグレーターは GET https://api-v3.raydium.io/pools/info/ids?ids=<POOL_ID> または SDK からプールの完全なアカウント セットを読み取ります。手動導出はめったに必要ありません。

​

ライフサイクル クイック リファレンス

イベント	作成されたアカウント	破棄されたアカウント
Initialize2	amm_info、amm_open_orders、amm_target_orders、ボルト、lp_mint、pool_withdraw_queue、pool_temp_lp	—
Deposit	—（ユーザー LP ATA を作成する可能性があります）	—
Withdraw	—	—
SwapBaseIn / SwapBaseOut（v1 / V2）	—（ユーザー ATA を作成する可能性があります）	—
WithdrawPnl	—	—

プールとそのアカウントは無期限に存続します。流動性が完全に引き出されても、AmmInfo は残ります。

​

どこで何を読むか

• 数学とフィー計算：products/amm-v4/math。
• フィー分割と CPMM/CLMM との比較：products/amm-v4/fees。
• 命令アカウント リスト：products/amm-v4/instructions。
• OpenBook アカウント導出：OpenBook プログラム ドキュメント（github.com/openbook-dex/program）。

ソース：

• Raydium AMM プログラム — raydium-io/raydium-amm
• reference/program-addresses（正規プログラム ID）
• OpenBook / Serum プロトコル（相手方アカウント）