Akun AMM v4

Inventaris akun lengkap dari pool AMM v4 — AmmInfo, TargetOrders, OpenOrders, vault, LP mint, authority — ditambah akun OpenBook yang terikat pada pool.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.

Lihat versi bahasa Inggris →

Sejak pembaruan 2026-07, ketergantungan OpenBook / Serum pada AMM v4 telah dihapus — tidak ada instruksi yang membaca atau menulis status OpenBook lagi. Akun pasar di bawah ini dipertahankan hanya sebagai placeholder posisional pada tata letak instruksi v1 warisan (diterima tetapi diabaikan) dan sebagai bidang referensi pada AmmInfo. Gunakan titik masuk swap V2, yang menghilangkannya sepenuhnya. Halaman ini masih mengelompokkan akun ke dalam bagian “pool-owned” dan “OpenBook (legacy)” untuk membaca transaksi yang lebih lama.

​

Inventaris

Pool AMM v4 mencatat satu pasar terikat pada AmmInfo saat pembuatan. Gambaran lengkapnya:

Kategori	Akun	Pemilik	Peran
Pool	AmmInfo	Program AMM v4	Status pool: biaya yang terkumpul, status, referensi ke vault (dan, sebagai bidang warisan, pasar).
Pool	amm_authority	Program AMM v4	PDA milik program yang menandatangani pergerakan vault. Dibagikan di semua pool AMM v4.
Pool	amm_open_orders	OpenBook	Referensi OpenOrders warisan. Tidak lagi dibaca/ditulis oleh program; masih dilewatkan secara posisional pada tata letak v1.
Pool	amm_target_orders	Program AMM v4	Akun target-orders warisan. Masih direferensikan oleh WithdrawPnl (sebagai akun #10) tetapi tidak ada grid yang dibangun.
Pool	pool_coin_token_account	SPL Token	Vault sisi coin pool (ATA dari amm_authority).
Pool	pool_pc_token_account	SPL Token	Vault sisi pc pool.
Pool	lp_mint	SPL Token	Mint LP yang dapat ditukar.
Pool	pool_withdraw_queue	Program AMM v4	Antrian warisan untuk penarikan tertunda; disimpan dengan panjang nol.
Pool	pool_temp_lp	Program AMM v4	Akun LP tambahan.
Legacy (OpenBook)	serum_market	OpenBook	Pasar yang terikat. Dilewatkan pada tata letak v1 tetapi tidak lagi divalidasi atau digunakan.
Legacy	serum_bids, serum_asks	OpenBook	Antrian bid/ask. Diabaikan.
Legacy	serum_event_queue	OpenBook	Peristiwa yang tertunda. Diabaikan.
Legacy	serum_coin_vault, serum_pc_vault	SPL Token	Vault tingkat pasar. Diabaikan.
Legacy	serum_vault_signer	OpenBook	PDA tingkat pasar. Diabaikan.

Catatan: “serum” dipertahankan sebagai awalan dalam IDL dan nama bidang AMM v4 untuk kompatibilitas mundur. Akun-akun ini tidak lagi berfungsi setelah penghapusan OpenBook.

​

AmmInfo

Akun status root pool. Besar (≈ 752 byte) karena membawa referensi pool dan OpenBook secara inline.

// programs/amm/src/state.rs (disingkat; urutan bidang / nama mengikuti 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
}

Tata letak struct tidak berubah (kompatibel byte) sehingga deserializer yang ada terus bekerja, tetapi setelah penghapusan OpenBook, bidang yang ditandai DEPRECATED di atas tidak lagi ditulis — penghitung volume swap_* dibekukan pada nilai terakhirnya. Untuk analitik volume, gunakan log perdagangan daripada bidang-bidang ini. Hanya need_take_pnl_* dan pool_open_time yang secara aktif dipertahankan.

Bidang yang menghadap integrator:

• coin_vault, pc_vault — vault SPL Token pool. coin adalah token_0 menurut konvensi Serum/OpenBook (base), pc adalah token_1 (quote).
• coin_decimals, pc_decimals — sesuai dengan mint.
• open_orders, target_orders, market — bidang referensi warisan. Masih ada di AmmInfo dan masih dilewatkan secara posisional pada tata letak instruksi v1, tetapi program tidak lagi membaca atau memvalidasinya. Titik masuk swap V2 menghilangkannya.
• fees.swap_fee_numerator / swap_fee_denominator — biaya perdagangan gabungan. Default 25 / 10_000 = 0.25%.
• status — bitmask yang membatasi operasi. Dapat diatur admin melalui AdminSetStatus.
• state_data.need_take_pnl_* — delta antara biaya yang terkumpul kotor dan apa yang telah disapu. TakePnl mengosongkan ini.

​

Pengkabelan OpenBook

Dihapus. Ketergantungan OpenBook / Serum telah dihapus dari program (pembaruan 2026-07). Akun yang dijelaskan di bagian ini tidak lagi divalidasi atau digunakan. Mereka tetap sebagai bidang referensi pada AmmInfo dan sebagai placeholder posisional pada tata letak instruksi v1 warisan. Gunakan titik masuk swap V2 (SwapBaseInV2 / SwapBaseOutV2) yang melewatkan akun-akun ini sepenuhnya.

