Token-2022 지원 매트릭스

​

프로그램 수준 지원

• CPMM: raydium-cp-swap/programs/cp-swap/src/utils/token.rs의 is_supported_mint, Initialize 및 InitializeWithPermission에서 호출됩니다.
• CLMM: raydium-clmm/programs/amm/src/util/token.rs의 is_supported_mint, CreatePool에서 호출됩니다.
• LaunchLab: raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs의 initialize_with_token_2022 (소스는 공개되지 않음).

​

CLMM 포지션 NFT 제한된 발행자에 대한 동결

• 풀은 이미 존재할 수 있으며 스왑 가능한 상태로 유지됩니다.
• 포지션 NFT 민트는 CLMM 풀 PDA를 자신의 동결 권한으로 사용합니다. 기본 발행자는 포지션 NFT를 제어하지 않습니다.
• OpenPositionV2는 Token-2022 풀 자산에 대한 클래식 SPL 포지션 NFT를 포함합니다. OpenPositionWithToken22Nft는 Token-2022 포지션 NFT를 포함합니다.
• OpenPosition V1은 볼트 민트를 검사하지 않으며 배포된 목록이 대상으로 하는 Token-2022 제한 자산을 제공할 수 없습니다.
• 기존 포지션은 변경되지 않습니다.

​

LaunchLab 견적 민트

• 기본 민트 — LaunchLab이 생성합니다. Token-2022 기본 민트는 initialize_with_token_2022를 통해서만 도달할 수 있으며, 프로그램은 MetadataPointer와 (선택적으로) TransferFeeConfig만 첨부합니다. 다른 것은 NoSupportExtension을 반환합니다. 기존 Token-2022 민트는 기본으로 전혀 제공될 수 없습니다. TransferFeeConfig가 첨부되면, 민트의 transfer_fee_config_authority는 졸업까지 시작 권한 PDA이고, 그 withdraw_withheld_authority는 민트 생성부터 플랫폼의 구성된 transfer_fee_extension_auth입니다 — 런치패드 프로그램 자체는 보류 중인 금액 인출 명령어가 없습니다. products/launchlab/platform-config를 참조하세요.
• 견적 민트 — LaunchLab이 생성하지 않으며 검사하지 않습니다. CreateConfig는 민트 계정을 그대로 수락하므로, 견적 측에는 is_supported_mint 동등물이 없습니다. 유일한 게이트는 관리자가 GlobalConfig에 바인딩하도록 선택하는 민트입니다.

• 견적 볼트, 두 수수료 볼트 및 공유 수수료 수신자의 토큰 계정은 견적 민트의 자체 프로그램에서 생성됩니다.
• 견적 측의 TransferFeeConfig는 네 가지 거래 명령어 모두에 가격이 책정되며, 슬리피지 바운드는 볼트의 총 이동이 아닌 지불자의 순 금액에 대해 검사됩니다. products/launchlab/instructions를 참조하세요.
• PoolState.token_program_flag는 두 민트의 프로그램을 기록합니다 — 기본 민트의 경우 bit0, 견적 민트의 경우 bit1. 비트별로 디코딩하세요. 바이트는 부울이 아닙니다. 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 중 하나로 소유됩니다. 사용자 정의 토큰 프로그램은 업스트림에서 거부됩니다.
• 풀 금고는 Token-2022 풀에 대해 올바른 ATA 확장으로 생성됩니다 (ImmutableOwner 등).
• 모든 전송은 transfer_checked를 통해 진행됩니다 — 수수료 부담 민트는 금고에 올바른 금액을 입금합니다.

​

”차단됨” 의미론

​

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

