Matrice de support Token-2022

​

Support au niveau du programme

• 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).

​

Gel des NFT de position CLMM pour les émetteurs restreints

• 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 de vault et ne peut pas servir les actifs Token-2022 restreints ciblés par la liste expédiée.
• Les positions existantes restent inchangées.

​

Mints quote LaunchLab

• 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é, la transfer_fee_config_authority du mint est le PDA de l’autorité de lancement jusqu’à la graduation, tandis que sa withdraw_withheld_authority est la 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 admin choisit de lier à une GlobalConfig.

• Le vault quote, les deux vaults 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 vault. 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.

​

Liste d’autorisation des extensions CPMM et 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)

​

Chemins de contournement

​

Le seul contournement : le registre par mint

​

Les contournements supprimés

​

MINT_WHITELIST statique — supprimé

​

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

​

Ce que les contournements ne dispensent pas

• Le mint est détenu par soit Token soit Token-2022. Un programme token personnalisé est rejeté en amont.
• Les vaults 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 atterrissent le bon montant dans le vault.

​

Sémantique « Bloqué »

​

Pourquoi chaque extension exclue est exclue

• TransferHook — invoque un programme personnalisé à chaque transfert, avec une consommation 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 token, y compris le vault du pool. Admissible uniquement en enregistrant le mint, c’est ainsi qu’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. Disallowed par défaut.
• DefaultAccountState (Frozen) — les ATA du pool atterriraient 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.
• Pointeurs Group/Member — pas activement nuisibles, mais non examinés. Disallowed par défaut pour garder la surface étroite.

​

Comptabilité des frais de transfert

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

export interface GetTransferAmountFee {
  amount: BN;                  // le montant qui se déplace réellement
  fee: BN | undefined;         // retenu par le mint ; undefined quand le mint n'a pas TransferFeeConfig
  expirationTime: number | undefined;  // défini pendant qu'un changement de frais programmé est en attente
}

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

​

Plafond maximumFee

​

Transition d’époque

​

Intérêt porteur et ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Définition du « pool Token-2022 »

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

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

​

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é-vol uniquement de l’ID du programme. Un mint peut être Token-2022 et non supporté. Parcourez la liste d’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 du tout accepté. L’API de cotation ne refuse pas de coter — c’est la création du pool qui revient en arrière. 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 des frais de transfert. Un mint avec frais de transfert de 1 % des deux côtés d’un pool CPMM de 0,25 % a des frais effectifs autour de 2,25 %, pas 0,25 %. Utilisez la cotation du SDK ou la cotation de l’API Trade — ne calculez jamais les frais manuellement à partir du seul niveau de frais du pool.
• Appeler l’instruction Swap héritée sur un pool Token-2022. Swap est antérieur à 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

• Programmes de hook de transfert autorisés au niveau Solana (convention d’écosystème en évolution).
• AMM compatibles avec le transfert confidentiel (stade de la recherche).
• Registre par mint CPMM 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 elle-même le PDA.

​

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.

• 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 LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — liaison de mint quote LaunchLab (pas de vérification d’extension).