Ma trận hỗ trợ Token-2022

Những chương trình Raydium nào hỗ trợ Token-2022, danh sách cho phép rõ ràng mà mỗi chương trình thực thi khi tạo pool, và các đường dẫn bỏ qua (danh sách mint tĩnh, sổ đăng ký theo mint, phát hiện Superstate) cho phép các mint bị từ chối.

Trang này được dịch tự động bằng AI. Phiên bản tiếng Anh là bản chính thức.

Xem bản tiếng Anh →

Raydium không chấp nhận các mint Token-2022 tùy ý. Cả CPMM và CLMM đều chạy ở chế độ danh sách cho phép nghiêm ngặt: chỉ một tập hợp nhỏ các extension được chấp nhận theo mặc định; mọi thứ khác bị từ chối khi tạo pool. Một số mint đáng tin cậy được chấp nhận thông qua địa chỉ được mã hóa cứng; CLMM còn hỗ trợ sổ đăng ký theo mint do quản trị viên quản lý và phát hiện token Superstate tại thời gian chạy. Trang này là tài liệu tham khảo duy nhất cho những gì được thực thi và ở đâu, kèm theo trích dẫn tệp và dòng từ mã nguồn chương trình.

​

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

Chương trình	Mint base/quote Token-2022?	Chế độ
CPMM	Có — được kiểm soát	Danh sách cho phép extension nghiêm ngặt + danh sách mint tĩnh 4 mint.
CLMM	Có — được kiểm soát	Danh sách cho phép extension nghiêm ngặt + danh sách mint tĩnh 6 mint + sổ đăng ký theo mint do quản trị viên quản lý + phát hiện Superstate.
AMM v4	Không	Chương trình ra đời trước Token-2022; cả hai mint phải là Token SPL cổ điển.
Stable AMM	Không	Các ràng buộc giống như AMM v4.
Farm v6	Có, một phần	Mint phần thưởng có thể là Token-2022 (tuân theo danh sách cho phép tương tự khi một farm bao bọc LP CPMM/CLMM); mint LP cược của người dùng kế thừa từ pool được bao bọc.
LaunchLab	Có — base do chương trình quản lý, quote không được kiểm soát	Mint base có thể là Token-2022, nhưng chỉ thông qua lệnh initialize_with_token_2022 chuyên dụng; chương trình tự tạo mint với MetadataPointer (luôn luôn) và tùy chọn TransferFeeConfig (tỷ lệ ≤ 5%). Các mint Token-2022 đã tồn tại với các extension tùy ý không thể được sử dụng làm base. Mint quote có thể là bất kỳ mint Token-2022 nào mà quản trị viên liên kết với GlobalConfig, không có kiểm tra extension — xem dưới đây.
Burn & Earn	Phản ánh chương trình pool	Kế thừa kiểm soát CPMM / CLMM.

Các kiểm tra danh sách cho phép nằm trong:

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

Không có kiểm tra mint tại thời gian swap trên CPMM hoặc CLMM — cổng chỉ kích hoạt khi tạo pool. Khi một pool tồn tại, các swap chỉ tin tưởng rằng các mint không thay đổi, điều này là chính xác đối với các phần bất biến của trạng thái mint Token-2022.

​

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

Các tài khoản NFT vị trí vẫn không bị đóng băng theo mặc định. CLMM chỉ đóng băng một tài khoản khi vị trí sử dụng đường dẫn mở V2 và ít nhất một freeze_authority hiện tại của mint vault khớp với danh sách nhà phát hành bị hạn chế được mã hóa cứng. Danh sách ban đầu chứa cùng một authority được sử dụng bởi đường dẫn phát hiện Superstate dưới đây. Đặt pool PDA làm freeze authority của mint NFT vị trí không phải là một sự đóng băng. Đây là một quy tắc quản lý vị trí, không phải là một danh sách cho phép tạo pool khác:

• Pool có thể đã tồn tại và vẫn có thể swap.
• 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í Token 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 vault mint 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.

Các vị trí bị đóng băng vẫn có thể được quản lý bởi chủ sở hữu nhưng không thể được chuyển. ClosePosition tan băng và đốt nguyên tử khi client chuyển pool làm tài khoản còn lại đầu tiên. Xem products/clmm/ticks-and-positions.

​

Mint quote LaunchLab

Hai mint của LaunchLab được kiểm soát rất khác nhau, và sự bất đối xứng rất dễ bỏ sót.

• 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à quản trị viên chọn liên kết với GlobalConfig.