• TransferHook — 모든 전송에서 사용자 정의 프로그램을 호출하며, 임의의 CU 소비, 임의의 실패 조건, 호출 프로그램을 재진입할 수 있는 능력이 있습니다. 안전한 샌드박스가 없습니다. 일부 DEX는 훅 허용 목록을 유지합니다. Raydium은 그렇지 않습니다.
• NonTransferable — Transfer는 항상 실패합니다. 풀은 보관권을 가질 수 없습니다.
• ConfidentialTransfer — 전송 금액이 암호화되어 있으므로 곡선이 스왑 가격을 책정할 수 없습니다.
• PermanentDelegate — 위임자 보유자는 풀 금고를 포함한 모든 토큰 계정을 쓸어낼 수 있습니다. 민트를 등록하여만 허용되며, 이는 신뢰할 수 있는 발행자 (예: 규제 스테이블코인)가 경우별로 온보딩되는 방식입니다.
• MintCloseAuthority — 민트를 닫을 수 있으므로 기존 풀을 사용할 수 없게 됩니다. 기본적으로 허용되지 않습니다.
• DefaultAccountState (Frozen) — 풀 ATA는 Frozen 상태로 도착하며 계정당 해동이 필요합니다. 민트를 등록하여만 허용되며, 이는 발행자가 등록 시 기관 계정을 해동한다고 가정합니다.
• Group/Member pointers — 적극적으로 해롭지는 않지만 검토되지 않았습니다. 표면을 좁게 유지하기 위해 기본적으로 허용되지 않습니다.

​

전송 수수료 회계

• 풀 수수료 (LP + 프로토콜 + 펀드 + 크리에이터)는 곡선에서 나옵니다. raydium.cpmm.computeSwapAmount({ ... })는 이를 fee로 반환하며, amountIn, amountOut, minAmountOut, executionPrice, priceImpact 및 원본 swapResult와 함께 반환합니다.
• Token-2022 전송 수수료는 풀이 아닌 민트에서 나옵니다. @raydium-io/raydium-sdk-v2의 getTransferAmountFee 헬퍼로 계산되며, GetTransferAmountFee를 반환합니다:

export interface GetTransferAmountFee {
  amount: BN;                  // 실제로 이동하는 금액
  fee: BN | undefined;         // 민트에 의해 보류됨; 민트에 TransferFeeConfig가 없을 때 undefined
  expirationTime: number | undefined;  // 예정된 수수료 변경이 보류 중일 때 설정됨
}

• 입력 금액 더하기 전송 fee를 “보내는 금액”으로
• 출력 금액 빼기 전송 fee를 “받는 금액”으로
• 풀 fee를 별도 줄로 — 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 } from "@raydium-io/raydium-sdk-v2";
// TOKEN_2022_PROGRAM_ID는 Raydium SDK에서 재내보내지지 않습니다 —
// @solana/spl-token에서 가져오세요. SDK 자체도 그렇게 합니다.
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는 거부하지 않습니다 — 풀 생성이 되돌립니다. UI에서 풀 생성을 노출하기 전에 오프체인에서 is_supported_mint 의미론을 확인하세요.
• 전송 수수료 감소 없이 견적하기. 양쪽에 1% 전송 수수료 민트가 있는 0.25% CPMM 풀의 유효 수수료는 약 2.25%이지, 0.25%가 아닙니다. SDK 견적 또는 Trade API 견적을 사용하세요 — 풀의 수수료 계층만으로 수수료를 수동으로 계산하지 마세요.
• Token-2022 풀에서 레거시 Swap 명령어 호출하기. Swap은 Token-2022보다 앞서갑니다. 어느 한 민트가 Token-2022일 때마다 SwapV2를 사용하세요.
• 새로운 Token-2022 민트 자동 나열하기. 지갑 및 애그리게이터는 민트를 사용자에게 표시하기 전에 TransferHook 및 NonTransferable을 확인해야 합니다. 둘 다 Raydium에 적대적입니다.

​

향후 작업

• Solana 수준의 허용 목록 전송 훅 프로그램 (생태계 규칙 진화 중).
• 기밀 전송 호환 AMM (연구 단계).
• 더 광범위한 CPMM 민트별 레지스트리 (CLMM과 동등).
• 레지스트리에 대한 공개 읽기 경로, UI가 PDA를 직접 파생시키지 않고도 “지원되지 않음”과 “지원되지 않지만 등록됨”을 구분할 수 있도록.

​

포인터

• 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 — 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 — LaunchLab Token-2022 기본 민트 생성.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — LaunchLab 견적 민트 바인딩 (확장 확인 없음).