Matriks dukungan Token-2022

Program Raydium mana yang mendukung Token-2022, daftar izin eksplisit yang ditegakkan setiap program saat pembuatan pool, dan satu-satunya bypass yang tersisa — PDA registri per-mint yang dikelola admin — yang mengakui mint yang ditolak.

Halaman ini diterjemahkan secara otomatis oleh AI. Versi bahasa Inggris adalah acuan resmi.

Lihat versi bahasa Inggris →

Raydium tidak menerima mint Token-2022 sembarangan. CPMM dan CLMM keduanya menjalankan mode daftar izin ketat: hanya serangkaian kecil ekstensi yang lolos secara default; semuanya ditolak saat pembuatan pool. Setiap program mengakui mint individual melalui satu mekanisme — PDA registri per-mint yang dikelola admin. Kedua program juga membawa bypass yang dikodekan keras di berbagai titik; semua itu telah dihapus. Halaman ini adalah referensi satu halaman untuk apa yang ditegakkan dan di mana, dengan kutipan ke sumber program.

​

Dukungan tingkat program

Program	Mint base/quote Token-2022?	Mode
CPMM	Ya — terbatas	Daftar izin ekstensi ketat + registri per-mint admin. Daftar putih statis 4-mint-nya dihapus dalam upgrade 2026-09.
CLMM	Ya — terbatas	Daftar izin ekstensi ketat + registri per-mint admin. Daftar putih statis 6-mint dan deteksi Superstate-nya dihapus pada Juli 2026.
AMM v4	Tidak	Program mendahului Token-2022; kedua mint harus SPL Token klasik.
Stable AMM	Tidak	Batasan yang sama dengan AMM v4.
Farm v6	Ya, sebagian	Mint reward dapat berupa Token-2022 (tunduk pada daftar izin yang sama ketika farm membungkus LP CPMM/CLMM); mint LP stake pengguna diwariskan dari pool yang dibungkus.
LaunchLab	Ya — base dikelola program, quote tidak terbatas	Mint base dapat berupa Token-2022, tetapi hanya melalui instruksi initialize_with_token_2022 khusus; program itu sendiri membuat mint dengan MetadataPointer (selalu) dan secara opsional TransferFeeConfig (rate ≤ 5%). Mint Token-2022 yang sudah ada dengan ekstensi sembarangan tidak dapat digunakan sebagai base. Mint quote dapat berupa mint Token-2022 apa pun yang diikat admin ke GlobalConfig, tanpa pemeriksaan ekstensi — lihat di bawah.
Burn & Earn	Mencerminkan program pool	Mewarisi gating CPMM / CLMM.

Pemeriksaan daftar izin berada di:

• CPMM: is_supported_mint dalam raydium-cp-swap/programs/cp-swap/src/utils/token.rs, dipanggil dari Initialize dan InitializeWithPermission.
• CLMM: is_supported_mint dalam raydium-clmm/programs/amm/src/util/token.rs, dipanggil dari CreatePool.
• LaunchLab: initialize_with_token_2022 dalam raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (sumber tidak tersedia untuk publik).

Tidak ada pemeriksaan mint saat swap pada CPMM atau CLMM — gating hanya berlaku saat pembuatan pool. Setelah pool ada, swap hanya mempercayai bahwa mint tidak berubah, yang benar untuk bagian yang tidak dapat diubah dari status mint Token-2022.

​

Pembekuan NFT posisi CLMM untuk penerbit terbatas

Akun NFT posisi tetap tidak beku secara default. CLMM membekukan satu hanya ketika posisi menggunakan jalur terbuka V2 dan setidaknya satu freeze_authority mint vault saat ini muncul dalam daftar frozen_position_nft_authorities::IDS yang dikodekan keras. Daftar itu adalah apa yang menggantikan deteksi token Superstate CLMM sebelumnya, dan membawa otoritas penerbit yang sama dengan heuristik lama yang cocok. Menetapkan pool PDA sebagai freeze_authority mint NFT posisi bukan pembekuan itu sendiri. Ini adalah aturan penjagaan posisi, bukan daftar izin pembuatan pool:

