Matrice de support Token-2022

Quels programmes Raydium supportent Token-2022, la liste d’autorisation explicite que chaque programme applique à la création de pool, et le seul contournement restant — le registre PDA géré par l’administrateur par mint — qui accepte les mints autrement rejetés.

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

Voir la version anglaise →

Raydium n’accepte pas les mints Token-2022 arbitraires. CPMM et CLMM fonctionnent tous deux en mode liste d’autorisation stricte : seul un petit ensemble d’extensions passe par défaut ; tout le reste est rejeté à la création du pool. Chaque programme admet un mint individuel par un seul mécanisme — un PDA de registre par mint géré par l’administrateur. Les deux programmes ont également porté des contournements codés en dur à différents endroits ; tous ont maintenant été supprimés. Cette page est la référence unique pour ce qui est appliqué et où, avec des citations dans la source du programme.

​

Support au niveau du programme

Programme	Mints base/quote Token-2022 ?	Mode
CPMM	Oui — contrôlé	Liste d’autorisation stricte des extensions + registre par mint de l’administrateur. Sa liste blanche statique de 4 mints a été supprimée dans la mise à jour 2026-09.
CLMM	Oui — contrôlé	Liste d’autorisation stricte des extensions + registre par mint de l’administrateur. Sa liste blanche statique de 6 mints et sa détection Superstate ont toutes deux été supprimées en juillet 2026.
AMM v4	Non	Le programme est antérieur à Token-2022 ; les deux mints doivent être du Token SPL classique.
Stable AMM	Non	Mêmes contraintes que AMM v4.
Farm v6	Oui, partiel	Le mint de récompense peut être Token-2022 (soumis à la même liste d’autorisation quand une farm enveloppe un LP CPMM/CLMM) ; les mints LP de stake utilisateur héritent du pool enveloppé.
LaunchLab	Oui — base gérée par le programme, quote non contrôlée	Le mint de base peut être Token-2022, mais uniquement via l’instruction dédiée initialize_with_token_2022 ; le programme crée lui-même le mint avec MetadataPointer (toujours) et optionnellement TransferFeeConfig (taux ≤ 5 %). Les mints Token-2022 préexistants avec des extensions arbitraires ne peuvent pas être utilisés comme base. Le mint quote peut être n’importe quel mint Token-2022 qu’un administrateur lie à une GlobalConfig, sans vérification d’extension — voir ci-dessous.
Burn & Earn	Reflète le programme de pool	Hérite du contrôle CPMM / CLMM.

Les vérifications de la liste d’autorisation se trouvent dans :

• CPMM : is_supported_mint dans raydium-cp-swap/programs/cp-swap/src/utils/token.rs, appelée depuis Initialize et InitializeWithPermission.
• CLMM : is_supported_mint dans raydium-clmm/programs/amm/src/util/token.rs, appelée depuis CreatePool.
• LaunchLab : initialize_with_token_2022 dans raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (source non disponible publiquement).

Il n’y a pas de vérification de mint au moment du swap sur CPMM ou CLMM — le contrôle ne s’active qu’à la création du pool. Une fois qu’un pool existe, les swaps font simplement confiance au fait que les mints n’ont pas changé, ce qui est correct pour les parties immuables de l’état du mint Token-2022.

​

Gel des NFT de position CLMM pour les émetteurs restreints

Les comptes NFT de position restent dégelés par défaut. CLMM en gèle un uniquement quand la position utilise un chemin ouvert V2 et qu’au moins l’une des autorités freeze_authority actuelles du mint du coffre apparaît dans la liste codée en dur frozen_position_nft_authorities::IDS. Cette liste est ce qui a remplacé la détection antérieure de token Superstate de CLMM, et elle porte la même autorité d’émetteur que l’ancienne heuristique correspondait. Définir le PDA du pool comme autorité de gel du mint NFT de position n’est pas en soi un gel. C’est une règle de garde de position, pas une liste d’autorisation de création de pool :

• Le pool peut déjà exister et rester échangeable.
• Le mint NFT de position utilise le PDA du pool CLMM comme sa propre autorité de gel ; l’émetteur sous-jacent ne contrôle pas le NFT de position.
• OpenPositionV2 couvre les NFT de position SPL classiques sur les actifs de pool Token-2022. OpenPositionWithToken22Nft couvre les NFT de position Token-2022.
• OpenPosition V1 n’inspecte pas les mints du coffre et ne peut pas servir les actifs restreints Token-2022 ciblés par la liste fournie.
• Les positions existantes restent inchangées.