Ketika Anda memanggil instruksi v1 SwapBaseIn / SwapBaseOut, Deposit, atau Withdraw warisan, jumlah akun harus tetap cocok dengan tata letak lama (akun pasar menempati posisi historisnya), tetapi isinya tidak lagi diperiksa — tidak ada CPI yang dikeluarkan terhadapnya. Kode baru harus menggunakan varian swap V2, yang tidak mengambil akun-akun ini sama sekali.

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_open_orders AMM adalah akun milik OpenBook yang menyimpan status limit-order pool di pasar ini: pesanan aktif, saldo yang diselesaikan, referrer, dll. amm_target_orders adalah sisi AMM: ia menyimpan grid yang dimaksudkan AMM (harga/ukuran untuk setiap slot pesanan) sehingga program dapat dengan murah membandingkan dengan apa yang saat ini diposting dan menempatkan / membatalkan perbedaannya.

​

PDA Authority

Ada tepat satu PDA amm_authority untuk seluruh program AMM v4. Seed-nya trivial (["amm authority"]) dan bump-nya disimpan di setiap AmmInfo. Authority ini menandatangani semua pergerakan token untuk semua pool AMM v4.

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

Ada authority scoped-pool terpisah yang diturunkan per pool untuk menandatangani operasi OpenBook (amm_authority di atas sebenarnya mencakup keduanya dalam desain program ini; versi berbeda menggunakan derivasi berbeda, jadi periksa AmmInfo.nonce pool spesifik dalam kode).

​

Vault

Vault SPL Token pool adalah akun token standar yang owner-nya adalah amm_authority. Bukan ATA — alamatnya adalah PDA spesifik yang diturunkan pada Initialize dengan seed ["amm_associated_seed", coin_mint_or_pc_mint, market, amm_id]. Alamat disimpan di AmmInfo; derivasi adalah keingintahuan satu kali.

Token-2022 tidak didukung. Program hardcode ID program SPL Token untuk semua pergerakan vault. Mencoba mengikat pool AMM v4 ke mint Token-2022 gagal pada Initialize.

​

LP mint

Mint SPL Token klasik yang authority-nya adalah amm_authority. Total supply melacak kepemilikan LP dari pool; membakar LP mengembalikan token dari kedua vault secara pro-rata. Karena AMM v4 mendahului CPMM, tidak ada mirror lp_supply dalam status pool — baca supply mint on-chain secara langsung.

​

Bitmask status

AmmInfo.status membatasi operasi. Bit (posisi mungkin berbeda di seluruh versi program — konfirmasi melalui sumber):

Bit	Flag	Efek
0	SWAP_DISABLED	Swap* ditolak.
1	DEPOSIT_DISABLED	Deposit ditolak.
2	WITHDRAW_DISABLED	Withdraw ditolak.
3	CLMM_LIKE_MIGRATE	Flag gerbang migrasi yang digunakan oleh ops.

Multisig Raydium menetapkan ini melalui SetParams (dengan param = Status). (AdminCancelOrders telah dihapus.)

​

Observasi / oracle

AMM v4 tidak memiliki akun observasi khusus. Protokol lain yang membutuhkan TWAP on-chain biasanya mengonsumsi penyeberangan buku OpenBook secara tidak langsung atau membaca off-chain. Jika Anda membutuhkan TWAP Raydium dengan dukungan program, gunakan CPMM atau CLMM.

​

Menurunkan akun pool dari awal

Karena AMM v4 tidak dirancang untuk PDA per-pasangan deterministik (mendahului konvensi Solana itu), amm_id kanonik adalah keypair berseeded yang diturunkan dengan:

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

Pola kunci berseeded yang sama berlaku untuk amm_open_orders, amm_target_orders, amm_withdraw_queue, pool_temp_lp, pool_coin_token_account, pool_pc_token_account, dan lp_mint. SDK dan API pra-menghitung ini untuk Anda; lihat raydium-sdk-v2’s Liquidity.getAssociatedPoolKeys.

Dalam praktiknya, integrator membaca set akun lengkap pool dari GET https://api-v3.raydium.io/pools/info/ids?ids=<POOL_ID> atau dari SDK. Derivasi manual jarang diperlukan.

​

Referensi cepat siklus hidup

Peristiwa	Akun dibuat	Akun dihapus
Initialize2	amm_info, amm_open_orders, amm_target_orders, vault, lp_mint, pool_withdraw_queue, pool_temp_lp	—
Deposit	— (mungkin membuat ATA LP pengguna)	—
Withdraw	—	—
SwapBaseIn / SwapBaseOut (v1 / V2)	— (mungkin membuat ATA pengguna)	—
WithdrawPnl	—	—

Pool dan akun mereka bertahan selamanya. Bahkan jika likuiditas sepenuhnya ditarik, AmmInfo tetap ada.

​

Apa yang dibaca di mana

• Matematika dan aritmetika biaya: products/amm-v4/math.
• Pembagian biaya dan bagaimana perbandingannya dengan CPMM/CLMM: products/amm-v4/fees.
• Daftar akun instruksi: products/amm-v4/instructions.
• Derivasi akun OpenBook: Dokumen program OpenBook (github.com/openbook-dex/program).

Sumber:

• Program Raydium AMM — raydium-io/raydium-amm
• reference/program-addresses untuk ID program kanonik
• Protokol OpenBook / Serum untuk akun pihak lawan