Token-2022-Unterstützungsmatrix

Diese Seite wurde mit KI automatisch übersetzt. Maßgeblich ist stets die englische Version.Englische Version ansehen →

Raydium akzeptiert keine beliebigen Token-2022-Mints. Sowohl CPMM als auch CLMM laufen im strikten Allow-List-Modus: Nur eine kleine Menge von Erweiterungen passiert standardmäßig; alles andere wird bei der Pool-Erstellung abgelehnt. Eine Handvoll vertrauenswürdiger Mints werden durch hardcodierte Adressen zugelassen; CLMM unterstützt zusätzlich eine von Administratoren verwaltete Pro-Mint-Registry und eine Laufzeit-Superstate-Token-Erkennung. Diese Seite ist die Einzelseiten-Referenz für das, was durchgesetzt wird und wo, mit Datei- und Zeilenzitaten in den Programmquellen.

Unterstützung auf Programmebene

Programm	Token-2022 Base/Quote-Mints?	Modus
CPMM	Ja — gated	Strikte Erweiterungs-Allowlist + 4-Mint-statische Whitelist.
CLMM	Ja — gated	Strikte Erweiterungs-Allowlist + 6-Mint-statische Whitelist + Admin-Pro-Mint-Registry + Superstate-Erkennung.
AMM v4	Nein	Programm stammt aus der Zeit vor Token-2022; beide Mints müssen klassisches SPL Token sein.
Stable AMM	Nein	Gleiche Einschränkungen wie AMM v4.
Farm v6	Ja, teilweise	Reward-Mint kann Token-2022 sein (unterliegt der gleichen Allow-List, wenn eine Farm einen CPMM/CLMM LP umhüllt); User-Stake-LP-Mints erben vom umhüllten Pool.
LaunchLab	Ja, programmverwaltet	Base-Mint kann Token-2022 sein, aber nur über die dedizierte `initialize_with_token_2022`-Anweisung; das Programm selbst erstellt den Mint mit `MetadataPointer` (immer) und optional `TransferFeeConfig` (Rate ≤ 5%). Bereits existierende Token-2022-Mints mit beliebigen Erweiterungen können nicht als Base verwendet werden.
Burn & Earn	Spiegelt Pool-Programm	Erbt CPMM/CLMM-Gating.

Die Allow-List-Checks befinden sich in:

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 (Quelle nicht öffentlich verfügbar).

Es gibt keinen Swap-Zeit-Mint-Check auf CPMM oder CLMM — das Gate wird nur bei der Pool-Erstellung ausgelöst. Sobald ein Pool existiert, vertrauen Swaps darauf, dass sich die Mints nicht geändert haben, was für die unveränderlichen Teile des Token-2022-Mint-Status korrekt ist.

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

Position-NFT-Konten bleiben standardmäßig aufgetaut. CLMM friert einen nur ein, wenn die Position einen V2-Open-Pfad verwendet und mindestens eine Vault-Mint die aktuelle freeze_authority hat, die der hardcodierten Liste eingeschränkter Emittenten entspricht. Die anfängliche Liste enthält die gleiche Authority, die vom Superstate-Erkennungspfad unten verwendet wird. Das Setzen des Pool-PDA als Freeze-Authority des Position-NFT-Mints ist selbst kein Einfrieren. Dies ist eine Position-Custody-Regel, keine weitere Pool-Erstellungs-Allow-List:

Der Pool kann bereits existieren und bleibt swappbar.
Der Position-NFT-Mint verwendet den 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.

Eingefrorene Positionen bleiben von ihrem Besitzer verwaltbar, können aber nicht übertragen werden. ClosePosition taut auf und brennt atomar, wenn der Client den Pool als erstes verbleibendes Konto übergibt. Siehe products/clmm/ticks-and-positions.

CPMM- und CLMM-Erweiterungs-Allow-List

Nach den statischen Whitelist-Kurzschlüssen (unten behandelt) iteriert das Programm die Erweiterungen des Mints und lehnt den Mint ab, wenn er irgendeine Erweiterung außer diesen fünf trägt:

