Instruksi AMM v4

Setiap instruksi AMM v4 dengan argumennya, akun pool dan OpenBook yang diharapkan, serta kondisi pre/post pada masing-masing.

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

Lihat versi bahasa Inggris →

Sejak pembaruan program 2026-07, ketergantungan OpenBook / Serum AMM v4 telah dihapus. Instruksi v1 warisan SwapBaseIn / SwapBaseOut, Deposit, dan Withdraw mempertahankan tata letak akun lama untuk kompatibilitas mundur: akun pasar masih diterima di posisi lama mereka, tetapi mereka tidak lagi divalidasi atau digunakan (tidak ada CPI yang dikeluarkan). Integrasi baru harus menggunakan titik masuk swap V2, yang menghilangkan akun pasar sepenuhnya. Beberapa instruksi telah dihapus dan sekarang kembali — lihat entri changelog. Daftar akun di bawah menggunakan nama bidang dari Raydium SDK; IDL yang mendasar kadang-kadang menggunakan awalan serum_*.

​

Inventaris instruksi

Grup	Instruksi	tag	Catatan
Siklus hidup pool	Initialize2	1	Satu-satunya instruksi pembuatan pool (UI default ke CPMM untuk pool baru).
Likuiditas	Deposit	3	Tambah likuiditas, terima LP. Tata letak tidak berubah (akun pasar diabaikan).
Likuiditas	Withdraw	4	Bakar LP, terima kedua sisi secara pro-rata. Tata letak tidak berubah (akun pasar diabaikan).
Swap	SwapBaseIn	9	Swap input-tepat. Tata letak v1 tidak berubah; akun pasar diterima tetapi diabaikan.
Swap	SwapBaseOut	11	Swap output-tepat. Sama seperti di atas.
Swap	SwapBaseInV2	16	Direkomendasikan. Swap input-tepat tanpa akun pasar.
Swap	SwapBaseOutV2	17	Direkomendasikan. Swap output-tepat tanpa akun pasar.
Pemeliharaan	SetParams	6	Admin: ubah parameter pool. Tata letak + nilai param berubah (breaking).
Pemeliharaan	WithdrawPnl	7	Kumpulkan PnL protokol yang terkumpul. Tata letak akun berubah (breaking).
Pemeliharaan	CreateConfigAccount	14	Admin: inisialisasi PDA AmmConfig tingkat program.
Pemeliharaan	UpdateConfigAccount	15	Admin: ubah parameter konfigurasi tingkat program.

SDK mengekspos builder hanya untuk instruksi yang menghadap pengguna. Instruksi pemeliharaan biasanya dipanggil oleh keeper Raydium.

Dihapus / tidak lagi dapat dipanggil (mereka sekarang kembali dengan unimplemented!, dan builder klien mereka dihapus): Initialize (tag 0, gunakan Initialize2), MonitorStep (2), MigrateToOpenBook (5), WithdrawSrm (8), PreInitialize (10, gunakan Initialize2), SimulateInfo (12), AdminCancelOrders (13).

​

Initialize2

Bootstrap pool AMM v4 baru yang terikat ke pasar OpenBook yang ada.

Argumen

nonce:        u8
open_time:    u64
init_pc_amount:   u64
init_coin_amount: u64

Akun (dapat ditulis W, penandatangan S)

#	Nama	W	S	Catatan
1	token_program			SPL Token.
2	system_program
3	rent
4	amm	W		Akun AmmInfo (kunci bersemai).
5	amm_authority			Program PDA.
6	amm_open_orders	W		OpenBook OpenOrders (bersemai).
7	lp_mint	W
8	coin_mint
9	pc_mint
10	pool_coin_token_account	W
11	pool_pc_token_account	W
12	pool_withdraw_queue	W
13	pool_target_orders_account	W
14	pool_lp_token_account	W		LP ATA pembuat.
15	pool_temp_lp_token_account	W		Akun awal.
16	market_program			Program OpenBook.
17	market			Pasar OpenBook.
18	user_wallet	W	S	Pembuat. Membayar sewa dan mendanai deposit awal.
19	user_token_coin	W
20	user_token_pc	W

Kondisi pasca

• lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN, di mana INIT_BURN ≈ 100 unit LP disimpan di luar peredaran.
• Tidak ada pesanan OpenBook yang diposting (kisi order-book telah dihapus). market_program / market masih dilewatkan tetapi hanya disimpan sebagai bidang referensi; coin_lot_size / pc_lot_size / min_size diinisialisasi ke 0.

Kesalahan umum — InvalidInput (desimal tidak cocok, tidak diurutkan), NotAllowed.

​

Deposit

Tambah likuiditas.

Argumen

max_coin_amount: u64
max_pc_amount:   u64
base_side:       u64    // 0 = base pada coin, 1 = base pada pc
// (beberapa varian SDK juga menerima other_amount_min)

