Матрица поддержки 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 для ограниченных издателей

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

​

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 — монеты с комиссией попадают в хранилище в правильном количестве.

​

Семантика “Blocked”

​

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

• TransferHook — вызывает пользовательскую программу при каждой передаче с произвольным потреблением CU, произвольными условиями отказа и способностью повторно входить в вызывающую программу. Безопасной песочницы не существует. Некоторые DEXes ведут allow-lists для hooks; Raydium — нет.
• NonTransferable — Transfer всегда не удаётся. Пул не может взять на себя ответственность.
• ConfidentialTransfer — суммы передачи зашифрованы; кривая не может оценить своп.
• PermanentDelegate — держатель делегата может очистить любой счёт токена, включая хранилище пула. Разрешено только через статический whitelist для доверенных издателей (например, регулируемые стейблкоины).
• 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 вне цепи перед тем, как открыть создание пула в вашем 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 в allow-list на уровне Solana (соглашение экосистемы развивается).
• AMM, совместимые с confidential-transfer (стадия исследования).
• Более широкий реестр для каждой монеты CPMM (паритет с CLMM).
• Обновление зависимости, чтобы декодирование ScaledUiConfig CLMM работало без эвристики Superstate.

​

Указатели

• 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 — 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 — инструкция реестра для каждой монеты.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — создание базовой монеты Token-2022 LaunchLab.