Token-2022-Unterstützungsmatrix

​

Unterstützung auf Programmebene

• CPMM: is_supported_mint in raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, aufgerufen von Initialize.
• CLMM: is_supported_mint in raydium-clmm/programs/amm/src/util/token.rs:280, aufgerufen von CreatePool.
• LaunchLab: initialize_with_token_2022 in raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (Quellcode nicht öffentlich verfügbar).

​

CLMM-Position-NFT-Einfrieren für eingeschränkte Emittenten

• Der Pool kann bereits existieren und bleibt swappbar.
• Der Position-NFT-Mint verwendet die CLMM-Pool-PDA als seine eigene Freeze-Authority; der zugrunde liegende Emittent kontrolliert den Position-NFT nicht.
• OpenPositionV2 deckt klassische SPL-Position-NFTs über Token-2022-Pool-Assets ab. OpenPositionWithToken22Nft deckt Token-2022-Position-NFTs ab.
• OpenPosition V1 inspiziert Vault-Mints nicht und kann nicht die Token-2022-eingeschränkten Assets bedienen, auf die die ausgelieferte Liste abzielt.
• Bestehende Positionen bleiben unverändert.

​

LaunchLab-Quote-Mints

• Base-Mint — LaunchLab erstellt ihn. Ein Token-2022-Base-Mint ist nur über initialize_with_token_2022 erreichbar, und das Programm wird nur MetadataPointer und (optional) TransferFeeConfig anhängen. Alles andere gibt NoSupportExtension zurück. Ein bereits vorhandener Token-2022-Mint kann überhaupt nicht als Base bereitgestellt werden. Wenn TransferFeeConfig angehängt ist, ist die transfer_fee_config_authority des Mints die Launch-Authority-PDA bis zur Graduation, während seine withdraw_withheld_authority die konfigurierte transfer_fee_extension_auth der Plattform ab der Mint-Erstellung ist — das Launchpad-Programm selbst hat keine Withdraw-Withheld-Anweisung. Siehe products/launchlab/platform-config.
• Quote-Mint — LaunchLab erstellt ihn nicht und screent ihn nicht. CreateConfig akzeptiert das Mint-Konto wie gegeben, daher gibt es kein is_supported_mint-Äquivalent auf der Quote-Seite. Das einzige Gate ist, welche Mints ein Admin an eine GlobalConfig bindet.

• Der Quote-Vault, beide Fee-Vaults und das Token-Konto des Share-Fee-Empfängers werden auf dem eigenen Programm des Quote-Mints erstellt.
• TransferFeeConfig auf der Quote-Seite wird in alle vier Trade-Anweisungen eingepreist, und die Slippage-Grenze wird gegen den Netto-Betrag des Zahlers statt gegen die Bruttobewegung des Vaults geprüft. Siehe products/launchlab/instructions.
• PoolState.token_program_flag zeichnet die Programme beider Mints auf — Bit0 für den Base-Mint, Bit1 für den Quote-Mint. Dekodieren Sie es pro Bit; das Byte ist kein Boolean. Siehe products/launchlab/accounts.

​

CPMM- und CLMM-Erweiterungs-Allowlist

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)

​

Bypass-Pfade

​

1. Statische Mint-Whitelist

​

2. Pro-Mint-Registry — nur CLMM

