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, chamado de Initialize e InitializeWithPermission.
• CLMM: is_supported_mint em raydium-clmm/programs/amm/src/util/token.rs, 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 de 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 de vault e não pode servir os ativos Token-2022 restritos direcionados pela lista enviada.
• Posições existentes permanecem inalteradas.

​

Mints quote do LaunchLab

• Mint base — LaunchLab o cria. Um mint base Token-2022 é alcançável apenas através de initialize_with_token_2022, e o programa apenas anexará MetadataPointer e (opcionalmente) TransferFeeConfig. Qualquer outra coisa retorna NoSupportExtension. Um mint Token-2022 pré-existente não pode ser fornecido como base. Quando TransferFeeConfig é anexado, o transfer_fee_config_authority do mint é o PDA de autoridade de lançamento até a graduação, enquanto seu withdraw_withheld_authority é o transfer_fee_extension_auth configurado da plataforma a partir da criação do mint — o próprio programa de launchpad não tem instrução de retirada retida. Veja products/launchlab/platform-config.
• Mint quote — LaunchLab não o cria e não o verifica. CreateConfig aceita a conta de mint como fornecida, então não há equivalente is_supported_mint no lado quote. O único controle é quais mints um admin escolhe vincular a um GlobalConfig.

• O vault de quote, ambos os vaults de taxa e a conta de token do receptor de taxa de compartilhamento são criados no próprio programa do mint quote.
• TransferFeeConfig no lado quote é precificado em todas as quatro instruções de negociação, e o limite de slippage é verificado contra o valor líquido do pagador em vez do movimento bruto do vault. Veja products/launchlab/instructions.
• PoolState.token_program_flag registra os programas de ambos os mints — bit0 para o mint base, bit1 para o mint quote. Decodifique por bit; o byte não é um booleano. Veja products/launchlab/accounts.

​

Lista de permissões de extensão 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

​

O único bypass: o registro por mint

​

Os bypasses removidos

​

MINT_WHITELIST estático — removido

​

Detecção de forma de autoridade Superstate — removido

​

O que os bypasses não dispensam

• O mint é de 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 chegam ao 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. Nenhuma sandbox segura existe. Alguns DEXes mantêm listas de permissões de hook; Raydium não.
• NonTransferable — Transfer sempre falha. Um pool não pode tomar custódia.
• ConfidentialTransfer — os valores de transferência são criptografados; a curva não pode precificar o swap.
• PermanentDelegate — um detentor do delegado pode varrer qualquer conta de token, incluindo o vault do pool. Admissível apenas registrando o mint, que é como um emissor confiável (por exemplo, uma stablecoin regulada) é integrado caso a caso.
• MintCloseAuthority — o mint pode ser fechado; pools existentes se tornam inutilizáveis. Desaprovado por padrão.
• DefaultAccountState (Frozen) — ATAs do pool aterrariam em estado Frozen e exigiriam descongelamento por conta. Admissível apenas registrando o mint, que assume que o emissor descongela contas institucionais no registro.
• Ponteiros de grupo/membro — não ativamente prejudiciais, mas não revisados. Desaprovados por padrão para manter a superfície estreita.

​

Contabilidade de taxa de transferência

• A taxa do pool (LP + protocolo + fundo + criador) vem da curva. raydium.cpmm.computeSwapAmount({ ... }) a retorna como fee, ao lado de amountIn, amountOut, minAmountOut, executionPrice, priceImpact e o swapResult bruto.
• A taxa de transferência Token-2022 vem do mint, não do pool. É computada pelos helpers getTransferAmountFee em @raydium-io/raydium-sdk-v2, que retornam um GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // o valor que realmente se move
  fee: BN | undefined;         // retido pelo mint; indefinido quando o mint não tem TransferFeeConfig
  expirationTime: number | undefined;  // definido enquanto uma mudança de taxa agendada está pendente
}

• o valor de entrada mais sua transferência fee como “você envia”
• o valor de saída menos sua transferência fee como “você recebe”
• a fee do pool como uma linha separada — não é a taxa Token-2022

​

Limite de 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...", ... }
  }]
}

​

Helpers do 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ões, e verifique o PDA de registro do mint, antes de permitir a criação do pool.
• Confiar na cotação do SDK quando o mint não é aceito. 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 a criação do 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 permitidos no nível Solana (convenção de ecossistema evoluindo).
• AMMs compatíveis com transferência confidencial (estágio de pesquisa).
• Registro por mint CPMM mais amplo (paridade com CLMM).
• Um caminho de leitura público para o registro, para que uma UI possa dizer “não suportado” de “não suportado mas registrado” sem derivar o PDA em si.

​

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 — 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 — 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.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — vinculação de mint quote do LaunchLab (sem verificação de extensão).