Akun AMM v4

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 pernah dibuat atau dibaca oleh program saat ini, yang menulis `AmmInfo.open_orders = Pubkey::default()` pada setiap pool baru; hanya pool yang dibuat sebelum penghapusan OpenBook yang membawa nilai sungguhan. 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.
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 padding1: [u64; 8],     // reserved — NOT withdraw_queue / lp_vault
    pub amm_owner: Pubkey,      // admin (multisig)
    pub lp_amount: u64,         // the pool's internal LP total; see the note below
    pub client_order_id: u64,
    pub recent_epoch: u64,
    pub padding2: u64,
}

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 — satu status u64 terenumerasi yang membatasi operasi, bukan bitmask. Dapat diatur admin melalui SetParams dengan param = 0 (Status). Lihat Status di bawah.
lp_amount — total LP internal pool. Nilainya tidak sama dengan lp_mint.supply: nilainya lebih tinggi tepat satu token LP utuh (10^coin_decimals unit dasar), karena jumlah itu dihitung saat init tetapi tidak pernah di-mint. Semua matematika pro-rata memakai lp_amount, jadi gunakan itu juga.
amm_owner — ditulis saat pembuatan dari kunci admin yang di-hardcode pada program, bukan dari kreator.
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,
);

Tidak ada authority kedua yang berskala pool: satu PDA ini mencakup semua yang ditandatangani program. Bump-nya adalah 254 di mainnet dan dicerminkan pada setiap AmmInfo sebagai nonce; WithdrawExcessLamports menurunkannya kembali dengan nonce itu di-hardcode.

Vault

Vault SPL Token pool adalah akun token standar yang owner-nya adalah amm_authority. Bukan ATA — alamatnya adalah PDA yang diturunkan pada Initialize2 dari [AMM_V4_PROGRAM_ID, market, "coin_vault_associated_seed"] dan [AMM_V4_PROGRAM_ID, market, "pc_vault_associated_seed"]. Mint bukan seed, dan amm_id juga bukan. 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 Initialize2 dengan InvalidSplTokenProgram.

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. Mirror dalam status memang ada: AmmInfo.lp_amount. Nilainya tidak sama dengan supply mint — nilainya lebih tinggi tepat satu token LP utuh (10^coin_decimals unit dasar), karena jumlah itu dihitung saat init tetapi tidak pernah di-mint. Setiap perhitungan pro-rata dalam program membagi dengan lp_amount, jadi gunakan bidang itu daripada supply on-chain mint.

Status

AmmInfo.status adalah satu status u64 terenumerasi, bukan bitmask. Uji dengan kesetaraan — klien yang menguji status & 1 salah mengklasifikasikan setiap pool aktif, karena status perdagangan normal adalah 6, yang bit 0-nya disetel.

Nilai	`AmmStatus`	Swap	Deposit	Withdraw
0	`Uninitialized`	tidak	tidak	tidak
1	`Initialized`	ya	ya	ya
2	`Disabled`	tidak	tidak	tidak
3	`WithdrawOnly`	tidak	tidak	ya
4	`LiquidityOnly`	tidak	ya	ya
5	`OrderBookOnly`	tidak	ya	ya
6	`SwapOnly`	ya	ya	ya
7	`WaitingTrade`	ya, setelah `pool_open_time` terlewati	ya	ya

Initialize2 menulis 7 ketika open_time berada di masa depan dan 6 jika tidak; pool pada 7 beralih sendiri ke 6 pada swap pertama pada atau setelah state_data.pool_open_time. Nilai di luar 0..=7 membuat AmmStatus::from_u64 panic. Multisig Raydium menetapkan status melalui SetParams dengan param = 0 (Status); hanya nilai 1–7 yang diterima. (AdminCancelOrders telah dihapus.)

Observasi / oracle

AMM v4 tidak memiliki akun observasi khusus, dan sejak penghapusan OpenBook juga tidak ada status order-book untuk menurunkannya. Jika Anda membutuhkan TWAP Raydium dengan dukungan program, gunakan CPMM atau CLMM — keduanya memelihara ring buffer ObservationState. Jika tidak, indeks log swap secara off-chain.

Menurunkan akun pool dari awal

Akun pool AMM v4 adalah PDA biasa yang dikunci pada pasar terikat — bukan keypair berseeded, dan bukan PDA per-pasangan. Daftar berikut lengkap: tidak ada akun ObservationState di antaranya. Setiap akun memakai bentuk tiga-seed yang sama [AMM_V4_PROGRAM_ID, market, <label>] di bawah AMM_V4_PROGRAM_ID:

Account	`<label>`
`amm_id` (`AmmInfo`)	`"amm_associated_seed"`
`amm_target_orders`	`"target_associated_seed"`
`lp_mint`	`"lp_mint_associated_seed"`
`pool_coin_token_account`	`"coin_vault_associated_seed"`
`pool_pc_token_account`	`"pc_vault_associated_seed"`

const [ammId] = PublicKey.findProgramAddressSync(
  [
    AMM_V4_PROGRAM_ID.toBuffer(),
    marketPubkey.toBuffer(),
    Buffer.from("amm_associated_seed"),
  ],
  AMM_V4_PROGRAM_ID,
);

Pasar terikat adalah satu-satunya seed variabel, itulah sebabnya satu pasar dipetakan ke tepat satu pool AMM v4. SDK dan API pra-menghitung ini untuk Anda; lihat Liquidity.getAssociatedPoolKeys dari raydium-sdk-v2. 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_target_orders`, kedua vault, `lp_mint`, dan ATA LP kreator	—
`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: sumber program OpenBook (github.com/openbook-dex/program) — sebuah monorepo Rust, bukan dokumentasi prosa.

Sumber:

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

Products

Algorithms

Inventaris

`AmmInfo`

Pengkabelan OpenBook

PDA Authority

Vault

LP mint

Status

Observasi / oracle

Menurunkan akun pool dari awal

Referensi cepat siklus hidup

Apa yang dibaca di mana

​Inventaris

​AmmInfo

​Pengkabelan OpenBook

​PDA Authority

​Vault

​LP mint

​Status

​Observasi / oracle

​Menurunkan akun pool dari awal

​Referensi cepat siklus hidup

​Apa yang dibaca di mana

Inventaris

`AmmInfo`

Pengkabelan OpenBook

PDA Authority

Vault

LP mint

Status

Observasi / oracle

Menurunkan akun pool dari awal

Referensi cepat siklus hidup

Apa yang dibaca di mana