Ma trận hỗ trợ 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.

​

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

• CPMM: is_supported_mint trong raydium-cp-swap/programs/cp-swap/src/utils/token.rs:178, được gọi từ Initialize.
• CLMM: is_supported_mint trong raydium-clmm/programs/amm/src/util/token.rs:280, đượ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).

​

Danh sách cho phép extension của 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 vượt qua

​

1. Danh sách mint tĩnh

​

2. Thanh ghi cho từng mint — chỉ CLMM

• crate::admin::ID — quyền hạn quản trị viên tiêu chuẩn của Raydium.
• crate::create_support_mint_associated_owner::ID — quyền hạn chuyên dụng cho mục đích này: RayVyjyJQz9vAi126A4sGexKnSU1XeZaHTRcM1mZMPY (mainnet), rayf3nEbb3bnfN6RDGFpqPbjc5uUa3tRUzu6UVYrRx5 (devnet).

​

3. Phát hiện Superstate — chỉ CLMM

superstate_allowlist::ID == freeze_authority
    && *mint_account_info.owner == spl_token_2022::ID
    && default_account_state_freeze
    && maybe_permanent_delegate

• Chương trình sở hữu nó là chương trình Token-2022.
• Quyền hạn đóng băng của nó bằng superstate_allowlist::ID. Mainnet: 2Yq4T3mPNfjtEyTxSbRjRKqLf1pwbTasuCQrWe6QpM7x. Devnet: 3TRuL3MFvzHaUfQAb6EsSAbQhWdhmYrKxEiViVkdQfXu.
• Extension DefaultAccountState của nó được đặt thành Frozen.
• Đại biểu vĩnh viễn của nó cũng là superstate_allowlist::ID.

​

Những gì những đường dẫn vượt qua không miễn khỏi

• Mint được sở hữu bởi Token hoặc Token-2022. Một chương trình token tùy chỉnh bị từ chối phía ngược dòng.
• Những hầm pool được tạo với những extension ATA phù hợp cho pool Token-2022 (ImmutableOwner, v.v.).
• Tất cả những lần chuyển đều đi qua transfer_checked — mint có phí hạ cánh số tiền đúng vào hầm.

​

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

​

Tại sao mỗi extension bị loại trừ lại bị loại trừ

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

​

Kế toán phí chuyển

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

• amountIn + token2022FeeIn là “bạn gửi”
• amountOut - token2022FeeOut là “bạn nhận”
• feeAmount là phí pool (LP + giao thức), riêng biệt với phí chuyển 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, 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);
  }
}

​

Những lỗi tích hợp phổ biến

• Pre-flighting chỉ ID chương trình. Một mint có thể là Token-2022 và không được hỗ trợ. Đi bộ danh sách extension so với danh sách cho phép (và danh sách trắng tĩnh) trước khi cho phép tạo pool.
• Tin tưởng vào quote của SDK khi mint không được chấp nhận hoàn toàn. API quote không từ chối trích dẫn — tạo pool là những gì bị hoàn nguyên. Xác nhận ngữ nghĩa is_supported_mint ngoài chuỗi trước khi công khai tạo pool trong UI của bạn.
• Trích dẫn mà không có cắt phí chuyển. Một mint phí chuyển 1% trên cả hai phía của pool CPMM 0.25% có phí hiệu quả khoảng 2.25%, không phải 0.25%. Sử dụng quote SDK hoặc quote Trade API — không bao giờ tính toán phí theo cách thủ công từ mức 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 bất kỳ mint nào là Token-2022.
• Tự động liệt kê mint Token-2022 mới. Những ví và bộ tập hợp nên kiểm tra TransferHook và NonTransferable trước khi trình bày 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

• Transfer-hook programs được cho phép ở cấp độ Solana (quy ước hệ sinh thái đang phát triển).
• Những AMM tương thích với confidential-transfer (giai đoạn nghiên cứu).
• Thanh ghi cho từng mint CPMM rộng hơn (bằng với CLMM).
• Nâng cấp phụ thuộc để giải mã ScaledUiConfig của CLMM hoạt động mà không cần heuristic Superstate.

​

Con trỏ

• algorithms/token-2022-transfer-fees — toán 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 — 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 — lệnh thanh ghi cho từng mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — tạo mint base Token-2022 của LaunchLab.