AMM v4 Anweisungen

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

Seit dem Programm-Upgrade 2026-07 wurde die OpenBook-/Serum-Abhängigkeit von AMM v4 entfernt. Die Legacy-v1-Anweisungen SwapBaseIn / SwapBaseOut, Deposit und Withdraw behalten ihre alten Kontolayouts für Rückwärtskompatibilität: Die Market-Konten werden weiterhin in ihren alten Positionen akzeptiert, aber sie werden nicht mehr validiert oder verwendet (es wird kein CPI ausgegeben). Neue Integrationen sollten die V2-Swap-Einstiegspunkte verwenden, die die Market-Konten vollständig weglassen. Mehrere Anweisungen wurden entfernt und kehren jetzt zurück – siehe den Changelog-Eintrag. Die Kontolisten unten verwenden die Feldnamen aus dem Raydium SDK; die zugrunde liegende IDL verwendet manchmal serum_*-Präfixe.Das Programm-Upgrade 2026-09 fügt eine Admin-Anweisung hinzu, WithdrawExcessLamports (Tag 18), und entfernt die Rent-Sysvar aus CreateConfigAccount. Alles, was ein Trader oder LP aufruft, bleibt unverändert. Siehe den Changelog-Eintrag vom 2026-09-09.

Anweisungsübersicht