Erweiterung	Grund für die Zulassung
`TransferFeeConfig`	Pool-Mathematik subtrahiert die eingehende Gebühr; das Token-2022-Programm verarbeitet die ausgehende Gebühr. Siehe `algorithms/token-2022-transfer-fees`.
`MetadataPointer`	Dekorativ — zeigt auf On-Chain-Metadaten.
`TokenMetadata`	Dekorativ — Inline-Metadaten.
`InterestBearingConfig`	Pool sieht den Hauptbetrag; UI-Multiplikator ist nur Dekoration und der zugrunde liegende Saldo bleibt erhalten.
`ScaledUiAmount`	Gleiche Form wie Zinsträger — Skalierungsfaktor gilt nur für UI-Anzeige.

Alles nicht in dieser Liste — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable usw. — führt dazu, dass is_supported_mint false zurückgibt und die Pool-Erstellung zurückgerollt wird. Die relevanten Zeilen (CPMM, identische Form in 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)

— cp-swap/src/utils/token.rs:190–200

Bypass-Pfade

Ein Token-2022-Mint, der nicht in die Allow-List passt, kann immer noch durch einen von drei expliziten Bypasses zugelassen werden. Sie werden der Reihe nach versucht, bevor die Erweiterungsiteration ausgeführt wird.

1. Statische Mint-Whitelist

Ein konstantes MINT_WHITELIST-Array von Base58-Strings ist in jedem Programm hardcodiert. Wenn die Adresse des Mints übereinstimmt, gibt die Funktion sofort true zurück und es wird keine Erweiterungsprüfung durchgeführt.

Programm	Whitelisted Mints
CPMM	`HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM`, `Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g`, `FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4`, `2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo`
CLMM	Die gleichen vier, plus `DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg`, `AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9`

Diese Adressen sind in das Programm eingebacken; das Aktualisieren der Liste erfordert ein Programm-Upgrade durch das 3/4-Upgrade-Multisig.

2. Pro-Mint-Registry — nur CLMM

CLMM konsultiert zusätzlich einen SupportMintAssociated-PDA mit Seed [b"support_mint", mint]. Wenn dieser PDA für den Mint existiert, wird er unabhängig von seinem Erweiterungssatz zugelassen. Der PDA wird von CreateSupportMintAssociated erstellt (admin/create_support_mint_associated.rs). Die Anweisung ist auf zwei Unterzeichner beschränkt:

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

Effekt: Das CLMM-Team kann einen bestimmten Token-2022-Mint für die Pool-Erstellung aktivieren, ohne ein Programm-Upgrade durchzuführen. CPMM hat kein Äquivalent — seine Allow-List ist streng im Quellcode definiert.

3. Superstate-Erkennung — nur CLMM

CLMM hat einen dritten Pfad speziell für Superstates tokenisierte Assets, die die ScaledUiConfig-Erweiterung verwenden, die die Version von spl-token-2022, die in das CLMM-Programm verlinkt ist, nicht entpacken kann. Anstatt die Abhängigkeit zu aktualisieren, erkennt CLMM Superstate-Token an ihrer Authority-Form:

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

— raydium-clmm/programs/amm/src/util/token.rs:485 Ein Mint passiert diesen Branch, wenn alle vier zutreffen:

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.

Dies ist eine Heuristik, keine Registry — jeder zukünftige Mint, den Superstate mit der gleichen Authority-Form ausgibt, wird automatisch zugelassen.

Was die Bypasses nicht verzeihen

Die Bypasses überspringen die Erweiterungs-Allow-List, aber das Programm erzwingt immer noch:

Der Mint wird entweder von 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.

Ein whitelisteter oder PDA-registrierter Mint, der z. B. später einen TransferHook hinzufügt, erhält keinen Swap-Zeit-Check; der Hook würde einfach bei jedem Transfer ausgeführt und könnte Swaps blockieren. Whitelisting ist daher eine Aktion mit hohem Vertrauen.

„Blocked”-Semantik

Wenn is_supported_mint false zurückgibt, wird die Pool-Erstellung mit ErrorCode::NotSupportMint (CPMM) / ErrorCode::NotSupportMint (CLMM) zurückgerollt. Siehe reference/error-codes für die numerischen Codes. Bestehende Pools können diese Prüfung nicht rückwirkend fehlschlagen — das Gate wird nur bei der Erstellung ausgeführt. Mint-Erweiterungen sind unveränderlich für die Kategorien, die Raydium ablehnt (Transfer-Hook, Non-Transferable, Confidential-Transfer können nach der Erstellung nicht hinzugefügt werden), daher ist die statische Prüfung ausreichend.

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-Listen; 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, einschließlich des Pool-Vaults, leeren. 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