• Pool sudah dapat ada dan tetap dapat ditukar.
• Mint NFT posisi menggunakan pool PDA CLMM sebagai freeze_authority-nya sendiri; penerbit yang mendasar tidak mengendalikan NFT posisi.
• OpenPositionV2 mencakup NFT posisi SPL klasik atas aset pool Token-2022. OpenPositionWithToken22Nft mencakup NFT posisi Token-2022.
• OpenPosition V1 tidak memeriksa mint vault dan tidak dapat melayani aset terbatas Token-2022 yang ditargetkan oleh daftar yang dikirim.
• Posisi yang ada tidak berubah.

Posisi yang beku tetap dapat dikelola oleh pemiliknya tetapi tidak dapat ditransfer. ClosePosition mencairkan dan membakar secara atomik ketika klien melewatkan pool sebagai akun pertama yang tersisa. Lihat products/clmm/ticks-and-positions.

​

Mint quote LaunchLab

Dua mint LaunchLab dibatasi sangat berbeda, dan asimetrinya mudah terlewatkan.

• Mint base — LaunchLab membuatnya. Mint base Token-2022 hanya dapat dicapai melalui initialize_with_token_2022, dan program hanya akan melampirkan MetadataPointer dan (secara opsional) TransferFeeConfig. Apa pun yang lain mengembalikan NoSupportExtension. Mint Token-2022 yang sudah ada tidak dapat disuplai sebagai base sama sekali. Ketika TransferFeeConfig dilampirkan, transfer_fee_config_authority mint adalah PDA otoritas peluncuran hingga kelulusan, sementara withdraw_withheld_authority-nya adalah transfer_fee_extension_auth platform yang dikonfigurasi dari pembuatan mint seterusnya — program launchpad itu sendiri tidak memiliki instruksi withdraw-withheld. Lihat products/launchlab/platform-config.
• Mint quote — LaunchLab tidak membuatnya dan tidak menyaringnya. CreateConfig menerima akun mint sebagaimana diberikan, jadi tidak ada setara is_supported_mint di sisi quote. Satu-satunya gating adalah mint mana yang dipilih admin untuk diikat ke GlobalConfig.

Itu membuat pengikatan mint quote Token-2022 menjadi tindakan kepercayaan tinggi, untuk alasan yang sama dengan mendaftarkan mint di bawah: mint quote TransferHook akan menjalankan hook-nya pada setiap pembelian, penjualan, dan klaim biaya di setiap pool yang dikutip di dalamnya, dan mint quote PermanentDelegate akan membiarkan delegasi menyapu vault quote pool tersebut. Tidak satupun yang diblokir oleh program.

Apa yang LaunchLab tangani dengan benar setelah mint quote diikat:

• Vault quote, kedua vault biaya, dan akun token penerima biaya saham dibuat pada program mint quote itu sendiri.
• TransferFeeConfig di sisi quote diperhitungkan dalam keempat instruksi perdagangan, dan batas slippage diperiksa terhadap jumlah bersih pembayar daripada pergerakan vault kotor. Lihat products/launchlab/instructions.
• PoolState.token_program_flag mencatat program kedua mint — bit0 untuk mint base, bit1 untuk mint quote. Dekode per bit; byte bukan boolean. Lihat products/launchlab/accounts.

Instruksi Initialize yang sudah usang masih mengambil program quote warisan saja, jadi config dengan mint quote Token-2022 hanya dapat dicapai melalui InitializeV2 dan InitializeWithToken2022.

​

Daftar izin ekstensi CPMM dan CLMM

Setelah dua shortcut yang tercakup di bawah, program mengulangi ekstensi mint dan menolak mint jika membawa ekstensi apa pun selain lima ini:

Ekstensi	Alasan diizinkan
TransferFeeConfig	Matematika pool mengurangi biaya masuk; program Token-2022 menangani biaya keluar. Lihat algorithms/token-2022-transfer-fees.
MetadataPointer	Dekoratif — menunjuk ke metadata on-chain.
TokenMetadata	Dekoratif — metadata inline.
InterestBearingConfig	Pool melihat jumlah pokok; pengganda UI hanya dekorator dan saldo yang mendasar dipertahankan.
ScaledUiAmount	Bentuk yang sama dengan interest-bearing — faktor skala hanya berlaku untuk tampilan UI.

