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

Documentation Index

Fetch the complete documentation index at: https://docs.raydium.io/llms.txt

Use this file to discover all available pages before exploring further.

​

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

• 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 (исходный код не опубликован).

​

Список разрешений расширений 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. Статический список адресов токенов

​

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

• crate::admin::ID — стандартный орган администратора Raydium.
• crate::create_support_mint_associated_owner::ID — выделенный орган для этой цели: 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. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• Его расширение DefaultAccountState установлено в Frozen.
• Его постоянный делегат также superstate_allowlist::ID.

​

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

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

​

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

​

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

• TransferHook — вызывает пользовательскую программу при каждом переводе с произвольным потреблением CU, произвольными условиями отказа и способностью повторно входить в вызывающую программу. Безопасной песочницы не существует. Некоторые DEXy поддерживают списки разрешений hook; Raydium не поддерживает.
• NonTransferable — Transfer всегда не удается. Пул не может взять под контроль.
• ConfidentialTransfer — суммы переводов зашифрованы; кривая не может оценить своп.
• PermanentDelegate — держатель делегата может очистить любой аккаунт токена, включая хранилище пула. Разрешено только через статический список разрешений для проверенных издателей (например, регулируемые stablecoin).
• MintCloseAuthority — mint можно закрыть; существующие пулы становятся непригодными. Запрещено по умолчанию.
• 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 программы. Mint может быть Token-2022 и неподдерживаемым. Проверьте список расширений по списку разрешений (и статическому списку) перед разрешением создания пула.
• Доверие цитате SDK, когда mint вообще не принят. API цитаты не отказывает в цитировании — создание пула — это то, что откатывается. Подтвердите семантику is_supported_mint офф-чейн перед открытием создания пула в вашем UI.
• Цитирование без скидки на комиссию передачи. Mint с комиссией передачи 1% с обеих сторон пула CPMM с 0.25% имеет эффективную комиссию около 2.25%, а не 0.25%. Используйте цитату SDK или цитату Trade API — никогда не вычисляйте комиссию вручную только с уровня комиссии пула.
• Вызов устаревшей инструкции Swap для пула Token-2022. Swap предшествует Token-2022. Используйте SwapV2 всякий раз, когда любой mint — Token-2022.
• Автоматический список новых токенов Token-2022. Кошельки и агрегаторы должны проверять TransferHook и NonTransferable перед отображением токена пользователям; оба враждебны Raydium.

​

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

• Разрешенные на уровне Solana программы transfer-hook (соглашение об экосистеме развивается).
• 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 — создание базового mint Token-2022 LaunchLab.