Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
Cette page est traduite automatiquement par IA. La version anglaise fait foi.Voir la version anglaise →
Résumé en un paragraphe
AMM v4 est le programme avec lequel Raydium a lancé. Il maintient un invariant de produit constant (x · y = k). Il a été conçu à l’origine comme un AMM hybride : chaque pool reposait sur un marché de carnet de limites 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 swapper directement contre le pool (chemin AMM) ou contre les ordres limités que le pool possédait sur OpenBook (chemin CLOB). Le côté OpenBook a depuis été désactivé — les pools ne publient plus ni ne maintiennent d’ordres sur OpenBook, et tout le trafic de swap actuel passe par les points d’entrée de swap V2 uniquement AMM. Token-2022 n’est pas pris en charge. AMM v4 est toujours pleinement opérationnel en tant qu’AMM à produit constant — chaque pool continue à trader, les frais s’accumulent toujours, les LP gagnent toujours — mais l’interface utilisateur et le SDK par défaut créent un nouveau pool dans 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 de limites 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 de limites voient la profondeur du pool gratuitement. Après le fork d’OpenBook depuis Serum fin 2022, le programme a continué à fonctionner avec OpenBook avec des modifications minimes. À mesure que CPMM et les agrégateurs on-chain ont mûri, l’avantage du côté carnet de limites s’est estompé, et l’intégration OpenBook d’AMM v4 a finalement été désactivée — la courbe est maintenant 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 importante TVL AMM v4 restent le lieu d’échange le plus profond pour ces trades.
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 mises en page de compte supposent SPL Token classique.
- Nombre de comptes réduit. Un swap touche le pool, l’autorité, les coffres, plus l’ensemble de la file d’événements/requêtes OpenBook et les côtés bids/asks. Même un swap AMM direct (en contournant CLOB) traîne tous les comptes OpenBook car l’instruction les valide.
- Utilisation faible du calcul. La validation seule des comptes coûte plus cher qu’un swap CPMM complet.
- Flux par défaut pour nouveau pool. Le programme est toujours fonctionnel et accepte toujours
Initialize, mais l’interface utilisateur Raydium, le SDK etapi-v3.raydium.ione proposent plus un 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
| Dimension | AMM v4 | CPMM |
|---|---|---|
| Courbe | Produit constant | Produit constant |
| Dépendance OpenBook | Inerte (originalement oui ; maintenant désactivée) | Non |
| Token-2022 | Non | Oui |
| Nombre de comptes par swap V2 | ~9 | ~11 |
| Unités de calcul par swap | ~80k–120k (chemin V2) | ~60k–100k |
| Frais LP | 0,22% du volume | Varie selon AmmConfig |
| Frais de protocole | 0,03% du volume (fixe) | Varie selon AmmConfig |
| Frais de fonds | Aucun | Oui |
| Oracle TWAP | Pas de compte d’observation natif | Tampon annulaire observation |
| Par défaut pour les nouveaux pools | Non (toujours accepté) | Oui |
products/amm-v4/fees et reference/fee-comparison.
Modèle mental
Un pool AMM v4 aujourd’hui est un AMM à produit constantx · y = k. Les deux coffres sont entièrement disponibles pour la courbe — aucune fraction n’est réservée aux ordres OpenBook, car l’intégration OpenBook n’est plus active. Les opérations sont swap (utilisateur ↔ pool, via SwapBaseInV2 / SwapBaseOutV2), deposit / withdraw (opérations LP) et un crank maintenant vestigial (MonitorStep, conservé on-chain mais plus nécessaire et non posté par le keeper de Raydium).
Modèle mental historique (pré-désactivation) : une fraction de chaque coffre était séquestre comme ordres de carnet ouvert ; le règlement des ordres remplis se produisait lors des opérations de swap et LP ; les swaps routés pouvaient se remplir contre les propres ordres OpenBook du pool. Rien de cela n’est en opération aujourd’hui.
Pourquoi CPMM est la recommandation par défaut
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 Raydium SDK, de sorte que l’avantage de visibilité du carnet de limites est largement moot.
- Risque opérationnel : les pannes ou pauses OpenBook dégradent les pools AMM v4 (
CrankError, ordres périmés). CPMM n’a pas de tel couplage.
protocol-overview/versions-and-migration pour les conseils de migration.
Quand AMM v4 est le bon choix
- Vous routez 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, pas une obligation ; le pool continue à fonctionner comme un AMM pur.
- Vous maintenez une intégration construite sur AMM v4 et n’avez pas de raison de migrer.
Où aller ensuite
- Comptes — les comptes de l’AMM plus les comptes OpenBook qu’il dessert.
- Mathématiques — mathématiques du swap à produit constant avec la convention de frais d’AMM v4.
- Instructions — la surface d’instruction :
Initialize,Swap,Deposit,Withdraw, aides crank. - 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.
reference/program-addressespour l’ID du programme canonique- Référentiel du programme OpenBook pour les comptes des tiers cette page référence