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 上限

​

Epoch 转换

​

利息承载和 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 报价或 Trade 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 报价铸币绑定（无扩展检查）。