AMM v4 Konten

Das vollständige Kontenverzeichnis eines AMM v4 Pools — AmmInfo, TargetOrders, OpenOrders, Vaults, LP Mint, Authority — sowie die OpenBook Konten, an die der Pool gebunden ist.

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.

Englische Version ansehen →

Seit dem Upgrade 2026-07 wurde die OpenBook / Serum Abhängigkeit von AMM v4 entfernt — keine Instruktion liest oder schreibt mehr OpenBook State. Die Marktkonten unten werden nur noch als Positionsplatzhalter in den Legacy v1 Instruktionslayouts (akzeptiert aber ignoriert) und als Referenzfelder auf AmmInfo beibehalten. Verwenden Sie die V2 Swap Entrypoints, die diese komplett weglassen. Diese Seite gruppiert die Konten weiterhin in „Pool-eigene” und „OpenBook (Legacy)” Abschnitte zum Lesen älterer Transaktionen.

​

Verzeichnis

Ein AMM v4 Pool registriert einen gebundenen Markt auf AmmInfo bei der Erstellung. Das vollständige Bild:

Kategorie	Konto	Besitzer	Rolle
Pool	AmmInfo	AMM v4 Programm	Pool State: aufgelaufene Gebühren, Status, Referenzen zu Vaults (und als Legacy Felder der Markt).
Pool	amm_authority	AMM v4 Programm	Programm-eigene PDA, die Vault Bewegungen signiert. Gemeinsam für alle AMM v4 Pools.
Pool	amm_open_orders	OpenBook	Legacy OpenOrders Referenz. Wird nicht mehr vom Programm gelesen/geschrieben; wird noch positionell auf v1 Layouts übergeben.
Pool	amm_target_orders	AMM v4 Programm	Legacy Target Orders Konto. Wird noch von WithdrawPnl (als Konto #10) referenziert, aber kein Grid wird gebaut.
Pool	pool_coin_token_account	SPL Token	Pool’s Coin-seitiger Vault (ATA von amm_authority).
Pool	pool_pc_token_account	SPL Token	Pool’s PC-seitiger Vault.
Pool	lp_mint	SPL Token	Fungible LP Mint.
Pool	pool_withdraw_queue	AMM v4 Programm	Legacy Queue für verzögerte Abhebungen; wird auf Nulllänge gehalten.
Pool	pool_temp_lp	AMM v4 Programm	Hilfs LP Konto.
Legacy (OpenBook)	serum_market	OpenBook	Der gebundene Markt. Wird auf v1 Layouts übergeben, wird aber nicht mehr validiert oder verwendet.
Legacy	serum_bids, serum_asks	OpenBook	Geld-/Briefschlangen. Ignoriert.
Legacy	serum_event_queue	OpenBook	Ausstehende Events. Ignoriert.
Legacy	serum_coin_vault, serum_pc_vault	SPL Token	Markt-Level Vaults. Ignoriert.
Legacy	serum_vault_signer	OpenBook	Markt-Level PDA. Ignoriert.

Hinweis: Das Präfix „serum” wird in AMM v4’s IDL und Feldnamen aus Gründen der Rückwärtskompatibilität beibehalten. Diese Konten sind nach der OpenBook Entfernung nicht mehr funktional.

​

AmmInfo

Das Root State Konto des Pools. Groß (≈ 752 Bytes), da es sowohl Pool als auch OpenBook Referenzen inline trägt.

// programs/amm/src/state.rs (gekürzt; Feldordnung / Namen folgen dem IDL)
pub struct AmmInfo {
    pub status: u64,           // Bitmaske: Swap/Deposit/Withdraw/Crank aktiviert
    pub nonce:  u64,           // Bump zur Ableitung von amm_authority
    pub order_num: u64,
    pub depth: u64,
    pub coin_decimals: u64,
    pub pc_decimals:   u64,
    pub state:         u64,    // interne Zustandsmaschine
    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 Größe); jetzt auf 0 initialisiert
    pub pc_lot_size:   u64,    // Legacy; jetzt auf 0 initialisiert
    pub min_price_multiplier: u64,
    pub max_price_multiplier: u64,
    pub sys_decimal_value: u64,

    pub fees: Fees,            // Trade/Protokoll/Fund Gebührensätze
    pub state_data: StateData,

    // Pool-eigene Konten:
    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 auf OpenBook
    pub market: Pubkey,        // OpenBook Markt
    pub market_program: Pubkey, // OpenBook Programm 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  → verwendet von OpenBook Integration
    pub trade_fee_denominator:    u64,     // 10_000
    pub pnl_numerator:            u64,     // 12  → Protokoll's Anteil der Swap Gebühr
    pub pnl_denominator:          u64,     // 100 → also 12/100 = 12% der Gebühr, = 0,03% des Volumens
    pub swap_fee_numerator:       u64,     // 25  → 0,25% Brutto Swap Gebühr
    pub swap_fee_denominator:     u64,     // 10_000
}

