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 de 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 NFT de posición SPL clásicos sobre activos de pool Token-2022. OpenPositionWithToken22Nft cubre NFT de posición Token-2022.
• OpenPosition V1 no inspecciona los mints de bóveda y no puede servir los activos Token-2022 restringidos dirigidos por la lista enviada.
• Las posiciones existentes no cambian.

​

Lista blanca 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 estática de mints

​

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á configurada 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 antes.
• Los bóvedas del pool se crean con las extensiones ATA correctas para pools Token-2022 (ImmutableOwner, etc.).
• Todas las transferencias pasan por transfer_checked — los mints con tarifa aterrizan la cantidad correcta en la bóveda.

​

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 blancas 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, incluida la bóveda 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 ATA del pool aterrizarían en estado Frozen y requerirían descongelación por cuenta. Permitido solo a través de la 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 blanca (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.
• Listar automáticamente 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 blanca a nivel de Solana (convención del ecosistema en evolución).
• AMMs compatibles con confidential-transfer (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.