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（ソースは公開されていません）。

​

Token-2022 ポジション NFT 制限発行者のフリーズ

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

​

LaunchLab クォートミント

• ベースミント — LaunchLab が作成します。Token-2022 ベースミントは initialize_with_token_2022 を通じてのみ到達可能で、プログラムは MetadataPointer と（オプションで）TransferFeeConfig のみをアタッチします。その他は NoSupportExtension を返します。既存の Token-2022 ミントはベースとしてまったく供給できません。TransferFeeConfig がアタッチされると、ミントの transfer_fee_config_authority は卒業まで起動権限 PDA であり、その withdraw_withheld_authority はミント作成時からプラットフォームの設定された transfer_fee_extension_auth です — ローンチパッドプログラム自体には引き出し保留命令がありません。products/launchlab/platform-config を参照してください。
• クォートミント — LaunchLab は作成せず、スクリーニングもしません。CreateConfig はミントアカウントをそのまま受け入れるため、クォート側に is_supported_mint 相当はありません。唯一のゲートは、管理者が GlobalConfig にバインドすることを選択するミントです。

• クォートボルト、両方の手数料ボルト、およびシェア手数料受信者のトークンアカウントは、クォートミント自身のプログラムで作成されます。
• クォート側の TransferFeeConfig は 4 つのすべてのトレード命令に価格設定され、スリッページ境界はボルトの総移動ではなく支払者の純額に対してチェックされます。products/launchlab/instructions を参照してください。
• PoolState.token_program_flag は両方のミントのプログラムを記録します — ベースミント用のビット 0、クォートミント用のビット 1。ビットごとにデコードします。バイトはブール値ではありません。products/launchlab/accounts を参照してください。

​

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 検出を通じてのみ許可されます。これは発行者が登録時に機関アカウントをフリーズ解除することを前提としています。
• グループ/メンバーポインター — 積極的に有害ではありませんが、未レビュー。表面を狭く保つためにデフォルトで許可されません。

​

転送手数料会計

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 セマンティクスを確認します。
• 転送手数料ヘアカットなしで引用する。 両側に 1% 転送手数料ミントを持つ 0.25% CPMM プールは、約 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 ベースミント作成。
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — LaunchLab クォートミントバインディング（拡張機能チェックなし）。