Gruppe	Anweisung	Tag	Hinweise
Pool-Lebenszyklus	`Initialize2`	1	Einzige Pool-Erstellungsanweisung (UI standardmäßig 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 die Market-Konten.
Swap	`SwapBaseOutV2`	17	Empfohlen. Exakte-Output-Swap ohne die Market-Konten.
Wartung	`SetParams`	6	Admin: Pool-Parameter ändern. Layout + `param`-Werte geändert (Breaking).
Wartung	`WithdrawPnl`	7	Aufgelaufene Protokoll-PnL abräumen. Kontolayout geändert (Breaking).
Wartung	`CreateConfigAccount`	14	Admin: Programm-Level-`AmmConfig`-PDA initialisieren.
Wartung	`UpdateConfigAccount`	15	Admin: Programm-Level-Config-Parameter ändern.
Wartung	`WithdrawExcessLamports`	18	Admin: Lamports über dem Rent-Exempt-Minimum von Programm-kontrollierten Konten abräumen. Hinzugefügt 2026-09.

Das SDK stellt Builder nur für die benutzerorientierten Anweisungen bereit. Wartungsanweisungen werden typischerweise vom Raydium-Keeper aufgerufen. Entfernt / nicht mehr aufrufbar (ihre Client-Builder wurden gelöscht): Initialize (Tag 0, verwenden Sie Initialize2), MonitorStep (2), MigrateToOpenBook (5), WithdrawSrm (8), PreInitialize (10, verwenden Sie Initialize2), SimulateInfo (12), AdminCancelOrders (13). Eine Transaktion mit einem dieser Tags schlägt fehl; das Programm führt die Anweisung nie aus. Behandeln Sie alle sieben als gelöscht, nicht als Fehlerpfade zum Verarbeiten.

`Initialize2`

Bootstrappen 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 (beschreibbar 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 Rent 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 = base auf coin, 1 = base 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    // LP zum Verbrennen

Konten — wie Deposit mit umgekehrter Richtung; lp_mint ist beschreibbar zum Verbrennen, die Benutzer-ATAs sind Empfänger. Das Kontolayout 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-Kontoliste (oder 18 mit dem optionalen Target-Orders-Konto), aber die OpenBook-/Market-Konten werden jetzt positionell akzeptiert und ignoriert – sie werden nicht validiert und es wird kein CPI ausgegeben. Das Übergeben einer falschen Kontoanzahl kehrt weiterhin mit WrongAccountsNumber zurück, aber der Inhalt der Market-Konten wird nicht mehr überprüft. Neue Integrationen sollten SwapBaseInV2 / SwapBaseOutV2 verwenden, die eine viel kleinere Kontoliste 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 Kontoliste 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 Anweisungen

Entfernt – nicht mehr aufrufbar. Seit 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 gesehen 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 Anweisung ist weg. Jeder Keeper oder jede Integration, die sie noch aufruft, muss den Aufruf entfernen.

`WithdrawPnl` / `TakePnl`

Admin-Abräumung 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 Kontoliste fiel 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-Konto-Layout)

#	Name	W	S	Hinweise
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 Anweisung 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 Kontoliste 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 umnummeriert 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.

`CreateConfigAccount` / `UpdateConfigAccount`

Admin-Verwaltung der Programm-Level-AmmConfig-PDA (Seed ["amm_config_account_seed"]), die den PnL-Besitzer, die Pool-Erstellungsgebühr und das Pool-Erstellungs-Flag enthält.

Geändert in 2026-09 und rückwärtskompatibel. CreateConfigAccount liest die Rent-Sysvar nicht mehr. Seine Kontoliste ist jetzt 4 Konten, reduziert von 5:

#	Name	W	S
1	`admin`	W	S
2	`amm_config`	W
3	`pnl_owner`
4	`system_program`

Das Programm liest Rent-Parameter von Rent::get() statt eine übergebene Sysvar-Konto zu deserialisieren – was die Solana 3.0-Abhängigkeits-Erhöhung natürlich machte.Das entfernte Konto war zuletzt in der Liste, und der Handler liest seine Konten positionell durch next_account_info ohne Längenkontrolle. Ein bestehendes Admin-Tool, das weiterhin die alte 5-Kontoliste übergibt, funktioniert daher weiterhin: das nachfolgende Rent-Konto wird einfach nie gelesen. Aktualisieren Sie es, wenn es bequem ist, nicht dringend. UpdateConfigAccount ist unverändert.

Initialize2 behält die Rent-Sysvar in Position 3 und verwendet sie weiterhin: Das Programm hat aufgehört, Rent::from_account_info darauf aufzurufen, aber es wird weiterhin in die spl_token::initialize_account und initialize_mint CPIs weitergeleitet, die die Pool-Vaults und LP-Mint erstellen. Lassen Sie es nicht aus der Kontoliste fallen.

`WithdrawExcessLamports`

Admin-Abräumung von Lamports, die über dem Rent-Exempt-Minimum auf Konten sitzen, die das Programm kontrolliert. Hinzugefügt im Upgrade 2026-09, um die Über-Finanzierung wiederherzustellen, die die SIMD-0437 Rent-Reduktion auf Konten hinterlässt, die vor jedem Schritt erstellt wurden. Es bewegt nur den Überschuss. Token-Salden, Kontodaten, Besitzer und Pool-Status bleiben unverändert, und die Anweisung ist ein No-Op auf einem Konto, das bereits bei seinem Minimum ist – daher ist es sicher, sie wiederholt und erneut nach jedem Rollout-Schritt auszuführen. Argumente — keine. Die Payload ist das einzelne Tag-Byte 18. Konten

#	Name	W	S	Hinweise
1	`collect_lamports`	W	S	Ziel für jeden abgeräumten Lamport. Muss gleich der Collect-Lamports-Wallet des Clusters sein – siehe `reference/program-addresses`. Jeder andere Unterzeichner schlägt mit `InvalidSignAccount` fehl.
2	`amm_authority`			Die einzelne AMM v4 Authority-PDA, vom Programm aus `["amm authority"]` mit einem festen Nonce von `254` neu abgeleitet. Sie unterzeichnet die Token-Programm-CPIs.
3	`token_program`			SPL Token. Überprüft gegen `spl_token::id()`; ein falscher Wert schlägt mit `InvalidSplTokenProgram` fehl.
4..	Quellkonten	W		`M` Konten zum Abräumen, beliebige Anzahl, beliebige Reihenfolge.

Wie jedes Quellkonto behandelt wird Das Programm verteilt auf den owner des Quellkontos:

Quellkonto-Besitzer	Behandlung
SPL Token, `data_len == 165` (ein Token-Konto), nicht-nativ	CPI `WithdrawExcessLamports` (Token-Programm-Diskriminant `38`), unterzeichnet von `amm_authority`.
SPL Token, `data_len == 165`, nativ (wSOL)	`WithdrawExcessLamports` kann nicht auf einem nativen Konto verwendet werden. Das Programm CPIs `SyncNative`, misst, wie viel der verpackte `amount` wuchs, `UnwrapLamports` (Diskriminant `45`) für genau dieses Delta, dann behauptet der verpackte Saldo ist auf seinen Pre-Sync-Wert zurück – andernfalls `LamportsCalculateError`. Die SOL-seitige Liquidität des Pools wird daher nie berührt.
SPL Token, beliebige andere Größe (ein LP-Mint)	CPI `WithdrawExcessLamports`, unterzeichnet von `amm_authority`.
Das AMM v4-Programm selbst (`AmmInfo`, `TargetOrders`, `AmmConfig`, die Withdraw-Queue)	Das Programm belastet das Konto direkt bis zu `rent.minimum_balance(data_len)`.
Alles andere	Stillschweigend übersprungen. Kein Fehler, keine Lamports bewegt.

Häufige Fehler — InvalidSignAccount (falscher Unterzeichner), InvalidSplTokenProgram (falsches Programm in Slot 3), InvalidProgramAddress (falsche amm_authority), LamportsCalculateError (benutzerdefinierter Code 60; die wSOL-Rundreise nettete nicht zu Null), und InsufficientFunds vom Programm-eigenen Pfad, wenn ein Konto weniger als sein eigenes Rent-Minimum hält. Kein SDK-Builder. @raydium-io/raydium-sdk-v2 liefert keinen Builder für diese Anweisung, und auch nicht das raydium-sdk-V2-demo-Repo – es ist ein Admin-Pfad. Kodieren Sie es von Hand, wie die Wallet-seitige Abräumung in solana-fundamentals/rent-and-reclaimable-rent für die Token-Programm-Anweisung.

Zustandsänderungs-Matrix

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

Anweisung	`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`	—	+ in, − out	+ pnl-Anteil
`SwapBaseOut` / `SwapBaseOutV2`	—	+ in, − out	+ pnl-Anteil
`WithdrawPnl`	—	− (pnl abgeräumt)	0
`SetParams`	—	—	—
`WithdrawExcessLamports`	—	— (Token-Salden unverändert)	—

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 – Kontovalidierungen auf der Market-Seite

Produkte

Algorithmen

Anweisungsübersicht

`Initialize2`

`Deposit`

`Withdraw`

`SwapBaseIn`

`SwapBaseOut`

`SwapBaseInV2` / `SwapBaseOutV2`

`MonitorStep` und andere entfernte Anweisungen

`WithdrawPnl` / `TakePnl`

`SetParams`

`CreateConfigAccount` / `UpdateConfigAccount`

`WithdrawExcessLamports`

Zustandsänderungs-Matrix

Nächste Schritte

​Anweisungsübersicht

​Initialize2

​Deposit

​Withdraw

​SwapBaseIn

​SwapBaseOut

​SwapBaseInV2 / SwapBaseOutV2

​MonitorStep und andere entfernte Anweisungen

​WithdrawPnl / TakePnl

​SetParams

​CreateConfigAccount / UpdateConfigAccount

​WithdrawExcessLamports

​Zustandsänderungs-Matrix

​Nächste Schritte

Anweisungsübersicht

`Initialize2`

`Deposit`

`Withdraw`

`SwapBaseIn`

`SwapBaseOut`

`SwapBaseInV2` / `SwapBaseOutV2`

`MonitorStep` und andere entfernte Anweisungen

`WithdrawPnl` / `TakePnl`

`SetParams`

`CreateConfigAccount` / `UpdateConfigAccount`

`WithdrawExcessLamports`

Zustandsänderungs-Matrix

Nächste Schritte