AMM v4 Instruktionen

Jede AMM v4 Instruktion mit ihren Argumenten, den Pool- und OpenBook-Konten, die sie erwartet, sowie den Vor- und Nachbedingungen für jede.

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

Englische Version ansehen →

Ab dem Programm-Upgrade 2026-07 wurde die OpenBook-/Serum-Abhängigkeit von AMM v4 entfernt. Die Legacy-v1-Instruktionen SwapBaseIn / SwapBaseOut, Deposit und Withdraw behalten ihre alten Account-Layouts für Rückwärtskompatibilität: Die Market-Konten werden weiterhin in ihren alten Positionen akzeptiert, aber sie werden nicht mehr validiert oder verwendet (kein CPI wird ausgegeben). Neue Integrationen sollten die V2-Swap-Einstiegspunkte verwenden, die die Market-Konten vollständig weglassen. Mehrere Instruktionen wurden entfernt und kehren jetzt zurück – siehe den Changelog-Eintrag. Die Account-Listen unten verwenden die Feldnamen aus dem Raydium SDK; die zugrunde liegende IDL verwendet manchmal serum_*-Präfixe.

​

Instruktions-Übersicht

Gruppe	Instruktion	Tag	Hinweise
Pool-Lebenszyklus	Initialize2	1	Einzige Pool-Erstellungs-Instruktion (UI setzt Standard auf CPMM für neue Pools).
Liquidität	Deposit	3	Liquidität hinzufügen, LP erhalten. Layout unverändert (Market-Konten ignoriert).
Liquidität	Withdraw	4	LP verbrennen, beide Seiten pro-rata erhalten. Layout unverändert (Market-Konten ignoriert).
Swap	SwapBaseIn	9	Exakte-Input-Swap. v1-Layout unverändert; Market-Konten akzeptiert aber ignoriert.
Swap	SwapBaseOut	11	Exakte-Output-Swap. Wie oben.
Swap	SwapBaseInV2	16	Empfohlen. Exakte-Input-Swap ohne Market-Konten.
Swap	SwapBaseOutV2	17	Empfohlen. Exakte-Output-Swap ohne Market-Konten.
Wartung	SetParams	6	Admin: Pool-Parameter ändern. Layout + param-Werte geändert (Breaking).
Wartung	WithdrawPnl	7	Aufgelaufene Protokoll-PnL einziehen. Account-Layout geändert (Breaking).
Wartung	CreateConfigAccount	14	Admin: Initialisiere die Programm-Level-AmmConfig-PDA.
Wartung	UpdateConfigAccount	15	Admin: Ändere Programm-Level-Config-Parameter.

Das SDK stellt Builder nur für die benutzerorientierten Instruktionen bereit. Wartungs-Instruktionen werden typischerweise vom Raydium-Keeper aufgerufen.

Entfernt / nicht mehr aufrufbar (sie kehren jetzt mit unimplemented! zurück, und ihre Client-Builder wurden gelöscht): Initialize (Tag 0, verwende Initialize2), MonitorStep (2), MigrateToOpenBook (5), WithdrawSrm (8), PreInitialize (10, verwende Initialize2), SimulateInfo (12), AdminCancelOrders (13).

​

Initialize2

Starten Sie einen neuen AMM v4 Pool, der an einen bestehenden OpenBook-Market gebunden ist.

Argumente

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

Konten (schreibbar W, Unterzeichner S)

#	Name	W	S	Hinweise
1	token_program			SPL Token.
2	system_program
3	rent
4	amm	W		AmmInfo-Konto (Seed-Schlüssel).
5	amm_authority			Programm-PDA.
6	amm_open_orders	W		OpenBook OpenOrders (Seed).
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 des Erstellers.
15	pool_temp_lp_token_account	W		Scratch-Konto.
16	market_program			OpenBook-Programm.
17	market			OpenBook-Market.
18	user_wallet	W	S	Ersteller. Zahlt Miete und finanziert die erste Einzahlung.
19	user_token_coin	W
20	user_token_pc	W

Nachbedingungen

• lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN, wobei INIT_BURN ≈ 100 LP-Einheiten aus dem Verkehr gezogen werden.
• Es werden keine OpenBook-Aufträge gepostet (das Order-Book-Gitter wurde entfernt). market_program / market werden weiterhin übergeben, aber nur als Referenzfelder gespeichert; coin_lot_size / pc_lot_size / min_size werden auf 0 initialisiert.

Häufige Fehler — InvalidInput (nicht übereinstimmende Dezimalstellen, nicht sortiert), NotAllowed.

​

Deposit

Liquidität hinzufügen.

Argumente

