مصفوفة دعم Token-2022

​

دعم على مستوى البرنامج

• CPMM: is_supported_mint في raydium-cp-swap/programs/cp-swap/src/utils/token.rs، يُستدعى من Initialize و InitializeWithPermission.
• CLMM: is_supported_mint في raydium-clmm/programs/amm/src/util/token.rs، يُستدعى من CreatePool.
• LaunchLab: initialize_with_token_2022 في raydium-launchpad/programs/launchpad/src/instructions/initialize_with_token_2022.rs (المصدر غير متاح للعموم).

​

تجميد NFT موضع CLMM للمُصدرين المقيدين

• يمكن أن يكون المجمع موجودًا بالفعل ويبقى قابلاً للمبادلة.
• يستخدم نعناع NFT الموضع PDA مجمع CLMM كسلطة تجميد خاصة به؛ المُصدر الأساسي لا يتحكم في NFT الموضع.
• OpenPositionV2 يغطي NFTs موضع SPL الكلاسيكي على أصول مجمع Token-2022. OpenPositionWithToken22Nft يغطي NFTs موضع Token-2022.
• 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 على جانب المقتبس يتم تسعيره في جميع تعليمات التجارة الأربعة، وتُفحص حدود الانزلاق مقابل المبلغ الصافي للدافع بدلاً من حركة الخزان الإجمالية. انظر 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. يتم رفض برنامج رمز مخصص في المنطقة العليا.
• يتم إنشاء خزانات المجمع مع امتدادات ATA الصحيحة لمجمعات Token-2022 (ImmutableOwner، إلخ).
• جميع التحويلات تمر عبر transfer_checked — نعناعات تحمل الرسوم تهبط المبلغ الصحيح في الخزان.

​

دلالات “محظور”

​

لماذا يتم استبعاد كل امتداد

• TransferHook — يستدعي برنامجًا مخصصًا على كل نقل، مع استهلاك CU عشوائي، شروط فشل عشوائية، والقدرة على إعادة الدخول إلى البرنامج الاستدعاء. لا يوجد صندوق رمل آمن. تحتفظ بعض DEXes بقوائم سماح خطاف؛ Raydium لا.
• NonTransferable — Transfer يفشل دائمًا. لا يمكن للمجمع أن يأخذ الحراسة.
• ConfidentialTransfer — مبالغ النقل مشفرة؛ المنحنى لا يمكنه تسعير المبادلة.
• PermanentDelegate — حامل المندوب يمكنه مسح أي حساب رمز، بما في ذلك خزان المجمع. مقبول فقط بتسجيل النعناع، وهو كيفية إدراج مُصدر موثوق (مثل عملة مستقرة منظمة) حالة تلو الأخرى.
• MintCloseAuthority — يمكن إغلاق النعناع؛ المجمعات الموجودة تصبح غير قابلة للاستخدام. محظور بشكل افتراضي.
• DefaultAccountState (Frozen) — ستهبط ATAs المجمع في حالة Frozen وتتطلب إذابة لكل حساب. مقبول فقط بتسجيل النعناع، الذي يفترض أن المُصدر يذيب الحسابات المؤسسية عند التسجيل.
• مؤشرات المجموعة/العضو — ليست ضارة بنشاط، لكن لم تُراجع. محظور بشكل افتراضي للحفاظ على السطح ضيقًا.

​

محاسبة رسوم النقل

• رسوم المجمع (LP + بروتوكول + صندوق + منشئ) تأتي من المنحنى. raydium.cpmm.computeSwapAmount({ ... }) يُرجعها كـ fee، إلى جانب amountIn، amountOut، minAmountOut، executionPrice، priceImpact والنتيجة الخام swapResult.
• رسوم نقل Token-2022 تأتي من النعناع، وليس المجمع. يتم حسابها بواسطة مساعدات getTransferAmountFee في @raydium-io/raydium-sdk-v2، التي تُرجع GetTransferAmountFee:

export interface GetTransferAmountFee {
  amount: BN;                  // المبلغ الذي يتحرك فعليًا
  fee: BN | undefined;         // محتفظ به من قبل النعناع؛ غير محدد عندما لا يحتوي النعناع على TransferFeeConfig
  expirationTime: number | undefined;  // تعيين أثناء انتظار تغيير رسوم مجدول
}

• مبلغ الإدخال زائد رسوم النقل الخاصة به كـ “أنت ترسل”
• مبلغ الإخراج ناقص رسوم النقل الخاصة به كـ “أنت تستقبل”
• رسوم المجمع كسطر منفصل — إنها ليست رسوم Token-2022

​

حد maximumFee

​

انتقال الحقبة

​

الفائدة والمبلغ المقياس في واجهة المستخدم

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);
  }
}

​

أخطاء التكامل الشائعة

• التحقق المسبق من معرف البرنامج فقط. يمكن أن يكون النعناع Token-2022 و غير مدعوم. امشِ قائمة الامتداد مقابل قائمة السماح، وتحقق من سجل PDA للنعناع، قبل السماح بإنشاء المجمع.
• الثقة في اقتباس SDK عندما لا يتم قبول النعناع على الإطلاق. API الاقتباس لا ترفض الاقتباس — إنشاء المجمع هو ما يرتد. أكد دلالات is_supported_mint خارج السلسلة قبل فضح إنشاء المجمع في واجهة المستخدم الخاصة بك.
• الاقتباس بدون خصم رسوم النقل. نعناع برسوم نقل 1% على كلا جانبي مجمع CPMM بنسبة 0.25% له رسوم فعالة حول 2.25%، وليس 0.25%. استخدم اقتباس SDK أو اقتباس Trade API — لا تحسب الرسوم يدويًا من مستوى رسوم المجمع وحده.
• استدعاء تعليمات Swap الوراثية على مجمع Token-2022. Swap يسبق Token-2022. استخدم SwapV2 كلما كان أي نعناع Token-2022.
• إدراج نعناعات Token-2022 الجديدة تلقائيًا. يجب على المحافظ والمجمعات التحقق من TransferHook و NonTransferable قبل سطح نعناع للمستخدمين؛ كلاهما معادٍ لـ Raydium.

​

العمل المستقبلي

• برامج خطاف نقل مسموحة على مستوى Solana (اتفاقية النظام البيئي تتطور).
• AMMs متوافقة مع النقل السري (مرحلة البحث).
• سجل نعناع CPMM أوسع لكل نعناع (التكافؤ مع CLMM).
• مسار قراءة عام للسجل، بحيث يمكن لواجهة المستخدم أن تخبر “غير مدعوم” من “غير مدعوم لكن مسجل” دون اشتقاق 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 — إنشاء نعناع أساسي Token-2022 في LaunchLab.
• raydium-launchpad/programs/launchpad/src/instructions/admin/create_config.rs — ربط نعناع مقتبس LaunchLab (بدون فحص امتداد).