Les positions gelées restent gérables par leur propriétaire mais ne peuvent pas être transférées. ClosePosition dégèle et brûle atomiquement quand le client passe le pool comme premier compte restant. Voir products/clmm/ticks-and-positions.

​

Mints quote LaunchLab

Les deux mints de LaunchLab sont contrôlés très différemment, et l’asymétrie est facile à manquer.

• Mint de base — LaunchLab le crée. Un mint de base Token-2022 n’est accessible que via initialize_with_token_2022, et le programme n’attachera que MetadataPointer et (optionnellement) TransferFeeConfig. Tout le reste retourne NoSupportExtension. Un mint Token-2022 préexistant ne peut pas du tout être fourni comme base. Quand TransferFeeConfig est attaché, l’autorité transfer_fee_config_authority du mint est le PDA de l’autorité de lancement jusqu’à la graduation, tandis que son withdraw_withheld_authority est l’transfer_fee_extension_auth configurée de la plateforme à partir de la création du mint — le programme launchpad lui-même n’a pas d’instruction de retrait des montants retenus. Voir products/launchlab/platform-config.
• Mint quote — LaunchLab ne le crée pas et ne le contrôle pas. CreateConfig accepte le compte mint tel quel, donc il n’y a pas d’équivalent is_supported_mint du côté quote. Le seul contrôle est les mints qu’un administrateur choisit de lier à une GlobalConfig.

Cela rend la liaison d’un mint quote Token-2022 une action de haute confiance, pour la même raison que l’enregistrement d’un mint ci-dessous : un mint quote TransferHook exécuterait son hook à chaque achat, vente et réclamation de frais dans chaque pool coté en lui, et un mint quote PermanentDelegate laisserait le délégué balayer les coffres quote de ces pools. Aucun n’est bloqué par le programme.

Ce que LaunchLab gère correctement une fois qu’un mint quote est lié :

• Le coffre quote, les deux coffres de frais et le compte token du destinataire des frais de partage sont créés sur le programme du mint quote lui-même.
• TransferFeeConfig du côté quote est intégré dans les quatre instructions de trade, et la limite de slippage est vérifiée par rapport au montant net du payeur plutôt que au mouvement brut du coffre. Voir products/launchlab/instructions.
• PoolState.token_program_flag enregistre les programmes des deux mints — bit0 pour le mint de base, bit1 pour le mint quote. Décodez-le par bit ; l’octet n’est pas un booléen. Voir products/launchlab/accounts.

L’instruction Initialize dépréciée accepte toujours un programme quote hérité, donc une config avec un mint quote Token-2022 n’est accessible que via InitializeV2 et InitializeWithToken2022.

​

Liste d’autorisation des extensions CPMM et CLMM

Après les deux raccourcis couverts ci-dessous, le programme itère les extensions du mint et rejette le mint s’il porte une extension autre que ces cinq :

Extension	Raison pour laquelle elle est autorisée
TransferFeeConfig	Les mathématiques du pool soustraient les frais entrants ; le programme Token-2022 gère les frais sortants. Voir algorithms/token-2022-transfer-fees.
MetadataPointer	Décoratif — pointe vers les métadonnées on-chain.
TokenMetadata	Décoratif — métadonnées en ligne.
InterestBearingConfig	Le pool voit le montant principal ; le multiplicateur UI est décorateur uniquement et le solde sous-jacent est préservé.
ScaledUiAmount	Même forme que l’intérêt composé — le facteur d’échelle s’applique uniquement à l’affichage UI.

Tout ce qui ne figure pas dans cette liste — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable, etc. — fait que is_supported_mint retourne false et la création du pool revient en arrière.

Les lignes pertinentes (CPMM, forme identique dans CLMM) :

for e in extensions {
    if e != ExtensionType::TransferFeeConfig
        && e != ExtensionType::MetadataPointer
        && e != ExtensionType::TokenMetadata
        && e != ExtensionType::InterestBearingConfig
        && e != ExtensionType::ScaledUiAmount
    {
        return Ok(false);
    }
}
Ok(true)

— cp-swap/src/utils/token.rs

​

Chemins de contournement

Un mint Token-2022 qui ne correspond pas à la liste d’autorisation peut toujours être admis, par un seul mécanisme dans chaque programme. Les deux programmes ont également porté des contournements codés en dur dans le passé ; aucun d’eux ne survit.

Contournement	CPMM	CLMM
PDA de registre par mint	Oui — le seul contournement	Oui — le seul contournement
MINT_WHITELIST statique	Supprimé 2026-09 (4 adresses)	Supprimé 2026-07 (6 adresses)
Détection de forme d’autorité Superstate	N’en a jamais eu	Supprimé 2026-07