Akun (ringkas)

#	Nama	W	S
1	token_program
2	amm	W
3	amm_authority
4	amm_open_orders
5	amm_target_orders	W
6	lp_mint	W
7	pool_coin_token_account	W
8	pool_pc_token_account	W
9	market
10	user_coin_token_account	W
11	user_pc_token_account	W
12	user_lp_token_account	W
13	user_owner		S

Matematika — pro-rata standar. Menggunakan cadangan efektif pool (vault + on-book), SDK menghitung pasangan coin/pc yang menghasilkan jumlah LP yang diberikan dan memeriksanya terhadap max_*. Kembali dengan ExceededSlippage jika salah satu sisi melebihi batas.

​

Withdraw

Bakar LP, terima kedua sisi.

Argumen

amount: u64    // LP untuk dibakar

Akun — seperti Deposit dengan arah terbalik; lp_mint dapat ditulis untuk pembakaran, ATA pengguna adalah penerima. Tata letak akun tidak berubah (akun pasar masih dilewatkan secara posisional, diabaikan). Tidak ada lagi langkah settle-from-OpenBook — matematika pro-rata menggunakan saldo vault secara langsung.

​

SwapBaseIn

Swap input-tepat. Selalu swap jalur AMM (tidak merutekan melalui pencocokan OpenBook).

Gunakan varian V2 untuk kode baru. Karena ketergantungan OpenBook AMM v4 telah dihapus, titik masuk V1 (SwapBaseIn, SwapBaseOut) masih mengharapkan daftar akun lengkap 17 (atau 18 dengan akun target-orders opsional), tetapi akun OpenBook/pasar sekarang diterima secara posisional dan diabaikan — mereka tidak divalidasi dan tidak ada CPI yang dikeluarkan. Melewatkan jumlah akun yang salah masih kembali dengan WrongAccountsNumber, tetapi isi akun pasar tidak lagi diperiksa. Integrasi baru harus menggunakan SwapBaseInV2 / SwapBaseOutV2, yang mengambil daftar akun yang jauh lebih kecil dan mewakili jalur eksekusi kanonik hari ini. Bentuk V1 didokumentasikan di sini untuk kelengkapan dan untuk membaca transaksi on-chain yang ada.

Argumen

amount_in:            u64
minimum_amount_out:   u64

Akun (ringkas)

#	Nama	W	S
1	token_program
2	amm	W
3	amm_authority
4	amm_open_orders	W
5	amm_target_orders	W
6	pool_coin_token_account	W
7	pool_pc_token_account	W
8	market_program
9	market	W
10	market_bids	W
11	market_asks	W
12	market_event_queue	W
13	market_coin_vault	W
14	market_pc_vault	W
15	market_vault_signer
16	user_source_token_account	W
17	user_dest_token_account	W
18	user_owner		S

Matematika — lihat products/amm-v4/math.

Kondisi awal

• amm.status memungkinkan swap (bit 0 dari bitmask status tidak diatur).
• amm.state_data.pool_open_time <= now.
• amount_in > 0.
• user_source_token_account memegang setidaknya amount_in.

Kondisi pasca

• Pengguna kehilangan amount_in dari token sumber, mendapatkan amount_out ≥ minimum_amount_out dari token tujuan.
• need_take_pnl_* ditambah dengan bagian biaya protokol.
• Catatan: penghitung analitik state_data.swap_*_in_amount / swap_*_out_amount tidak lagi diperbarui — nilainya dibekukan. Gunakan log perdagangan untuk analitik volume.

Kesalahan umum — ExceededSlippage, InvalidInput, InvalidStatus, NotAllowed (mint coin/pc identik).

​

SwapBaseOut

Output-tepat, kebalikan dari SwapBaseIn. Akun yang sama.

Argumen

max_amount_in: u64
amount_out:    u64

​

SwapBaseInV2 / SwapBaseOutV2

Varian titik masuk swap (tag 16 / 17) yang melewatkan akun OpenBook sepenuhnya. Matematika identik dengan jalur V1, tetapi daftar akun menyusut menjadi hanya sisi AMM dan pengguna — 8 akun, dan amm_open_orders tidak dilewatkan:

#	Nama	W	S
1	token_program
2	amm	W
3	amm_authority
4	pool_coin_token_account	W
5	pool_pc_token_account	W
6	user_source_token_account	W
7	user_dest_token_account	W
8	user_owner		S

Cadangan pool sekarang adalah saldo vault (minus PnL tertunda), jadi matematika kutipan langsung dan identik dengan jalur v1. Gunakan V2 untuk menghemat komputasi dan menghindari melewatkan akun pasar (sekarang diabaikan). Router Raydium selalu menggunakan bentuk V2 saat merutekan melalui AMM v4.

