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

Raydium プログラムが Token-2022 をサポートしているか、プール作成時に各プログラムが実施する明示的な拡張機能許可リスト、および許可されていないミントを認める唯一の回避メカニズム（管理者が管理するミント単位のレジストリ PDA）について説明します。

このページは AI による自動翻訳です。すべての内容は英語版を正とします。

英語版を表示 →

Raydium は任意の Token-2022 ミントを受け入れません。CPMM と CLMM の両方は厳密な許可リストモードで動作します。デフォルトでは限定的な拡張機能セットのみが許可され、その他はすべてプール作成時に拒否されます。各プログラムは 1 つのメカニズム（管理者が管理するミント単位のレジストリ PDA）を通じて個別のミントを認めます。両プログラムは過去にさまざまなポイントでハードコードされた回避メカニズムを持っていましたが、すべて削除されました。このページは、何が実施されているか、どこで実施されているかについての単一ページのリファレンスで、プログラムソースへの引用が含まれています。

​

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

プログラム	Token-2022 ベース/クォート ミント?	モード
CPMM	はい — ゲート付き	厳密な拡張機能許可リスト + 管理者ミント単位レジストリ。4 ミント静的ホワイトリストは 2026-09 アップグレードで削除されました。
CLMM	はい — ゲート付き	厳密な拡張機能許可リスト + 管理者ミント単位レジストリ。6 ミント静的ホワイトリストと Superstate 検出は 2026 年 7 月に削除されました。
AMM v4	いいえ	プログラムは Token-2022 より前のもの。両方のミントは従来の SPL Token である必要があります。
Stable AMM	いいえ	AMM v4 と同じ制約。
Farm v6	はい、部分的	リワード ミントは Token-2022 にできます（ファームが CPMM/CLMM LP をラップする場合、同じ許可リストの対象）。ユーザーステーク LP ミントはラップされたプールから継承されます。
LaunchLab	はい — ベースはプログラム管理、クォートはゲートなし	ベース ミントは Token-2022 にできますが、専用の initialize_with_token_2022 命令を通じてのみ。プログラムは MetadataPointer（常に）と TransferFeeConfig（レート ≤ 5%）をオプションで作成します。任意の拡張機能を持つ既存の Token-2022 ミントはベースとして使用できません。クォート ミントは、管理者が GlobalConfig にバインドする任意の Token-2022 ミントにできます。拡張機能チェックはありません — 下記を参照してください。
Burn & Earn	プール プログラムをミラー	CPMM / CLMM ゲートを継承します。

許可リスト チェックは以下の場所にあります：

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

CPMM または CLMM にはスワップ時のミント チェックはありません — ゲートはプール作成時にのみ発火します。プールが存在すると、スワップはミントが変更されなかったことを信頼します。これは Token-2022 ミント状態の不変部分に対して正しいです。

​

CLMM ポジション NFT 制限付き発行者のフリーズ

ポジション NFT アカウントはデフォルトではフリーズされません。CLMM は、ポジションが V2 オープン パスを使用し、かつ少なくとも 1 つのボールト ミントの現在の freeze_authority がハードコードされた frozen_position_nft_authorities::IDS リストに表示される場合にのみ、1 つをフリーズします。このリストは CLMM の以前の Superstate トークン検出に置き換わったもので、古いヒューリスティックが一致した発行者権限と同じものを持ちます。プール PDA をポジション NFT ミントのフリーズ権限として設定することは、それ自体はフリーズではありません。これはプール作成許可リストではなく、ポジション カストディ ルールです：

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

フリーズされたポジションは所有者によって管理可能なままですが、転送できません。ClosePosition はクライアントがプールを最初の残りアカウントとして渡すときに、アトミックにフリーズ解除して焼却します。products/clmm/ticks-and-positions を参照してください。

​

LaunchLab クォート ミント

LaunchLab の 2 つのミントは非常に異なる方法でゲートされており、非対称性は見落としやすいです。

• ベース ミント — 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 にバインドすることを選択するミントです。

これにより、Token-2022 クォート ミントをバインドすることは高信頼アクションになります。理由は以下のミント登録と同じです：TransferHook クォート ミントはそれで引用されるすべてのプールのすべての買い、売り、手数料請求でそのフックを実行し、PermanentDelegate クォート ミントはデリゲートがそれらのプールのクォート ボールトをスイープできるようにします。どちらもプログラムによってブロックされません。

LaunchLab がクォート ミントがバインドされると正しく処理するもの：

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

非推奨の Initialize 命令は依然としてレガシーのみのクォート プログラムを受け取るため、Token-2022 クォート ミントを持つ設定は InitializeV2 と InitializeWithToken2022 を通じてのみ到達可能です。

​

CPMM と CLMM 拡張機能許可リスト

下記でカバーされた 2 つのショートサーキットの後、プログラムはミントの拡張機能を反復処理し、これら 5 つ以外の拡張機能を持つミントを拒否します：

