Instructions AMM v4

Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →

À partir de la mise à jour du programme 2026-07, la dépendance d’AMM v4 envers OpenBook / Serum a été supprimée. Les instructions héritées v1 SwapBaseIn / SwapBaseOut, Deposit et Withdraw conservent leurs anciens schémas de comptes pour la compatibilité rétroactive : les comptes de marché sont toujours acceptés à leurs anciennes positions, mais ils ne sont plus validés ni utilisés (aucun CPI n’est émis). Les nouvelles intégrations doivent utiliser les points d’entrée de swap V2, qui omettent entièrement les comptes de marché. Plusieurs instructions ont été supprimées et reviennent maintenant — voir l’entrée du journal des modifications. Les listes de comptes ci-dessous utilisent les noms de champs du SDK Raydium ; l’IDL sous-jacent utilise parfois des préfixes serum_*.La mise à jour du programme 2026-09 ajoute une instruction d’administration, WithdrawExcessLamports (tag 18), et supprime la sysvar de rent de CreateConfigAccount. Tout ce qu’un trader ou LP appelle reste inchangé. Voir l’entrée du journal des modifications 2026-09-09.

Inventaire des instructions

Groupe	Instruction	tag	Notes
Cycle de vie du pool	`Initialize2`	1	Seule instruction de création de pool (l’interface par défaut utilise CPMM pour les nouveaux pools).
Liquidité	`Deposit`	3	Ajouter de la liquidité, recevoir des LP. Schéma inchangé (comptes de marché ignorés).
Liquidité	`Withdraw`	4	Brûler des LP, recevoir les deux côtés au prorata. Schéma inchangé (comptes de marché ignorés).
Swap	`SwapBaseIn`	9	Swap à entrée exacte. Schéma v1 inchangé ; comptes de marché acceptés mais ignorés.
Swap	`SwapBaseOut`	11	Swap à sortie exacte. Identique à ce qui précède.
Swap	`SwapBaseInV2`	16	Recommandé. Swap à entrée exacte sans les comptes de marché.
Swap	`SwapBaseOutV2`	17	Recommandé. Swap à sortie exacte sans les comptes de marché.
Maintenance	`SetParams`	6	Admin : modifier les paramètres du pool. Schéma + valeurs `param` modifiés (rupture).
Maintenance	`WithdrawPnl`	7	Récupérer les frais de protocole accumulés. Schéma de comptes modifié (rupture).
Maintenance	`CreateConfigAccount`	14	Admin : initialiser la PDA `AmmConfig` au niveau du programme.
Maintenance	`UpdateConfigAccount`	15	Admin : modifier les paramètres de configuration au niveau du programme.
Maintenance	`WithdrawExcessLamports`	18	Admin : récupérer les lamports au-dessus du minimum exempt de rent des comptes contrôlés par le programme. Ajouté en 2026-09.

Le SDK expose des builders uniquement pour les instructions accessibles aux utilisateurs. Les instructions de maintenance sont généralement invoquées par le keeper Raydium. Supprimées / non plus appelables (leurs builders client ont été supprimés) : Initialize (tag 0, utilisez Initialize2), MonitorStep (2), MigrateToOpenBook (5), WithdrawSrm (8), PreInitialize (10, utilisez Initialize2), SimulateInfo (12), AdminCancelOrders (13). Une transaction portant l’un de ces tags échoue ; le programme n’exécute jamais l’instruction. Traitez les sept comme disparus plutôt que comme des chemins d’erreur à gérer.

`Initialize2`

Amorcer un nouveau pool AMM v4 lié à un marché OpenBook existant. Arguments

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

Comptes (modifiable W, signataire S)