Argumen sama dengan bentuk V1 (amount_in / minimum_amount_out untuk SwapBaseInV2; max_amount_in / amount_out untuk SwapBaseOutV2).

​

MonitorStep dan instruksi dihapus lainnya

Dihapus — tidak lagi dapat dipanggil. Sejak pembaruan 2026-07, MonitorStep (tag 2) telah dihapus dari program dan sekarang kembali (unimplemented!) jika dipanggil. Builder kliennya juga dihapus. Hal yang sama berlaku untuk MigrateToOpenBook (5), WithdrawSrm (8), SimulateInfo (12), AdminCancelOrders (13), dan titik masuk pembuatan pool warisan Initialize (0) / PreInitialize (10) — gunakan Initialize2 sebagai gantinya.

Secara historis, MonitorStep menggerakkan interaksi OpenBook pool: ia menyelesaikan pesanan yang diisi (memindahkan hasil dari vault pasar ke vault pool melalui CPI OpenBook), membatalkan pesanan basi, dan memposting pesanan baru untuk menutup celah antara target_orders dan amm_open_orders. Dengan ketergantungan OpenBook dihapus, tidak ada yang perlu dikgerakkan dan instruksi hilang. Setiap keeper atau integrasi yang masih memanggilnya harus menghapus panggilan.

​

WithdrawPnl / TakePnl

Penyapuan admin biaya protokol yang terkumpul.

Argumen

• WithdrawPnl tidak mengambil argumen; ia membaca need_take_pnl_* dan memindahkan jumlah yang tepat.

Perubahan breaking (admin saja). Daftar akun turun dari 17 (+1 opsional) menjadi 10 — amm_open_orders dan keenam akun pasar dihapus — tanpa penguraian kompatibilitas. Tata letak lama tidak selaras (lama #5 adalah amm_open_orders, sekarang pool_coin_token_account) dan gagal dengan kesalahan seperti InvalidCoinVault. Alat admin harus diperbarui.

Akun (tata letak 10-akun baru)

#	Nama	W	S
1	token_program
2	amm	W
3	amm_config
4	amm_authority
5	pool_coin_token_account	W
6	pool_pc_token_account	W
7	pnl_coin_token_account	W		Penerima.
8	pnl_pc_token_account	W
9	pnl_owner		S	Multisig admin.
10	amm_target_orders	W

Efek

• Mentransfer need_take_pnl_coin dari pool_coin_token_account ke pnl_coin_token_account.
• Sama untuk pc.
• Mengosongkan need_take_pnl_coin dan need_take_pnl_pc.
• Perubahan logika: jika saldo vault tidak cukup untuk menutupi PnL yang terkumpul, instruksi mengembalikan TakePnlError secara langsung (tidak lagi memanipulasi status order-book).

Tidak ada perubahan pada cadangan karena PnL yang terkumpul sudah dikecualikan dari invarian.

​

SetParams

Perubahan parameter admin, dipanggil oleh multisig Raydium. Argumen adalah tag param: u8 + payload.

Perubahan breaking (admin saja). Daftar akun dikurangi menjadi hanya [amm (W), admin (S)] (otoritas, open-orders, target-orders, vault, dan semua akun pasar dihapus). Enum param dinomori ulang dan dipangkas: Status = 0, State = 1, Fees = 2 (sebelumnya 9), SetOpenTime = 3 (sebelumnya 11). Semua parameter kisi order-book dan AmmOwner, LastOrderDistance, UpdateOpenOrder dihapus, dan struct SetParamsInstruction menghilangkan new_pubkey dan last_order_distance. Alat admin harus diperbarui.

​

Matriks perubahan status

Kolom OpenBook hilang — tidak ada instruksi yang menyentuh order book lagi.

Instruksi	Pasokan lp_mint	Vault	Penghitung PnL
Initialize2	pasokan init dicetak ke pembuat	+ init_coin_amount, + init_pc_amount	0
Deposit	+	+ kedua	—
Withdraw	−	− kedua	—
SwapBaseIn / SwapBaseInV2	—	+ in, − out	+ bagian pnl
SwapBaseOut / SwapBaseOutV2	—	+ in, − out	+ bagian pnl
WithdrawPnl	—	− (pnl disapu)	0
SetParams	—	—	—

​

Ke mana selanjutnya

• products/amm-v4/code-demos — Contoh TypeScript untuk alur swap dan LP.
• products/amm-v4/fees — Detail WithdrawPnl dan pembagian biaya.
• reference/error-codes — Tabel referensi maju (kesalahan AMM v4 tercantum di halaman itu).

Sumber:

• Program Raydium AMM — raydium-io/raydium-amm
• Modul Liquidity Raydium SDK v2
• Program OpenBook — validasi akun di sisi pasar