الانتقال إلى المحتوى الرئيسي
يدور Ace Data Cloud X402 حاليًا حول تسوية USDC، ويدعم نوعين من السلاسل: EVM وSolana. تختلف طريقة التوقيع وعنوان الأصول وسلوك gas وسيناريوهات التطبيق بين الشبكات المختلفة، ويجب اختيار الشبكة جيدًا قبل التكامل.

تستخدم معرّفات الشبكة CAIP-2

إن accepts[].network في x402 v2 هو معرّف CAIP-2، وليس اختصارات مثل base وsolana. يجب على العميل مقارنة سلاسل CAIP-2 عند مطابقة الشبكة:

مصفوفة الدعم

يتوفر upto حاليًا على Base فقط. تخضع العناصر المتاحة فعليًا لما تُرجعه واجهة API من accepts. يمكنك أيضًا الاطلاع على Facilitator:
إرجاع Facilitator /supported:
توضيح النتائج:
  • إن exact على Base وSolana هو مسار دفع بمبلغ ثابت.
  • توفر Base فقط مسار القياس اللاحق upto، الذي يعتمد على approve لـ Permit2.
  • إن extra.facilitatorAddress في عنصر upto هو العنوان الذي يجب على العميل كتابته في witness عند التوقيع، ويجب أن يتطابق مع القيمة التي يُرجعها الخادم.

Base

تستخدم Base عقد USDC الرسمي:
في مخطط exact، يوقّع العميل EIP-712 TransferWithAuthorization. يشمل محتوى التوقيع:
  • from: عنوان محفظة الدفع
  • to: عنوان استلام Ace Data Cloud
  • value: مبلغ هذه الدفعة
  • validAfter / validBefore: نافذة صلاحية التوقيع
  • nonce: nonce عشوائي من 32 بايت
بعد أن يتحقق Facilitator من التوقيع، سيستدعي transferWithAuthorization الخاص بـ USDC على السلسلة لإتمام التحويل. Base هي شبكة التكامل الرسمية الأكثر توصية، وهي مناسبة بشكل خاص للقياس اللاحق upto، لأن منظومة Permit2 وUSDC والمحافظ أكثر نضجًا. مثال على نتيجة التحقق من Base exact:
توضيح النتائج:
  • يعيد API paid retry محتوى النموذج ADC_BASE_E2E_OK.
  • يمكن البحث عن المعاملة على السلسلة في BaseScan، ورقم الكتلة هو 46726299.
  • إن 95215 atomic USDC تعادل 0.095215 USDC، وهي مبلغ التسوية الفعلي لاستدعاء API هذا.
نتيجة تشغيل البرنامج لدفع الطلب عبر Base exact:
توضيح النتائج:
  • الحالة النهائية لطلب المنصة هي Finished.
  • يُكتب pay_id الخاص بالطلب في نفس هاش معاملة Base.
  • إن 1200000 atomic USDC تعادل 1.2 USDC، وهي المبلغ المدفوع تاريخيًا لطلب 10 Credits هذا بموجب السياسة القديمة؛ لم تعد الطلبات الجديدة تتمتع بخصم إضافي لطريقة دفع X402، ويخضع مبلغ التوقيع المحدد لاستجابة 402 هذه المرة.

Solana

تستخدم Solana SPL USDC TransferChecked. ينشئ العميل معاملة تحويل، ويوقّعها ويرسلها، ثم يضع توقيع المعاملة أو المعاملة المتسلسلة في envelope PAYMENT-SIGNATURE. خصائص Solana:
  • استخدام Solana wallet adapter أو base58 secret key؛
  • الأصل هو Solana USDC mint؛
  • يدعم حاليًا exact فقط؛
  • سيتحقق Facilitator من mint وdestination وauthority وamount الخاصة بـ transfer instruction.
إذا تم استخدام وضع wallet fee payer، فسترسل المحفظة المعاملة مباشرةً، ويتولى Facilitator تأكيد المعاملة وإرجاع نتيجة settlement. مثال على نتيجة التحقق من Solana 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 في الوقت الفعلي.