Ma trận hỗ trợ Token-2022

​

Hỗ trợ cấp chương trình

• CPMM: is_supported_mint trong raydium-cp-swap/programs/cp-swap/src/utils/token.rs, được gọi từ Initialize và InitializeWithPermission.
• CLMM: is_supported_mint trong raydium-clmm/programs/amm/src/util/token.rs, được gọi từ CreatePool.
• LaunchLab: initialize_with_token_2022 trong raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (mã nguồn không công khai).

​

Đóng băng NFT vị trí CLMM cho các nhà phát hành bị hạn chế

• Pool có thể đã tồn tại và vẫn có thể hoán đổi.
• Mint NFT vị trí sử dụng pool PDA CLMM làm freeze authority của chính nó; nhà phát hành cơ bản không kiểm soát NFT vị trí.
• OpenPositionV2 bao gồm NFT vị trí SPL cổ điển trên tài sản pool Token-2022. OpenPositionWithToken22Nft bao gồm NFT vị trí Token-2022.
• OpenPosition V1 không kiểm tra mint vault và không thể phục vụ tài sản Token-2022 bị hạn chế được nhắm mục tiêu bởi danh sách được gửi.
• Các vị trí hiện có không thay đổi.

​

Mint quote LaunchLab

• Mint base — LaunchLab tạo nó. Mint base Token-2022 chỉ có thể truy cập được thông qua initialize_with_token_2022, và chương trình sẽ chỉ đính kèm MetadataPointer và (tùy chọn) TransferFeeConfig. Bất cứ thứ gì khác sẽ trả về NoSupportExtension. Một mint Token-2022 đã tồn tại không thể được cung cấp làm base. Khi TransferFeeConfig được đính kèm, transfer_fee_config_authority của mint là launch authority PDA cho đến khi tốt nghiệp, trong khi withdraw_withheld_authority của nó là transfer_fee_extension_auth được cấu hình của nền tảng từ khi tạo mint trở đi — chương trình launchpad tự nó không có lệnh withdraw-withheld. Xem products/launchlab/platform-config.
• Mint quote — LaunchLab không tạo nó và không sàng lọc nó. CreateConfig chấp nhận tài khoản mint như được cung cấp, vì vậy không có tương đương is_supported_mint ở phía quote. Cổng duy nhất là những mint nào mà admin chọn liên kết với GlobalConfig.

• Vault quote, cả hai vault phí và tài khoản token của người nhận phí chia sẻ được tạo trên chương trình của mint quote.
• TransferFeeConfig ở phía quote được định giá vào cả bốn lệnh giao dịch, và giới hạn slippage được kiểm tra so với số tiền ròng của người trả tiền chứ không phải chuyển động brutto của vault. Xem products/launchlab/instructions.
• PoolState.token_program_flag ghi lại các chương trình của cả hai mint — bit0 cho mint base, bit1 cho mint quote. Giải mã nó theo bit; byte không phải là boolean. Xem products/launchlab/accounts.

​

Danh sách cho phép tiện ích mở rộng CPMM và 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)

​

Đường dẫn bypass

​

Bypass duy nhất: đăng ký mint

​

Các bypass đã bị xóa

​

MINT_WHITELIST tĩnh — bị xóa

​

Phát hiện hình dạng quyền hạn Superstate — bị xóa

​

Những gì các bypass không miễn trừ

• Mint được sở hữu bởi Token hoặc Token-2022. Chương trình token tùy chỉ bị từ chối ở thượng nguồn.
• Các vault pool được tạo với các tiện ích mở rộng ATA phù hợp cho pool Token-2022 (ImmutableOwner, v.v.).
• Tất cả các chuyển giao đi qua transfer_checked — mint mang phí hạ cánh số tiền chính xác trong vault.

​

Ngữ nghĩa “Bị chặn”

​

Tại sao mỗi tiện ích mở rộng bị loại trừ

• TransferHook — gọi một chương trình tùy chỉnh trên mỗi chuyển giao, với tiêu thụ CU tùy ý, điều kiện thất bại tùy ý, và khả năng nhập lại chương trình gọi. Không có sandbox an toàn nào tồn tại. Một số DEX duy trì danh sách cho phép hook; Raydium không.
• NonTransferable — Transfer luôn thất bại. Pool không thể chiếm quyền quản lý.
• ConfidentialTransfer — số tiền chuyển giao được mã hóa; đường cong không thể định giá swap.
• PermanentDelegate — người nắm giữ delegate có thể quét bất kỳ tài khoản token nào, bao gồm vault pool. Chỉ có thể chấp nhận bằng cách đăng ký mint, đó là cách nhà phát hành đáng tin cậy (ví dụ: stablecoin được quy định) được onboarded từng trường hợp một.
• MintCloseAuthority — mint có thể được đóng; các pool hiện có trở nên không sử dụng được. Bị cấm theo mặc định.
• DefaultAccountState (Frozen) — pool ATA sẽ hạ cánh ở trạng thái Frozen và yêu cầu thawing cho mỗi tài khoản. Chỉ có thể chấp nhận bằng cách đăng ký mint, giả định rằng nhà phát hành thaw các tài khoản tổ chức khi đăng ký.
• Group/Member pointers — không gây hại tích cực, nhưng chưa được xem xét. Bị cấm theo mặc định để giữ bề mặt hẹp.

