Token-2022-Unterstützungsmatrix

​

Unterstützung auf Programmebene

• CPMM: is_supported_mint in raydium-cp-swap/programs/cp-swap/src/utils/token.rs, aufgerufen von Initialize und InitializeWithPermission.
• CLMM: is_supported_mint in raydium-clmm/programs/amm/src/util/token.rs, 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 tauschbar.
• Der Position-NFT-Mint verwendet die CLMM-Pool-PDA als seine eigene Freeze-Autorität; 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 die Token-2022-eingeschränkten Assets, auf die die ausgelieferte Liste abzielt, nicht bedienen.
• 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-Autorität-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 prüft 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 Brutto-Bewegung 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

​

Der einzige Bypass: die Pro-Mint-Registry

​

Die entfernten Bypasses

​

Statische MINT_WHITELIST — entfernt

​

Superstate-Autoritäts-Form-Erkennung — entfernt

​

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.

​

„Blockiert”-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-Allowlists; Raydium nicht.
• NonTransferable — Transfer schlägt immer fehl. Ein Pool kann keine Verwahrung übernehmen.
• ConfidentialTransfer — Übertragsbeträge sind verschlüsselt; die Kurve kann den Swap nicht bewerten.
• PermanentDelegate — ein Inhaber des Delegaten kann jedes Token-Konto leeren, einschließlich des Pool-Vaults. Nur durch Registrierung des Mints zulässig, was ist, wie ein vertrauenswürdiger Emittent (z. B. eine regulierte Stablecoin) Fall für Fall eingebunden wird.
• 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 durch Registrierung des Mints zulässig, was 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.

​

Gebührenabrechnung übertragen

• Die Pool-Gebühr (LP + Protokoll + Fonds + Creator) kommt aus der Kurve. raydium.cpmm.computeSwapAmount({ ... }) gibt sie als fee zurück, zusammen mit amountIn, amountOut, minAmountOut, executionPrice, priceImpact und dem rohen swapResult.
• Die Token-2022-Übertragsgebühr kommt vom Mint, nicht vom Pool. Sie wird von den getTransferAmountFee-Helfern in @raydium-io/raydium-sdk-v2 berechnet, die eine GetTransferAmountFee zurückgeben:

export interface GetTransferAmountFee {
  amount: BN;                  // der Betrag, der tatsächlich bewegt wird
  fee: BN | undefined;         // vom Mint einbehalten; undefined, wenn der Mint keine TransferFeeConfig hat
  expirationTime: number | undefined;  // gesetzt, während eine geplante Gebührenänderung ausstehend ist
}

• den Eingabebetrag plus seine Übertragsgebühr als „Sie senden”
• den Ausgabebetrag minus seine Übertragsgebühr als „Sie erhalten”
• die Pool-Gebühr als separate Zeile — es ist nicht die Token-2022-Gebühr

​

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 } from "@raydium-io/raydium-sdk-v2";
// TOKEN_2022_PROGRAM_ID is not re-exported by the Raydium SDK — import it from
// @solana/spl-token, as the SDK itself does.
import {
  TOKEN_2022_PROGRAM_ID,
  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 Allowlist durch und prüfen Sie auf die Registry-PDA des Mints, bevor Sie die Pool-Erstellung zulassen.
• Der SDK-Quote vertrauen, wenn der Mint überhaupt nicht akzeptiert wird. Die Quote-API weigert sich nicht zu zitieren — Pool-Erstellung ist das, was zurückgerollt wird. Bestätigen Sie is_supported_mint-Semantik offline, bevor Sie die Pool-Erstellung in Ihrer UI verfügbar machen.
• Zitieren ohne den Übertragsgebühren-Haarschnitt. Ein 1%-Übertragsgebü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-Quote oder Trade-API-Quote — berechnen Sie die Gebühr niemals manuell nur aus der Pool-Gebühren-Stufe.
• 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

• Auf Solana-Ebene erlaubte Transfer-Hook-Programme (Ökosystem-Konvention entwickelt sich).
• Vertrauliche-Transfer-kompatible AMMs (Forschungsstadium).
• Breitere CPMM-Pro-Mint-Registry (Parität mit CLMM).
• Ein öffentlicher Lesepfad für die Registry, damit eine UI „nicht unterstützt” von „nicht unterstützt aber registriert” unterscheiden kann, ohne die PDA selbst abzuleiten.

​

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