@acedatacloud/x402-client توقيع ترويسة طلب PAYMENT-SIGNATURE عند مواجهة 402 Payment Required.
عناوين المصدر والحزم:
- مستودع SDK: https://github.com/AceDataCloud/SDK
- مستودع X402 Client: https://github.com/AceDataCloud/X402Client
- npm SDK: https://www.npmjs.com/package/@acedatacloud/sdk
- npm X402 Client: https://www.npmjs.com/package/@acedatacloud/x402-client
تثبيت التبعيات
@solana/web3.js:
- يمكن تثبيت كل من
@acedatacloud/sdkو@acedatacloud/x402-clientمن npm واستيرادهما بواسطة Node.js. - يُستخدم
ethersلتوقيع EVM typed data، ويُستخدم@solana/web3.jsلبناء Solana transaction.
مثال Base
يمكن استخدامwindow.ethereum مباشرة في المتصفح. في Node.js، يمكن تغليف ethers.Wallet بطبقة provider بأسلوب EIP-1193.
مثال محفظة المتصفح
عند استخدام MetaMask أو Coinbase Wallet أو WalletConnect في تطبيق الواجهة الأمامية، يُمرَّر عادةً EIP-1193 provider مباشرةً:مثال Solana
تستخدم Solana SPL USDCTransferChecked. يجب أن يكشف wallet adapter المُمرَّر عن publicKey وsignAndSendTransaction.
exact فقط، ولا يدعم upto. إذا أعاد API عدة accepts، فسيختار handler العنصر الذي له network = 'solana'.
تم التحقق من أن paid retry لمسار Solana على نفس API العام يمكن أن يعيد HTTP 200 وADC_SOLANA_E2E_OK. قد تخضع استعلامات RPC العامة لتحديد المعدل، لذلك لا تكتب هذه المقالة Solana tx hash؛ عند الحاجة إلى المطابقة على السلسلة، يرجى استخدام Solana RPC الخاص بك أو تأكيد سجلات وحدة التحكم.
اختيار exact أو upto
سيختار TypeScript handler الحالي أول payment requirement للشبكة المطابقة يعيدها الخادم. يضع API الخاص بـ Ace Data Cloud عادةً exact للشبكة نفسها قبل upto، لذلك إذا كنت تريد صراحةً استخدام القياس المؤجل، تحتاج إلى تمرير preferScheme: 'upto'.
مثال:
upto requirement لتلك الشبكة، فسيرجع handler تلقائيًا إلى أول requirement متاح لتلك الشبكة، والذي يكون عادةً exact.
يتطلب upto تفويض Permit2 لمرة واحدة. يُوفر upto حاليًا على Base فقط، لذلك تحتاج فقط إلى تنفيذ تفويض واحد لـ Base USDC:
upto التحقق من API العام: HTTP 402 -> HTTP 200، ومعاملة settlement المؤجلة هي 0x4b0b836ce1cd1171cdbc37df1637150b024214ec28e7f6f2d09122f15cbfc036. راجع شرح خطة الفوترة للحصول على المخرجات الكاملة.
ما الذي تفعله SDK
سينفذ transport الخاص بـ@acedatacloud/sdk payment handler مرة واحدة عند استلام 402:
@acedatacloud/x402-client بما يلي:
- اختيار payment requirement للشبكة المستهدفة من
ctx.accepts. - بناء توقيع EVM EIP-712 أو Solana transfer transaction وفقًا للشبكة.
- تسلسل envelope إلى Base64.
- إرجاع
{ headers: { 'PAYMENT-SIGNATURE': '<base64>' } }. - تعيد SDK المحاولة تلقائيًا باستخدام نص الطلب الأصلي.