• crate::admin::ID — die Standard-Raydium-Admin-Authority.
• crate::create_support_mint_associated_owner::ID — eine dedizierte Authority für diesen Zweck: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (Mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (Devnet).

​

3. Superstate-Erkennung — nur CLMM

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

• Sein besitzendes Programm ist das Token-2022-Programm.
• Seine Freeze-Authority entspricht superstate_allowlist::ID. Siehe reference/program-addresses für die Mainnet-Beta- und Devnet-Werte.
• Seine DefaultAccountState-Erweiterung ist auf Frozen gesetzt.
• Sein permanenter Delegate ist auch superstate_allowlist::ID.

​

Was die Bypasses nicht verzeihen

• Der Mint wird von entweder Token oder Token-2022 besessen. Ein benutzerdefiniertes Token-Programm wird vorgelagert abgelehnt.
• Die Pool-Vaults werden mit den richtigen ATA-Erweiterungen für Token-2022-Pools erstellt (ImmutableOwner, usw.).
• Alle Transfers gehen durch transfer_checked — gebührentragende Mints landen den richtigen Betrag im Vault.

​

„Blocked”-Semantik

​

Warum jede ausgeschlossene Erweiterung ausgeschlossen ist

• TransferHook — ruft ein benutzerdefiniertes Programm bei jedem Transfer auf, mit beliebigem CU-Verbrauch, beliebigen Fehlerbedingungen und der Möglichkeit, das aufrufende Programm erneut einzugeben. Es gibt keine sichere Sandbox. Einige DEXes führen Hook-Allow-Lists; Raydium nicht.
• NonTransferable — Transfer schlägt immer fehl. Ein Pool kann keine Custody übernehmen.
• ConfidentialTransfer — Transfer-Beträge sind verschlüsselt; die Kurve kann den Swap nicht bewerten.
• PermanentDelegate — ein Inhaber des Delegates kann jedes Token-Konto leeren, einschließlich des Pool-Vaults. Nur über die statische Whitelist für vertrauenswürdige Emittenten zulässig (z. B. regulierte Stablecoins).
• MintCloseAuthority — der Mint kann geschlossen werden; bestehende Pools werden unbrauchbar. Standardmäßig nicht zulässig.
• DefaultAccountState (Frozen) — Pool-ATAs würden im Frozen-Status landen und müssen pro Konto aufgetaut werden. Nur über Superstate-Erkennung zulässig, die davon ausgeht, dass der Emittent institutionelle Konten bei der Registrierung auftaut.
• Group/Member-Pointer — nicht aktiv schädlich, aber ungeprüft. Standardmäßig nicht zulässig, um die Oberfläche eng zu halten.

​

Transfer-Gebühren-Buchhaltung

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

• amountIn + token2022FeeIn als „Sie senden”
• amountOut - token2022FeeOut als „Sie erhalten”
• feeAmount als die Pool-Gebühr (LP + Protokoll), die von der Token-2022-Transfer-Gebühr getrennt ist

​

maximumFee-Obergrenze

​

Epoch-Übergang

​

Zinsträger und ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

„Token-2022-Pool”-Definition

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

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

​

SDK-Helfer

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);
  }
}

​

Häufige Integrationsfehler

• Nur die Programm-ID vorab-flighting. Ein Mint kann Token-2022 und nicht unterstützt sein. Gehen Sie die Erweiterungsliste gegen die Allow-List (und die statische Whitelist) durch, bevor Sie die Pool-Erstellung zulassen.
• Das SDK-Zitat vertrauen, wenn der Mint überhaupt nicht akzeptiert wird. Die Zitat-API weigert sich nicht zu zitieren — Pool-Erstellung ist das, was zurückgerollt wird. Bestätigen Sie die is_supported_mint-Semantik offline, bevor Sie die Pool-Erstellung in Ihrer UI verfügbar machen.
• Zitieren ohne den Transfer-Gebühren-Haarschnitt. Ein 1%-Transfer-Gebühren-Mint auf beiden Seiten eines 0,25%-CPMM-Pools hat eine effektive Gebühr von etwa 2,25%, nicht 0,25%. Verwenden Sie das SDK-Zitat oder Trade-API-Zitat — berechnen Sie die Gebühr niemals manuell nur aus der Gebühren-Stufe des Pools.
• Die Legacy-Swap-Anweisung auf einem Token-2022-Pool aufrufen. Swap stammt aus der Zeit vor Token-2022. Verwenden Sie SwapV2, wenn einer der Mints Token-2022 ist.
• Automatisches Auflisten neuer Token-2022-Mints. Wallets und Aggregatoren sollten auf TransferHook und NonTransferable prüfen, bevor sie einen Mint Benutzern anzeigen; beide sind Raydium-feindselig.

​

Zukünftige Arbeit

• Allow-listed Transfer-Hook-Programme auf Solana-Ebene (Ökosystem-Konvention entwickelt sich).
• Confidential-Transfer-kompatible AMMs (Forschungsphase).
• Breitere CPMM-Pro-Mint-Registry (Parität mit CLMM).
• Abhängigkeits-Upgrade, damit die ScaledUiConfig-Dekodierung von CLMM ohne die Superstate-Heuristik funktioniert.

​

Zeiger

• algorithms/token-2022-transfer-fees — Gebühren-Mathematik in Swaps.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — NotSupportMint-Numerische Codes pro Programm.

• 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 — Pro-Mint-Registry-Anweisung.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — LaunchLab Token-2022-Base-Mint-Erstellung.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — LaunchLab-Quote-Mint-Bindung (keine Erweiterungsprüfung).