Điều đó làm cho việc liên kết mint quote Token-2022 là một hành động đòi hỏi sự tin tưởng cao, với lý do tương tự như danh sách mint tĩnh CPMM và CLMM dưới đây: mint quote TransferHook sẽ chạy hook của nó trên mỗi lần mua, bán và yêu cầu phí trong mỗi pool được trích dẫn trong nó, và mint quote PermanentDelegate sẽ cho phép đại biểu quét các vault quote của những pool đó. Cả hai đều không bị chương trình chặn.

Những gì LaunchLab xử lý chính xác khi mint quote được liên kết:

• 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 là 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.

Lệnh Initialize không dùng nữa vẫn nhận chương trình quote chỉ dành cho kế thừa, vì vậy config với mint quote Token-2022 chỉ có thể truy cập được thông qua InitializeV2 và InitializeWithToken2022.

​

Danh sách cho phép extension CPMM và CLMM

Sau khi các lối tắt danh sách tĩnh (được đề cập dưới đây), chương trình lặp qua các extension của mint và từ chối mint nếu nó mang bất kỳ extension nào khác ngoài năm cái này:

Extension	Lý do nó được cho phép
TransferFeeConfig	Toán học pool trừ phí inbound; chương trình Token-2022 xử lý phí outbound. Xem algorithms/token-2022-transfer-fees.
MetadataPointer	Trang trí — trỏ đến metadata on-chain.
TokenMetadata	Trang trí — metadata nội tuyến.
InterestBearingConfig	Pool thấy số tiền gốc; bộ nhân UI chỉ là trang trí và số dư cơ bản được bảo toàn.
ScaledUiAmount	Hình dạng giống như lãi suất — hệ số tỷ lệ chỉ áp dụng cho hiển thị UI.

Bất cứ thứ gì không có trong danh sách này — TransferHook, NonTransferable, ConfidentialTransferMint, PermanentDelegate, MintCloseAuthority, DefaultAccountState, GroupPointer, GroupMemberPointer, MemberPointer, Pausable, v.v. — khiến is_supported_mint trả về false và tạo pool hoàn tác.

Các dòng liên quan (CPMM, hình dạng giống hệt trong 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)

— cp-swap/src/utils/token.rs:190–200

​

Đường dẫn bỏ qua

Mint Token-2022 không phù hợp với danh sách cho phép vẫn có thể được chấp nhận thông qua một trong ba lối thoát rõ ràng. Chúng được thử theo thứ tự, trước khi lặp extension chạy.

​

1. Danh sách mint tĩnh

Một mảng hằng số MINT_WHITELIST của các chuỗi base58 được mã hóa cứng trong mỗi chương trình. Nếu địa chỉ mint khớp, hàm trả về true ngay lập tức và không có kiểm tra extension nào được thực hiện.

Chương trình	Mint được liệt kê
CPMM	HVbpJAQGNpkgBaYBZQBR1t7yFdvaYVp2vCQQfKKEN4tM, Crn4x1Y2HUKko7ox2EZMT6N2t2ZyH7eKtwkBGVnhEq1g, FrBfWJ4qE5sCzKm3k3JaAtqZcXUh4LvJygDeketsrsH4, 2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo
CLMM	Bốn cái trên, cộng với DAUcJBg4jSpVoEzASxYzdqHMUN8vuTpQyG2TvDcCHfZg, AUSD1jCcCyPLybk1YnvPWsHQSrZ46dxwoMniN4N2UEB9

Những địa chỉ này được nướng vào chương trình; cập nhật danh sách yêu cầu nâng cấp chương trình thông qua multisig nâng cấp 3/4.

​

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

CLMM còn tham khảo PDA SupportMintAssociated tại seed [b"support_mint", mint]. Nếu PDA đó tồn tại cho mint, nó được chấp nhận bất kể tập hợp extension của nó.

PDA được tạo bởi CreateSupportMintAssociated (admin/create_support_mint_associated.rs). Lệnh được kiểm soát bởi hai người ký:

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

Hiệu ứng: nhóm CLMM có thể chọn một mint Token-2022 cụ thể vào tạo pool mà không cần nâng cấp chương trình. CPMM không có tương đương — danh sách cho phép của nó hoàn toàn được mã hóa nguồn.

​

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

CLMM có đường dẫn thứ ba dành riêng cho tài sản token hóa của Superstate, sử dụng extension ScaledUiConfig mà phiên bản spl-token-2022 được liên kết vào chương trình CLMM không thể giải nén. Thay vì nâng cấp phụ thuộc, CLMM phát hiện token Superstate bằng hình dạng authority của chúng:

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

— raydium-clmm/programs/amm/src/util/token.rs:485

