Token-2022 destek matrisi

​

Program düzeyinde destek

• CPMM: is_supported_mint in raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, Initialize’dan çağrılır.
• CLMM: is_supported_mint in raydium-clmm/programs/amm/src/util/token.rs:280, CreatePool’dan ç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ğildir).

​

CLMM pozisyon NFT’si kısıtlı yayıncılar için dondurma

• Havuz zaten var olabilir ve değiştirilebilir kalabilir.
• Pozisyon NFT mint’i CLMM havuz PDA’sını kendi freeze authority’si olarak kullanır; temel yayıncı pozisyon NFT’yi kontrol etmez.
• OpenPositionV2 klasik SPL pozisyon NFT’lerini Token-2022 havuz varlıkları üzerinde kapsar. OpenPositionWithToken22Nft Token-2022 pozisyon NFT’lerini kapsar.
• OpenPosition V1 vault mint’lerini incelemez ve gönderilen liste tarafından hedeflenen Token-2022 kısıtlı varlıklarına hizmet edemez.
• Mevcut pozisyonlar değişmez.

​

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

​

2. Mint başına kayıt defteri — yalnızca CLMM

• crate::admin::ID — standart Raydium yönetici authority’si.
• crate::create_support_mint_associated_owner::ID — bu amaç için adanmış authority: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Superstate tespiti — yalnızca 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 authority’si superstate_allowlist::ID’ye eşittir. Mainnet-beta ve devnet değerleri için reference/program-addresses bölümüne bakın.
• 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 sahiplenilir. Özel bir token programı upstream’de reddedilir.
• Havuz vault’ları Token-2022 havuzları için doğru ATA uzantılarıyla oluşturulur (ImmutableOwner, vb.).
• Tüm transferler transfer_checked aracılığıyla gerçekleşir — ücret taşıyan mint’ler vault’a doğru miktarı indirir.

​

”Engellendi” semantiği

​

Her hariç tutulan uzantının neden hariç tutulduğu

• 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 girmek yeteneği. Güvenli sandbox yoktur. Bazı DEX’ler hook izin listelerini korur; Raydium yapmaz.
• NonTransferable — Transfer her zaman başarısız olur. Havuz saklama alamaz.
• ConfidentialTransfer — transfer miktarları şifrelenmiştir; eğri swap’ı fiyatlandıramaz.
• PermanentDelegate — delegenin sahibi, havuz vault’u da dahil olmak üzere herhangi bir token hesabını temizleyebilir. Yalnızca güvenilir yayıncılar (örn. düzenlenmiş stablecoin’ler) için statik whitelist aracılığıyla izin verilir.
• MintCloseAuthority — mint kapatılabilir; mevcut havuzlar kullanılamaz hale gelir. Varsayılan olarak disallowed.
• DefaultAccountState (Frozen) — havuz ATA’ları Frozen durumunda iniş yapacak ve hesap başına çözmesi gerekecektir. Yalnızca Superstate tespiti aracılığıyla izin verilir; bu, yayıncının kayıt sırasında kurumsal hesapları çözeceğini varsayar.
• Group/Member pointers — aktif olarak zararlı değildir, ancak gözden geçirilmemiştir. Yüzeyi dar tutmak için varsayılan olarak disallowed.

​

Transfer ücreti muhasebesi

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

• amountIn + token2022FeeIn olarak “gönderdiğiniz”
• amountOut - token2022FeeOut olarak “aldığınız”
• feeAmount havuz ücreti (LP + protokol) olarak; Token-2022 transfer ücretinden ayrıdır

​

maximumFee sınırı

​

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

​

Yaygın entegrasyon hataları

• Yalnızca program ID’sini ön kontrol etmek. Bir mint Token-2022 ve desteklenmeyen olabilir. Havuz oluşturmaya izin vermeden önce uzantı listesini izin listesine (ve statik whitelist’e) karşı yürütün.
• Mint hiç kabul edilmediğinde SDK’nın alıntısına güvenmek. Alıntı API’si alıntı yapmayı reddetmez — havuz oluşturma geri alınır. UI’nızda havuz oluşturmayı ortaya çıkarmadan önce is_supported_mint semantiğini çevrimdışı olarak doğrulayın.
• Transfer ücreti kesintisi olmadan alıntı yapmak. Her iki tarafta %1 transfer ücreti mint’i olan %0,25 CPMM havuzunun etkili ücreti %0,25 değil, yaklaşık %2,25’tir. SDK alıntısını veya Trade API alıntısını kullanın — asla ücret’i yalnızca havuzun ücret katmanından manuel olarak hesaplamayın.
• Token-2022 havuzunda eski Swap talimatını çağırmak. Swap Token-2022’den önce geliştirilmiştir. Herhangi bir mint Token-2022 olduğunda SwapV2 kullanın.
• Yeni Token-2022 mint’lerini otomatik olarak listelemek. Cüzdanlar ve toplayıcılar, bir mint’i kullanıcılara sunmadan önce TransferHook ve NonTransferable kontrol etmelidir; her ikisi de Raydium’a düşmandır.

​

Gelecek çalışma

• Solana düzeyinde izin listeli transfer-hook programları (ekosistem sözleşmesi gelişiyor).
• Gizli transfer uyumlu AMM’ler (araştırma aşaması).
• Daha geniş CPMM mint başına kayıt defteri (CLMM ile eşlik).
• CLMM’nin ScaledUiConfig kodlamasının Superstate buluşsal yöntemi olmadan çalışması için bağımlılık yükseltmesi.

​

İşaretçiler

• algorithms/token-2022-transfer-fees — swap’larda ü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 defteri talimatı.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — LaunchLab Token-2022 base-mint oluşturma.