is_supported_mint est maintenant octet pour octet la même fonction dans les deux programmes : les mints Token SPL hérités passent, un mint avec un PDA de registre passe, et tout le reste doit porter uniquement des extensions autorisées.

​

Le seul contournement : le registre par mint

Les deux programmes consultent un PDA SupportMintAssociated à la graine [b"support_mint", mint]. Si ce PDA existe pour le mint, le mint est admis indépendamment de son ensemble d’extensions.

Chaque programme a sa propre copie du PDA (ils dérivent sous des ID de programme différents), sa propre paire CreateSupportMintAssociated / CloseSupportMintAssociated, et sa propre autorité dédiée aux côtés de l’administrateur partagé :

Les quatre clés (CPMM et CLMM × mainnet et devnet) sont listées sous Support-mint registry authorities.

Dans les deux programmes, l’instruction accepte soit crate::admin::ID soit l’autorité dédiée de ce programme, et exige que le mint soit détenu par Token-2022. Effet : un mint Token-2022 spécifique peut être accepté pour la création de pool sans mise à niveau du programme — c’est pourquoi les listes codées en dur pouvaient disparaître.

Chaque programme consulte le registre à partir de chaque chemin de création de pool qu’il a : CPMM depuis Initialize et InitializeWithPermission (ce dernier est ce que les graduations LaunchLab utilisent, donc un mint enregistré se gradue ainsi que crée), CLMM depuis CreatePool, CreateCustomizablePool et CreateCustomizablePoolV2.

​

Les contournements supprimés

Les deux mécanismes codés en dur ont disparu des programmes déployés. Ils sont documentés ici uniquement parce que les intégrations écrites contre l’ancien comportement peuvent encore les supposer.

​

MINT_WHITELIST statique — supprimée

Un tableau constant d’adresses de mint en base58 utilisé pour court-circuiter is_supported_mint avant l’itération sur les extensions. CLMM en contenait six et a été supprimé le 2026-07-24 ; CPMM en contenait les quatre premiers du même ensemble et a été supprimé lors de la mise à jour du 2026-09-09.

Anciennement autorisée dans	Mints
CPMM et CLMM	HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM, Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g, FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4, 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
CLMM uniquement	DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg, AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9

Un pool qui existe déjà pour l’un de ces mints continue de fonctionner — la vérification du mint s’exécute uniquement à la création du pool. Créer un nouveau pool pour l’un d’eux nécessite maintenant un PDA de registre à la place.

​

Détection de la forme d’autorité Superstate — supprimée

CLMM a brièvement identifié les actifs tokenisés de Superstate par leur forme d’autorité plutôt que par adresse : un mint Token-2022 dont freeze_authority et permanent delegate égalaient tous deux superstate_allowlist::ID, avec DefaultAccountState défini sur Frozen, était admis. C’était une heuristique, donc tout mint futur ayant la même forme aurait été automatiquement admis.

Elle a été supprimée le 2026-07-31, ainsi que le module superstate_allowlist. Ce qui l’a remplacée est plus étroit et sert un objectif différent : frozen_position_nft_authorities::IDS, qui n’admet rien — il décide si un NFT de position est gelé, et est décrit ci-dessus. L’une des autorités d’émetteur que l’ancienne heuristique correspondait est l’une des entrées de cette liste.

​

Ce que les contournements ne dispensent pas

Les contournements ignorent la liste d’autorisation des extensions, mais le programme applique toujours :

• Le mint est détenu par Token ou Token-2022. Un programme de token personnalisé est rejeté en amont.
• Les coffres du pool sont créés avec les bonnes extensions ATA pour les pools Token-2022 (ImmutableOwner, etc.).
• Tous les transferts passent par transfer_checked — les mints porteurs de frais déposent le bon montant dans le coffre.

Un mint autorisé ou enregistré via PDA qui, par exemple, ajoute un TransferHook plus tard ne gagne pas une vérification au moment du swap ; le hook s’exécuterait simplement à chaque transfert et pourrait bloquer les swaps. L’enregistrement d’un mint est donc une action de haute confiance.

​

Sémantique « bloquée »

Quand is_supported_mint retourne false, la création du pool revient avec ErrorCode::NotSupportMint (CPMM) / ErrorCode::NotSupportMint (CLMM). Consultez reference/error-codes pour les codes numériques.