max_coin_amount: u64
max_pc_amount:   u64
base_side:       u64    // 0 = Basis auf Coin, 1 = Basis auf PC
// (einige SDK-Varianten akzeptieren auch other_amount_min)

Konten (gekürzt)

#	Name	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

Mathematik — Standard pro-rata. Mit den effektiven Reserven des Pools (Vaults + On-Book) berechnet das SDK das Coin/PC-Paar, das die angegebene LP-Menge ergibt, und prüft es gegen max_*. Kehrt mit ExceededSlippage zurück, wenn eine Seite die Obergrenze überschreitet.

​

Withdraw

LP verbrennen, beide Seiten erhalten.

Argumente

amount: u64    // Zu verbrennende LP

Konten — wie Deposit mit umgekehrter Richtung; lp_mint ist schreibbar zum Verbrennen, die Benutzer-ATAs sind Empfänger. Das Account-Layout ist unverändert (Market-Konten werden weiterhin positionell übergeben, ignoriert). Es gibt keinen Settle-from-OpenBook-Schritt mehr – die Pro-Rata-Mathematik verwendet die Vault-Salden direkt.

​

SwapBaseIn

Exakte-Input-Swap. Immer ein AMM-Pfad-Swap (wird nicht durch OpenBook-Matching weitergeleitet).

Verwenden Sie die V2-Varianten für neuen Code. Da die OpenBook-Abhängigkeit von AMM v4 entfernt wurde, erwarten die V1-Einstiegspunkte (SwapBaseIn, SwapBaseOut) weiterhin die vollständige 17-Account-Liste (oder 18 mit dem optionalen Target-Orders-Konto), aber die OpenBook/Market-Konten werden jetzt positionell akzeptiert und ignoriert – sie werden nicht validiert und kein CPI wird ausgegeben. Das Übergeben einer falschen Account-Anzahl kehrt weiterhin mit WrongAccountsNumber zurück, aber der Market-Account-Inhalt wird nicht mehr überprüft. Neue Integrationen sollten SwapBaseInV2 / SwapBaseOutV2 verwenden, die eine viel kleinere Account-Liste benötigen und den kanonischen Ausführungspfad heute darstellen. Die V1-Formen werden hier der Vollständigkeit halber und zum Lesen bestehender On-Chain-Transaktionen dokumentiert.

Argumente

amount_in:            u64
minimum_amount_out:   u64

Konten (gekürzt)

#	Name	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

Mathematik — siehe products/amm-v4/math.

Vorbedingungen

• amm.status erlaubt Swap (Bit 0 der Status-Bitmaske nicht gesetzt).
• amm.state_data.pool_open_time <= now.
• amount_in > 0.
• user_source_token_account hält mindestens amount_in.

Nachbedingungen

• Benutzer verliert amount_in des Quell-Tokens, gewinnt amount_out ≥ minimum_amount_out des Ziel-Tokens.
• need_take_pnl_* erhöht um den Protokoll-Fee-Anteil.
• Hinweis: Die state_data.swap_*_in_amount / swap_*_out_amount Analytics-Zähler werden nicht mehr aktualisiert – ihre Werte sind eingefroren. Verwenden Sie Trade-Logs für Volume-Analytics.

Häufige Fehler — ExceededSlippage, InvalidInput, InvalidStatus, NotAllowed (Coin/PC-Mint identisch).

​

SwapBaseOut

Exakte-Output, Umkehrung von SwapBaseIn. Gleiche Konten.

Argumente

max_amount_in: u64
amount_out:    u64

​

SwapBaseInV2 / SwapBaseOutV2

Varianten-Swap-Einstiegspunkte (Tags 16 / 17), die die OpenBook-Konten vollständig überspringen. Die Mathematik ist identisch mit dem V1-Pfad, aber die Account-Liste schrumpft auf nur die AMM-Seite und den Benutzer – 8 Konten, und amm_open_orders wird nicht übergeben:

#	Name	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

Pool-Reserven sind jetzt die Vault-Salden (minus ausstehende PnL), daher ist die Quote-Mathematik unkompliziert und identisch mit dem v1-Pfad. Verwenden Sie V2, um Compute zu sparen und das Übergeben der (jetzt ignorierten) Market-Konten zu vermeiden. Der Raydium-Router verwendet immer die V2-Form beim Routing durch AMM v4.

Die Argumente sind die gleichen wie die V1-Formen (amount_in / minimum_amount_out für SwapBaseInV2; max_amount_in / amount_out für SwapBaseOutV2).

​

MonitorStep und andere entfernte Instruktionen

