Matriz de suporte Token-2022

​

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).

​

Congelamento de NFT de posição CLMM para emissores restritos

• O pool já pode existir e permanecer permutável.
• O mint do NFT de posição usa o PDA do pool CLMM como sua própria autoridade de congelamento; o emissor subjacente não controla o NFT de posição.
• OpenPositionV2 cobre NFTs de posição SPL clássicos sobre ativos de pool Token-2022. OpenPositionWithToken22Nft cobre NFTs de posição Token-2022.
• OpenPosition V1 não inspeciona mints do vault e não pode servir os ativos Token-2022 restritos direcionados pela lista enviada.
• Posições existentes não são alteradas.

​

Lista de permissão 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. Whitelist estática de mints

​

2. Registro por mint — apenas CLMM

• crate::admin::ID — a autoridade admin padrão do Raydium.
• crate::create_support_mint_associated_owner::ID — uma autoridade dedicada para este propósito: 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 congelamento é igual a superstate_allowlist::ID. Veja reference/program-addresses para os valores mainnet-beta e devnet.
• Sua extensão DefaultAccountState está definida como Frozen.
• Seu delegado permanente também é superstate_allowlist::ID.

​

O que os bypasses não dispensam

• O mint é propriedade de Token ou Token-2022. Um programa de token customizado é rejeitado upstream.
• 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 de transferência desembarcam o valor correto no vault.

​

Semântica “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. Nenhum sandbox seguro existe. Alguns DEXes mantêm listas de permissão 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 detentor do delegado pode varrer qualquer conta de token, incluindo o vault do pool. Permitido apenas via whitelist estática para emissores confiáveis (por exemplo, stablecoins regulados).
• MintCloseAuthority — o mint pode ser fechado; pools existentes se tornam inutilizáveis. Desabilitado por padrão.
• DefaultAccountState (Frozen) — ATAs do pool desembarcariam em estado Frozen e exigiriam descongelamento por conta. Permitido apenas via detecção Superstate, que assume que o emissor descongela contas institucionais no registro.
• Ponteiros Group/Member — não ativamente prejudiciais, mas não revisados. Desabilitados 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

​

Limite maximumFee

​

Transição de época

​

Juros compostos 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...", ... }
  }]
}

​

Auxiliares 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

• Pré-voo apenas do ID do programa. Um mint pode ser Token-2022 e não suportado. Caminhe pela lista de extensões contra a lista de permissão (e a whitelist estática) antes de permitir criação de pool.
• Confiar na cotação do SDK quando o mint não é aceito em absoluto. 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 off-chain antes de expor criação de pool em sua UI.
• Cotação sem o corte de taxa de transferência. Um mint de 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 nível 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 novos mints Token-2022. Carteiras e agregadores devem verificar TransferHook e NonTransferable antes de exibir um mint aos usuários; ambos são hostis ao Raydium.

​

Trabalho futuro

• Programas de transfer-hook na lista de permissão no nível Solana (convenção de ecossistema evoluindo).
• AMMs compatíveis com confidential-transfer (estágio 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.