AMM v4 账户

本页内容由 AI 自动翻译，所有内容以英文版本为准。查看英文版 →

AMM v4 的账户数量远多于 CPMM 或 CLMM，因为每项操作都涉及 OpenBook 状态。本页将账户分为”池拥有”和”OpenBook 拥有”两部分，方便集成者快速判断各类账户。

账户清单

AMM v4 池在创建时绑定到恰好一个 OpenBook 市场。完整的实时图景如下：

类别	账户	所有者	用途
池	`AmmInfo`	AMM v4 程序	池状态：已累积手续费、状态、指向金库和 OpenBook 市场的引用
池	`amm_authority`	AMM v4 程序	程序拥有的 PDA，对金库操作进行签名。在所有 AMM v4 池间共享
池	`amm_open_orders`	OpenBook	池在该市场的 OpenBook `OpenOrders` 账户
池	`amm_target_orders`	AMM v4 程序	池端目标限价订单网格，用于回发至 OpenBook
池	`pool_coin_token_account`	SPL Token	池的币端金库（`amm_authority` 的 ATA）
池	`pool_pc_token_account`	SPL Token	池的法币端金库
池	`lp_mint`	SPL Token	可互换的 LP 代币
池	`pool_withdraw_queue`	AMM v4 程序	延迟提取的历史队列；保持为零长度
池	`pool_temp_lp`	AMM v4 程序	`Initialize` 中使用的辅助 LP 账户
市场 (OpenBook)	`serum_market`	OpenBook	市场本身（基础/报价代币、金库签名者等）
市场	`serum_bids`, `serum_asks`	OpenBook	买单和卖单队列
市场	`serum_event_queue`	OpenBook	待处理事件（成交、撤单）
市场	`serum_coin_vault`, `serum_pc_vault`	SPL Token	OpenBook 的市场级金库
市场	`serum_vault_signer`	OpenBook	市场级 PDA，对 `serum_*_vault` 操作进行签名

注：为了向后兼容，AMM v4 的 IDL 和字段名中保留了”serum”前缀。它现在指代 OpenBook 市场。

`AmmInfo`

池的根状态账户。体积较大（约 752 字节），因为同时携带池和 OpenBook 引用。

// programs/amm/src/state.rs (简写；字段顺序/名称遵循 IDL)
pub struct AmmInfo {
    pub status: u64,           // 位掩码：swap/deposit/withdraw/crank 启用标志
    pub nonce:  u64,           // 用于推导 amm_authority 的 bump
    pub order_num: u64,
    pub depth: u64,
    pub coin_decimals: u64,
    pub pc_decimals:   u64,
    pub state:         u64,    // 内部状态机
    pub reset_flag:    u64,
    pub min_size:      u64,
    pub vol_max_cut_ratio: u64,
    pub amount_wave: u64,
    pub coin_lot_size: u64,    // 镜像 OpenBook 市场配置
    pub pc_lot_size:   u64,
    pub min_price_multiplier: u64,
    pub max_price_multiplier: u64,
    pub sys_decimal_value: u64,

    pub fees: Fees,            // 交易/协议/基金手续费率
    pub state_data: StateData,

    // 池拥有的账户：
    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,   // 池在 OpenBook 的 OpenOrders
    pub market: Pubkey,        // OpenBook 市场
    pub market_program: Pubkey, // OpenBook 程序 ID
    pub target_orders: Pubkey,
    pub withdraw_queue: Pubkey,
    pub lp_vault:       Pubkey, // = pool_temp_lp
    pub owner: Pubkey,          // 管理员（多签）
    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  → OpenBook 集成使用
    pub trade_fee_denominator:    u64,     // 10_000
    pub pnl_numerator:            u64,     // 12  → 协议在 swap 手续费中的占比
    pub pnl_denominator:          u64,     // 100 → 因此 12/100 = 12% 手续费，= 交易量的 0.03%
    pub swap_fee_numerator:       u64,     // 25  → 0.25% 总 swap 手续费
    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 — 必须传递给每个 swap/deposit/withdraw 指令。
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 swap 入口点验证（以及由 Initialize、Deposit、Withdraw 验证），以保持向后兼容性。但实际上它们引用的链上状态为空。请使用 V2 swap 入口点 (SwapBaseInV2 / SwapBaseOutV2)，它们完全跳过这些账户，代表当今的规范执行路径。

当你调用 AMM v4 池的任何 V1 读或写指令时，必须传递 OpenBook 账户。程序会重新推导并验证它们，传入不匹配的账户集合将被拒绝。（V2 swap 变体则不需要这些账户。）

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

// OpenBook 在其市场账户上暴露的字段：
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 程序恰好有一个 amm_authority PDA。其种子很简单（["amm authority"]），bump 存储在每个 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 上；推导是一次性的。 不支持 Token-2022。程序在所有金库操作中硬编码了 SPL Token 的程序 ID。尝试将 AMM v4 池绑定到 Token-2022 代币会在 Initialize 时失败。

LP 代币

标准 SPL Token 代币，其管理员是 amm_authority。总供应量追踪 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`	运维使用的迁移门控标志

Raydium 多签通过 AdminCancelOrders、AdminSetParams 等设置这些位。

观察/预言机

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`	—（可能创建用户 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 代币

状态位掩码

观察/预言机

从头推导池的账户

生命周期快速参考

在哪里阅读什么

产品

算法

Documentation Index

​账户清单

​AmmInfo

​OpenBook 接线

​管理员 PDA

​金库

​LP 代币

​状态位掩码

​观察/预言机

​从头推导池的账户

​生命周期快速参考

​在哪里阅读什么

账户清单

`AmmInfo`

OpenBook 接线

管理员 PDA

金库

LP 代币

状态位掩码

观察/预言机

从头推导池的账户

生命周期快速参考

在哪里阅读什么