Les pools existants ne peuvent pas échouer rétroactivement cette vérification — la barrière s’exécute uniquement à la création. Les extensions de mint sont immuables pour les catégories que Raydium rejette (transfer hook, non-transférable, confidential transfer ne peuvent pas être ajoutés après la création), donc la vérification statique est suffisante.

​

Pourquoi chaque extension exclue est exclue

• TransferHook — invoque un programme personnalisé à chaque transfert, avec une consommation de CU arbitraire, des conditions d’échec arbitraires, et la capacité de réentrer le programme appelant. Aucun bac à sable sûr n’existe. Certains DEX maintiennent des listes d’autorisation de hooks ; Raydium ne le fait pas.
• NonTransferable — Transfer échoue toujours. Un pool ne peut pas prendre la garde.
• ConfidentialTransfer — les montants de transfert sont chiffrés ; la courbe ne peut pas évaluer le swap.
• PermanentDelegate — un détenteur du délégué peut balayer n’importe quel compte de token, y compris le coffre du pool. Admissible uniquement en enregistrant le mint, ce qui est comment un émetteur de confiance (par exemple une stablecoin réglementée) est intégré au cas par cas.
• MintCloseAuthority — le mint peut être fermé ; les pools existants deviennent inutilisables. Interdit par défaut.
• DefaultAccountState (Frozen) — les ATA du pool se retrouveraient dans l’état Frozen et nécessiteraient un dégel par compte. Admissible uniquement en enregistrant le mint, ce qui suppose que l’émetteur dégèle les comptes institutionnels à l’inscription.
• Group/Member pointers — pas activement nuisibles, mais non examinés. Interdits par défaut pour garder la surface étroite.

​

Comptabilité des frais de transfert

Pour les mints portant TransferFeeConfig, chaque swap, dépôt et retrait déplace moins que le montant nominal. Deux nombres distincts sont impliqués, et le SDK les garde séparés :

• Le frais du pool (LP + protocole + fonds + créateur) provient de la courbe. raydium.cpmm.computeSwapAmount({ ... }) le retourne comme fee, aux côtés de amountIn, amountOut, minAmountOut, executionPrice, priceImpact et le swapResult brut.
• Le frais de transfert Token-2022 provient du mint, pas du pool. Il est calculé par les assistants getTransferAmountFee dans @raydium-io/raydium-sdk-v2, qui retournent un GetTransferAmountFee :

export interface GetTransferAmountFee {
  amount: BN;                  // the amount that actually moves
  fee: BN | undefined;         // withheld by the mint; undefined when the mint has no TransferFeeConfig
  expirationTime: number | undefined;  // set while a scheduled fee change is pending
}

Le dépôt et le retrait le surfacent directement : computePairAmount retourne inputAmountFee et anotherAmount comme des valeurs GetTransferAmountFee.

Une UI correcte affiche :

• le montant d’entrée plus son frais de transfert comme « vous envoyez »
• le montant de sortie moins son frais de transfert comme « vous recevez »
• le frais du pool comme une ligne séparée — ce n’est pas le frais Token-2022

Une UI naïve qui affiche uniquement amountIn → amountOut sous-estime les coûts. Passez epochInfo du cluster dans ces assistants plutôt que de le mettre en cache ; l’époque est ce qui sélectionne entre la configuration de frais older et newer d’un mint.

​

Plafond maximumFee

Les frais de transfert Token-2022 sont plafonnés par transfert. Pour un mint de 1 % avec un plafond de 10 000 tokens, un transfert de 100 000 000 tokens paie seulement 10 000 en frais. Le computeSwapAmount du SDK applique le plafond ; les appelants de programme directs doivent le répliquer.

​

Transition d’époque

Une autorité de mint peut planifier un changement de taux de frais qui s’active à la prochaine époque. Pendant la fenêtre de transition, deux configurations (older, newer) vivent sur le mint à la fois et TransferChecked sélectionne par époque actuelle. CPMM SwapV2 et CLMM SwapV2 passent tous deux le compte de mint complet dans accounts, donc le programme lit la bonne configuration sans recherche supplémentaire.

Si vous cotez plus d’une époque à l’avance via l’API Trade ou le SDK, le frais exécuté peut différer du frais coté — limité par le maximum_fee_basis_points de la configuration plus ancienne.

​

Porteur d’intérêt et ScaledUiAmount

Le pool détient le montant principal ; le « montant UI » est le principal multiplié par un facteur d’échelle dépendant du temps ou défini par l’administrateur. Les mathématiques de swap opèrent sur le principal :

