Matriks dukungan Token-2022

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 sama-sama menjalankan mode daftar izin ketat: hanya serangkaian kecil ekstensi yang lulus secara default; semuanya ditolak saat pembuatan pool. Beberapa mint tepercaya diterima melalui alamat yang dikode keras; CLMM juga mendukung registri per-mint yang dikelola admin dan deteksi token Superstate saat runtime. Halaman ini adalah referensi singkat untuk apa yang diterapkan dan di mana, lengkap dengan kutipan file-dan-baris ke sumber program.

Dukungan tingkat program

Program	Mint Token-2022 base/quote?	Mode
CPMM	Ya — gated	Daftar izin ekstensi ketat + daftar whitelist 4 mint statis.
CLMM	Ya — gated	Daftar izin ekstensi ketat + daftar whitelist 6 mint statis + registri per-mint admin + deteksi Superstate.
AMM v4	Tidak	Program mendahului Token-2022; kedua mint harus SPL Token klasik.
Stable AMM	Tidak	Batasan sama dengan AMM v4.
Farm v6	Ya, sebagian	Mint reward dapat berupa Token-2022 (tunduk pada daftar izin yang sama saat farm membungkus LP CPMM/CLMM); mint LP stake pengguna mewarisi dari pool yang dibungkus.
LaunchLab	Ya, dikelola program	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.
Burn & Earn	Cerminkan program pool	Mewarisi gating CPMM / CLMM.

Pengecekan daftar izin berada di:

CPMM: is_supported_mint di raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, dipanggil dari Initialize.
CLMM: is_supported_mint di raydium-clmm/programs/amm/src/util/token.rs:280, dipanggil dari CreatePool.
LaunchLab: initialize_with_token_2022 di raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (sumber tidak tersedia untuk umum).

Tidak ada pengecekan mint pada waktu swap di CPMM atau CLMM — gate hanya berfungsi saat pembuatan pool. Setelah pool ada, swap hanya mempercayai bahwa mint tidak berubah, yang benar untuk bagian-bagian yang tidak dapat diubah dari status mint Token-2022.

Daftar izin ekstensi CPMM dan CLMM

Setelah shortcut daftar whitelist statis (dijelaskan di bawah), program mengulangi ekstensi mint dan menolak mint jika membawa ekstensi apa pun selain lima ini:

Ekstensi	Alasan diizinkan
`TransferFeeConfig`	Matematika pool mengurangkan 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; pengali UI hanya dekorator dan saldo yang mendasar dipertahankan.
`ScaledUiAmount`	Bentuk sama dengan interest-bearing — faktor skala hanya berlaku pada tampilan UI.

Apa pun yang tidak ada di daftar ini — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable, dll. — menyebabkan is_supported_mint mengembalikan false dan pembuatan pool kembali. Baris-baris 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:190–200

Jalur bypass

Mint Token-2022 yang tidak sesuai daftar izin masih dapat diterima melalui salah satu dari tiga bypass eksplisit. Mereka dicoba secara berurutan, sebelum iterasi ekstensi berjalan.

1. Daftar whitelist mint statis

Array konstanta MINT_WHITELIST dari string base58 dikode keras di setiap program. Jika alamat mint cocok, fungsi mengembalikan true segera dan tidak ada pengecekan ekstensi yang dilakukan.

Program	Mint yang di-whitelist
CPMM	`HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM`, `Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g`, `FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4`, `2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo`
CLMM	Empat yang sama, ditambah `DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg`, `AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9`

Alamat-alamat ini ditanamkan dalam program; memperbarui daftar memerlukan upgrade program melalui multisig upgrade 3/4.

2. Registri per-mint — CLMM saja

CLMM juga berkonsultasi dengan PDA SupportMintAssociated pada seed [b"support_mint", mint]. Jika PDA itu ada untuk mint, itu diterima terlepas dari set ekstensinya. PDA dibuat oleh CreateSupportMintAssociated (admin/create_support_mint_associated.rs). Instruksi gated ke dua penanda:

crate::admin::ID — otoritas admin Raydium standar.
crate::create_support_mint_associated_owner::ID — otoritas khusus untuk tujuan ini: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