Apa pun yang tidak dalam daftar ini — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable, dll. — menyebabkan is_supported_mint mengembalikan false dan pembuatan pool kembali.

Baris yang relevan (CPMM, bentuk identik di 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

​

Jalur bypass

Mint Token-2022 yang tidak sesuai dengan daftar izin masih dapat diterima, melalui satu mekanisme di setiap program. Kedua program juga membawa bypass yang dikodekan keras di masa lalu; tidak satupun yang bertahan.

Bypass	CPMM	CLMM
PDA registri per-mint	Ya — satu-satunya bypass	Ya — satu-satunya bypass
MINT_WHITELIST statis	Dihapus 2026-09 (4 alamat)	Dihapus 2026-07 (6 alamat)
Deteksi bentuk otoritas Superstate	Tidak pernah ada	Dihapus 2026-07

is_supported_mint sekarang byte-for-byte fungsi yang sama di kedua program: mint SPL Token warisan lolos, mint dengan PDA registri lolos, dan semuanya harus membawa hanya ekstensi yang diizinkan.

​

Satu-satunya bypass: registri per-mint

Kedua program berkonsultasi dengan PDA SupportMintAssociated pada seed [b"support_mint", mint]. Jika PDA itu ada untuk mint, mint diterima terlepas dari set ekstensinya.

Setiap program memiliki salinannya sendiri dari PDA (mereka berasal di bawah ID program yang berbeda), pasangan CreateSupportMintAssociated / CloseSupportMintAssociated sendiri, dan otoritas khusus sendiri bersama admin bersama:

Empat kunci (CPMM dan CLMM × mainnet dan devnet) tercantum di bawah Support-mint registry authorities.

Di kedua program instruksi menerima baik crate::admin::ID atau otoritas khusus program itu, dan memerlukan mint dimiliki oleh Token-2022. Efek: mint Token-2022 tertentu dapat dipilih ke dalam pembuatan pool tanpa upgrade program — itulah mengapa daftar yang dikodekan keras bisa hilang.

Setiap program berkonsultasi dengan registri dari setiap jalur pembuatan pool yang dimilikinya: CPMM dari Initialize dan InitializeWithPermission (yang terakhir adalah apa yang digunakan kelulusan LaunchLab, jadi mint terdaftar lulus serta membuat), CLMM dari CreatePool, CreateCustomizablePool dan CreateCustomizablePoolV2.

​

Mekanisme bypass yang dihapus

Kedua mekanisme hardcoded telah dihapus dari program yang di-deploy. Mekanisme ini didokumentasikan di sini hanya karena integrasi yang ditulis terhadap perilaku lama mungkin masih mengasumsikannya.

​

Static MINT_WHITELIST — dihapus

Sebuah array konstanta dari alamat mint base58 yang digunakan untuk short-circuit is_supported_mint sebelum iterasi extension. CLMM menyimpan enam alamat dan dihapus pada 2026-07-24; CPMM menyimpan empat alamat pertama dari set yang sama dan dihapus dalam upgrade 2026-09-09.

Sebelumnya di-whitelist di	Mints
CPMM dan CLMM	HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM, Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g, FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4, 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
CLMM saja	DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg, AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9

Pool yang sudah ada untuk salah satu mint ini tetap dapat melakukan trading — pemeriksaan mint hanya berjalan saat pembuatan pool. Membuat pool baru untuk salah satu mint sekarang memerlukan registry PDA untuk mint tersebut.

​

Deteksi bentuk authority Superstate — dihapus

CLMM sempat mengidentifikasi aset tokenisasi Superstate berdasarkan bentuk authority mereka daripada berdasarkan alamat: mint Token-2022 yang freeze_authority dan permanent delegate keduanya sama dengan superstate_allowlist::ID, dengan DefaultAccountState diatur ke Frozen, diterima. Ini adalah heuristik, jadi mint apa pun di masa depan dengan bentuk yang sama akan diterima secara otomatis.

Ini dihapus pada 2026-07-31, bersama dengan modul superstate_allowlist. Apa yang menggantinya lebih sempit dan melayani tujuan yang berbeda: frozen_position_nft_authorities::IDS, yang tidak menerima apa pun — ini menentukan apakah position NFT menjadi frozen, dan dijelaskan di atas. Satu-satunya issuer authority yang cocok dengan heuristik lama adalah satu-satunya entri dalam daftar itu.

​

Apa yang tidak dilewati oleh bypass

Bypass melewati extension allow-list, tetapi program masih memberlakukan:

• Mint dimiliki oleh Token atau Token-2022. Program token kustom ditolak upstream.
• Pool vault dibuat dengan extension ATA yang tepat untuk pool Token-2022 (ImmutableOwner, dll.).
• Semua transfer melalui transfer_checked — mint yang membawa biaya mendarat dengan jumlah yang tepat di vault.

Mint yang di-whitelist atau terdaftar di PDA yang, misalnya, menambahkan TransferHook kemudian tidak mendapatkan pemeriksaan saat swap; hook akan berjalan pada setiap transfer dan dapat merusak swap. Mendaftarkan mint adalah tindakan yang memerlukan kepercayaan tinggi.

​

Semantik “Blocked”

Ketika is_supported_mint mengembalikan false, pembuatan pool kembali dengan ErrorCode::NotSupportMint (CPMM) / ErrorCode::NotSupportMint (CLMM). Lihat reference/error-codes untuk kode numerik.

Pool yang sudah ada tidak dapat secara retroaktif gagal pemeriksaan ini — gate hanya berjalan saat pembuatan. Extension mint tidak dapat diubah untuk kategori yang ditolak Raydium (transfer hook, non-transferable, confidential transfer tidak dapat ditambahkan setelah pembuatan), jadi pemeriksaan statis sudah cukup.

​

Mengapa setiap extension yang dikecualikan dikecualikan

• TransferHook — memanggil program kustom pada setiap transfer, dengan konsumsi CU yang sewenang-wenang, kondisi kegagalan yang sewenang-wenang, dan kemampuan untuk memasuki kembali program yang memanggil. Tidak ada sandbox yang aman. Beberapa DEX mempertahankan hook allow-list; Raydium tidak.
• NonTransferable — Transfer selalu gagal. Pool tidak dapat mengambil alih.
• ConfidentialTransfer — jumlah transfer dienkripsi; kurva tidak dapat menentukan harga swap.
• PermanentDelegate — pemegang delegate dapat menyapu akun token apa pun, termasuk pool vault. Hanya dapat diterima dengan mendaftarkan mint, yang merupakan cara issuer terpercaya (misalnya stablecoin yang diatur) di-onboard kasus per kasus.
• MintCloseAuthority — mint dapat ditutup; pool yang ada menjadi tidak dapat digunakan. Dilarang secara default.
• DefaultAccountState (Frozen) — pool ATA akan mendarat dalam status Frozen dan memerlukan thawing per akun. Hanya dapat diterima dengan mendaftarkan mint, yang mengasumsikan issuer mencairkan akun institusional saat pendaftaran.
• Group/Member pointers — tidak secara aktif berbahaya, tetapi belum ditinjau. Dilarang secara default untuk menjaga permukaan tetap sempit.

​

Akuntansi transfer-fee

Untuk mint yang membawa TransferFeeConfig, setiap swap, deposit, dan withdraw memindahkan lebih sedikit dari jumlah nominal. Dua angka terpisah terlibat, dan SDK menjaganya tetap terpisah:

• Pool fee (LP + protokol + dana + kreator) berasal dari kurva. raydium.cpmm.computeSwapAmount({ ... }) mengembalikannya sebagai fee, bersama dengan amountIn, amountOut, minAmountOut, executionPrice, priceImpact dan swapResult mentah.
• Token-2022 transfer fee berasal dari mint, bukan pool. Ini dihitung oleh helper getTransferAmountFee di @raydium-io/raydium-sdk-v2, yang mengembalikan GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // the amount that actually moves
  fee: BN | undefined;         // withheld by the mint; undefined when the mint has no TransferFeeConfig
  expirationTime: number | undefined;  // set while a scheduled fee change is pending
}

