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: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).

​

Đó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 CLMM pool PDA 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 Token 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.

​

Danh sách cho phép extension 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 vòng

​

1. Danh sách mint tĩnh

​

2. Sổ đăng ký theo mint — chỉ CLMM

• crate::admin::ID — quyền quản trị viên Raydium tiêu chuẩn.
• crate::create_support_mint_associated_owner::ID — một quyề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 của nó là chương trình Token-2022.
• Freeze authority của nó bằng superstate_allowlist::ID. Xem reference/program-addresses cho các giá trị mainnet-beta và devnet.
• Extension DefaultAccountState của nó được đặt thành Frozen.
• Permanent delegate của nó cũng là superstate_allowlist::ID.

​

Những gì các đường vòng không miễn trừ

• Mint được sở hữu bởi Token hoặc Token-2022. Một 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 extension 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 phù hợp trong vault.

​

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

​

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

• TransferHook — gọi một chương trình tùy chỉ 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ó 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 không.
• NonTransferable — Transfer luôn thất bại. Một pool không thể giữ quyền sở hữu.
• ConfidentialTransfer — số tiền chuyển giao được mã hóa; đường cong không thể định giá swap.
• PermanentDelegate — một người giữ delegate có thể quét bất kỳ tài khoản token nào, bao gồm vault pool. Chỉ được phép thông qua danh sách tĩnh cho các nhà phát hành đáng tin cậy (ví dụ: stablecoin được quy định).
• 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 làm tan bă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 làm tan băng các tài khoản tổ chức khi đăng ký.
• Con trỏ Nhóm/Thành viên — 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

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

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

​

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

• Chỉ pre-flighting 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 mint tĩnh) trước khi cho phép tạo pool.
• Tin tưởng trích dẫn SDK khi mint không được chấp nhận hoàn toà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 hiển thị tạo pool trong UI của bạn.
• Trích dẫn mà không cắt tóc phí chuyển giao. Một 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í theo cách 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ê các mint Token-2022 mới. Ví dụ và tổng hợp nên kiểm tra TransferHook và NonTransferable trước khi bề mặt 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).
• Sổ đăng ký theo mint CPMM rộng hơn (tương đươ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 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 — 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 sổ đăng ký theo mint.
• raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs — tạo mint base Token-2022 của LaunchLab.