principal_in = ui_amount_in / ui_multiplier(now)

Le SDK convertit automatiquement. Les lecteurs RPC directs doivent traiter pool.token0Vault.amount comme principal.

​

Définition de « pool Token-2022 »

Un pool est un pool Token-2022 si l’un ou l’autre mint a programId == TokenzQdB.... L’API le surface :

GET /pools/info/ids?ids=<POOL_ID>

{
  "data": [{
    "mintA": { "programId": "TokenzQdB...", "hasTransferFee": true, ... },
    "mintB": { "programId": "Tokenkeg...", ... }
  }]
}

Utilisez programId pour dispatcher, et hasTransferFee pour afficher un avertissement UI.

​

Assistants SDK

import { Raydium } from "@raydium-io/raydium-sdk-v2";
// TOKEN_2022_PROGRAM_ID is not re-exported by the Raydium SDK — import it from
// @solana/spl-token, as the SDK itself does.
import {
  TOKEN_2022_PROGRAM_ID,
  ExtensionType,
  getExtensionTypes,
  unpackMint,
} from "@solana/spl-token";

const raydium = await Raydium.load({ owner, connection });

const acct = await connection.getAccountInfo(mintPubkey);
if (!acct) throw new Error("mint not found");
const mint = unpackMint(mintPubkey, acct, acct.owner);

if (acct.owner.equals(TOKEN_2022_PROGRAM_ID)) {
  const extensions = getExtensionTypes(mint.tlvData);
  const accepted = new Set([
    ExtensionType.TransferFeeConfig,
    ExtensionType.MetadataPointer,
    ExtensionType.TokenMetadata,
    ExtensionType.InterestBearingConfig,
    ExtensionType.ScaledUiAmount,
  ]);
  const rejecting = extensions.filter(e => !accepted.has(e));
  if (rejecting.length) {
    console.warn("Pool creation will revert unless this mint is whitelisted:", rejecting);
  }
}

​

Erreurs d’intégration courantes

• Pré-vérifier uniquement l’ID du programme. Un mint peut être Token-2022 et non supporté. Parcourez la liste des extensions par rapport à la liste d’autorisation, et vérifiez le PDA de registre du mint, avant d’autoriser la création du pool.
• Faire confiance à la cotation du SDK quand le mint n’est pas accepté du tout. L’API de cotation ne refuse pas de coter — c’est la création du pool qui revient. Confirmez la sémantique is_supported_mint hors chaîne avant d’exposer la création du pool dans votre UI.
• Coter sans la réduction du frais de transfert. Un mint avec frais de transfert de 1 % des deux côtés d’un pool CPMM de 0,25 % a un frais effectif d’environ 2,25 %, pas 0,25 %. Utilisez la cotation du SDK ou la cotation de l’API Trade — ne calculez jamais le frais manuellement à partir du seul niveau de frais du pool.
• Appeler l’instruction Swap héritée sur un pool Token-2022. Swap précède Token-2022. Utilisez SwapV2 chaque fois que l’un ou l’autre mint est Token-2022.
• Auto-lister les nouveaux mints Token-2022. Les portefeuilles et agrégateurs doivent vérifier TransferHook et NonTransferable avant de surfacer un mint aux utilisateurs ; les deux sont hostiles à Raydium.

​

Travaux futurs

Éléments de la feuille de route de l’écosystème Solana et du protocole qui changeraient cette matrice :

• Programmes de transfer-hook autorisés au niveau Solana (convention d’écosystème en évolution).
• AMM compatibles avec confidential-transfer (stade de recherche).
• Registre CPMM par mint plus large (parité avec CLMM).
• Un chemin de lecture public pour le registre, afin qu’une UI puisse dire « non supporté » par rapport à « non supporté mais enregistré » sans dériver le PDA elle-même.

Cette page sera mise à jour quand l’un d’eux sera implémenté.

​

Pointeurs

• algorithms/token-2022-transfer-fees — mathématiques des frais dans les swaps.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — codes numériques NotSupportMint par programme.

Sources :

• raydium-cp-swap/programs/cp-swap/src/utils/token.rs — is_supported_mint, support_mint_associated_is_initialized.
• raydium-clmm/programs/amm/src/util/token.rs — is_supported_mint, support_mint_associated_is_initialized, frozen_position_nft_authorities, position_nft_must_freeze.
• raydium-clmm/programs/amm/src/instructions/admin/create_support_mint_associated.rs — instruction de registre par mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — création de mint de base Token-2022 de LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — liaison de mint de cotation LaunchLab (pas de vérification d’extension).