Für Mints mit TransferFeeConfig bewegt jeder Swap, jede Einzahlung und jede Auszahlung weniger als den nominalen Betrag. Das SDK zeigt beide Hälften der Berechnung:

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

Eine korrekte UI zeigt:

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

Eine naive UI, die nur amountIn → amountOut zeigt, unterschätzt die Kosten.

`maximumFee`-Obergrenze

Token-2022-Transfer-Gebühren sind pro Transfer begrenzt. Für einen 1%-Mint mit einer 10.000-Token-Obergrenze zahlt ein 100.000.000-Token-Transfer nur 10.000 an Gebühren. Das computeSwapAmount des SDK wendet die Obergrenze an; direkte Programm-Aufrufer müssen sie replizieren.

Epoch-Übergang

Eine Mint-Authority kann eine Gebührensatzänderung planen, die in der nächsten Epoch aktiviert wird. Während des Übergangsfensters leben zwei Configs (older, newer) gleichzeitig auf dem Mint und TransferChecked wählt nach aktuellem Epoch. Sowohl CPMM SwapV2 als auch CLMM SwapV2 übergeben das vollständige Mint-Konto in accounts, sodass das Programm die richtige Config ohne zusätzliche Suche liest. Wenn Sie mehr als eine Epoch im Voraus über die Trade API oder das SDK zitieren, kann die ausgeführte Gebühr von der zitierten Gebühr abweichen — begrenzt durch die maximum_fee_basis_points der älteren Config.

Zinsträger und ScaledUiAmount

Der Pool hält den Hauptbetrag; der „UI-Betrag” ist der Hauptbetrag multipliziert mit einem zeitabhängigen oder von Admin gesetzten Skalierungsfaktor. Swap-Mathematik arbeitet mit dem Hauptbetrag:

principal_in = ui_amount_in / ui_multiplier(now)

Das SDK konvertiert automatisch. Direkte RPC-Leser sollten pool.token0Vault.amount als Hauptbetrag behandeln.

Definition von „Token-2022-Pool”

Ein Pool ist ein Token-2022-Pool, wenn entweder Mint programId == TokenzQdB... hat. Die API zeigt dies:

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

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

Verwenden Sie programId zum Dispatchen und hasTransferFee zum Anzeigen einer UI-Warnung.

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 prüfen. 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 — die 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 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 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 entweder Mint Token-2022 ist.
Neue Token-2022-Mints automatisch auflisten. Wallets und Aggregatoren sollten auf TransferHook und NonTransferable prüfen, bevor sie einen Mint Benutzern anzeigen; beide sind Raydium-feindselig.

Zukünftige Arbeiten

Solana-Ökosystem- und Protokoll-Roadmap-Elemente, die diese Matrix ändern würden:

Allow-gelistete 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.

Diese Seite wird aktualisiert, wenn etwas davon umgesetzt wird.

Verweise

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.

Quellen:

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.

​Unterstützung auf Programmebene

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

​CPMM- und CLMM-Erweiterungs-Allow-List

​Bypass-Pfade

​1. Statische Mint-Whitelist

​2. Pro-Mint-Registry — nur CLMM

​3. Superstate-Erkennung — nur CLMM

​Was die Bypasses nicht verzeihen

​„Blocked”-Semantik

​Warum jede ausgeschlossene Erweiterung ausgeschlossen ist

​Transfer-Gebühren-Buchhaltung

​maximumFee-Obergrenze

​Epoch-Übergang

​Zinsträger und ScaledUiAmount

​Definition von „Token-2022-Pool”

​SDK-Helfer

​Häufige Integrationsfehler

​Zukünftige Arbeiten

​Verweise

Unterstützung auf Programmebene

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

CPMM- und CLMM-Erweiterungs-Allow-List

Bypass-Pfade

1. Statische Mint-Whitelist

2. Pro-Mint-Registry — nur CLMM

3. Superstate-Erkennung — nur CLMM

Was die Bypasses nicht verzeihen

„Blocked”-Semantik

Warum jede ausgeschlossene Erweiterung ausgeschlossen ist

Transfer-Gebühren-Buchhaltung

`maximumFee`-Obergrenze

Epoch-Übergang

Zinsträger und ScaledUiAmount

Definition von „Token-2022-Pool”

SDK-Helfer

Häufige Integrationsfehler

Zukünftige Arbeiten

Verweise