Matriz de compatibilidad Token-2022

Qué programas de Raydium soportan Token-2022, la lista de extensiones permitidas explícita que cada programa aplica en la creación de pools, y el único mecanismo de derivación restante — el registro PDA por mint administrado — que admite mints rechazados de otro modo.

Esta página fue traducida automáticamente por IA. La versión en inglés es la fuente autorizada.

Ver versión en inglés →

Raydium no acepta mints Token-2022 arbitrarios. Tanto CPMM como CLMM ejecutan un modo de lista de permitidos estricto: solo un pequeño conjunto de extensiones pasan por defecto; todo lo demás se rechaza en la creación del pool. Cada programa admite un mint individual a través de un mecanismo — un PDA de registro por mint administrado. Ambos programas también llevaban derivaciones codificadas en varios puntos; todas ellas han sido eliminadas. Esta página es la referencia única para lo que se aplica y dónde, con citas en el código fuente del programa.

​

Soporte a nivel de programa

Programa	¿Mints base/quote Token-2022?	Modo
CPMM	Sí — controlado	Lista de permitidos de extensiones estricta + registro por mint administrado. Su lista blanca estática de 4 mints fue eliminada en la actualización 2026-09.
CLMM	Sí — controlado	Lista de permitidos de extensiones estricta + registro por mint administrado. Su lista blanca estática de 6 mints y su detección de Superstate fueron eliminadas en julio de 2026.
AMM v4	No	El programa es anterior a Token-2022; ambos mints deben ser Token SPL clásico.
Stable AMM	No	Las mismas restricciones que AMM v4.
Farm v6	Sí, parcial	El mint de recompensa puede ser Token-2022 (sujeto a la misma lista de permitidos cuando una granja envuelve un LP de CPMM/CLMM); los mints LP de stake del usuario heredan del pool envuelto.
LaunchLab	Sí — base administrada por programa, quote sin control	El mint base puede ser Token-2022, pero solo a través de la instrucción dedicada initialize_with_token_2022; el programa crea el mint con MetadataPointer (siempre) y opcionalmente TransferFeeConfig (tasa ≤ 5%). Los mints Token-2022 preexistentes con extensiones arbitrarias no pueden usarse como base. El mint quote puede ser cualquier mint Token-2022 que un administrador vincule a una GlobalConfig, sin verificación de extensiones — ver abajo.
Burn & Earn	Refleja el programa del pool	Hereda el control de CPMM / CLMM.

Las verificaciones de la lista de permitidos se encuentran en:

• CPMM: is_supported_mint en raydium-cp-swap/programs/cp-swap/src/utils/token.rs, llamada desde Initialize e InitializeWithPermission.
• CLMM: is_supported_mint en raydium-clmm/programs/amm/src/util/token.rs, llamada 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).

No hay verificación de mint en tiempo de swap en CPMM o CLMM — la compuerta se activa solo en la creación del pool. Una vez que existe un pool, los swaps simplemente confían en que los mints no cambiaron, lo cual es correcto para las partes inmutables del estado del mint Token-2022.

​

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

Las cuentas de NFT de posición permanecen descongeladas por defecto. CLMM congela una solo cuando la posición usa una ruta abierta V2 y la freeze_authority actual de al menos un mint de bóveda aparece en la lista codificada frozen_position_nft_authorities::IDS. Esa lista es lo que reemplazó la detección anterior de token Superstate de CLMM, y lleva la misma autoridad del emisor que la heurística anterior coincidía. Establecer el PDA del pool como la autoridad de congelación del mint de NFT de posición no es en sí mismo una congelación. Esta es una regla de custodia de posición, no una lista de permitidos de creación de pool:

• 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 mints de bóveda y no puede servir los activos Token-2022 restringidos dirigidos por la lista enviada.
• Las posiciones existentes no cambian.

Las posiciones congeladas permanecen manejables por su propietario pero no pueden transferirse. ClosePosition descongela y quema atómicamente cuando el cliente pasa el pool como la primera cuenta restante. Ver products/clmm/ticks-and-positions.

​

Mints quote de LaunchLab

Los dos mints de LaunchLab se controlan de manera muy diferente, y la asimetría es fácil de pasar por alto.

• 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, la transfer_fee_config_authority del mint es el PDA de autoridad de lanzamiento hasta la graduación, mientras que su withdraw_withheld_authority es la transfer_fee_extension_auth configurada de la plataforma desde la creación del mint en adelante — el programa de launchpad en sí no tiene instrucción de retiro de retenido. Ver products/launchlab/platform-config.
• Mint quote — LaunchLab no lo crea ni 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 compuerta es qué mints elige un administrador vincular a una GlobalConfig.

Eso hace que vincular un mint quote Token-2022 sea una acción de alta confianza, por la misma razón que registrar un mint abajo: un mint quote TransferHook ejecutaría su hook en cada compra, venta y reclamación de tarifa en cada pool cotizado en él, y un mint quote PermanentDelegate permitiría al delegado barrer las bóvedas quote de esos pools. Ninguno está bloqueado por el programa.

Lo que LaunchLab maneja correctamente una vez que se vincula un mint quote:

