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 →
Les ID de programme et les seeds PDA pour CPMM sont listés canoniquement dans
reference/program-addresses. Cette page se concentre sur à quoi sert chaque compte et les invariants qu’il maintient, pas sur les adresses codées en dur.Les six comptes d’un pool CPMM
Chaque pool CPMM est entièrement décrit par six adresses dérivées du programme (PDA) sous le programme CPMM, plus un compte partagéAmmConfig auquel il fait référence. Une fois que vous avez les deux mints, vous pouvez dériver tout de manière déterministe sans toucher le réseau.
| Compte | Seed(s) | Propriétaire | Objectif |
|---|---|---|---|
authority | "vault_and_lp_mint_auth_seed" | CPMM | Le signataire pour chaque mouvement de coffre et chaque mint/burn LP. Partagé entre tous les pools CPMM. |
poolState | "pool", ammConfig, token0Mint, token1Mint ou une paire de clés aléatoire fournie par un signataire | CPMM | La structure d’état du pool — paire de mints, soldes des coffres, approvisionnement en LP, accumulation de frais, pointeur d’observation. L’instruction CPMM Initialize accepte soit le PDA canonique dérivé des quatre seeds soit une paire de clés arbitraire signée par le créateur. Le chemin des paires de clés aléatoires existe pour contrer une attaque de front-running où un adversaire surveille le mempool et fait la course pour occuper le PDA canonique avant le créateur légitime. |
lpMint | "pool_lp_mint", poolState | SPL Token | Le jeton LP du pool. Approvisionnement = total LP en circulation. Autorité de mint = le PDA d’autorité CPMM. |
vault0 | "pool_vault", poolState, token0Mint | SPL Token / Token-2022 | Détient le solde du pool en token0. Possédé par le PDA d’autorité. |
vault1 | "pool_vault", poolState, token1Mint | SPL Token / Token-2022 | Détient le solde du pool en token1. Possédé par le PDA d’autorité. |
observation | "observation", poolState | CPMM | Ring buffer d’échantillons de prix utilisés pour le TWAP. Écrit à chaque swap. |
| Compte | Seed(s) | Propriétaire | Objectif |
|---|---|---|---|
ammConfig | "amm_config", index: u16 | CPMM | Détient les taux de frais commerciaux/protocole/fonds/créateurs et les clés d’admin. Un par « niveau de frais ». PoolState se lie à un à la création et ne peut pas changer plus tard. |
Dériver un pool à partir de rien d’autre que deux mints
L’ID du pool n’est pas toujours le PDA canonique.
Initialize accepte une paire de clés signataire arbitraire comme pool_state en plus du PDA ci-dessus. Si le compte transmis ne correspond pas au PDA canonique, le programme exige qu’il soit un signataire — c’est-à-dire que le créateur transmet une nouvelle paire de clés qu’il signe. C’est la défense contre le front-running : tout tiers qui fait la course pour saisir le PDA canonique peut être contourné par le créateur légitime qui utilise à la place une paire de clés aléatoire. Les PDA en aval (lpMint, vault0, vault1, observation) sont toujours dérivés de poolState.key(), ils restent donc uniques à l’adresse utilisée. Quand vous indexez les pools, découvrez toujours l’ID du pool à partir de l’état on-chain (par exemple, les comptes PoolState sous le programme CPMM), pas en dérivant le PDA canonique — ce dernier manquera les pools avec des paires de clés aléatoires.Dispositions des comptes
Les définitions Rust complètes vivent dans la sourceraydium-cp-swap. Les champs ci-dessous sont ceux que vous lirez lors d’une intégration.
PoolState
lp_supply— le miroir interne du pool de l’approvisionnement total du mint LP. Utilisez-le pour les calculs de part LP ; la valeur doit correspondre à l’approvisionnement on-chain du mint, mais la lire à partir dePoolStateévite une récupération supplémentaire de compte.protocol_fees_token{0,1},fund_fees_token{0,1}— frais accumulés non encore balayés. Ceux-ci n’affectent pas la tarification des swaps ; ils restent dans les coffres jusqu’à ce queCollectProtocolFee/CollectFundFeesoit appelé.status— un masque de bits contrôlant siSwap,Deposit,Withdrawsont autorisés. Mis à jour par l’admin viaUpdatePoolStatus. Le SDK le vérifie avant de construire une transaction ; si vous faites du CPI directement, vérifiez-le vous-même.token0_program/token1_program— le programme de jetons vers lequel faire du CPI pour chaque coffre. L’un peut être SPL Token classique et l’autre Token-2022 ; ils sont indépendants.open_time— un timestamp Unix. Les swaps avant cette heure échouent. Les dépôts sont autorisés avantopen_timepour que le pool puisse être amorcé.creator_fee_on/enable_creator_fee— ensemble contrôlent si le frais de créateur facultatif est actif pour ce pool et de quel côté du swap il est collecté.enable_creator_fee == falseannule le chemin du frais de créateur. Quand activé,creator_fee_onsélectionne :0= prendre un frais sur quel que soit le jeton qui est l’entrée du swap (BothToken) ;1= prendre un frais surtoken_0uniquement (sauter sur les swapstoken_1 → token_0) ;2= prendre un frais surtoken_1uniquement. Défini à la création du pool viaInitializeWithPermission; ne peut pas changer plus tard.creator_fees_token_{0,1}— frais de créateur accumulés, balayés parCollectCreatorFee.
AmmConfig
trade_fee_rateetcreator_fee_ratesont des fractions du volume, tous deux exprimés en unités de1/1_000_000.2500signifie 0,25 % du volume commercial.protocol_fee_rateetfund_fee_ratesont des fractions du frais commercial (pas du volume), avec le même dénominateur1/1_000_000. Le frais de créateur est pas une fraction du frais commercial — c’est son propre taux indépendant. L’arithmétique complète se trouve dansproducts/cpmm/fees.indexest unu16, donc le seed hash utilise 2 octets big-endian. Un décalage d’ordre d’octets est un bug d’intégration courant.AmmConfigest immuable au niveau du pool. Un pool pointe vers unAmmConfigà la création et ne change jamais. Les changements de frais se propagent parce que le pool lit la config à chaque swap — mais le pool ne peut pas être déplacé entre les niveaux de frais.
creator_fee_rate) vit sur AmmConfig et est partagé dans le niveau de frais. Si un pool particulier le facture réellement (enable_creator_fee) et de quel côté du swap il arrive (creator_fee_on) vivent sur PoolState. Le frais de créateur est indépendant du frais commercial — c’est son propre taux, accumulé dans ses propres compteurs (creator_fees_token_{0,1}), et ne réduit jamais les parts LP / protocole / fonds du frais commercial. Le balayage se fait via CollectCreatorFee. Voir products/cpmm/fees pour la mécanique complète.
Permission
Un petit compte de contrôle d’accès utilisé par InitializeWithPermission. Le programme CPMM supporte un chemin de création de pool avec permission pour que d’autres programmes (par exemple LaunchLab lors de la promotion d’un jeton vers CPMM) puissent prouver qu’ils sont autorisés à créer un pool contre un AmmConfig donné.
CreatePermissionPda et révoqué via ClosePermissionPda. Les utilisateurs finaux n’interagissent pas directement avec ce compte — c’est de la tuyauterie pour les flux cross-program.
Coffres et Token-2022
vault0 et vault1 sont possédés par le PDA d’autorité CPMM, et leur propriétaire du programme de jetons (token_program) est soit SPL Token soit Token-2022, déterminé à la création du pool par le programme du mint. Le pool gère les deux cas de manière transparente — vous passez le bon ID de programme de jetons pour chaque côté dans les comptes d’instruction Swap / Deposit / Withdraw.
CPMM applique une stricte liste de permission des extensions à la création du pool (is_supported_mint dans utils/token.rs). Un mint Token-2022 ne peut être utilisé dans un pool CPMM que si chaque extension qu’il porte se trouve sur cette liste :
TransferFeeConfig. Appliquée par le mint à chaque transfert. Le pool est du côté récepteur pour les dépôtsSwapBaseInputet du côté expéditeur pour les retraits. Le programme calcule la quantité nette arrivant dans le coffre et définit la courbe en conséquence. Voiralgorithms/token-2022-transfer-fees.MetadataPointeretTokenMetadata. Métadonnées standard on-mint. Aucun effet sur les calculs de swap.InterestBearingConfig. La quantité d’affichage du mint accumule les intérêts. Le coffre stocke les quantités brutes ; la courbe opère uniquement sur les quantités brutes. Les interfaces qui affichent l’APR doivent appeler les aides Token-2022 pour afficher la quantité d’affichage.ScaledUiAmount. Extension de mise à l’échelle d’affichage d’interface. Même traitement queInterestBearingConfig— la courbe utilise les quantités brutes.
PermanentDelegate, TransferHook, DefaultAccountState, NonTransferable, ConfidentialTransfer, Group/GroupMember, MintCloseAuthority, etc. — provoque le rejet de Initialize avec NotSupportMint. L’exception est une petite liste de mints codée en dur dans le programme (quelques pubkeys spécifiques) qui contourne la vérification des extensions ; elle est utilisée pour intégrer des mints spécifiques au cas par cas.
La liste des extensions vérifiées et la liste blanche des mints vivent dans la source CP-Swap sous programs/cp-swap/src/utils/token.rs et peuvent changer avec les futures mises à niveau du programme.
Observation
Le compte observation est un ring buffer d’entréesObservationState, chacune stockant un block_timestamp et un prix cumulatif. À chaque swap, le programme ajoute une nouvelle observation si suffisamment de temps s’est écoulé depuis la dernière. Les TWAP sont calculés en lisant deux observations et en divisant Δcumulative / Δtime.
ObservationState PDA complet fait environ 4 100 octets après les champs entourant et le discriminateur.
Deux règles pour les consommateurs :
- N’utilisez pas une observation unique comme prix. C’est un cumulatif, pas un prix spot. Utilisez deux d’entre elles pour calculer un TWAP.
- Choisissez les observations au moins un bloc à part. Les swaps au cours du même bloc peuvent ne pas produire une nouvelle observation ; relire en arrière peut retourner le même enregistrement.
products/clmm/accounts.
Cycle de vie des comptes
| Événement | Comptes créés | Comptes détruits |
|---|---|---|
Initialize | poolState, lpMint, vault0, vault1, observation | — |
Deposit | — (peut créer un ATA LP utilisateur) | — |
Withdraw | — | — |
Swap | — (peut créer un ATA de destination utilisateur) | — |
CollectProtocolFee | — | — |
CollectFundFee | — | — |
UpdatePoolStatus | — | — |
poolState reste. C’est volontaire : réensemencer le même pool plus tard préserve son tampon d’observation historique et sa dérivation PDA reste stable.
Où lire quoi
- Listes de comptes d’instruction (lequel des comptes ci-dessus est inscriptible/signataire pour chaque instruction) :
products/cpmm/instructions. - Sémantique d’accumulation des frais :
products/cpmm/fees. - Calcul des swaps / règle de mise à jour des observations :
products/cpmm/math. - Seeds canoniques / ID de programmes :
reference/program-addresses.