Efek: tim CLMM dapat mengaktifkan mint Token-2022 tertentu untuk pembuatan pool tanpa upgrade program. CPMM tidak memiliki padanannya — daftar izinnya benar-benar dikode sumber.

3. Deteksi Superstate — CLMM saja

CLMM memiliki jalur ketiga khusus untuk aset yang ditokenkan Superstate, yang menggunakan ekstensi ScaledUiConfig yang versi spl-token-2022 yang ditautkan ke dalam program CLMM tidak dapat unpacked. Daripada upgrade dependency, CLMM mendeteksi token Superstate berdasarkan bentuk otoritasnya:

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 Mint lulus cabang ini jika keempat kondisi terpenuhi:

Program pemiliknya adalah program Token-2022.
Otoritas pembekuannya sama dengan superstate_allowlist::ID. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
Ekstensi DefaultAccountState diatur ke Frozen.
Delegate permanen juga superstate_allowlist::ID.

Ini adalah heuristik, bukan registri — mint apa pun di masa depan yang dikeluarkan Superstate dengan bentuk otoritas yang sama akan diterima secara otomatis.

Apa yang bypass tidak mengesampingkan

Bypass melewati daftar izin ekstensi, tetapi program masih menerapkan:

Mint dimiliki oleh Token atau Token-2022. Program token khusus ditolak hulu.
Vault pool dibuat dengan ekstensi ATA yang tepat untuk pool Token-2022 (ImmutableOwner, dll.).
Semua transfer melalui transfer_checked — mint pemegang biaya mendarat jumlah yang tepat di vault.

Mint yang di-whitelist atau terdaftar PDA yang, misalnya, kemudian menambahkan TransferHook tidak mendapatkan pengecekan waktu swap; hook hanya akan berjalan pada setiap transfer dan bisa batu swap. Whitelisting karenanya adalah tindakan 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 ada tidak bisa secara retroaktif gagal pengecekan ini — gate hanya berjalan saat pembuatan. Ekstensi mint tidak dapat diubah untuk kategori yang Raydium tolak (transfer hook, non-transferable, confidential transfer tidak dapat ditambahkan pasca-pembuatan), jadi pengecekan statis sudah cukup.

Mengapa setiap ekstensi yang dikecualikan dikecualikan

TransferHook — menjalankan program khusus pada setiap transfer, dengan konsumsi CU sembarang, kondisi kegagalan sembarang, dan kemampuan untuk masuk kembali ke program pemanggil. Tidak ada sandbox aman. Beberapa DEX mempertahankan daftar izin hook; Raydium tidak.
NonTransferable — Transfer selalu gagal. Pool tidak dapat mengambil alih.
ConfidentialTransfer — jumlah transfer dienkripsi; kurva tidak dapat harga swap.
PermanentDelegate — pemegangnya dapat menyapu akun token apa pun, termasuk vault pool. Hanya diizinkan melalui daftar whitelist statis untuk penerbit tepercaya (misalnya, stablecoin yang diatur).
MintCloseAuthority — mint dapat ditutup; pool yang ada menjadi tidak dapat digunakan. Dilarang secara default.
DefaultAccountState (Frozen) — ATA pool akan mendarat di status Frozen dan memerlukan thawing per akun. Hanya diizinkan melalui deteksi Superstate, yang mengasumsikan penerbit thaws akun institusional saat enrollment.
Group/Member pointers — tidak secara aktif berbahaya, tetapi tidak ditinjau. Dilarang secara default untuk menjaga permukaan tetap sempit.

Akuntansi transfer-fee

Untuk mint membawa TransferFeeConfig, setiap swap, deposit, dan withdraw memindahkan lebih sedikit dari jumlah nominal. SDK melayani kedua belahan kalkulasi:

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

UI yang benar menunjukkan:

amountIn + token2022FeeIn sebagai “Anda mengirim”
amountOut - token2022FeeOut sebagai “Anda menerima”
feeAmount sebagai pool fee (LP + protokol), yang terpisah dari biaya transfer Token-2022

UI naif yang hanya menunjukkan amountIn → amountOut meremehkan biaya.