• La bóveda quote, ambas bóvedas 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 de la bóveda. 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.

La instrucción Initialize deprecada aún toma un programa quote heredado, por lo que una configuración con un mint quote Token-2022 es alcanzable solo a través de InitializeV2 e InitializeWithToken2022.

​

Lista de permitidos de extensiones CPMM y CLMM

Después de los dos cortocircuitos cubiertos abajo, el programa itera las extensiones del mint y rechaza el mint si lleva cualquier extensión que no sea estas cinco:

Extensión	Razón por la que se permite
TransferFeeConfig	La matemática del pool resta la tarifa de entrada; el programa Token-2022 maneja la tarifa de salida. Ver algorithms/token-2022-transfer-fees.
MetadataPointer	Decorativa — apunta a metadatos en cadena.
TokenMetadata	Decorativa — metadatos en línea.
InterestBearingConfig	El pool ve la cantidad principal; el multiplicador de UI es solo decorador y el saldo subyacente se preserva.
ScaledUiAmount	La misma forma que interés acumulado — el factor de escala se aplica solo a la visualización de UI.

Cualquier cosa que no esté en esta lista — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable, etc. — causa que is_supported_mint devuelva false y la creación del pool se revierta.

Las líneas relevantes (CPMM, forma idéntica en 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)

— cp-swap/src/utils/token.rs

​

Rutas de derivación

Un mint Token-2022 que no se ajusta a la lista de permitidos aún puede ser admitido, a través de un mecanismo en cada programa. Ambos programas también llevaban derivaciones codificadas en el pasado; ninguna de ellas sobrevive.

Derivación	CPMM	CLMM
PDA de registro por mint	Sí — la única derivación	Sí — la única derivación
MINT_WHITELIST estático	Eliminado 2026-09 (4 direcciones)	Eliminado 2026-07 (6 direcciones)
Detección de forma de autoridad Superstate	Nunca tuvo una	Eliminado 2026-07

is_supported_mint ahora es byte por byte la misma función en ambos programas: los mints Token SPL heredados pasan, un mint con un PDA de registro pasa, y todo lo demás debe llevar solo extensiones permitidas.

​

La única derivación: el registro por mint

Ambos programas consultan un PDA SupportMintAssociated en la semilla [b"support_mint", mint]. Si ese PDA existe para el mint, el mint se admite independientemente de su conjunto de extensiones.

Cada programa tiene su propia copia del PDA (se derivan bajo IDs de programa diferentes), su propio par CreateSupportMintAssociated / CloseSupportMintAssociated, y su propia autoridad dedicada junto con el administrador compartido:

Programa	Autoridad dedicada de soporte-mint (mainnet)	Autoridad dedicada de soporte-mint (devnet)
CPMM	Rayv2LG4tFSMizZhMP8aSUYxDPjV8qJtx2NQY9RKYZy	DRaypyeDL6y1dUusMgwyeDM5JebjhsSi8aRXobKQ9DcQ
CLMM	RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY	rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5

En ambos programas la instrucción acepta crate::admin::ID o la autoridad dedicada de ese programa, y requiere que el mint sea propiedad de Token-2022. Efecto: un mint Token-2022 específico puede ser incluido en la creación del pool sin una actualización del programa — por eso las listas codificadas podrían desaparecer.

Cada programa consulta el registro desde cada ruta de creación de pool que tiene: CPMM desde Initialize e InitializeWithPermission (este último es lo que usan las graduaciones de LaunchLab, por lo que un mint registrado se gradúa así como crea), CLMM desde CreatePool, CreateCustomizablePool y CreatePermissionedPool.

​

Las derivaciones eliminadas

Ambos mecanismos codificados se han ido de los programas desplegados. Se documentan aquí solo porque las integraciones escritas contra el comportamiento anterior aún pueden asumirlas.

​

MINT_WHITELIST estático — eliminado

Una matriz constante de direcciones de mint en base58 solía cortocircuitar is_supported_mint antes de la iteración de extensiones. La de CLMM contenía seis direcciones y fue eliminada el 2026-07-24; la de CPMM contenía los primeros cuatro del mismo conjunto y fue eliminada en la actualización 2026-09-09.

Anteriormente permitido en	Mints
CPMM y CLMM	HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM, Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g, FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4, 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
Solo CLMM	DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg, AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9

Un pool que ya existe para uno de estos mints sigue comerciando — la verificación de mint se ejecuta solo en la creación del pool. Crear un nuevo pool para uno ahora requiere un PDA de registro para él en su lugar.

​

Detección de forma de autoridad Superstate — eliminado

CLMM identificó brevemente los activos tokenizados de Superstate por su forma de autoridad en lugar de por dirección: un mint Token-2022 cuya freeze_authority y delegado permanente ambos igualaban superstate_allowlist::ID, con DefaultAccountState establecido en Frozen, fue admitido. Era una heurística, por lo que cualquier mint futuro con la misma forma habría sido admitido automáticamente.

Fue eliminado el 2026-07-31, junto con el módulo superstate_allowlist. Lo que lo reemplazó es más estrecho y sirve un propósito diferente: frozen_position_nft_authorities::IDS, que no admite nada — decide si un NFT de posición se congela, y se describe arriba. La única autoridad del emisor que la heurística anterior coincidía es la única entrada en esa lista.