Entfernt – nicht mehr aufrufbar. Ab dem Upgrade 2026-07 wurde MonitorStep (Tag 2) aus dem Programm entfernt und kehrt jetzt zurück (unimplemented!), wenn es aufgerufen wird. Sein Client-Builder wurde ebenfalls gelöscht. Das Gleiche gilt für MigrateToOpenBook (5), WithdrawSrm (8), SimulateInfo (12), AdminCancelOrders (13) und die Legacy-Pool-Erstellungs-Einstiegspunkte Initialize (0) / PreInitialize (10) – verwenden Sie stattdessen Initialize2.

Historisch betrieb MonitorStep die OpenBook-Interaktion des Pools: Es siedelte gefüllte Aufträge an (bewegte Erlöse aus den Market-Vaults in die Pool-Vaults über OpenBook CPI), stornierte veraltete Aufträge und postete neue Aufträge, um die Lücke zwischen target_orders und amm_open_orders zu schließen. Mit der entfernten OpenBook-Abhängigkeit gibt es nichts mehr zu betreiben und die Instruktion ist weg. Jeder Keeper oder jede Integration, die sie noch aufruft, muss den Aufruf entfernen.

​

WithdrawPnl / TakePnl

Admin-Einzug aufgelaufener Protokoll-Gebühren.

Argumente

• WithdrawPnl nimmt keine Argumente; es liest need_take_pnl_* und bewegt diese genauen Beträge.

Breaking Change (nur Admin). Die Account-Liste sank von 17 (+1 optional) auf 10 – amm_open_orders und alle sechs Market-Konten wurden entfernt – ohne Kompatibilitäts-Parsing. Das alte Layout ist nicht ausgerichtet (altes #5 war amm_open_orders, jetzt pool_coin_token_account) und schlägt mit Fehlern wie InvalidCoinVault fehl. Admin-Tools müssen aktualisiert werden.

Konten (neues 10-Account-Layout)

#	Name	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		Empfänger.
8	pnl_pc_token_account	W
9	pnl_owner		S	Admin-Multisig.
10	amm_target_orders	W

Effekt

• Überträgt need_take_pnl_coin von pool_coin_token_account zu pnl_coin_token_account.
• Gleiches für PC.
• Setzt need_take_pnl_coin und need_take_pnl_pc auf Null.
• Logik-Änderung: Wenn der Vault-Saldo nicht ausreicht, um aufgelaufene PnL zu decken, gibt die Instruktion direkt TakePnlError zurück (sie manipuliert nicht mehr den Order-Book-Status).

Keine Änderung der Reserven, da aufgelaufene PnL bereits aus der Invariante ausgeschlossen war.

​

SetParams

Admin-Parameter-Änderungen, aufgerufen vom Raydium-Multisig. Argumente sind ein param: u8-Tag + Payload.

Breaking Change (nur Admin). Die Account-Liste wurde auf nur [amm (W), admin (S)] reduziert (die Authority, Open-Orders, Target-Orders, Vault und alle Market-Konten wurden entfernt). Das param-Enum wurde neu nummeriert und gekürzt: Status = 0, State = 1, Fees = 2 (war 9), SetOpenTime = 3 (war 11). Alle Order-Book-Grid-Parameter und AmmOwner, LastOrderDistance, UpdateOpenOrder wurden entfernt, und die SetParamsInstruction-Struktur verlor new_pubkey und last_order_distance. Admin-Tools müssen aktualisiert werden.

​

Zustandsänderungs-Matrix

Die OpenBook-Spalte ist weg – keine Instruktion berührt mehr ein Order-Book.

Instruktion	lp_mint-Angebot	Vaults	PnL-Zähler
Initialize2	Init-Angebot an Ersteller geprägt	+ init_coin_amount, + init_pc_amount	0
Deposit	+	+ beide	—
Withdraw	−	− beide	—
SwapBaseIn / SwapBaseInV2	—	+ rein, − raus	+ pnl-Anteil
SwapBaseOut / SwapBaseOutV2	—	+ rein, − raus	+ pnl-Anteil
WithdrawPnl	—	− (pnl eingezogen)	0
SetParams	—	—	—

​

Nächste Schritte

• products/amm-v4/code-demos — TypeScript-Beispiele für Swap- und LP-Flows.
• products/amm-v4/fees — WithdrawPnl-Details und die Fee-Aufteilung.
• reference/error-codes — Vorwärts-Referenztabelle (AMM v4-Fehler sind auf dieser Seite aufgelistet).

Quellen:

• Raydium AMM-Programm — raydium-io/raydium-amm
• Raydium SDK v2 Liquidity-Modul
• OpenBook-Programm – Account-Validierungen auf der Market-Seite