Token-2022 destek matrisi

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

Program düzeyinde destek

• CPMM: is_supported_mint in raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, Initialize yapısından çağrılır.
• CLMM: is_supported_mint in raydium-clmm/programs/amm/src/util/token.rs:280, CreatePool yapısından çağrılır.
• LaunchLab: initialize_with_token_2022 in raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (kaynak herkese açık değil).

​

CPMM ve CLMM uzantı izin listesi

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 yolları

​

1. Statik mint whitelist’i

​

2. Mint başına kayıt — sadece CLMM

• crate::admin::ID — standart Raydium yönetim otoritesi.
• crate::create_support_mint_associated_owner::ID — bu amaç için ayrılmış otorite: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Superstate tespiti — sadece CLMM

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

• Sahibi olan programı Token-2022 programıdır.
• Freeze otoritesi superstate_allowlist::ID eşittir. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• DefaultAccountState uzantısı Frozen olarak ayarlanmıştır.
• Kalıcı delegesi de superstate_allowlist::ID dir.

​

Bypass’ların feragat etmediği şeyler

• Mint Token veya Token-2022 tarafından sahip olunur. Özel bir token programı yukarıda reddedilir.
• Havuz kasaları Token-2022 havuzları (ImmutableOwner, vb.) için doğru ATA uzantıları ile oluşturulur.
• Tüm transferler transfer_checked aracılığıyla yapılır — ücreti taşıyan mint’ler kasa içinde doğru tutarı belirler.

​

”Engellendi” anlamı

​

Her dışarıda bırakılan uzantının neden dışarıda bırakıldığı

• TransferHook — her transferde özel bir programı çağırır, keyfi CU tüketimi, keyfi başarısızlık koşulları ve çağıran programı yeniden giriş yapabilme yeteneği. Güvenli bir sandbox yoktur. Bazı DEX’ler hook izin listeleri tutar; Raydium tutmaz.
• NonTransferable — Transfer her zaman başarısız olur. Havuz intiyat sağlayamaz.
• ConfidentialTransfer — transfer tutarları şifrelenir; eğri swap’ı fiyatlandıramaz.
• PermanentDelegate — temsilcinin sahibi, havuz kasası da dahil olmak üzere herhangi bir token hesabını temizleyebilir. Güvenilen ihraççılar (örneğin düzenlü stablecoin’ler) için statik whitelist aracılığıyla izinlidir.
• MintCloseAuthority — mint kapatılabilir; mevcut havuzlar kullanılamaz hale gelir. Varsayılan olarak yasaklanmıştır.
• DefaultAccountState (Frozen) — havuz ATA’ları Frozen durumda ve her hesap başına çözülmesi gerekir. Sadece Superstate tespiti aracılığıyla izinlidir, ihraççı kaydolmada kurumsal hesapları çözer.
• Group/Member pointer’lar — aktif olarak zararlı değildir, ancak gözden geçirilmemiştir. Yüzeyi dar tutmak için varsayılan olarak yasaklanmıştır.

​

Transfer ücreti muhasebesı

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

• amountIn + token2022FeeIn as “gönderdikleriniz”
• amountOut - token2022FeeOut as “aldıklarınız”
• feeAmount havuz ücreti olarak (LP + protokol), Token-2022 transfer ücretinden ayrı

​

maximumFee sınırı

​

Epok geçişi

​

Faiz taşıyan ve ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

”Token-2022 havuzu” tanımı

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

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

​

SDK yardımcıları

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

​

Ortak entegrasyon hataları

• Sadece program kimliğini ön kontrol etme. Bir mint Token-2022 ve desteklenmeyen olabilir. Havuz oluşturmaya izin vermeden önce uzantı listesini izin listesine (ve statik whitelist’e) göre yürütün.
• Mint hiç kabul edilmediğinde SDK’nın alıntısına güvenme. Alıntı API’sı alıntı yapmayı reddetmez — havuz oluşturma geri alınır. Havuz oluşturmayı UI’ınızda ortaya çıkarmadan önce is_supported_mint anlamını çevrimdışı olarak onaylayın.
• Transfer ücreti kesintisi olmadan alıntı yapma. Her iki tarafında %1 transfer ücreti mint’i 0,25% CPMM havuzun efektif ücret sınırı %0,25 değil, yaklaşık %2,25. SDK alıntısı veya Trade API alıntısı kullanın — asla havuzun ücret katmanından manuel olarak ücret hesaplamayın.
• Token-2022 havuzunda eski Swap talimatını çağırma. Swap Token-2022’yi önceden oluşturdu. Ya mint Token-2022 olduğunda her zaman SwapV2 kullanın.
• Otomatik olarak yeni Token-2022 mint’lerini listeleme. Cüzdanlar ve toplayıcılar, bir mint’i kullanıcılara ortaya koymadan önce TransferHook ve NonTransferable’ı kontrol etmelidir; her ikisi de Raydium düşmanıdır.

​

Gelecek çalışma

• Solana düzeyinde izin listesi transfer-hook programları (ekosistem sözleşmesi gelişmekte).
• Gizli transfere uyumlu AMM’ler (araştırma aşaması).
• Daha geniş CPMM mint başına kayıt (CLMM ile eşlik).
• Bağımlılık yükseltmesi böylece CLMM’nin ScaledUiConfig dekodu Superstate sezgisel olmadan çalışır.

​

İşaretçiler

• algorithms/token-2022-transfer-fees — swap’lardaki ücret matematiği.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — program başına NotSupportMint sayısal kodları.

• 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 — mint başına kayıt talimatı.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — LaunchLab Token-2022 base-mint oluşturma.