​

Kế toán phí chuyển giao

• Phí pool (LP + giao thức + quỹ + người tạo) đến từ đường cong. raydium.cpmm.computeSwapAmount({ ... }) trả về nó dưới dạng fee, cùng với amountIn, amountOut, minAmountOut, executionPrice, priceImpact và swapResult thô.
• Phí chuyển giao Token-2022 đến từ mint, không phải pool. Nó được tính toán bởi các trợ giúp getTransferAmountFee trong @raydium-io/raydium-sdk-v2, trả về GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // số tiền thực sự di chuyển
  fee: BN | undefined;         // được giữ lại bởi mint; undefined khi mint không có TransferFeeConfig
  expirationTime: number | undefined;  // được đặt trong khi thay đổi phí được lên lịch đang chờ xử lý
}

• số tiền đầu vào cộng phí chuyển giao của nó dưới dạng “bạn gửi”
• số tiền đầu ra trừ phí chuyển giao của nó dưới dạng “bạn nhận”
• phí pool dưới dạng dòng riêng — nó không phải là phí Token-2022

​

Giới hạn maximumFee

​

Chuyển đổi epoch

​

Lãi suất và ScaledUiAmount

principal_in = ui_amount_in / ui_multiplier(now)

​

Định nghĩa “Pool Token-2022”

GET /pools/info/ids?ids=<POOL_ID>

{
  "data": [{
    "mintA": { "programId": "TokenzQdB...", "hasTransferFee": true, ... },
    "mintB": { "programId": "Tokenkeg...", ... }
  }]
}

​

Trợ giúp 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);
  }
}

​

Lỗi tích hợp phổ biến

• Chỉ pre-flighting ID chương trình. Mint có thể là Token-2022 và không được hỗ trợ. Đi bộ danh sách tiện ích mở rộng so với danh sách cho phép, và kiểm tra PDA đăng ký của mint, trước khi cho phép tạo pool.
• Tin tưởng vào trích dẫn SDK khi mint không được chấp nhận. API trích dẫn không từ chối trích dẫn — tạo pool là những gì hoàn nguyên. Xác nhận ngữ nghĩa is_supported_mint ngoài chuỗi trước khi bề mặt tạo pool trong UI của bạn.
• Trích dẫn mà không cắt tóc phí chuyển giao. Mint phí chuyển giao 1% ở cả hai bên của pool CPMM 0,25% có phí hiệu quả khoảng 2,25%, không phải 0,25%. Sử dụng trích dẫn SDK hoặc trích dẫn Trade API — không bao giờ tính toán phí thủ công từ tầng phí pool một mình.
• Gọi lệnh Swap kế thừa trên pool Token-2022. Swap ra đời trước Token-2022. Sử dụng SwapV2 bất cứ khi nào mint nào là Token-2022.
• Tự động liệt kê mint Token-2022 mới. Ví và bộ tổng hợp nên kiểm tra TransferHook và NonTransferable trước khi bề mặt mint cho người dùng; cả hai đều không thân thiện với Raydium.

​

Công việc trong tương lai

• Các chương trình transfer-hook được cho phép ở cấp độ Solana (quy ước hệ sinh thái đang phát triển).
• AMM tương thích chuyển giao bí mật (giai đoạn nghiên cứu).
• Đăng ký mint CPMM rộng hơn (tương đương với CLMM).
• Đường dẫn đọc công khai cho đăng ký, vì vậy UI có thể cho biết “không được hỗ trợ” từ “không được hỗ trợ nhưng đã đăng ký” mà không cần dẫn xuất PDA tự nó.

​

Con trỏ

• algorithms/token-2022-transfer-fees — toán học phí trong swap.
• products/cpmm/instructions — SwapV2, Initialize.
• products/clmm/instructions — SwapV2, CreatePool, CreateSupportMintAssociated.
• reference/error-codes — mã số NotSupportMint cho mỗi chương trình.

• 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 — lệnh đăng ký mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — tạo mint base Token-2022 LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — liên kết mint quote LaunchLab (không có kiểm tra tiện ích mở rộng).