拡張機能	許可される理由
TransferFeeConfig	プール数学は受信手数料を差し引きます。Token-2022 プログラムは送信手数料を処理します。algorithms/token-2022-transfer-fees を参照してください。
MetadataPointer	装飾的 — オンチェーン メタデータを指します。
TokenMetadata	装飾的 — インライン メタデータ。
InterestBearingConfig	プールは元本を見ます。UI 乗数は装飾のみで、基礎となる残高は保持されます。
ScaledUiAmount	利息ベアリングと同じ形状 — スケール係数は UI 表示にのみ適用されます。

このリストにない何か — TransferHook、NonTransferable、ConfidentialTransferMint、PermanentDelegate、MintCloseAuthority、DefaultAccountState、GroupPointer、GroupMemberPointer、MemberPointer、Pausable など — は is_supported_mint が false を返し、プール作成がリバートされます。

関連する行（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)

— cp-swap/src/utils/token.rs

​

回避メカニズム

許可リストに適合しない Token-2022 ミントは、各プログラムの 1 つのメカニズムを通じて認められる可能性があります。両プログラムは過去にハードコードされた回避メカニズムを持っていました。それらのどれも生き残っていません。

回避メカニズム	CPMM	CLMM
ミント単位レジストリ PDA	はい — 唯一の回避メカニズム	はい — 唯一の回避メカニズム
静的 MINT_WHITELIST	2026-09 で削除（4 アドレス）	2026-07 で削除（6 アドレス）
Superstate 権限形状検出	持っていない	2026-07 で削除

is_supported_mint は現在、両プログラムでバイト単位で同じ関数です：レガシー SPL Token ミントは渡され、ミントにレジストリ PDA がある場合は渡され、その他すべては許可リストされた拡張機能のみを持つ必要があります。

​

唯一の回避メカニズム：ミント単位レジストリ

両プログラムは、シード [b"support_mint", mint] で SupportMintAssociated PDA を参照します。そのミント用の PDA が存在する場合、ミントは拡張機能セットに関係なく認められます。

各プログラムは PDA の独自のコピー（異なるプログラム ID の下で派生）、独自の CreateSupportMintAssociated / CloseSupportMintAssociated ペア、および共有管理者と並んで独自の専用権限を持ちます：

4 つのキー（CPMM と CLMM × メインネットと devnet）は Support-mint レジストリ権限 の下にリストされています。

両プログラムでは、命令は crate::admin::ID またはそのプログラムの専用権限のいずれかを受け入れ、ミントが Token-2022 によって所有されることを要求します。効果：特定の Token-2022 ミントは、プログラム アップグレードなしでプール作成にオプトインできます — これがハードコードされたリストが削除できた理由です。

各プログラムは、それが持つすべてのプール作成パスからレジストリを参照します：CPMM は Initialize と InitializeWithPermission から（後者は LaunchLab 卒業が使用するため、登録されたミントは作成と同様に卒業します）、CLMM は CreatePool、CreateCustomizablePool、CreateCustomizablePoolV2 から。

​

削除されたバイパス

デプロイされたプログラムから両方のハードコード化されたメカニズムは削除されています。ここで文書化されているのは、古い動作に対して書かれた統合が依然としてそれらを想定している可能性があるためです。

​

静的な MINT_WHITELIST — 削除済み

拡張機能の反復処理の前に is_supported_mint をショートサーキットするために使用されていた base58 ミントアドレスの定数配列。CLMM は 6 つのアドレスを保持していて 2026-07-24 に削除されました。CPMM は同じセットの最初の 4 つを保持していて、2026-09-09 アップグレードで削除されました。

以前ホワイトリストに登録されていたプログラム	ミント
CPMM と CLMM	HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM, Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g, FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4, 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
CLMM のみ	DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg, AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9

これらのミントの 1 つに対してすでに存在するプールは取引を続けます — ミントチェックはプール作成時にのみ実行されます。現在、これらのいずれかに対して新しいプールを作成するには、代わりにレジストリ PDA が必要です。

​

Superstate オーソリティ形状検出 — 削除済み

CLMM は、アドレスではなくオーソリティ形状によって Superstate のトークン化資産を識別していました。freeze_authority と permanent delegate の両方が superstate_allowlist::ID に等しく、DefaultAccountState が Frozen に設定されている Token-2022 ミントが許可されていました。これはヒューリスティックだったため、同じ形状を持つ将来のミントは自動的に許可されていたでしょう。

これは 2026-07-31 に superstate_allowlist モジュールとともに削除されました。それを置き換えたのはより狭い範囲のもので、異なる目的を果たします。frozen_position_nft_authorities::IDS は何も許可しません — ポジション NFT が凍結されるかどうかを決定し、上記で説明されています。古いヒューリスティックが一致した 1 つの発行者オーソリティは、そのリストの唯一のエントリです。

​

バイパスが免除しないもの

バイパスは拡張機能のアロー・リストをスキップしますが、プログラムは依然として以下を強制します。

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

ホワイトリストに登録されたまたは PDA に登録されたミントが、例えば後で TransferHook を追加しても、スワップ時チェックを取得しません。フックはすべての転送で実行され、スワップをブロックする可能性があります。ミントを登録することは、したがって高い信頼が必要なアクションです。