pub struct StateData {
    pub need_take_pnl_coin: u64,        // wird noch aktualisiert — aufgelaufene Protokoll Gebühr (Coin Seite)
    pub need_take_pnl_pc:   u64,        // wird noch aktualisiert — aufgelaufene Protokoll Gebühr (PC Seite)
    pub total_pnl_pc:   u64,            // VERALTET — wird nicht mehr aktualisiert
    pub total_pnl_coin: u64,            // VERALTET — wird nicht mehr aktualisiert
    pub pool_open_time: u64,            // wird noch verwendet — Pool Öffnungszeitstempel
    pub padding: [u64; 2],              // reserviert
    pub orderbook_to_init_time: u64,    // VERALTET — wird nicht mehr aktualisiert
    pub swap_coin_in_amount: u128,      // VERALTET — Volumenzähler eingefroren
    pub swap_pc_out_amount:  u128,      // VERALTET
    pub swap_acc_pc_fee:    u64,        // VERALTET
    pub swap_pc_in_amount:  u128,       // VERALTET
    pub swap_coin_out_amount: u128,     // VERALTET
    pub swap_acc_coin_fee:  u64,        // VERALTET
}

Das Struct Layout ist unverändert (byte-kompatibel), daher funktionieren bestehende Deserialisierer weiterhin, aber nach der OpenBook Entfernung werden die oben als VERALTET markierten Felder nicht mehr geschrieben — die swap_* Volumenzähler sind bei ihrem letzten Wert eingefroren. Für Volumen Analytics verwenden Sie Trade Logs statt dieser Felder. Nur need_take_pnl_* und pool_open_time werden aktiv gepflegt.

Integrator-relevante Felder:

• coin_vault, pc_vault — die SPL Token Vaults des Pools. coin ist token_0 nach Serum/OpenBook Konvention (Basis), pc ist token_1 (Quote).
• coin_decimals, pc_decimals — entsprechend den Mints.
• open_orders, target_orders, market — Legacy Referenzfelder. Sind noch auf AmmInfo vorhanden und werden noch positionell auf v1 Instruktionslayouts übergeben, aber das Programm liest oder validiert sie nicht mehr. Die V2 Swap Entrypoints lassen sie weg.
• fees.swap_fee_numerator / swap_fee_denominator — die kombinierte Trade Gebühr. Standard 25 / 10_000 = 0,25%.
• status — Bitmaske, die Operationen kontrolliert. Admin-setzbar via AdminSetStatus.
• state_data.need_take_pnl_* — Delta zwischen Brutto aufgelaufenen Gebühren und dem, was eingezogen wurde. TakePnl setzt diese auf Null.

​

Die OpenBook Verdrahtung

Entfernt. Die OpenBook / Serum Abhängigkeit wurde aus dem Programm gelöscht (Upgrade 2026-07). Die in diesem Abschnitt beschriebenen Konten werden nicht mehr validiert oder verwendet. Sie bleiben als Referenzfelder auf AmmInfo und als Positionsplatzhalter auf den Legacy v1 Instruktionslayouts. Verwenden Sie die V2 Swap Entrypoints (SwapBaseInV2 / SwapBaseOutV2), die diese Konten komplett überspringen.

Wenn Sie eine Legacy v1 SwapBaseIn / SwapBaseOut, Deposit oder Withdraw Instruktion aufrufen, muss die Konto Anzahl immer noch dem alten Layout entsprechen (die Marktkonten nehmen ihre historischen Positionen ein), aber ihr Inhalt wird nicht mehr überprüft — kein CPI wird gegen sie ausgegeben. Neuer Code sollte die V2 Swap Varianten verwenden, die diese Konten überhaupt nicht benötigen.

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

// Felder, die OpenBook auf seinem Marktkonto verfügbar macht:
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,
);

Das amm_open_orders des AMM ist ein OpenBook-eigenes Konto, das den Limit Order State des Pools auf diesem Markt hält: aktive Orders, abgerechnete Guthaben, Referrer usw. amm_target_orders ist AMM-seitig: es hält das beabsichtigte Grid des AMM (Preis/Größe für jeden Order Slot), damit das Programm billig vergleichen kann, was derzeit gepostet ist, und die Differenz platzieren / stornieren kann.

​

Authority PDAs

Es gibt genau eine amm_authority PDA für das gesamte AMM v4 Programm. Sein Seed ist trivial (["amm authority"]) und sein Bump wird auf jedem AmmInfo gespeichert. Diese Authority signiert alle Token Bewegungen für alle AMM v4 Pools.

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

