تستخدم معرّفات الشبكة CAIP-2
إنaccepts[].network في x402 v2 هو معرّف CAIP-2، وليس اختصارات مثل base وsolana. يجب على العميل مقارنة سلاسل CAIP-2 عند مطابقة الشبكة:
مصفوفة الدعم
يتوفر
upto حاليًا على Base فقط. تخضع العناصر المتاحة فعليًا لما تُرجعه واجهة API من accepts. يمكنك أيضًا الاطلاع على Facilitator:
/supported:
- إن
exactعلى Base وSolana هو مسار دفع بمبلغ ثابت. - توفر Base فقط مسار القياس اللاحق
upto، الذي يعتمد على approve لـ Permit2. - إن
extra.facilitatorAddressفي عنصرuptoهو العنوان الذي يجب على العميل كتابته في witness عند التوقيع، ويجب أن يتطابق مع القيمة التي يُرجعها الخادم.
Base
تستخدم Base عقد USDC الرسمي:exact، يوقّع العميل EIP-712 TransferWithAuthorization. يشمل محتوى التوقيع:
from: عنوان محفظة الدفعto: عنوان استلام Ace Data Cloudvalue: مبلغ هذه الدفعةvalidAfter/validBefore: نافذة صلاحية التوقيعnonce: nonce عشوائي من 32 بايت
transferWithAuthorization الخاص بـ USDC على السلسلة لإتمام التحويل.
Base هي شبكة التكامل الرسمية الأكثر توصية، وهي مناسبة بشكل خاص للقياس اللاحق upto، لأن منظومة Permit2 وUSDC والمحافظ أكثر نضجًا.
مثال على نتيجة التحقق من Base exact:
- يعيد API paid retry محتوى النموذج
ADC_BASE_E2E_OK. - يمكن البحث عن المعاملة على السلسلة في BaseScan، ورقم الكتلة هو
46726299. - إن
95215atomic USDC تعادل0.095215USDC، وهي مبلغ التسوية الفعلي لاستدعاء API هذا.
exact:
- الحالة النهائية لطلب المنصة هي
Finished. - يُكتب
pay_idالخاص بالطلب في نفس هاش معاملة Base. - إن
1200000atomic USDC تعادل1.2USDC، وهي المبلغ المدفوع تاريخيًا لطلب 10 Credits هذا بموجب السياسة القديمة؛ لم تعد الطلبات الجديدة تتمتع بخصم إضافي لطريقة دفع X402، ويخضع مبلغ التوقيع المحدد لاستجابة 402 هذه المرة.
Solana
تستخدم Solana SPL USDCTransferChecked. ينشئ العميل معاملة تحويل، ويوقّعها ويرسلها، ثم يضع توقيع المعاملة أو المعاملة المتسلسلة في envelope PAYMENT-SIGNATURE.
خصائص Solana:
- استخدام Solana wallet adapter أو base58 secret key؛
- الأصل هو Solana USDC mint؛
- يدعم حاليًا
exactفقط؛ - سيتحقق Facilitator من mint وdestination وauthority وamount الخاصة بـ transfer instruction.
exact:
- أعاد paid retry بالفعل HTTP 200، وأنتج النموذج
ADC_SOLANA_E2E_OK. - قد تواجه استعلامات RPC العامة عن signature على السلسلة تقييدًا للمعدل.
- نظرًا إلى أن استعلامات RPC العامة قد تكون مقيّدة للمعدل، لا يُكتب هنا Solana explorer. عند الحاجة إلى تسوية صارمة، يُرجى استخدام Solana RPC الخاص بك أو سجلات تسوية المنصة لتأكيد توقيع المعاملة.
كيفية الاختيار
بغض النظر عن السلسلة التي تختارها، لا تقم بترميز الأسعار بشكل ثابت في العميل. يتحدد السعر بواسطة
accepts[].maxAmountRequired الذي يُرجعه الخادم.
إضافة شبكات EVM جديدة
يتوفر دعم برمجي لمدفوعات USDC الأصلية ذات المبلغ الثابت على الشبكات التالية، ويتم فتحها لكل شبكة على حدة. يعتمد التوفر علىaccepts الذي يعيده الطلب أو واجهة API؛ ولا يعني أن جميع الشبكات مفعّلة في بيئة الإنتاج.
تدعم هذه الشبكات
exact فقط، ودقة العملة هي 6. لا تستخدم USDC المربوط الذي يحمل الاسم نفسه.
عند استخدام X402 Client الرسمي لـ TypeScript/Python، يمكنك تمرير الاسم المختصر في الجدول أو معرّف CAIP-2.
يستخدم العميل معرّف السلسلة المستهدفة لإنشاء التوقيع؛ ويجب أن تدعم المحفظة الشبكة المستهدفة.
يسرد جدول الدعم الرسمي لمحفظة Phantom الإضافية Arbitrum وPolygon؛ بينما لا تُدرج Optimism وAvalanche
حاليًا في هذا الجدول، ويمكن استخدام Rabby أو MetaMask اللتين تدعمان السلسلة المستهدفة. يمكن أن يكون عنوان EVM
متطابقًا عبر سلاسل مختلفة، لكن الأرصدة مستقلة عن بعضها، ولا ينطبق عنوان Solana على USDC الخاص بـ EVM.
راجع جدول دعم محفظة Phantom.
نقطة دخول التدرج للشبكات الجديدة
تكون نقطة دخول السلسلة الجديدة مخفية افتراضيًا. عند الوصول إلى لوحة التحكم أو Studio، يمكنك استخدام?features=x402-arbitrum
لتفعيل السلسلة المقابلة، وتُفصل عدة علامات بفواصل. لإيقاف سلسلة واحدة استخدم ?features=-x402-arbitrum،
ولمسح التجاوزات المحلية استخدم ?features=none۔ يتم حفظ المفاتيح لكل نطاق على حدة.
تستخدم عروض أسعار الطلبات وإعادة محاولة الدفع المفتاح نفسه، ويتحقق الخادم بشكل مستقل؛ ولا يزال بالإمكان عرض سجلات الدفع الموجودة.
إن تفعيل علامة الصفحة فقط لا يفعّل سلسلة لم تُضبط بعد، وتبقى الشبكات القابلة للدفع فعليًا خاضعة لـ accepts في الوقت الفعلي.