​

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

is_supported_mint が false を返すと、プール作成は ErrorCode::NotSupportMint（CPMM）/ ErrorCode::NotSupportMint（CLMM）で戻ります。数値コードについては reference/error-codes を参照してください。

既存のプールはこのチェックに遡及的に失敗することはできません — ゲートは作成時にのみ実行されます。ミント拡張機能は Raydium が拒否するカテゴリでは不変です（転送フック、非転送可能、機密転送は作成後に追加できません）ため、静的チェックで十分です。

​

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

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

​

転送手数料会計

TransferFeeConfig を含むミントの場合、すべてのスワップ、デポジット、および引き出しは名目金額より少ない金額を移動します。 2 つの別々の数字が関係しており、SDK はそれらを分離しています。

• プール手数料（LP + プロトコル + ファンド + クリエイター）は曲線から来ます。raydium.cpmm.computeSwapAmount({ ... }) は fee、amountIn、amountOut、minAmountOut、executionPrice、priceImpact および生の swapResult とともにそれを返します。
• Token-2022 転送手数料はプールではなくミントから来ます。これは @raydium-io/raydium-sdk-v2 の getTransferAmountFee ヘルパーによって計算され、GetTransferAmountFee を返します。

export interface GetTransferAmountFee {
  amount: BN;                  // 実際に移動する金額
  fee: BN | undefined;         // ミントによって保留されます。ミントに TransferFeeConfig がない場合は undefined
  expirationTime: number | undefined;  // スケジュールされた手数料変更が保留中の間に設定されます
}

デポジットと引き出しはそれを直接表示します。computePairAmount は inputAmountFee と anotherAmount を GetTransferAmountFee 値として返します。

正しい UI は以下を表示します。

• 入力金額プラスその転送 fee を「送信」として
• 出力金額マイナスその転送 fee を「受け取り」として
• プール fee を別の行として — これは Token-2022 手数料ではありません

amountIn → amountOut のみを表示する素朴な UI はコストを過小評価します。これらのヘルパーにクラスタから epochInfo を渡してください。キャッシュしないでください。エポックはミントの older と newer 手数料設定の間で選択するものです。

​

maximumFee キャップ

Token-2022 転送手数料は転送ごとにキャップされます。1% ミントで 10,000 トークンのキャップの場合、100,000,000 トークンの転送は手数料で 10,000 のみを支払います。SDK の computeSwapAmount はキャップを適用します。直接プログラム呼び出し元はそれを複製する必要があります。

​

エポック遷移

ミントオーソリティは次のエポックで有効になる手数料レート変更をスケジュールできます。遷移ウィンドウ中、2 つの設定（older、newer）がミント上に同時に存在し、TransferChecked は現在のエポックで選択します。CPMM SwapV2 と CLMM SwapV2 の両方は accounts に完全なミントアカウントを渡すため、プログラムは追加のルックアップなしで正しい設定を読み取ります。

Trade API または SDK を通じて 1 つ以上のエポック先に引用する場合、実行された手数料は引用された手数料と異なる可能性があります — 古い設定の maximum_fee_basis_points によって制限されます。

​

利息付きおよび ScaledUiAmount

プールはプリンシパル金額を保持します。「UI 金額」はプリンシパルに時間依存またはアドミン設定のスケール係数を乗じたものです。スワップ数学はプリンシパルで動作します。

principal_in = ui_amount_in / ui_multiplier(now)

SDK は自動的に変換します。直接 RPC リーダーは pool.token0Vault.amount をプリンシパルとして扱うべきです。

​

「Token-2022 プール」定義

プールは Token-2022 プールです。いずれかのミントが programId == TokenzQdB... を持つ場合。API はこれを表示します。

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

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

ディスパッチするには programId を使用し、UI 警告を表示するには hasTransferFee を使用します。

​

SDK ヘルパー

import { Raydium } from "@raydium-io/raydium-sdk-v2";
// TOKEN_2022_PROGRAM_ID は Raydium SDK によって再エクスポートされません — 
// @solana/spl-token からインポートしてください。SDK 自体がそうしているように。
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);
  }
}

​

一般的な統合の間違い

• プログラム ID のみをプリフライトする。 ミントは Token-2022 かつサポートされていない可能性があります。プール作成を許可する前に、拡張機能リストをアロー・リストに対して確認し、ミントのレジストリ PDA を確認してください。
• ミントがまったくサポートされていない場合、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 エコシステムおよびプロトコルロードマップアイテム。

• Solana レベルでのアロー・リストされた転送フックプログラム（エコシステム規約が進化中）。
• 機密転送互換 AMM（研究段階）。
• より広い CPMM ごとのミントレジストリ（CLMM とのパリティ）。
• レジストリの公開読み取りパス。UI が PDA 自体を導出することなく「サポートされていない」と「サポートされていないが登録済み」を区別できるようにします。

いずれかが実装されたときにこのページは更新されます。

​

ポインタ

• 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 — 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 — ごとのミントレジストリ命令。
• 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 クォートミント バインディング（拡張機能チェックなし）。