Token-2022 destek matrisi

​

Program düzeyinde destek

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

​

LaunchLab quote mint’leri

• Base mint — LaunchLab bunu oluşturur. Token-2022 base mint’i yalnızca initialize_with_token_2022 aracılığıyla ulaşılabilir ve program yalnızca MetadataPointer ve (isteğe bağlı olarak) TransferFeeConfig ekler. Başka bir şey NoSupportExtension döndürür. Önceden var olan bir Token-2022 mint base olarak hiç sağlanamaz. TransferFeeConfig eklendiğinde, mint’in transfer_fee_config_authority’si mezuniyet’e kadar başlatma yetkilisi PDA’sıdır, withdraw_withheld_authority’si ise mint oluşturulmadan itibaren platformun yapılandırılmış transfer_fee_extension_auth’ıdır — launchpad programının kendisinin withdraw-withheld talimatı yoktur. Bkz. products/launchlab/platform-config.
• Quote mint — LaunchLab bunu oluşturmaz ve taramaz. CreateConfig mint hesabını olduğu gibi kabul eder, bu nedenle quote tarafında is_supported_mint eşdeğeri yoktur. Tek kapı, bir yönetici tarafından GlobalConfig’e bağlanmayı seçen mint’lerdir.

• Quote kasası, her iki ücret kasası ve pay-ücret alıcısının token hesabı quote mint’inin kendi programında oluşturulur.
• Quote tarafında TransferFeeConfig dört ticaret talimatının tümüne fiyatlandırılır ve slippage sınırı kasa brüt hareketi yerine ödeyicinin net tutarına karşı kontrol edilir. Bkz. products/launchlab/instructions.
• PoolState.token_program_flag her iki mint’in programlarını kaydeder — base mint için bit0, quote mint için bit1. Bunu bit başına çöz; bayt bir boolean değildir. Bkz. products/launchlab/accounts.

​

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ı

​

Tek bypass: mint başına kayıt

​

Kaldırılan bypass’lar

​

Statik MINT_WHITELIST — kaldırıldı

​

Superstate yetkilisi-şekli algılaması — kaldırıldı

​

Bypass’ların feragat etmediği şey

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

​

”Engellendi” semantiği

​

Her dışlanan uzantı neden dışlanır

• TransferHook — her transferde keyfi CU tüketimi, keyfi başarısızlık koşulları ve çağıran programı yeniden girmek yeteneği ile özel bir programı çağırır. 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 tutarları şifrelenir; eğri swap’ı fiyatlandıramaz.
• PermanentDelegate — temsilcinin sahibi havuz kasası da dahil olmak üzere herhangi bir token hesabını temizleyebilir. Yalnızca mint’i kaydederek kabul edilebilir, bu da güvenilir ihraççı (örn. düzenlenmiş stablecoin) duruma göre nasıl katılır.
• MintCloseAuthority — mint kapatılabilir; mevcut havuzlar kullanılamaz hale gelir. Varsayılan olarak disallowed.
• DefaultAccountState (Frozen) — havuz ATA’ları Frozen durumunda inecek ve hesap başına çözmek gerekir. Yalnızca mint’i kaydederek kabul edilebilir, bu da ihraççının kurumsal hesapları kayıt sırasında çözdüğünü varsayar.
• Group/Member pointers — aktif olarak zararlı değil, ancak gözden geçirilmemiş. Yüzeyi dar tutmak için varsayılan olarak disallowed.

​

Transfer-ücret muhasebesi

• Havuz ücreti (LP + protokol + fon + yaratıcı) eğriden gelir. raydium.cpmm.computeSwapAmount({ ... }) bunu fee olarak döndürür, amountIn, amountOut, minAmountOut, executionPrice, priceImpact ve ham swapResult ile birlikte.
• Token-2022 transfer ücreti havuzdan değil mint’ten gelir. @raydium-io/raydium-sdk-v2’deki getTransferAmountFee yardımcıları tarafından hesaplanır, GetTransferAmountFee döndürür:

export interface GetTransferAmountFee {
  amount: BN;                  // gerçekten hareket eden tutar
  fee: BN | undefined;         // mint tarafından alıkonulan; mint TransferFeeConfig'i olmadığında undefined
  expirationTime: number | undefined;  // zamanlanmış ücret değişikliği beklemede iken ayarlanır
}

• giriş tutarı artı transfer fee’si “gönderdiğiniz”
• çıkış tutarı eksi transfer fee’si “aldığınız”
• havuz fee’si ayrı bir satır — Token-2022 ücreti değildir

​

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

​

Yaygın entegrasyon hataları

• Yalnızca program ID’sini ön kontrol etme. Mint Token-2022 ve desteklenmeyen olabilir. Havuz oluşturmaya izin vermeden önce uzantı listesini izin listesine karşı yürüyün ve mint’in kayıt PDA’sını kontrol edin.
• Mint hiç kabul edilmediğinde SDK’nın alıntısına güvenme. Alıntı API’si alıntı vermeyi 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-ücret kesintisi olmadan alıntı alma. Her iki tarafında %1 transfer-ücret mint’i %0.25 CPMM havuzunun etkin ücreti %0.25 değil, yaklaşık %2.25’tir. SDK alıntısını veya Trade API alıntısını kullanın — hiçbir zaman ücret’i yalnızca havuzun ücret katmanından manuel olarak hesaplamayın.
• Token-2022 havuzunda eski Swap talimatını çağırma. Swap Token-2022’den önce geliştirildi. Herhangi bir mint Token-2022 olduğunda SwapV2 kullanın.
• Yeni Token-2022 mint’lerini otomatik listeleme. Cüzdanlar ve toplayıcılar 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 listesi 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 (CLMM ile eşlik).
• Kayıt defterinin herkese açık okuma yolu, böylece UI “desteklenmeyen”i “desteklenmeyen ancak kayıtlı”dan PDA’yı kendisi türetmeden söyleyebilir.

​

İş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 — 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 — mint başına kayıt talimatı.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — LaunchLab Token-2022 base-mint oluşturma.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — LaunchLab quote-mint bağlama (uzantı kontrolü yok).