Deposit dan withdraw menampilkannya secara langsung: computePairAmount mengembalikan inputAmountFee dan anotherAmount sebagai nilai GetTransferAmountFee.

UI yang benar menampilkan:

• jumlah input plus transfer fee-nya sebagai “Anda mengirim”
• jumlah output minus transfer fee-nya sebagai “Anda menerima”
• pool fee sebagai baris terpisah — ini bukan Token-2022 fee

UI naif yang hanya menampilkan amountIn → amountOut meremehkan biaya. Lewatkan epochInfo dari cluster ke helper ini daripada meng-cache-nya; epoch adalah yang memilih antara older dan newer fee config mint.

​

Batas maximumFee

Token-2022 transfer fee dibatasi per transfer. Untuk mint 1% dengan batas 10.000 token, transfer 100.000.000 token hanya membayar 10.000 dalam biaya. SDK computeSwapAmount menerapkan batas; pemanggil program langsung harus mereplikasi batas.

​

Transisi epoch

Otoritas mint dapat menjadwalkan perubahan fee-rate yang diaktifkan pada epoch berikutnya. Selama jendela transisi, dua config (older, newer) hidup di mint secara bersamaan dan TransferChecked memilih berdasarkan epoch saat ini. CPMM SwapV2 dan CLMM SwapV2 keduanya melewatkan akun mint lengkap di accounts, jadi program membaca config yang tepat tanpa lookup tambahan.

