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: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 disponible publiquement).

​

Gel du 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 fournie.
• Les positions existantes restent inchangées.

​

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 statique de mints

​

2. Registre par mint — CLMM uniquement

• crate::admin::ID — l’autorité administrateur 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 est égale à superstate_allowlist::ID. Voir reference/program-addresses pour les valeurs mainnet-beta et devnet.
• Son extension DefaultAccountState est définie sur Frozen.
• Son délégué permanent est également superstate_allowlist::ID.

​

Ce que les contournements ne dispensent pas

• Le mint est détenu par Token ou Token-2022. Un programme de 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 consommation CU arbitraire, 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 blanche 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 vault du pool. Autorisé uniquement via la liste blanche statique pour les émetteurs de confiance (par exemple, les stablecoins réglementés).
• MintCloseAuthority — le mint peut être fermé ; les pools existants deviennent inutilisables. Désallowé par défaut.
• DefaultAccountState (Frozen) — les ATA du pool atterriraient dans 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 à l’inscription.
• Pointeurs Group/Member — pas activement nuisibles, mais non examinés. Désallowés par défaut pour garder la surface étroite.

​

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 les frais du pool (LP + protocole), qui sont séparés des frais de transfert Token-2022

​

Plafond maximumFee

​

Transition d’époque

​

Intérêts porteurs et ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Définition « pool Token-2022 »

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

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

​

Assistants 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é-vérifier uniquement l’ID du programme. Un mint peut être Token-2022 et non supporté. Parcourez la liste d’extensions 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 — 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 à 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 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.
• Lister automatiquement les nouveaux mints Token-2022. Les portefeuilles et agrégateurs doivent vérifier TransferHook et NonTransferable avant de présenter un mint aux utilisateurs ; les deux sont hostiles à Raydium.

​

Travaux futurs

• Programmes de hook de transfert sur liste blanche au niveau Solana (convention d’écosystème en évolution).
• AMM compatibles avec le transfert confidentiel (stade de recherche).
• Registre par mint CPMM plus large (parité avec CLMM).
• Mise à niveau de dépendance pour 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 de LaunchLab.