Cap `maximumFee`

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

Transisi epoch

Otoritas mint dapat menjadwalkan perubahan tingkat biaya yang diaktifkan di epoch berikutnya. Selama jendela transisi, dua config (older, newer) hidup di mint sekaligus dan TransferChecked memilih berdasarkan epoch saat ini. CPMM SwapV2 dan CLMM SwapV2 keduanya melewatkan akun mint penuh 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 memegang jumlah pokok; “jumlah UI” adalah pokok dikalikan dengan faktor skala yang bergantung waktu atau yang ditetapkan admin. Matematika swap beroperasi pada pokok:

principal_in = ui_amount_in / ui_multiplier(now)

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

Definisi “pool Token-2022”

Pool adalah pool Token-2022 jika salah satu mint memiliki programId == TokenzQdB.... API melayani 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.

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

Kesalahan integrasi umum

Pre-flighting hanya ID program. Mint dapat berupa Token-2022 dan tidak didukung. Berjalan di daftar ekstensi terhadap daftar izin (dan daftar whitelist statis) sebelum mengizinkan pembuatan pool.
Mempercayai kutipan SDK ketika mint tidak diterima sama sekali. API kutipan 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 rambut transfer-fee. Mint transfer-fee 1% di kedua sisi pool CPMM 0,25% memiliki biaya efektif sekitar 2,25%, bukan 0,25%. Gunakan kutipan SDK atau kutipan Trade API — jangan pernah hitung biaya secara manual dari tingkat 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 melayani mint kepada pengguna; keduanya bermusuhan dengan Raydium.

Pekerjaan masa depan

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

Program transfer-hook yang di-whitelist pada tingkat Solana (konvensi ekosistem berkembang).
AMM yang kompatibel confidential-transfer (tahap penelitian).
Registri per-mint CPMM yang lebih luas (paritas dengan CLMM).
Upgrade dependency sehingga dekoding ScaledUiConfig CLMM berfungsi tanpa heuristik Superstate.

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 — 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 — instruksi registri per-mint.
raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — pembuatan mint base Token-2022 LaunchLab.

Reference

Resources

Matriks dukungan Token-2022

Dukungan tingkat program

Daftar izin ekstensi CPMM dan CLMM

Jalur bypass

1. Daftar whitelist mint statis

2. Registri per-mint — CLMM saja

3. Deteksi Superstate — CLMM saja

Apa yang bypass tidak mengesampingkan

Semantik “Blocked”

Mengapa setiap ekstensi yang dikecualikan dikecualikan

Akuntansi transfer-fee

Cap `maximumFee`

Transisi epoch

Interest-bearing dan ScaledUiAmount

Definisi “pool Token-2022”

Helper SDK

Kesalahan integrasi umum

Pekerjaan masa depan

Pointer

Reference

Resources

Documentation Index

​Dukungan tingkat program

​Daftar izin ekstensi CPMM dan CLMM

​Jalur bypass

​1. Daftar whitelist mint statis

​2. Registri per-mint — CLMM saja

​3. Deteksi Superstate — CLMM saja

​Apa yang bypass tidak mengesampingkan

​Semantik “Blocked”

​Mengapa setiap ekstensi yang dikecualikan dikecualikan

​Akuntansi transfer-fee

​Cap maximumFee

​Transisi epoch

​Interest-bearing dan ScaledUiAmount

​Definisi “pool Token-2022”

​Helper SDK

​Kesalahan integrasi umum

​Pekerjaan masa depan

​Pointer

Dukungan tingkat program

Daftar izin ekstensi CPMM dan CLMM

Jalur bypass

1. Daftar whitelist mint statis

2. Registri per-mint — CLMM saja

3. Deteksi Superstate — CLMM saja

Apa yang bypass tidak mengesampingkan

Semantik “Blocked”

Mengapa setiap ekstensi yang dikecualikan dikecualikan

Akuntansi transfer-fee

Cap `maximumFee`

Transisi epoch

Interest-bearing dan ScaledUiAmount

Definisi “pool Token-2022”

Helper SDK

Kesalahan integrasi umum

Pekerjaan masa depan

Pointer