#	Nom	W	S	Notes
1	`token_program`			SPL Token.
2	`system_program`
3	`rent`
4	`amm`	W		Compte `AmmInfo` (clé semée).
5	`amm_authority`			PDA du programme.
6	`amm_open_orders`	W		`OpenOrders` d’OpenBook (semé).
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		ATA LP du créateur.
15	`pool_temp_lp_token_account`	W		Compte de travail.
16	`market_program`			Programme OpenBook.
17	`market`			Marché OpenBook.
18	`user_wallet`	W	S	Créateur. Paie le rent et finance le dépôt initial.
19	`user_token_coin`	W
20	`user_token_pc`	W

Postconditions

lp_supply = sqrt(init_coin_amount × init_pc_amount) − INIT_BURN, où INIT_BURN ≈ 100 unités LP sont retenues de la circulation.
Aucun ordre OpenBook n’est affiché (la grille du carnet d’ordres a été supprimée). market_program / market sont toujours passés mais stockés uniquement comme champs de référence ; coin_lot_size / pc_lot_size / min_size sont initialisés à 0.

Erreurs courantes — InvalidInput (décimales mal appariées, non triées), NotAllowed.

`Deposit`

Ajouter de la liquidité. Arguments

max_coin_amount: u64
max_pc_amount:   u64
base_side:       u64    // 0 = base sur coin, 1 = base sur pc
// (certaines variantes du SDK acceptent aussi other_amount_min)

Comptes (abrégé)

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

Mathématiques — prorata standard. En utilisant les réserves effectives du pool (coffres + en carnet), le SDK calcule la paire coin/pc qui produit le montant LP donné et la vérifie par rapport à max_*. Revient avec ExceededSlippage si l’un ou l’autre côté dépasse le plafond.

`Withdraw`

Brûler des LP, recevoir les deux côtés. Arguments

amount: u64    // LP à brûler

Comptes — comme Deposit avec la direction inversée ; lp_mint est modifiable pour le brûlage, les ATA utilisateur sont des récepteurs. Le schéma de comptes est inchangé (comptes de marché toujours passés positionnellement, ignorés). Il n’y a plus d’étape de règlement depuis OpenBook — les mathématiques au prorata utilisent directement les soldes des coffres.

`SwapBaseIn`

Swap à entrée exacte. Toujours un swap par chemin AMM (ne route pas via l’appariement OpenBook).

Utilisez les variantes V2 pour le nouveau code. Puisque la dépendance d’AMM v4 envers OpenBook a été supprimée, les points d’entrée V1 (SwapBaseIn, SwapBaseOut) s’attendent toujours à la liste complète de 17 comptes (ou 18 avec le compte target-orders optionnel), mais les comptes OpenBook/marché sont maintenant acceptés positionnellement et ignorés — ils ne sont pas validés et aucun CPI n’est émis. Passer un mauvais nombre de comptes revient toujours avec WrongAccountsNumber, mais le contenu des comptes de marché n’est plus vérifié. Les nouvelles intégrations doivent utiliser SwapBaseInV2 / SwapBaseOutV2, qui prennent une liste de comptes beaucoup plus petite et représentent le chemin d’exécution canonique aujourd’hui. Les formes V1 sont documentées ici pour la complétude et pour lire les transactions existantes en chaîne.

Arguments

amount_in:            u64
minimum_amount_out:   u64

Comptes (abrégé)

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

Mathématiques — voir products/amm-v4/math. Préconditions

amm.status autorise le swap (bit 0 du masque de bits de statut non défini).
amm.state_data.pool_open_time <= now.
amount_in > 0.
user_source_token_account détient au moins amount_in.

Postconditions

L’utilisateur perd amount_in du jeton source, gagne amount_out ≥ minimum_amount_out du jeton destination.
need_take_pnl_* incrémenté par la part des frais de protocole.
Remarque : les compteurs d’analyse state_data.swap_*_in_amount / swap_*_out_amount ne sont plus mis à jour — leurs valeurs sont figées. Utilisez les journaux de transactions pour l’analyse du volume.

Erreurs courantes — ExceededSlippage, InvalidInput, InvalidStatus, NotAllowed (mint coin/pc identique).

