Matriz de compatibilidad Token-2022

​

Soporte a nivel de programa

• CPMM: is_supported_mint en raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, llamado desde Initialize.
• CLMM: is_supported_mint en raydium-clmm/programs/amm/src/util/token.rs:280, llamado desde CreatePool.
• LaunchLab: initialize_with_token_2022 en raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (código fuente no disponible públicamente).

​

Congelación de NFT de posición CLMM para emisores restringidos

• El pool ya puede existir y permanecer intercambiable.
• El mint del NFT de posición usa el PDA del pool CLMM como su propia autoridad de congelación; el emisor subyacente no controla el NFT de posición.
• OpenPositionV2 cubre NFTs de posición SPL clásicos sobre activos de pool Token-2022. OpenPositionWithToken22Nft cubre NFTs de posición Token-2022.
• OpenPosition V1 no inspecciona los mints del vault y no puede servir los activos Token-2022 restringidos dirigidos por la lista enviada.
• Las posiciones existentes no cambian.

​

Mints quote de LaunchLab

• Mint base — LaunchLab lo crea. Un mint base Token-2022 solo es alcanzable a través de initialize_with_token_2022, y el programa solo adjuntará MetadataPointer y (opcionalmente) TransferFeeConfig. Cualquier otra cosa devuelve NoSupportExtension. Un mint Token-2022 preexistente no puede suministrarse como base en absoluto. Cuando se adjunta TransferFeeConfig, el transfer_fee_config_authority del mint es el PDA de autoridad de lanzamiento hasta la graduación, mientras que su withdraw_withheld_authority es el transfer_fee_extension_auth configurado de la plataforma desde la creación del mint en adelante — el programa launchpad en sí no tiene instrucción de retiro de fondos retenidos. Ver products/launchlab/platform-config.
• Mint quote — LaunchLab no lo crea y no lo examina. CreateConfig acepta la cuenta de mint tal como se proporciona, por lo que no hay equivalente de is_supported_mint en el lado quote. La única puerta es qué mints elige un administrador vincular a un GlobalConfig.

• El vault quote, ambos vaults de tarifa y la cuenta de token del receptor de tarifa de participación se crean en el programa del mint quote.
• TransferFeeConfig en el lado quote se precifica en las cuatro instrucciones de comercio, y el límite de slippage se verifica contra la cantidad neta del pagador en lugar del movimiento bruto del vault. Ver products/launchlab/instructions.
• PoolState.token_program_flag registra los programas de ambos mints — bit0 para el mint base, bit1 para el mint quote. Decodifica por bit; el byte no es un booleano. Ver products/launchlab/accounts.

​

Lista permitida de extensiones CPMM y 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)

​

Rutas de omisión

​

1. Lista blanca de mint estática

​

2. Registro por mint — solo CLMM

• crate::admin::ID — la autoridad de administrador estándar de Raydium.
• crate::create_support_mint_associated_owner::ID — una autoridad dedicada para este propósito: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Detección Superstate — solo CLMM

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

• Su programa propietario es el programa Token-2022.
• Su autoridad de congelación es igual a superstate_allowlist::ID. Ver reference/program-addresses para los valores de mainnet-beta y devnet.
• Su extensión DefaultAccountState está establecida en Frozen.
• Su delegado permanente también es superstate_allowlist::ID.

​

Lo que las omisiones no eximen

• El mint es propiedad de Token o Token-2022. Un programa de token personalizado se rechaza aguas arriba.
• Los vaults del pool se crean con las extensiones ATA correctas para pools Token-2022 (ImmutableOwner, etc.).
• Todas las transferencias pasan por transfer_checked — los mints que llevan tarifa aterrizan la cantidad correcta en el vault.

​

Semántica de “bloqueado”

​

Por qué se excluye cada extensión

• TransferHook — invoca un programa personalizado en cada transferencia, con consumo de CU arbitrario, condiciones de fallo arbitrarias y la capacidad de reingresar al programa que llama. No existe sandbox seguro. Algunos DEXes mantienen listas permitidas de hooks; Raydium no.
• NonTransferable — Transfer siempre falla. Un pool no puede tomar custodia.
• ConfidentialTransfer — los montos de transferencia están encriptados; la curva no puede fijar el precio del swap.
• PermanentDelegate — un titular del delegado puede barrer cualquier cuenta de token, incluido el vault del pool. Permitido solo a través de la lista blanca estática para emisores de confianza (por ejemplo, stablecoins regulados).
• MintCloseAuthority — el mint puede cerrarse; los pools existentes se vuelven inutilizables. Desallowed por defecto.
• DefaultAccountState (Frozen) — los ATAs del pool aterrizarían en estado Frozen y requerirían descongelación por cuenta. Permitido solo a través de detección Superstate, que asume que el emisor descongela cuentas institucionales en la inscripción.
• Punteros de grupo/miembro — no activamente dañinos, pero no revisados. Desallowed por defecto para mantener la superficie estrecha.

​

Contabilidad de tarifa de transferencia

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

• amountIn + token2022FeeIn como “envías”
• amountOut - token2022FeeOut como “recibes”
• feeAmount como la tarifa del pool (LP + protocolo), que es separada de la tarifa de transferencia Token-2022

​

Límite de maximumFee

​

Transición de época

​

Interés acumulado y ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Definición de “pool Token-2022”

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

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

​

Ayudantes del 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);
  }
}

​

Errores comunes de integración

• Pre-vuelo solo del ID del programa. Un mint puede ser Token-2022 y no soportado. Camina la lista de extensiones contra la lista permitida (y la lista blanca estática) antes de permitir la creación del pool.
• Confiar en la cotización del SDK cuando el mint no se acepta en absoluto. La API de cotización no se niega a cotizar — la creación del pool es lo que se revierte. Confirma la semántica de is_supported_mint fuera de cadena antes de exponer la creación del pool en tu UI.
• Cotizar sin el corte de tarifa de transferencia. Un mint de tarifa de transferencia del 1% en ambos lados de un pool CPMM del 0.25% tiene una tarifa efectiva alrededor del 2.25%, no del 0.25%. Usa la cotización del SDK o la cotización de la API de Trade — nunca calcules la tarifa manualmente solo desde el nivel de tarifa del pool.
• Llamar a la instrucción Swap heredada en un pool Token-2022. Swap es anterior a Token-2022. Usa SwapV2 siempre que cualquiera de los mints sea Token-2022.
• Auto-listar nuevos mints Token-2022. Las billeteras y agregadores deben verificar TransferHook y NonTransferable antes de mostrar un mint a los usuarios; ambos son hostiles a Raydium.

​

Trabajo futuro

• Programas de transfer-hook en lista permitida a nivel de Solana (convención del ecosistema en evolución).
• AMMs compatibles con transferencia confidencial (etapa de investigación).
• Registro por mint CPMM más amplio (paridad con CLMM).
• Actualización de dependencia para que la decodificación ScaledUiConfig de CLMM funcione sin la heurística Superstate.

​

Punteros

• algorithms/token-2022-transfer-fees — matemática de tarifa en swaps.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — códigos numéricos de NotSupportMint por programa.

• 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 — instrucción de registro por mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — creación de mint base Token-2022 de LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — vinculación de mint quote de LaunchLab (sin verificación de extensión).