Mint vượt qua nhánh này nếu tất cả bốn giữ:

• 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.

Đây là một heuristic, không phải là sổ đăng ký — bất kỳ mint trong tương lai nào mà Superstate phát hành với hình dạng authority tương tự sẽ được chấp nhận tự động.

​

Những gì các lối thoát không miễn trừ

Các lối thoát bỏ qua danh sách cho phép extension, nhưng chương trình vẫn thực thi:

• 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 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 chứa phí hạ cánh số tiền chính xác trong vault.

Mint được liệt kê trắng hoặc đăng ký PDA mà, ví dụ, thêm TransferHook sau đó không nhận được kiểm tra thời gian swap; hook sẽ chỉ chạy trên mỗi chuyển giao và có thể làm gián đoạn swap. Do đó, liệt kê trắng là một hành động đòi hỏi sự tin tưởng cao.

​

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

Khi is_supported_mint trả về false, tạo pool hoàn tác với ErrorCode::NotSupportMint (CPMM) / ErrorCode::NotSupportMint (CLMM). Xem reference/error-codes cho các mã số.

Các pool hiện có không thể hoàn tác thất bại kiểm tra này — cổng chỉ chạy khi tạo. Các extension mint là bất biến đối với các danh mục mà Raydium từ chối (transfer hook, non-transferable, confidential transfer không thể được thêm sau khi tạo), vì vậy kiểm tra tĩnh là đủ.

​

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

• TransferHook — gọi 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ể lấy 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ữ đại biểu 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. Không được phép theo mặc định.
• DefaultAccountState (Frozen) — pool ATA sẽ hạ cánh ở trạng thái Frozen và yêu cầu 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 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. Không được phép theo mặc định để giữ bề mặt hẹp.

​

Kế toán phí chuyển giao

Đối với mint mang TransferFeeConfig, mỗi swap, deposit và withdraw di chuyển ít hơn số tiền danh nghĩa. SDK bề mặt cả hai nửa của tính toán:

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

UI chính xác hiển thị:

• amountIn + token2022FeeIn là “bạn gửi”
• amountOut - token2022FeeOut là “bạn nhận”
• feeAmount là phí pool (LP + giao thức), tách biệt với phí chuyển giao Token-2022

UI ngây thơ chỉ hiển thị amountIn → amountOut giảm thiểu chi phí.

​

Giới hạn maximumFee

Phí chuyển giao Token-2022 được giới hạn cho mỗi chuyển giao. Đối với mint 1% với giới hạn 10.000 token, chuyển giao 100.000.000 token chỉ trả 10.000 phí. computeSwapAmount của SDK áp dụng giới hạn; người gọi chương trình trực tiếp phải sao chép nó.

​

Chuyển đổi epoch

Authority mint có thể lên lịch thay đổi tỷ lệ phí kích hoạt tại epoch tiếp theo. Trong cửa sổ chuyển đổi, hai config (older, newer) tồn tại trên mint cùng một lúc và TransferChecked chọn theo epoch hiện tại. Cả SwapV2 CPMM và SwapV2 CLMM đều chuyển toàn bộ tài khoản mint trong accounts, vì vậy chương trình đọc config chính xác mà không cần tra cứu thêm.

Nếu bạn trích dẫn nhiều hơn một epoch trước thông qua Trade API hoặc SDK, phí được thực thi có thể khác với phí được trích dẫn — giới hạn bởi maximum_fee_basis_points của config cũ hơn.

​

Lãi suất và ScaledUiAmount

Pool giữ số tiền gốc; “số tiền UI” là số tiền gốc nhân với hệ số tỷ lệ phụ thuộc thời gian hoặc do quản trị viên đặt. Toán học swap hoạt động trên gốc:

principal_in = ui_amount_in / ui_multiplier(now)

SDK chuyển đổi tự động. Người đọc RPC trực tiếp nên coi pool.token0Vault.amount là gốc.

​

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

Pool là pool Token-2022 nếu mint nào có programId == TokenzQdB.... API bề mặt này:

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

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

Sử dụng programId để gửi, và hasTransferFee để bề mặt cảnh báo UI.

​

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. 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 tác. 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 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 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ê 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 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 mục lộ trình hệ sinh thái Solana và giao thức sẽ thay đổi ma trận này:

• Các chương trình transfer-hook được liệt kê trắng ở cấp độ Solana (quy ước hệ sinh thái phát triển).
• AMM tương thích chuyển giao bảo 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.

Trang này sẽ được cập nhật khi bất kỳ hạ cánh.

​

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.

Nguồn:

• 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 LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — liên kết mint quote LaunchLab (không có kiểm tra extension).