Matrice de support Token-2022

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.

​

Support au niveau du programme

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

​

Liste blanche d’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

​

1. Liste blanche de mint statique

​

2. Registre par mint — CLMM uniquement

• crate::admin::ID — l’autorité admin Raydium standard.
• crate::create_support_mint_associated_owner::ID — une autorité dédiée à cet effet : RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Détection Superstate — CLMM uniquement

superstate_allowlist::ID == freeze_authority
    && *mint_account_info.owner == spl_token_2022::ID
    && default_account_state_freeze
    && maybe_permanent_delegate

• Son programme propriétaire est le programme Token-2022.
• Son autorité de gel égale superstate_allowlist::ID. Mainnet : 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet : 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• Son extension DefaultAccountState est définie sur Frozen.
• Son délégué permanent est aussi superstate_allowlist::ID.

​

Ce que les contournements ne dispensent pas

• Le mint est propriété de 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 landent le bon montant dans le coffre.

​

Sémantique « Bloqué »

​

Pourquoi chaque extension exclue est exclue

• TransferHook — invoque un programme personnalisé à chaque transfert, avec consommation CU arbitraire, conditions d’échec arbitraires, et la capacité à réentrer le programme appelant. Aucun sandbox sûr n’existe. Certains DEX maintiennent des listes blanches 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 titulaire du délégué peut balayer n’importe quel compte de token, y compris le coffre du pool. Autorisé uniquement via la liste blanche statique pour les émetteurs de confiance (p. ex., stablecoins réglementés).
• MintCloseAuthority — le mint peut être fermé ; les pools existants deviennent inutilisables. Disallowed by default.
• DefaultAccountState (Frozen) — les ATA du pool se retrouveraient à l’état Frozen et nécessiteraient un dégel par compte. Autorisé uniquement via la détection Superstate, qui suppose que l’émetteur dégèle les comptes institutionnels lors de l’inscription.
• Group/Member pointers — pas activement nuisibles, mais non examinés. Disallowed by default to keep the surface narrow.

​

Comptabilité des frais de transfert

const { amountIn, amountOut, feeAmount, token2022FeeIn, token2022FeeOut } =
  await raydium.cpmm.computeSwapAmount({ ... });

• amountIn + token2022FeeIn comme « vous envoyez »
• amountOut - token2022FeeOut comme « vous recevez »
• feeAmount comme la commission du pool (LP + protocole), qui est séparée de la commission de transfert Token-2022

​

Plafond maximumFee

​

Transition d’époque

​

Interest-bearing et ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Définition de « pool Token-2022 »

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

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

​

Aides du SDK

import { Raydium, TOKEN_2022_PROGRAM_ID } from "@raydium-io/raydium-sdk-v2";
import { 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é-validation seulement de l’ID du programme. Un mint peut être Token-2022 et non supporté. Marchez la liste d’extension par rapport à la liste blanche (et la liste blanche statique) 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 — la création du pool est ce qui s’annule. Confirmez la sémantique is_supported_mint hors chaîne avant d’exposer la création du pool dans votre UI.
• Coter sans la retenue de frais de transfert. Un mint à frais de transfert de 1 % des deux côtés d’un pool CPMM à 0,25 % a une commission effective d’environ 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 antécède Token-2022. Utilisez SwapV2 quand l’un ou l’autre mint est Token-2022.
• Lister automatiquement 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 transfer-hook en liste blanche au niveau Solana (convention d’écosystème en évolution).
• AMM compatibles avec confidential-transfer (stade de recherche).
• Registre par mint CPMM plus large (parité avec CLMM).
• Mise à niveau de dépendance afin que le décodage ScaledUiConfig de CLMM fonctionne sans l’heuristique Superstate.

​

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 — MINT_WHITELIST, is_supported_mint.
• raydium-clmm/programs/amm/src/util/token.rs — MINT_WHITELIST, superstate_allowlist, is_superstate_token, is_supported_mint.
• 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 pour LaunchLab.