`SwapBaseOut`

Sortie exacte, inverse de SwapBaseIn. Mêmes comptes. Arguments

max_amount_in: u64
amount_out:    u64

`SwapBaseInV2` / `SwapBaseOutV2`

Points d’entrée de swap variantes (tags 16 / 17) qui omettent entièrement les comptes OpenBook. Les mathématiques sont identiques au chemin V1, mais la liste de comptes se réduit à juste le côté AMM et l’utilisateur — 8 comptes, et amm_open_orders n’est pas passé :

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

Les réserves du pool sont maintenant les soldes des coffres (moins le PnL en attente), donc les mathématiques de cotation sont simples et identiques au chemin v1. Utilisez V2 pour économiser du calcul et éviter de passer les comptes de marché (maintenant ignorés). Le routeur Raydium utilise toujours la forme V2 lors du routage via AMM v4. Les arguments sont les mêmes que les formes V1 (amount_in / minimum_amount_out pour SwapBaseInV2 ; max_amount_in / amount_out pour SwapBaseOutV2).

`MonitorStep` et autres instructions supprimées

Supprimées — non plus appelables. À partir de la mise à jour 2026-07, MonitorStep (tag 2) a été supprimée du programme et revient maintenant (unimplemented!) si elle est invoquée. Son builder client a également été supprimé. Il en va de même pour MigrateToOpenBook (5), WithdrawSrm (8), SimulateInfo (12), AdminCancelOrders (13), et les points d’entrée de création de pool hérités Initialize (0) / PreInitialize (10) — utilisez Initialize2 à la place.

Historiquement, MonitorStep actionnait l’interaction OpenBook du pool : elle réglait les ordres remplis (déplaçant les produits des coffres de marché vers les coffres du pool via CPI OpenBook), annulait les ordres obsolètes et affichait de nouveaux ordres pour combler l’écart entre target_orders et amm_open_orders. Avec la dépendance OpenBook supprimée, il n’y a rien à actionner et l’instruction est partie. Tout keeper ou intégration qui l’appelle encore doit supprimer l’appel.

`WithdrawPnl` / `TakePnl`

Récupération administrative des frais de protocole accumulés. Arguments

WithdrawPnl ne prend pas d’arguments ; elle lit need_take_pnl_* et déplace exactement ces montants.

