Матрица поддержки Token-2022

​

Поддержка на уровне программы

• CPMM: is_supported_mint в raydium-cp-swap/programs/cp-swap/src/utils/token.rs, вызывается из Initialize и InitializeWithPermission.
• CLMM: is_supported_mint в raydium-clmm/programs/amm/src/util/token.rs, вызывается из CreatePool.
• LaunchLab: initialize_with_token_2022 в raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (исходный код не является общедоступным).

​

Замораживание позиционных NFT CLMM для ограниченных эмитентов

• Пул может уже существовать и оставаться пригодным для swap.
• Минт позиционного NFT использует пул PDA CLMM как свой собственный freeze_authority; базовый эмитент не контролирует позиционный NFT.
• OpenPositionV2 охватывает классические позиционные NFT SPL над активами пула Token-2022. OpenPositionWithToken22Nft охватывает позиционные NFT Token-2022.
• OpenPosition V1 не проверяет минты хранилища и не может служить активам Token-2022 с ограничениями, на которые нацелен отправленный список.
• Существующие позиции не изменяются.

​

Минты quote LaunchLab

• Минт base — LaunchLab его создаёт. Минт base Token-2022 доступен только через initialize_with_token_2022, и программа будет прикреплять только MetadataPointer и (опционально) TransferFeeConfig. Всё остальное возвращает NoSupportExtension. Уже существующий минт Token-2022 вообще не может быть предоставлен как base. Когда TransferFeeConfig прикреплён, transfer_fee_config_authority минта является PDA полномочий запуска до выпуска, в то время как его withdraw_withheld_authority является настроенным платформой transfer_fee_extension_auth с момента создания минта — сама программа launchpad не имеет инструкции для вывода удержанного. См. products/launchlab/platform-config.
• Минт quote — LaunchLab его не создаёт и не проверяет. CreateConfig принимает счёт минта как есть, поэтому на стороне quote нет эквивалента is_supported_mint. Единственное ограничение — какие минты администратор выбирает для привязки к GlobalConfig.

• Хранилище quote, оба хранилища комиссий и счёт получателя комиссии за акции создаются в собственной программе минта quote.
• TransferFeeConfig на стороне quote учитывается во всех четырёх инструкциях торговли, и граница проскальзывания проверяется против чистой суммы плательщика, а не против валового движения хранилища. См. products/launchlab/instructions.
• PoolState.token_program_flag записывает программы обоих минтов — бит0 для минта base, бит1 для минта quote. Декодируйте по битам; байт не является логическим значением. См. 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. Пользовательская программа токена отклоняется выше по течению.
• Хранилища пула создаются с правильными расширениями ATA для пулов Token-2022 (ImmutableOwner и т. д.).
• Все передачи проходят через transfer_checked — минты с комиссией приземляют правильную сумму в хранилище.

​

Семантика “заблокировано”

​

Почему каждое исключённое расширение исключено

• TransferHook — вызывает пользовательскую программу при каждой передаче с произвольным потреблением CU, произвольными условиями отказа и способностью повторно входить в вызывающую программу. Безопасной песочницы не существует. Некоторые DEX поддерживают списки разрешений hook; Raydium — нет.
• NonTransferable — Transfer всегда не удаётся. Пул не может взять под опеку.
• ConfidentialTransfer — суммы передачи зашифрованы; кривая не может оценить swap.
• PermanentDelegate — держатель делегата может очистить любой счёт токена, включая хранилище пула. Допустимо только путём регистрации минта, что является тем, как доверенный эмитент (например, регулируемая стабилизированная монета) подключается в каждом случае.
• MintCloseAuthority — минт может быть закрыт; существующие пулы становятся непригодными для использования. Запрещено по умолчанию.
• DefaultAccountState (Frozen) — ATA пула приземлятся в состояние Frozen и потребуют размораживания для каждого счёта. Допустимо только путём регистрации минта, что предполагает, что эмитент размораживает институциональные счета при регистрации.
• Group/Member pointers — не активно вредны, но не проверены. Запрещены по умолчанию, чтобы сохранить поверхность узкой.

​

Учёт комиссии за передачу

• Комиссия пула (LP + протокол + фонд + создатель) поступает из кривой. raydium.cpmm.computeSwapAmount({ ... }) возвращает её как fee, наряду с amountIn, amountOut, minAmountOut, executionPrice, priceImpact и сырым swapResult.
• Комиссия за передачу Token-2022 поступает из минта, а не из пула. Она вычисляется помощниками getTransferAmountFee в @raydium-io/raydium-sdk-v2, которые возвращают GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // сумма, которая фактически перемещается
  fee: BN | undefined;         // удержана минтом; undefined, когда минт не имеет TransferFeeConfig
  expirationTime: number | undefined;  // установлено, пока ожидается запланированное изменение комиссии
}

• входящую сумму плюс её передачу fee как “вы отправляете”
• исходящую сумму минус её передачу fee как “вы получаете”
• комиссию пула fee как отдельную строку — это не комиссия Token-2022

​

Крышка maximumFee

​

Переход эпохи

​

Interest-bearing и 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 котировки не отказывает в котировке — создание пула — это то, что откатывается. Подтвердите семантику is_supported_mint вне цепи перед раскрытием создания пула в вашем UI.
• Котировка без скидки на комиссию за передачу. Минт с комиссией за передачу 1% с обеих сторон пула CPMM 0,25% имеет эффективную комиссию около 2,25%, а не 0,25%. Используйте котировку SDK или котировку Trade API — никогда не вычисляйте комиссию вручную только из уровня комиссии пула.
• Вызов устаревшей инструкции Swap на пуле Token-2022. Swap предшествует Token-2022. Используйте SwapV2 всякий раз, когда любой минт является Token-2022.
• Автоматический список новых минтов Token-2022. Кошельки и агрегаторы должны проверять TransferHook и NonTransferable перед выводом минта пользователям; оба враждебны Raydium.

​

Будущая работа

• Списки разрешений transfer-hook программ на уровне Solana (соглашение экосистемы развивается).
• AMM, совместимые с конфиденциальной передачей (этап исследования).
• Более широкий реестр CPMM для каждого минта (паритет с CLMM).
• Общественный путь чтения для реестра, чтобы UI мог сказать “неподдерживаемый” от “неподдерживаемый, но зарегистрированный” без самостоятельного вывода PDA.

​

Указатели

• algorithms/token-2022-transfer-fees — математика комиссии в swap.
• 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 — создание базового минта Token-2022 LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — привязка минта quote LaunchLab (без проверки расширений).