Jika Anda mengutip lebih dari satu epoch sebelumnya melalui Trade API atau SDK, biaya yang dieksekusi dapat berbeda dari biaya yang dikutip — dibatasi oleh maximum_fee_basis_points config yang lebih lama.

​

Interest-bearing dan ScaledUiAmount

Pool menyimpan jumlah pokok; “UI amount” adalah pokok dikalikan dengan faktor skala yang bergantung waktu atau diatur admin. Matematika swap beroperasi pada pokok:

principal_in = ui_amount_in / ui_multiplier(now)

SDK mengonversi secara otomatis. Pembaca RPC langsung harus memperlakukan pool.token0Vault.amount sebagai pokok.

​

Definisi “Token-2022 pool”

Pool adalah Token-2022 pool jika salah satu mint memiliki programId == TokenzQdB.... API menampilkan ini:

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

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

Gunakan programId untuk dispatch, dan hasTransferFee untuk menampilkan peringatan UI.

​

SDK helpers

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

​

Kesalahan integrasi umum

• Pre-flighting hanya program ID. Mint dapat menjadi Token-2022 dan tidak didukung. Jalan-jalan daftar extension terhadap allow-list, dan periksa registry PDA mint, sebelum memungkinkan pembuatan pool.
• Mempercayai quote SDK ketika mint tidak diterima sama sekali. Quote API tidak menolak untuk mengutip — pembuatan pool adalah yang kembali. Konfirmasi semantik is_supported_mint off-chain sebelum mengekspos pembuatan pool di UI Anda.
• Mengutip tanpa potongan transfer-fee. Mint transfer-fee 1% di kedua sisi pool CPMM 0,25% memiliki biaya efektif sekitar 2,25%, bukan 0,25%. Gunakan quote SDK atau quote Trade API — jangan pernah hitung biaya secara manual dari tier biaya pool saja.
• Memanggil instruksi Swap legacy pada pool Token-2022. Swap mendahului Token-2022. Gunakan SwapV2 kapan pun salah satu mint adalah Token-2022.
• Auto-listing mint Token-2022 baru. Dompet dan agregator harus memeriksa TransferHook dan NonTransferable sebelum menampilkan mint kepada pengguna; keduanya tidak ramah Raydium.

​

Pekerjaan di masa depan

Item roadmap ekosistem Solana dan protokol yang akan mengubah matriks ini:

• Program transfer-hook yang di-allow-list di level Solana (konvensi ekosistem berkembang).
• AMM yang kompatibel dengan confidential-transfer (tahap penelitian).
• Registry per-mint CPMM yang lebih luas (paritas dengan CLMM).
• Jalur baca publik untuk registry, sehingga UI dapat membedakan “tidak didukung” dari “tidak didukung tetapi terdaftar” tanpa menurunkan PDA itu sendiri.

Halaman ini akan diperbarui ketika ada yang mendarat.

​

Pointer

• algorithms/token-2022-transfer-fees — matematika biaya dalam swap.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — kode numerik NotSupportMint per program.

Sumber:

• 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 — instruksi registry per-mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — pembuatan base-mint Token-2022 LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — pengikatan quote-mint LaunchLab (tidak ada pemeriksaan extension).