Token-2022 支援矩陣

​

程式級支援

• 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（原始碼不公開）。

​

CLMM 位置 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（從鑄幣建立開始）——launchpad 程式本身沒有提取預留指令。見products/launchlab/platform-config。
• 報價鑄幣 — LaunchLab 不建立它也不篩選它。CreateConfig 接受給定的鑄幣帳戶，所以報價端沒有 is_supported_mint 等效項。唯一的限制是管理員選擇綁定到 GlobalConfig 的鑄幣。

• 報價金庫、兩個費用金庫和分享費用接收者的代幣帳戶都在報價鑄幣自己的程式上建立。
• 報價端的 TransferFeeConfig 被計入所有四個交易指令中，滑點界限針對支付者的淨額而不是金庫的總移動進行檢查。見products/launchlab/instructions。
• PoolState.token_program_flag 記錄兩個鑄幣的程式——bit0 用於基礎鑄幣，bit1 用於報價鑄幣。按位解碼；位元組不是布林值。見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)

​

繞過路徑

​

唯一的繞過：按鑄幣登錄

​

移除的繞過

​

靜態 MINT_WHITELIST — 已移除

​

Superstate 權限形狀檢測 — 已移除

​

繞過不豁免的內容

• 鑄幣由 Token 或 Token-2022 擁有。自訂代幣程式在上游被拒絕。
• 流動性池金庫使用 Token-2022 流動性池的正確 ATA 擴充功能建立（ImmutableOwner 等）。
• 所有轉移都透過 transfer_checked 進行——費用軸承鑄幣在金庫中登陸正確的金額。

​

“被阻止”語義

​

為什麼每個被排除的擴充功能被排除

• TransferHook — 在每次轉移時調用自訂程式，具有任意 CU 消耗、任意失敗條件以及重新進入呼叫程式的能力。不存在安全沙箱。一些 DEX 維護鉤子允許清單；Raydium 不維護。
• NonTransferable — Transfer 始終失敗。流動性池無法取得保管。
• ConfidentialTransfer — 轉移金額被加密；曲線無法為交換定價。
• PermanentDelegate — 委託人的持有者可以掃過任何代幣帳戶，包括流動性池金庫。只能透過登錄鑄幣允許，這是受信任發行人（例如受監管的穩定幣）逐案登錄的方式。
• MintCloseAuthority — 鑄幣可以關閉；現有流動性池變得不可用。預設不允許。
• DefaultAccountState (Frozen) — 流動性池 ATA 會登陸 Frozen 狀態並需要按帳戶解凍。只能透過登錄鑄幣允許，這假設發行人在登錄時解凍機構帳戶。
• Group/Member 指標 — 不是主動有害的，但未審查。預設不允許以保持表面狹窄。

​

轉移費用會計

• 流動性池費用（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 時未定義
  expirationTime: number | undefined;  // 在計劃的費用變更待決時設定
}

• 輸入金額加上其轉移 fee 作為「你發送」
• 輸出金額減去其轉移 fee 作為「你接收」
• 流動性池 fee 作為單獨的行——它不是 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 } 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);
  }
}

​

常見整合錯誤

• 僅預檢程式 ID。 鑄幣可以是 Token-2022 且不受支援。在允許流動性池建立之前，針對允許清單檢查擴充功能清單，並檢查鑄幣的登錄 PDA。
• 當鑄幣根本不被接受時信任 SDK 的報價。 報價 API 不拒絕報價——流動性池建立是還原的內容。在在 UI 中公開流動性池建立之前，確認 is_supported_mint 語義離線。
• 引用時不考慮轉移費用。 具有 0.25% CPMM 流動性池兩側的 1% 轉移費用鑄幣的有效費用約為 2.25%，而不是 0.25%。使用 SDK 報價或交易 API 報價——永遠不要僅從流動性池的費用層級手動計算費用。
• 在 Token-2022 流動性池上呼叫舊版 Swap 指令。 Swap 早於 Token-2022。每當任一鑄幣是 Token-2022 時使用 SwapV2。
• 自動列出新的 Token-2022 鑄幣。 錢包和聚合器應在向使用者表面鑄幣之前檢查 TransferHook 和 NonTransferable；兩者都對 Raydium 不利。

​

未來工作

• 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 報價鑄幣綁定（無擴充功能檢查）。