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: raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178의 is_supported_mint, Initialize에서 호출
• CLMM: raydium-clmm/programs/amm/src/util/token.rs:280의 is_supported_mint, CreatePool에서 호출
• LaunchLab: raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs의 initialize_with_token_2022 (소스는 공개되지 않음)

​

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 (메인넷), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (데브넷)

​

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 프로그램입니다.
• 동결 권한이 superstate_allowlist::ID와 같습니다. 메인넷: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. 데브넷: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• DefaultAccountState 확장이 Frozen으로 설정되어 있습니다.
• 영구 위임자도 superstate_allowlist::ID입니다.

​

우회 경로가 포기하지 않는 것

• 민트는 Token 또는 Token-2022가 소유합니다. 사용자 정의 토큰 프로그램은 업스트림에서 거부됩니다.
• 풀 볼트는 Token-2022 풀을 위한 올바른 ATA 확장(ImmutableOwner 등)으로 생성됩니다.
• 모든 전송은 transfer_checked를 통합니다 — 수수료 부담 민트는 올바른 양을 볼트에 넣습니다.

​

”차단됨” 의미 논리

​

각 제외된 확장이 제외되는 이유

• TransferHook — 모든 전송에서 사용자 정의 프로그램을 호출하며, 임의의 CU 소비, 임의의 실패 조건, 호출 프로그램을 다시 입력할 수 있습니다. 안전한 샌드박스가 없습니다. 일부 DEX는 훅 허용 목록을 유지합니다, Raydium은 그렇지 않습니다.
• NonTransferable — Transfer는 항상 실패합니다. 풀이 보유권을 가질 수 없습니다.
• ConfidentialTransfer — 전송 양이 암호화됩니다, 곡선은 스왑을 가격책정할 수 없습니다.
• PermanentDelegate — 위임자 보유자는 풀 볼트를 포함한 모든 토큰 계정을 넘길 수 있습니다. 신뢰할 수 있는 발행자(예: 규제된 스테이블코인)의 정적 화이트리스트를 통해서만 허용됩니다.
• MintCloseAuthority — 민트가 폐쇄될 수 있고, 기존 풀은 사용할 수 없게 됩니다. 기본적으로 거부됩니다.
• DefaultAccountState (Frozen) — 풀 ATA는 Frozen 상태로 끝나고 계정별 해동이 필요합니다. Superstate 감지를 통해서만 허용되며, 발급자가 등록 시 기관 계정을 해동한다고 가정합니다.
• Group/Member 포인터 — 적극적으로 해롭지는 않지만 검토되지 않았습니다. 표면을 좁게 유지하기 위해 기본적으로 거부됩니다.

​

전송 수수료 계정

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

• amountIn + token2022FeeIn을 “보내시는 금액”으로
• amountOut - token2022FeeOut을 “받으시는 금액”으로
• feeAmount를 풀 수수료(LP + 프로토콜)로, Token-2022 전송 수수료와 별개

​

maximumFee 상한선

​

에포크 전환

​

이자 추적 및 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일 수 있으면서 지원되지 않을 수 있습니다. 풀 생성을 허용하기 전에 확장 목록을 허용 목록(및 정적 화이트리스트)에 대해 확인합니다.
• 민트가 전혀 승인되지 않았을 때 SDK의 견적을 신뢰. 견적 API는 거부하지 않습니다 — 풀 생성이 되돌립니다. UI에서 풀 생성을 표시하기 전에 오프체인에서 is_supported_mint 의미 논리를 확인합니다.
• 전송 수수료 헤어컷 없이 견적. 양쪽에 1% 전송 수수료 민트와 0.25% CPMM 풀은 0.25%가 아니라 약 2.25%의 효과적 수수료를 가집니다. SDK 견적 또는 Trade API 견적을 사용합니다 — 수수료를 풀의 수수료 티어만으로 수동 계산하지 않습니다.
• Token-2022 풀에서 레거시 Swap 명령어 호출. Swap은 Token-2022보다 먼저 나왔습니다. 두 민트 중 하나가 Token-2022일 때마다 SwapV2를 사용합니다.
• 새로운 Token-2022 민트 자동 나열. 지갑과 애그리게이터는 민트를 사용자에게 표시하기 전에 TransferHook과 NonTransferable을 확인해야 합니다, 둘 다 Raydium 적대적입니다.

​

향후 작업

• Solana 수준에서 허용 목록된 전송 훅 프로그램(에코시스템 관례 진화)
• 기밀 전송 호환 AMM(연구 단계)
• 더 광범위한 CPMM 민트별 레지스트리(CLMM과의 동등)
• CLMM의 ScaledUiConfig 디코딩이 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 — LaunchLab Token-2022 기본 민트 생성