Matriz de suporte 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.

​

Suporte no nível do programa

• CPMM: is_supported_mint em raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, chamado de Initialize.
• CLMM: is_supported_mint em raydium-clmm/programs/amm/src/util/token.rs:280, chamado de CreatePool.
• LaunchLab: initialize_with_token_2022 em raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (código-fonte não disponível publicamente).

​

Lista de permissões de extensões CPMM e 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)

​

Caminhos de bypass

​

1. Lista branca estática de mints

​

2. Registro por mint — apenas CLMM

• crate::admin::ID — a autoridade de admin padrão da Raydium.
• crate::create_support_mint_associated_owner::ID — uma autoridade dedicada para este fim: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Detecção Superstate — apenas CLMM

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

• Seu programa proprietário é o programa Token-2022.
• Sua autoridade de freeze é igual a superstate_allowlist::ID. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• Sua extensão DefaultAccountState está definida como Frozen.
• Seu delegado permanente também é superstate_allowlist::ID.

​

O que os bypasses não dispensam

• A mint é proprietária de Token ou Token-2022. Um programa de token customizado é rejeitado antes.
• Os vaults do pool são criados com as extensões ATA corretas para pools Token-2022 (ImmutableOwner, etc.).
• Todas as transferências passam por transfer_checked — mints com taxa desembarcam o valor certo no vault.

​

Semântica de “bloqueado”

​

Por que cada extensão excluída é excluída

• TransferHook — invoca um programa customizado em cada transferência, com consumo de CU arbitrário, condições de falha arbitrárias, e a capacidade de reentrar o programa chamador. Nenhuma sandbox segura existe. Alguns DEXes mantêm listas de permissões de hooks; Raydium não.
• NonTransferable — Transfer sempre falha. Um pool não pode tomar custódia.
• ConfidentialTransfer — valores de transferência são criptografados; a curva não consegue precificar o swap.
• PermanentDelegate — um titular do delegado pode varrer qualquer conta de token, incluindo o vault do pool. Permitido apenas via lista branca estática para emissores confiáveis (por exemplo, stablecoins reguladas).
• MintCloseAuthority — a mint pode ser fechada; pools existentes ficam inutilizáveis. Desalojado por padrão.
• DefaultAccountState (Frozen) — ATAs do pool aterrissariam em estado Frozen e exigiriam descongelamento por conta. Permitido apenas via detecção Superstate, que assume que o emissor descongela contas institucionais na inscrição.
• Group/Member pointers — não ativamente prejudiciais, mas não revisados. Desalojados por padrão para manter a superfície estreita.

​

Contabilidade de taxa de transferência

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

• amountIn + token2022FeeIn como “você envia”
• amountOut - token2022FeeOut como “você recebe”
• feeAmount como a taxa do pool (LP + protocolo), que é separada da taxa de transferência Token-2022

​

Cap maximumFee

​

Transição de época

​

Interest-bearing e ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Definição de “pool 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);
  }
}

​

Erros comuns de integração

• Fazer pré-flighting apenas do ID do programa. Uma mint pode ser Token-2022 e não suportada. Caminhe pela lista de extensões contra a lista de permissões (e a lista branca estática) antes de permitir criação de pool.
• Confiar na cotação do SDK quando a mint não é aceita de forma alguma. A API de cotação não se recusa a cotar — a criação do pool é o que reverte. Confirme a semântica is_supported_mint offline antes de expor a criação de pool em sua UI.
• Cotar sem o corte de taxa de transferência. Uma mint com taxa de transferência de 1% em ambos os lados de um pool CPMM de 0,25% tem uma taxa efetiva em torno de 2,25%, não 0,25%. Use a cotação do SDK ou cotação da Trade API — nunca compute taxa manualmente apenas a partir do tier de taxa do pool.
• Chamar a instrução Swap legada em um pool Token-2022. Swap é anterior ao Token-2022. Use SwapV2 sempre que qualquer mint for Token-2022.
• Auto-listar novas mints Token-2022. Wallets e agregadores devem verificar TransferHook e NonTransferable antes de exibir uma mint aos usuários; ambas são hostis à Raydium.

​

Trabalho futuro

• Programas de transfer-hook em lista de permissões no nível Solana (convenção do ecossistema evoluindo).
• AMMs compatíveis com confidential-transfer (fase de pesquisa).
• Registro por mint CPMM mais amplo (paridade com CLMM).
• Atualização de dependência para que a decodificação ScaledUiConfig do CLMM funcione sem a heurística Superstate.

​

Ponteiros

• algorithms/token-2022-transfer-fees — matemática de taxa em swaps.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — códigos numéricos 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 — instrução de registro por mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — criação de mint base Token-2022 do LaunchLab.