Matriz de compatibilidad con 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.

​

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 (el código fuente no está disponible públicamente).

​

Lista blanca de extensiones de 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 bypass

​

1. Lista blanca estática de mints

​

2. Registro por mint — solo CLMM

• crate::admin::ID — la autoridad estándar del admin 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. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• Su extensión DefaultAccountState está configurada en Frozen.
• Su delegado permanente es también superstate_allowlist::ID.

​

Lo que los bypasses no eximen

• El mint es propiedad de Token o Token-2022. Un programa de token personalizado se rechaza anteriormente.
• Los vaults del pool se crean con las extensiones ATA correctas para pools de Token-2022 (ImmutableOwner, etc.).
• Todas las transferencias pasan por transfer_checked — los mints con tarifa colocan 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 reentrar 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 cifrados; 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 mediante la lista blanca estática para emisores de confianza (p. ej., monedas estables reguladas).
• MintCloseAuthority — el mint puede cerrarse; los pools existentes se vuelven inutilizables. Desallowado por defecto.
• DefaultAccountState (Frozen) — los ATAs del pool aterrizarían en estado Frozen y requerirían descongelar por cuenta. Permitido solo mediante detección Superstate, que asume que el emisor descongela cuentas institucionales en la inscripción.
• Punteros Group/Member — no son activamente dañinos, pero no revisados. Desallowado 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 de Token-2022

​

Tope maximumFee

​

Transición de epoch

​

Interest-bearing y ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Definición de “pool de Token-2022”

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

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

​

Helpers de 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-flighting solo el 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 con 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 Trade API — nunca calcules la tarifa manualmente solo desde el tier de tarifa del pool.
• Llamar la instrucción Swap heredada en un pool de Token-2022. Swap es anterior a Token-2022. Usa SwapV2 siempre que cualquiera de los mints sea Token-2022.
• Listar automáticamente nuevos mints de 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 evolucionando).
• AMMs compatibles con confidential-transfer (etapa de investigación).
• Registro por mint de CPMM más amplio (paridad con CLMM).
• Actualización de dependencia para que la decodificación de ScaledUiConfig de CLMM funcione sin la heurística de Superstate.

​

Enlaces

• algorithms/token-2022-transfer-fees — matemáticas 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.