Skip to main content
Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →
La dépendance d’AMM v4 envers OpenBook / Serum a été supprimée (mise à jour du programme 2026-07). Les swaps en direct s’exécutent exclusivement contre la courbe AMM. Le crank MonitorStep, les CPI du carnet d’ordres et les instructions de market-making ont été supprimés du programme et reviennent maintenant en erreur s’ils sont appelés ; la dépendance serum_dex a disparu. Les instructions v1 SwapBaseIn / SwapBaseOut, Deposit et Withdraw conservent leurs anciens agencements de comptes (les comptes de marché sont toujours acceptés positionnellement mais ne sont plus validés ni utilisés). Traitez AMM v4 aujourd’hui comme un AMM à produit constant pur ; le matériel hybride ci-dessous est conservé à titre historique. Consultez l’entrée du journal des modifications du 2026-07-22.

​
Résumé en un paragraphe

AMM v4 est le programme avec lequel Raydium a lancé. Il maintient un invariant à produit constant (x · y = k). Il a été conçu à l’origine comme un AMM hybride : chaque pool reposait sur un marché de carnet d’ordres limités OpenBook (anciennement Serum) et reflétait des portions de sa courbe sous forme d’ordres limités sur ce carnet, afin que les utilisateurs et les agrégateurs puissent échanger directement contre le pool (chemin AMM) ou contre les ordres limités que le pool possédait sur OpenBook (chemin CLOB). La dépendance OpenBook a depuis été supprimée du programme — les pools ne publient plus ni ne maintiennent d’ordres sur OpenBook, et tout le trafic d’échange actuel transite par les points d’entrée de swap V2 réservés à l’AMM. Token-2022 n’est pas pris en charge. AMM v4 est toujours entièrement opérationnel en tant qu’AMM à produit constant — chaque pool continue de trader, les frais s’accumulent toujours, les LP gagnent toujours — mais l’interface utilisateur et le SDK définissent par défaut la création de nouveaux pools sur CPMM car CPMM est moins cher et prend en charge plus de types de mint.

​
Historique hybride (contexte)

Au lancement, la création d’un pool aux côtés du carnet d’ordres de Serum risquait de fragmenter la liquidité. La conception hybride publiait la courbe de l’AMM sur le carnet sous forme d’ordres limités, afin que les routeurs de carnet d’ordres voient la profondeur du pool gratuitement. Après qu’OpenBook ait forké Serum fin 2022, le programme a continué à fonctionner contre OpenBook avec des modifications minimales. À mesure que CPMM et les agrégateurs on-chain ont mûri, l’avantage du côté du carnet d’ordres s’est estompé, et l’intégration OpenBook d’AMM v4 a finalement été désactivée — la courbe est désormais la seule surface d’exécution du pool.

​
Ce qu’AMM v4 vous offre (que CPMM ne fait pas)

  • Liquidité profonde pour les paires héritées. Les paires majeures (SOL-USDC, mSOL-USDC, etc.) avec une TVL importante d’AMM v4 restent le lieu le plus profond pour ces échanges.
(Historiquement, AMM v4 offrait également une visibilité du côté du carnet d’ordres via le mécanisme hybride OpenBook, mais ce chemin n’est plus actif. Tout intégrateur qui acheminait précédemment via les ordres OpenBook de l’AMM devrait maintenant acheminer directement via les points d’entrée de swap AMM.)

​
Ce qu’AMM v4 ne vous offre pas

  • Token-2022. Non pris en charge. AMM v4 a été écrit avant l’existence de Token-2022 ; ses agencements de comptes supposent le Token SPL classique.
  • Nombre de comptes faible sur les swaps v1. Les agencements hérités SwapBaseIn / SwapBaseOut portent toujours les comptes de marché OpenBook comme espaces réservés positionnels (ils sont acceptés mais ne sont plus validés ni utilisés). Utilisez SwapBaseInV2 / SwapBaseOutV2 pour les supprimer et réduire la transaction.
  • Utilisation de calcul faible. Même un swap V2 coûte plus qu’un swap CPMM.
  • Flux de création de nouveaux pools par défaut. Les nouveaux pools sont créés avec Initialize2 (les points d’entrée hérités Initialize / PreInitialize ont été supprimés et reviennent maintenant en erreur). L’interface utilisateur Raydium, le SDK et api-v3.raydium.io ne proposent plus de bouton « créer un pool AMM v4 » — le chemin par défaut pour les nouveaux pools est CPMM.

​
Comment AMM v4 diffère de CPMM

Plus de détails sur les frais : products/amm-v4/fees et reference/fee-comparison.

​
Modèle mental

Un pool AMM v4 aujourd’hui est un AMM à produit constant x · y = k. Les deux coffres sont entièrement disponibles pour la courbe — aucune fraction n’est engagée dans les ordres OpenBook, car l’intégration OpenBook a été supprimée. Les opérations sont swap (utilisateur ↔ pool, via SwapBaseInV2 / SwapBaseOutV2) et dépôt / retrait (opérations LP). L’ancien crank (MonitorStep) a été supprimé et revient maintenant en erreur s’il est appelé. Modèle mental historique (pré-désactivation) : une fraction de chaque coffre était séquestre sous forme d’ordres de carnet d’ordres ; le règlement des ordres remplis se produisait lors des opérations de swap et LP ; les swaps acheminés pouvaient se remplir contre les propres ordres OpenBook du pool. Rien de tout cela n’est en fonctionnement aujourd’hui.

​
Pourquoi CPMM est la valeur par défaut recommandée

CPMM supprime la dépendance OpenBook. Les compromis :
  • Les transactions CPMM sont 2×–3× moins chères en calcul.
  • CPMM prend en charge les mints Token-2022.
  • Les agrégateurs intègrent maintenant CPMM directement via le SDK Raydium, donc l’avantage de visibilité du carnet d’ordres est largement sans objet.
  • Risque opérationnel : historiquement, les pannes ou pauses d’OpenBook pouvaient dégrader les pools AMM v4 (ordres obsolètes). Avec la dépendance OpenBook maintenant supprimée du programme, ce couplage a disparu — mais CPMM reste la valeur par défaut recommandée et moins coûteuse.
Consultez protocol-overview/versions-and-migration pour les conseils de migration.

​
Quand AMM v4 est le bon choix

  • Vous achemininez un swap et l’un des pools candidats est un pool AMM v4 avec le meilleur prix.
  • Vous fournissez ou gérez la liquidité dans un pool AMM v4 existant — la migration est un choix, non une obligation ; le pool continue de fonctionner comme un AMM pur.
  • Vous maintenez une intégration construite contre AMM v4 et n’avez aucune raison de migrer.
(La visibilité du carnet d’ordres sur OpenBook n’est plus une raison de choisir AMM v4 — cette intégration est désactivée.) Pour un nouveau pool à produit constant, CPMM est la valeur par défaut plus simple.

​
Où aller ensuite

  • Comptes — les comptes de l’AMM, plus les champs de référence OpenBook (maintenant vestigiaux).
  • Mathématiques — mathématiques de swap à produit constant avec la convention de frais d’AMM v4.
  • Instructions — la surface d’instruction : Initialize2, Swap (v1 / V2), Deposit, Withdraw, WithdrawPnl, SetParams.
  • Frais — la répartition de 0,25 % et comment elle est collectée.
  • Démonstrations de code — exemples TypeScript pour les flux de swap et LP.
Sources :
  • reference/program-addresses pour l’ID de programme canonique
  • Référentiel du programme OpenBook pour les comptes de contrepartie que cette page référence