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는 4개 거래 명령어 모두에 가격이 책정되며, 슬리피지 바운드는 볼트의 총 이동이 아닌 지불자의 순 금액에 대해 확인됩니다. 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 포인터 — 적극적으로 해롭지는 않지만 검토되지 않았습니다. 표면을 좁게 유지하기 위해 기본적으로 허용되지 않습니다.

​

전송 수수료 회계

• 풀 수수료 (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 is not re-exported by the Raydium SDK — import it from
// @solana/spl-token, as the SDK itself does.
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 인용 민트 바인딩 (확장 검사 없음).