Es gibt eine separate Pool-scoped Authority, die pro Pool abgeleitet wird, um OpenBook Operationen zu signieren (amm_authority oben deckt tatsächlich beide in diesem Programm Design ab; verschiedene Versionen verwendeten unterschiedliche Ableitungen, daher überprüfen Sie den spezifischen AmmInfo.nonce des Pools im Code).

​

Vaults

Die SPL Token Vaults des Pools sind Standard Token Konten, deren owner amm_authority ist. Keine ATAs — ihre Adressen sind spezifische PDAs, die bei Initialize mit ["amm_associated_seed", coin_mint_or_pc_mint, market, amm_id] Seeds abgeleitet werden. Adressen werden auf AmmInfo gespeichert; Ableitung ist eine einmalige Kuriosität.

Token-2022 wird nicht unterstützt. Das Programm hardcoded die SPL Token Programm ID für alle Vault Bewegungen. Der Versuch, einen AMM v4 Pool an einen Token-2022 Mint zu binden, schlägt bei Initialize fehl.

​

LP Mint

Ein klassischer SPL Token Mint, dessen Authority amm_authority ist. Die Gesamtversorgung verfolgt LP Eigentum des Pools; das Verbrennen von LP gibt Token aus beiden Vaults proportional zurück. Da AMM v4 CPMM vorausgeht, gibt es keinen lp_supply Mirror im Pool State — lesen Sie die Mint’s On-Chain Versorgung direkt.

​

Status Bitmaske

AmmInfo.status kontrolliert Operationen. Bits (Position kann zwischen Programmversionen unterschiedlich sein — bestätigen Sie über die Quelle):

Bit	Flag	Effekt
0	SWAP_DISABLED	Swap* lehnt ab.
1	DEPOSIT_DISABLED	Deposit lehnt ab.
2	WITHDRAW_DISABLED	Withdraw lehnt ab.
3	CLMM_LIKE_MIGRATE	Migrations-Gate Flag verwendet von Ops.

Das Raydium Multisig setzt diese via SetParams (mit param = Status). (AdminCancelOrders wurde entfernt.)

​

Beobachtung / Oracle

AMM v4 hat kein dediziertes Observation Konto. Andere Protokolle, die einen On-Chain TWAP benötigen, konsumieren typischerweise OpenBook’s Buch Crossings indirekt oder lesen Off-Chain. Wenn Sie einen Raydium TWAP mit Programm Support benötigen, verwenden Sie CPMM oder CLMM.

​

Ableitung der Pool Konten von Grund auf

Da AMM v4 nicht für deterministische Pro-Pair PDAs entworfen wurde (es geht diesem Solana Convention voraus), ist die kanonische amm_id ein Seeded Keypair, abgeleitet mit:

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

Das gleiche Seeded-Key Muster gilt für amm_open_orders, amm_target_orders, amm_withdraw_queue, pool_temp_lp, pool_coin_token_account, pool_pc_token_account und lp_mint. Das SDK und die API berechnen diese für Sie vor; siehe raydium-sdk-v2’s Liquidity.getAssociatedPoolKeys.

In der Praxis lesen Integratoren den vollständigen Kontosatz des Pools von GET https://api-v3.raydium.io/pools/info/ids?ids=<POOL_ID> oder vom SDK. Manuelle Ableitung ist selten erforderlich.

​

Lebenszyklus Kurzreferenz

Event	Konten erstellt	Konten gelöscht
Initialize2	amm_info, amm_open_orders, amm_target_orders, Vaults, lp_mint, pool_withdraw_queue, pool_temp_lp	—
Deposit	— (kann Benutzer LP ATA erstellen)	—
Withdraw	—	—
SwapBaseIn / SwapBaseOut (v1 / V2)	— (kann Benutzer ATA erstellen)	—
WithdrawPnl	—	—

Pools und ihre Konten bleiben unbegrenzt bestehen. Selbst wenn Liquidität vollständig abgezogen wird, bleibt AmmInfo erhalten.

​

Was wo zu lesen ist

• Mathematik und Gebühren Arithmetik: products/amm-v4/math.
• Gebühren Split und wie es sich mit CPMM/CLMM vergleicht: products/amm-v4/fees.
• Instruktions Kontolisten: products/amm-v4/instructions.
• OpenBook Konto Ableitung: OpenBook Programm Docs (github.com/openbook-dex/program).

Quellen:

• Raydium AMM Programm — raydium-io/raydium-amm
• reference/program-addresses für kanonische Programm IDs
• OpenBook / Serum Protokoll für die Gegenparteien Konten