Changement de rupture (admin uniquement). La liste de comptes est passée de 17 (+1 optionnel) à 10 — amm_open_orders et les six comptes de marché ont été supprimés — sans analyse de compatibilité. L’ancien schéma se désaligne (l’ancien #5 était amm_open_orders, maintenant pool_coin_token_account) et échoue avec des erreurs telles que InvalidCoinVault. Les outils d’administration doivent être mis à jour.

Comptes (nouveau schéma de 10 comptes)

#	Nom	W	S	Notes
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		Destinataire.
8	`pnl_pc_token_account`	W
9	`pnl_owner`		S	Multisig admin.
10	`amm_target_orders`	W

Effet

Transfère need_take_pnl_coin de pool_coin_token_account vers pnl_coin_token_account.
Identique pour pc.
Remet à zéro need_take_pnl_coin et need_take_pnl_pc.
Changement logique : si le solde du coffre est insuffisant pour couvrir le PnL accumulé, l’instruction retourne TakePnlError directement (elle ne manipule plus l’état du carnet d’ordres).

Aucun changement aux réserves puisque le PnL accumulé était déjà exclu de l’invariant.

`SetParams`

Modifications de paramètres d’administration, appelées par le multisig Raydium. Les arguments sont une balise param: u8 + charge utile.

Changement de rupture (admin uniquement). La liste de comptes a été réduite à juste [amm (W), admin (S)] (l’autorité, les ordres ouverts, les ordres cibles, le coffre et tous les comptes de marché ont été supprimés). L’énumération param a été renumérotée et réduite : Status = 0, State = 1, Fees = 2 (était 9), SetOpenTime = 3 (était 11). Tous les paramètres de grille de carnet d’ordres et AmmOwner, LastOrderDistance, UpdateOpenOrder ont été supprimés, et la structure SetParamsInstruction a supprimé new_pubkey et last_order_distance. Les outils d’administration doivent être mis à jour.

`CreateConfigAccount` / `UpdateConfigAccount`

Gestion administrative de la PDA AmmConfig au niveau du programme (seed ["amm_config_account_seed"]), qui détient le propriétaire du PnL, les frais de création de pool et l’indicateur de création de pool.

Modifié en 2026-09, et rétrocompatible. CreateConfigAccount ne lit plus la sysvar de rent. Sa liste de comptes est maintenant 4 comptes, en baisse par rapport à 5 :

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

Le programme lit les paramètres de rent de Rent::get() au lieu de désérialiser un compte sysvar passé — ce que la mise à jour de dépendance Solana 3.0 a rendu naturel.Le compte supprimé était dernier dans la liste, et le gestionnaire lit ses comptes positionnellement via next_account_info sans vérification de longueur. Un outil d’administration existant qui passe toujours l’ancienne liste de 5 comptes continue donc de fonctionner : le compte de rent final n’est simplement jamais lu. Mettez-le à jour quand c’est pratique, pas d’urgence. UpdateConfigAccount est inchangé.

Initialize2 conserve la sysvar de rent à la position 3, et l’utilise toujours : le programme a arrêté d’appeler Rent::from_account_info sur elle, mais elle est toujours transmise aux CPI spl_token::initialize_account et initialize_mint qui créent les coffres du pool et le mint LP. Ne la supprimez pas de la liste de comptes.

`WithdrawExcessLamports`

Récupération administrative des lamports assis au-dessus du minimum exempt de rent sur les comptes que le programme contrôle. Ajouté dans la mise à jour 2026-09 pour récupérer le surfinancement que la réduction de rent SIMD-0437 laisse derrière sur les comptes créés avant chaque étape. Il ne déplace que l’excédent. Les soldes de jetons, les données de compte, les propriétaires et l’état du pool restent inchangés, et l’instruction est un no-op sur un compte déjà à son minimum — donc il est sûr de l’exécuter à plusieurs reprises et à nouveau après chaque étape de déploiement. Arguments — aucun. La charge utile est le seul octet de balise 18. Comptes

#	Nom	W	S	Notes
1	`collect_lamports`	W	S	Destination pour chaque lamport récupéré. Doit égaler le portefeuille de collecte de lamports du cluster — voir `reference/program-addresses`. Tout autre signataire échoue avec `InvalidSignAccount`.
2	`amm_authority`			La seule PDA d’autorité AMM v4, re-dérivée par le programme de `["amm authority"]` avec un nonce fixe de `254`. Elle signe les CPI du programme de jetons.
3	`token_program`			SPL Token. Vérifié par rapport à `spl_token::id()` ; une mauvaise valeur échoue avec `InvalidSplTokenProgram`.
4..	comptes source	W		`M` comptes à récupérer, n’importe quel nombre, n’importe quel ordre.

Comment chaque compte source est traité Le programme se divise sur le propriétaire du compte source :

Propriétaire du compte source	Traitement
SPL Token, `data_len == 165` (un compte de jeton), non-natif	CPI `WithdrawExcessLamports` (discriminant du programme de jetons `38`), signé par `amm_authority`.
SPL Token, `data_len == 165`, natif (wSOL)	`WithdrawExcessLamports` ne peut pas être utilisé sur un compte natif. Le programme CPI `SyncNative`, mesure combien le `amount` enveloppé a augmenté, `UnwrapLamports` (discriminant `45`) pour exactement ce delta, puis affirme que le solde enveloppé est revenu à sa valeur pré-sync — sinon `LamportsCalculateError`. La liquidité SOL du pool n’est donc jamais touchée.
SPL Token, toute autre taille (un mint LP)	CPI `WithdrawExcessLamports`, signé par `amm_authority`.
Le programme AMM v4 lui-même (`AmmInfo`, `TargetOrders`, `AmmConfig`, la file d’attente de retrait)	Le programme débite le compte directement jusqu’à `rent.minimum_balance(data_len)`.
N’importe quoi d’autre	Ignoré silencieusement. Aucune erreur, aucun lamport déplacé.

Erreurs courantes — InvalidSignAccount (mauvais signataire), InvalidSplTokenProgram (mauvais programme à l’emplacement 3), InvalidProgramAddress (mauvais amm_authority), LamportsCalculateError (code personnalisé 60 ; l’aller-retour wSOL n’a pas donné zéro), et InsufficientFunds du chemin contrôlé par le programme quand un compte détient moins que son propre minimum de rent. Pas de builder SDK. @raydium-io/raydium-sdk-v2 ne fournit pas de builder pour cette instruction, pas plus que le dépôt raydium-sdk-V2-demo — c’est un chemin d’administration. Encodez-le à la main, comme le fait la récupération côté portefeuille dans solana-fundamentals/rent-and-reclaimable-rent pour l’instruction du programme de jetons.

Matrice de changement d’état

La colonne OpenBook est partie — aucune instruction ne touche plus un carnet d’ordres.

Instruction	Approvisionnement `lp_mint`	Coffres	Compteurs PnL
`Initialize2`	approvisionnement initial frappé au créateur	`+ init_coin_amount`, `+ init_pc_amount`	0
`Deposit`	+	+ les deux	—
`Withdraw`	−	− les deux	—
`SwapBaseIn` / `SwapBaseInV2`	—	+ entrée, − sortie	+ part pnl
`SwapBaseOut` / `SwapBaseOutV2`	—	+ entrée, − sortie	+ part pnl
`WithdrawPnl`	—	− (pnl récupéré)	0
`SetParams`	—	—	—
`WithdrawExcessLamports`	—	— (soldes de jetons inchangés)	—

Où aller ensuite

products/amm-v4/code-demos — Exemples TypeScript pour les flux de swap et LP.
products/amm-v4/fees — Détails de WithdrawPnl et la répartition des frais.
reference/error-codes — Tableau de référence directe (les erreurs AMM v4 sont listées sur cette page).

Sources :

Programme Raydium AMM — raydium-io/raydium-amm
Module Liquidity du SDK Raydium v2
Programme OpenBook — validations de comptes du côté du marché

Produits

Algorithmes

Inventaire des instructions

`Initialize2`

`Deposit`

`Withdraw`

`SwapBaseIn`

`SwapBaseOut`

`SwapBaseInV2` / `SwapBaseOutV2`

`MonitorStep` et autres instructions supprimées

`WithdrawPnl` / `TakePnl`

`SetParams`

`CreateConfigAccount` / `UpdateConfigAccount`

`WithdrawExcessLamports`

Matrice de changement d’état

Où aller ensuite

​Inventaire des instructions

​Initialize2

​Deposit

​Withdraw

​SwapBaseIn

​SwapBaseOut

​SwapBaseInV2 / SwapBaseOutV2

​MonitorStep et autres instructions supprimées

​WithdrawPnl / TakePnl

​SetParams

​CreateConfigAccount / UpdateConfigAccount

​WithdrawExcessLamports

​Matrice de changement d’état

​Où aller ensuite

Inventaire des instructions

`Initialize2`

`Deposit`

`Withdraw`

`SwapBaseIn`

`SwapBaseOut`

`SwapBaseInV2` / `SwapBaseOutV2`

`MonitorStep` et autres instructions supprimées

`WithdrawPnl` / `TakePnl`

`SetParams`

`CreateConfigAccount` / `UpdateConfigAccount`

`WithdrawExcessLamports`

Matrice de changement d’état

Où aller ensuite