AMM v4 アカウント

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

AMM v4 は、すべての操作が OpenBook 状態に接触するため、CPMM や CLMM よりも大幅にアカウント数が多くなります。このページではアカウントを「プール所有」と「OpenBook 所有」のセクションに分けており、インテグレータは各側がどちらなのかをすぐに確認できます。

インベントリ

AMM v4 プールは、作成時に正確に 1 つの OpenBook マーケットにバインドされます。現在の全体像は以下の通りです：

カテゴリ	アカウント	オーナー	役割
Pool	`AmmInfo`	AMM v4 プログラム	プール状態：累積フィー、ステータス、ボルト・OpenBook マーケットへの参照。
Pool	`amm_authority`	AMM v4 プログラム	ボルト移動に署名するプログラム所有 PDA。すべての AMM v4 プール全体で共有。
Pool	`amm_open_orders`	OpenBook	このマーケット用のプールの OpenBook `OpenOrders` アカウント。
Pool	`amm_target_orders`	AMM v4 プログラム	OpenBook に戻すターゲットリミットオーダーのプール側グリッド。
Pool	`pool_coin_token_account`	SPL Token	プールのコイン側ボルト（`amm_authority` の ATA）。
Pool	`pool_pc_token_account`	SPL Token	プールの pc 側ボルト。
Pool	`lp_mint`	SPL Token	Fungible LP ミント。
Pool	`pool_withdraw_queue`	AMM v4 プログラム	遅延引き出しのレガシーキュー；ゼロ長で保持。
Pool	`pool_temp_lp`	AMM v4 プログラム	`Initialize` 中に使用される補助 LP アカウント。
Market (OpenBook)	`serum_market`	OpenBook	マーケット自体（ベース/クォートミント、ボルト署名者など）。
Market	`serum_bids`, `serum_asks`	OpenBook	ビッド・アスクキュー。
Market	`serum_event_queue`	OpenBook	保留中のイベント（約定、キャンセル）。
Market	`serum_coin_vault`, `serum_pc_vault`	SPL Token	OpenBook のマーケットレベルボルト。
Market	`serum_vault_signer`	OpenBook	`serum_*_vault` 移動に署名するマーケットレベル 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,    // mirrors OpenBook market
    pub pc_lot_size:   u64,
    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,
    pub need_take_pnl_pc:   u64,
    pub total_pnl_pc:   u64,
    pub total_pnl_coin: u64,
    pub pool_open_time: u64,
    pub punish_pc_amount: u64,
    pub punish_coin_amount: u64,
    pub orderbook_to_init_time: u64,
    pub swap_coin_in_amount: u128,
    pub swap_pc_out_amount:  u128,
    pub swap_acc_pc_fee:    u64,
    pub swap_pc_in_amount:  u128,
    pub swap_coin_out_amount: u128,
    pub swap_acc_coin_fee:  u64,
}

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

coin_vault、pc_vault — プールの SPL Token ボルト。Serum/OpenBook の慣例により、coin は token_0（ベース）、pc は token_1（クォート）です。
coin_decimals、pc_decimals — ミントに合致します。
open_orders、target_orders、market — すべてのスワップ/デポジット/引き出し命令に渡す必要があります。
fees.swap_fee_numerator / swap_fee_denominator — 統合トレードフィー。デフォルトは 25 / 10_000 = 0.25%。
status — 操作をゲートするビットマスク。AdminSetStatus 経由で管理者が設定可能。
state_data.need_take_pnl_* — 総累積フィーとスイープされた額との差分。TakePnl がこれらをゼロにします。

OpenBook 配線

非アクティブ。 AMM v4 プールは OpenBook にリクイディティを共有しなくなりました—リミットオーダーグリッドは無効化されています。このセクションで説明されている OpenBook アカウントは、各プールの AmmInfo に残っており、V1 スワップエンドポイント（および Initialize、Deposit、Withdraw）で後方互換性のために検証されていますが、実際には参照されるオンブック状態は空です。V2 スワップエンドポイント（SwapBaseInV2 / SwapBaseOutV2）を使用してください。これらはこれらのアカウントをまったく必要としないため、今日の標準的な実行パスを表します。

AMM v4 プール上で V1 読み書き命令を呼び出す場合、OpenBook アカウントを渡す必要があります。プログラムがこれらを再導出して検証するため、不正確なセットを渡すと元に戻ります。（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 ボルトは、オーナーが amm_authority である標準的なトークンアカウントです。ATA ではありません—それらのアドレスは ["amm_associated_seed", coin_mint_or_pc_mint, market, amm_id] シードで Initialize で導出される特定の PDA です。アドレスは AmmInfo に保存されています；導出は 1 回限りの curiosity です。 Token-2022 はサポートされていません。プログラムはすべてのボルト移動に対して SPL Token のプログラム ID をハードコードしています。Token-2022 ミントに AMM v4 プールをバインドしようとすると、Initialize で失敗します。

LP ミント

オーソリティが amm_authority である classic SPL Token ミント。総供給はプール内の LP 所有権を追跡します；LP を burn するとトークンを両方のボルトから比率通りに返します。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 マルチシグは AdminCancelOrders、AdminSetParams などでこれらを設定します。

Observation / オラクル

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

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

AMM v4 は決定的なペアごとの PDA 用に設計されていなかった（Solana の慣例より前）ため、標準的な amm_id は以下でシードされた keypair です：

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 にも同じ seeded-key パターンが適用されます。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`	—（ユーザー ATA を作成する可能性）	—
`TakePnl`	—	—
`MonitorStep`（crank）	—	—

プールとそのアカウントは無期限に存続します。リクイディティが完全に引き出されても、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 プロトコル（相手方アカウントの場合）

プロダクト

アルゴリズム

インベントリ

`AmmInfo`

OpenBook 配線

オーソリティ PDA

ボルト

LP ミント

ステータスビットマスク

Observation / オラクル

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

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

どこで何を読むか

プロダクト

アルゴリズム

Documentation Index

​インベントリ

​AmmInfo

​OpenBook 配線

​オーソリティ PDA

​ボルト

​LP ミント

​ステータス ビットマスク

​Observation / オラクル

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

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

​どこで何を読むか

インベントリ

`AmmInfo`

OpenBook 配線

オーソリティ PDA

ボルト

LP ミント

ステータスビットマスク

Observation / オラクル

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

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

どこで何を読むか