Аккаунты AMM v4

Полный реестр аккаунтов пула AMM v4 — AmmInfo, TargetOrders, OpenOrders, хранилища, LP mint, authority — плюс аккаунты OpenBook, к которым привязан пул.

Эта страница переведена с помощью ИИ. За эталон принимается английская версия.

Открыть английскую версию →

Начиная с обновления 2026-07, зависимость AMM v4 от OpenBook / Serum была удалена — ни одна инструкция больше не читает и не записывает состояние OpenBook. Аккаунты маркета ниже сохранены только как позиционные заполнители в старых макетах инструкций v1 (принимаются, но игнорируются) и как справочные поля на AmmInfo. Используйте точки входа V2 для свопов, которые полностью их опускают. На этой странице аккаунты по-прежнему разделены на секции «принадлежащие пулу» и «OpenBook (устаревшие)» для чтения старых транзакций.

​

Реестр

Пул AMM v4 записывает один привязанный маркет на 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	Хранилище пула на стороне coin (ATA amm_authority).
Пул	pool_pc_token_account	SPL Token	Хранилище пула на стороне pc.
Пул	lp_mint	SPL Token	Fungible LP mint.
Пул	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» сохранён в IDL и названиях полей AMM v4 для обратной совместимости. Эти аккаунты больше не функциональны после удаления OpenBook.

​

AmmInfo

Корневой аккаунт состояния пула. Большой (≈ 752 байта), так как содержит ссылки на пул и OpenBook встроенными.

// programs/amm/src/state.rs (сокращённо; порядок полей / имена следуют IDL)
pub struct AmmInfo {
    pub status: u64,           // битовая маска: swap/deposit/withdraw/crank включены
    pub nonce:  u64,           // bump для получения amm_authority
    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); теперь инициализируется в 0
    pub pc_lot_size:   u64,    // устаревшее; теперь инициализируется в 0
    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,   // OpenOrders пула на OpenBook
    pub market: Pubkey,        // маркет OpenBook
    pub market_program: Pubkey, // ID программы OpenBook
    pub target_orders: Pubkey,
    pub withdraw_queue: Pubkey,
    pub lp_vault:       Pubkey, // = pool_temp_lp
    pub owner: Pubkey,          // администратор (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  → используется интеграцией OpenBook
    pub trade_fee_denominator:    u64,     // 10_000
    pub pnl_numerator:            u64,     // 12  → доля протокола ОТ комиссии свопа
    pub pnl_denominator:          u64,     // 100 → итак 12/100 = 12% комиссии, = 0.03% объёма
    pub swap_fee_numerator:       u64,     // 25  → 0.25% валовая комиссия свопа
    pub swap_fee_denominator:     u64,     // 10_000
}

pub struct StateData {
    pub need_take_pnl_coin: u64,        // по-прежнему обновляется — накопленная комиссия протокола (сторона coin)
    pub need_take_pnl_pc:   u64,        // по-прежнему обновляется — накопленная комиссия протокола (сторона pc)
    pub total_pnl_pc:   u64,            // УСТАРЕВШЕЕ — больше не обновляется
    pub total_pnl_coin: u64,            // УСТАРЕВШЕЕ — больше не обновляется
    pub pool_open_time: u64,            // по-прежнему используется — временная метка открытия пула
    pub padding: [u64; 2],              // зарезервировано
    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,        // УСТАРЕВШЕЕ
}

Макет структуры не изменился (совместим по байтам), поэтому существующие десериализаторы продолжают работать, но после удаления OpenBook поля, отмеченные как УСТАРЕВШЕЕ выше, больше не записываются — счётчики объёма swap_* заморожены на последнем значении. Для аналитики объёма используйте логи торговли вместо этих полей. Только need_take_pnl_* и pool_open_time активно поддерживаются.

Поля, видимые интеграторам:

• coin_vault, pc_vault — хранилища SPL Token пула. coin — это token_0 по соглашению Serum/OpenBook (базовый), 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 = ...;  // PublicKey маркета OpenBook

// Поля, которые 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_open_orders пула — это принадлежащий OpenBook аккаунт, содержащий состояние лимитных ордеров пула на этом маркете: активные ордеры, урегулированные балансы, рефереры и т. д. amm_target_orders — со стороны AMM: он содержит предполагаемую сетку AMM (цена/размер для каждого слота ордера), чтобы программа могла дёшево сравнить с тем, что в настоящий момент выставлено, и разместить / отменить разницу.

​

Authority PDAs

Существует ровно один PDA amm_authority для всей программы AMM v4. Его seed тривиален (["amm authority"]), а его bump хранится на каждом AmmInfo. Эта authority подписывает все перемещения токенов для всех пулов AMM v4.

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

Существует отдельная authority, ограниченная пулом, полученная для каждого пула для подписания операций OpenBook (amm_authority выше фактически охватывает обе в дизайне этой программы; разные версии использовали разные получения, поэтому проверьте AmmInfo.nonce конкретного пула в коде).

​

Хранилища

Хранилища SPL Token пула — это стандартные аккаунты токенов, чей owner — это amm_authority. Не ATAs — их адреса — это специфичные PDAs, полученные при Initialize с seeds ["amm_associated_seed", coin_mint_or_pc_mint, market, amm_id]. Адреса хранятся на AmmInfo; получение — это одноразовая любопытство.

Token-2022 не поддерживается. Программа жёстко кодирует ID программы SPL Token для всех перемещений хранилищ. Попытка привязать пул AMM v4 к минту Token-2022 не удаётся при Initialize.

​

LP mint

Классический SPL Token mint, чья authority — это 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	Флаг ограничения миграции, используемый операциями.

Multisig Raydium устанавливает эти значения через SetParams (с param = Status). (AdminCancelOrders был удалён.)

​

Наблюдение / оракул

AMM v4 не имеет выделенного аккаунта наблюдения. Другие протоколы, которым нужен TWAP в цепи, обычно потребляют пересечения книги OpenBook косвенно или читают вне цепи. Если вам нужен TWAP Raydium с поддержкой программы, используйте CPMM или CLMM.

​

Получение аккаунтов пула с нуля

Поскольку AMM v4 не был разработан для детерминированных PDAs для каждой пары (это предшествует этому соглашению Solana), канонический amm_id — это seeded keypair, полученный с:

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

Тот же паттерн seeded-key применяется к 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’s 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 для аккаунтов контрагента