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

​

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

• CPMM: is_supported_mint в raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, вызывается из Initialize.
• CLMM: is_supported_mint в raydium-clmm/programs/amm/src/util/token.rs:280, вызывается из 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 authority запуска до выпуска, а withdraw_withheld_authority — это настроенный платформой transfer_fee_extension_auth с момента создания монеты — сама программа launchpad не имеет инструкции для вывода удержанных средств. См. products/launchlab/platform-config.
• Монета quote — LaunchLab её не создаёт и не проверяет. CreateConfig принимает счёт монеты как есть, поэтому нет эквивалента is_supported_mint на стороне quote. Единственное ограничение — какие монеты администратор выбирает привязать к GlobalConfig.

• Хранилище quote, оба хранилища комиссий и счёт получателя комиссии за акции создаются в собственной программе монеты quote.
• TransferFeeConfig на стороне quote учитывается во всех четырёх инструкциях торговли, и граница slippage проверяется против чистой суммы плательщика, а не против валового движения хранилища. См. products/launchlab/instructions.
• PoolState.token_program_flag записывает программы обеих монет — бит0 для монеты base, бит1 для монеты quote. Декодируйте по битам; байт не является логическим значением. См. products/launchlab/accounts.

​

Allow-list расширений 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. Статический whitelist монет

​

2. Реестр для каждой монеты — только CLMM

• crate::admin::ID — стандартный authority администратора Raydium.
• crate::create_support_mint_associated_owner::ID — выделенный authority для этой цели: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

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.
• Её freeze authority равна superstate_allowlist::ID. См. reference/program-addresses для значений mainnet-beta и devnet.
• Её расширение DefaultAccountState установлено на Frozen.
• Её permanent delegate также равен superstate_allowlist::ID.

​

Что пути обхода не отменяют

• Монета принадлежит либо Token, либо Token-2022. Пользовательская программа токена отклоняется выше по потоку.
• Хранилища пула создаются с правильными расширениями ATA для пулов Token-2022 (ImmutableOwner и т. д.).
• Все передачи проходят через transfer_checked — монеты с комиссией попадают в хранилище в правильном количестве.

​

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

​

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

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

​

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

const { amountIn, amountOut, feeAmount, token2022FeeIn, token2022FeeOut } =
  await raydium.cpmm.computeSwapAmount({ ... });

• amountIn + token2022FeeIn как “вы отправляете”
• amountOut - token2022FeeOut как “вы получаете”
• feeAmount как комиссию пула (LP + протокол), которая отделена от комиссии за передачу 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, 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 и неподдерживаемой. Пройдитесь по списку расширений против allow-list (и статического whitelist) перед разрешением создания пула.
• Доверие к котировке SDK, когда монета вообще не принята. API котировки не отказывает в котировке — создание пула — это то, что откатывается. Подтвердите семантику is_supported_mint off-chain перед тем, как выставить создание пула в вашем 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.

​

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

• Allow-listed программы transfer-hook на уровне Solana (соглашение экосистемы развивается).
• AMM, совместимые с confidential-transfer (стадия исследования).
• Более широкий реестр per-mint для CPMM (паритет с CLMM).
• Обновление зависимости, чтобы декодирование ScaledUiConfig в CLMM работало без эвристики Superstate.

​

Указатели

• 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 — 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 — инструкция реестра per-mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — создание base-mint Token-2022 в LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — привязка quote-mint в LaunchLab (без проверки расширений).