​

Lo que las derivaciones no eximen

Las derivaciones omiten la lista de permitidos de extensiones, pero el programa aún aplica:

• El mint es propiedad de Token o Token-2022. Un programa de token personalizado se rechaza aguas arriba.
• Las 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 que llevan tarifa aterrizan la cantidad correcta en la bóveda.

Un mint permitido o registrado en PDA que, p. ej., agrega un TransferHook más tarde no gana una verificación en tiempo de swap; el hook simplemente se ejecutaría en cada transferencia y podría romper los swaps. Registrar un mint es por lo tanto una acción de alta confianza.

​

Semántica “Bloqueado”

Cuando is_supported_mint devuelve false, la creación del pool se revierte con ErrorCode::NotSupportMint (CPMM) / ErrorCode::NotSupportMint (CLMM). Ver reference/error-codes para los códigos numéricos.

Los pools existentes no pueden fallar retroactivamente esta verificación — la compuerta se ejecuta solo en la creación. Las extensiones de mint son inmutables para las categorías que Raydium rechaza (transfer hook, no transferible, transferencia confidencial no se puede agregar después de la creación), por lo que la verificación estática es suficiente.

​

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 de permitidos 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. Admisible solo registrando el mint, que es cómo se incorpora un emisor de confianza (p. ej. una stablecoin regulada) caso por caso.
• 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. Admisible solo registrando el mint, 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

Para mints que llevan TransferFeeConfig, cada swap, depósito y retiro mueve menos que la cantidad nominal. Dos números separados están involucrados, y el SDK los mantiene separados:

• La tarifa del pool (LP + protocolo + fondo + creador) viene de la curva. raydium.cpmm.computeSwapAmount({ ... }) la devuelve como fee, junto con amountIn, amountOut, minAmountOut, executionPrice, priceImpact y el swapResult sin procesar.
• La tarifa de transferencia Token-2022 viene del mint, no del pool. Se calcula mediante los ayudantes getTransferAmountFee en @raydium-io/raydium-sdk-v2, que devuelven un GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // la cantidad que realmente se mueve
  fee: BN | undefined;         // retenida por el mint; indefinida cuando el mint no tiene TransferFeeConfig
  expirationTime: number | undefined;  // establecida mientras un cambio de tarifa programado está pendiente
}

Depósito y retiro lo exponen directamente: computePairAmount devuelve inputAmountFee y anotherAmount como valores GetTransferAmountFee.

Una UI correcta muestra:

• la cantidad de entrada más su transferencia fee como “envías”
• la cantidad de salida menos su transferencia fee como “recibes”
• la fee del pool como una línea separada — no es la tarifa Token-2022

Una UI ingenua que muestra solo amountIn → amountOut subestima los costos. Pasa epochInfo del clúster a estos ayudantes en lugar de almacenarlo en caché; la época es lo que selecciona entre la configuración de tarifa older y newer de un mint.

​

Límite de maximumFee

Las tarifas de transferencia Token-2022 se limitan por transferencia. Para un mint del 1% con un límite de 10,000 tokens, una transferencia de 100,000,000 tokens paga solo 10,000 en tarifa. El computeSwapAmount del SDK aplica el límite; los llamadores de programa directo deben replicarlo.

​

Transición de época

Una autoridad de mint puede programar un cambio de tasa de tarifa que se active en la próxima época. Durante la ventana de transición, dos configuraciones (older, newer) viven en el mint a la vez y TransferChecked selecciona por época actual. Tanto SwapV2 de CPMM como SwapV2 de CLMM pasan la cuenta de mint completa en accounts, por lo que el programa lee la configuración correcta sin una búsqueda adicional.

Si citas más de una época por adelantado a través de la API de Comercio o SDK, la tarifa ejecutada puede diferir de la tarifa cotizada — limitada por los maximum_fee_basis_points de la configuración anterior.

​

Interés acumulado y ScaledUiAmount

El pool mantiene la cantidad principal; la “cantidad de UI” es la principal multiplicada por un factor de escala dependiente del tiempo o establecido por administrador. La matemática de swap opera en principal:

principal_in = ui_amount_in / ui_multiplier(now)

El SDK convierte automáticamente. Los lectores de RPC directo deben tratar pool.token0Vault.amount como principal.

​

Definición de “pool Token-2022”

Un pool es un pool Token-2022 si cualquiera de los mints tiene programId == TokenzQdB.... La API lo expone:

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

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

Usa programId para despachar, y hasTransferFee para mostrar una advertencia de UI.

​

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 de permitidos, y verifica el PDA de registro del mint, 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 Comercio — 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

Elementos de la hoja de ruta del ecosistema Solana y protocolo que cambiarían esta matriz:

• Programas de transfer-hook permitidos 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).
• Una ruta de lectura pública para el registro, para que una UI pueda decir “no soportado” de “no soportado pero registrado” sin derivar el PDA en sí.

Esta página se actualizará cuando alguno aterrice.

​

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.

Fuentes:

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