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

​

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

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

​

CLMM ポジション NFT 制限発行者向けフリーズ

• プールは既に存在でき、スワップ可能なままです。
• ポジション NFT ミントは CLMM プール PDA をそれ自体のフリーズ権限として使用します。基礎となる発行者はポジション NFT を制御しません。
• OpenPositionV2 は Token-2022 プール資産上の従来の SPL ポジション NFT をカバーします。OpenPositionWithToken22Nft は Token-2022 ポジション NFT をカバーします。
• OpenPosition V1 はボルトミントを検査せず、出荷されたリストが対象とする Token-2022 制限資産に対応できません。
• 既存のポジションは変更されません。

​

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 と等しい。メインネット-ベータとデブネット値については reference/program-addresses を参照してください。
• その 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 ベースミント作成。