Token-2022サポートマトリックス

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.

​

プログラムレベルのサポート

• CPMM: is_supported_mint in raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, Initialize から呼び出し。
• CLMM: is_supported_mint in raydium-clmm/programs/amm/src/util/token.rs:280, CreatePool から呼び出し。
• LaunchLab: initialize_with_token_2022 in raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs（ソースは公開されていません）。

​

CPMM および 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)

​

迂回パス

​

1. 静的ミント許可リスト

​

2. ミント単位のレジストリ — CLMM のみ

• crate::admin::ID — 標準 Raydium 管理者権限。
• crate::create_support_mint_associated_owner::ID — この目的専用の権限：RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY（メインネット）、rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5（デブネット）。

​

3. Superstate検出 — CLMM のみ

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

• そのプログラムの所有者は Token-2022 プログラムです。
• その凍結権限は superstate_allowlist::ID と等しい。メインネット：2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x。デブネット：3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu。
• その DefaultAccountState 拡張機能は Frozen に設定されています。
• その永続的な委任者も superstate_allowlist::ID です。

​

迂回路が放棄しないもの

• ミントは Token または Token-2022 によって所有されています。カスタムトークンプログラムはアップストリームで拒否されます。
• プールボールトは Token-2022 プール用の正しい ATA 拡張機能で作成されます（ImmutableOwner など）。
• すべての転送は transfer_checked を通過します — 手数料付きミントはボールトに正しい金額を配置します。

​

「ブロック」セマンティクス

​

除外された各拡張機能が除外される理由

• TransferHook — すべての転送で カスタムプログラムを呼び出します。任意の CU 消費、任意の失敗条件、呼び出し元プログラムの再入能力があります。安全なサンドボックスはありません。一部の DEX はフック許可リストを保持しており、Raydium はそうしません。
• NonTransferable — Transfer は常に失敗します。プールは保管を取ることができません。
• ConfidentialTransfer — 転送金額は暗号化されています。曲線はスワップを価格設定できません。
• PermanentDelegate — 委任者の保有者はプールボールトを含む任意のトークンアカウントをスイープできます。信頼できる発行者（例えば規制されたステーブルコイン）の場合のみ静的許可リストを介して許可されます。
• MintCloseAuthority — ミントは閉じることができます。既存のプールは使用不可になります。デフォルトで禁止されています。
• DefaultAccountState (Frozen) — プール ATA は Frozen 状態で着陸し、アカウントごとにチューニングが必要です。Superstate 検出でのみ許可されます。これは発行者が登録時に機関口座をチューニングすることを前提としています。
• Group/Member ポインター — 積極的に有害ではありませんが、レビューされていません。表面を狭く保つため、デフォルトで禁止されています。

​

転送手数料計算

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

• amountIn + token2022FeeIn を「送信」として
• amountOut - token2022FeeOut を「受け取る」として
• feeAmount をプール手数料（LP + プロトコル）として。これは Token-2022 転送手数料とは別です

​

maximumFee キャップ

​

エポック遷移

​

利息付きおよび ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

「Token-2022 プール」定義

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

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

​

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

​

統合の一般的な誤り

• プログラム ID のみをプリフライトする。 ミントは Token-2022 かつサポートされていない可能性があります。許可リスト（および静的許可リスト）に対して拡張機能リストをウォークしてから、プール作成を許可してください。
• ミントがまったく受け入れられていない場合、SDK のクォートを信頼する。 クォート API は拒否されません — プール作成が戻ります。UI でプール作成を公開する前に、is_supported_mint セマンティクスをオフチェーンで確認してください。
• 転送手数料カットなしでクォートする。 0.25% CPMM プールの両側に 1% 転送手数料ミントがあると、実効手数料は約 2.25% であり、0.25% ではありません。SDK クォートまたは Trade API クォートを使用してください — プールの手数料層だけから手数料を手動計算しないでください。
• Token-2022 プールで従来の Swap 命令を呼び出す。 Swap は Token-2022 以前のものです。いずれかのミントが Token-2022 であるときはいつでも SwapV2 を使用してください。
• 新しい Token-2022 ミントを自動リストする。 ウォレットとアグリゲーターは、ミントをユーザーに表示する前に TransferHook と NonTransferable を確認する必要があります。両方とも Raydium に対して敵対的です。

​

今後の作業

• Solana レベルで許可されている転送フックプログラム（エコシステム慣例進化中）。
• 機密転送互換 AMM（研究段階）。
• より広い CPMM ミント単位レジストリ（CLMM とのパリティ）。
• Superstate ヒューリスティックなしで CLMM の ScaledUiConfig デコーディングが機能するように依存関係をアップグレード。

​

ポインター

• algorithms/token-2022-transfer-fees — スワップの手数料数学。
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — プログラムごとの NotSupportMint 数値コード。

• 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 — ミント単位レジストリ命令。
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — LaunchLab Token-2022 ベースミント作成。