إجراء دفعة x402

استخدم Pay لتشغيل واجهة API من نوع x402 V2 ومنح Claude Code عميل HTTP يدعم الدفع. تعتمد واجهة API ومحفظة الدافع والتسوية جميعها على البيئة التجريبية في سولانا، لذا لا يتطلب هذا الدليل حسابًا أو أموالًا حقيقية.

تحتاج إلى طرفية (terminal) وتثبيت Pay وClaude Code.

1. تثبيت Pay

على macOS، ثبّت الملف التنفيذي المُجهَّز مسبقًا:

brew install pay
pay --version

على المنصات الأخرى، ثبّت حزمة npm:

npm install --global @solana/pay
pay --version

2. تشغيل واجهة API تجريبية لـ x402

أنشئ الملف x402-demo.yaml:

name: x402-demo
subdomain: x402-demo
title: "x402 Demo"
description: "Minimal x402 V2 sandbox endpoint."
category: devtools
version: v1
routing:
  type: respond
operator:
  currencies:
    usd: ["USDC"]
  network: "localnet"
  fee_payer: true
endpoints:
  - method: GET
    path: "report"
    description: "Return a sandbox report."
    metering:
      schemes: [x402-exact]
      dimensions:
        - direction: usage
          unit: requests
          scale: 1
          tiers:
            - price_usd: 0.001

شغّل واجهة API واتركها قيد التشغيل:

pay --sandbox server start x402-demo.yaml --bind 127.0.0.1:1402

يجعل المخطط x402-exact هذه النقطة الطرفية خاصة بـ x402 فقط. ينشئ الوضع التجريبي حسابات مؤقتة للمشغّل والدافع ويموّلها تلقائيًا.

3. تشغيل الوكيل باستخدام Pay

في طرفية أخرى، شغّل Claude Code في الوضع التجريبي:

pay --sandbox claude

يربط Pay أدوات MCP المحلية الخاصة به بجلسة الوكيل. ولا يتلقى الوكيل أي مفتاح خاص.

4. إجراء طلب x402 واحد

الصق هذه المطالبة في الوكيل:

Use Pay to make exactly one sandbox x402 API request to
http://127.0.0.1:1402/report.

Before paying, show me the amount and ask for approval. Then return the API
result and payment receipt. Do not make any other paid requests.

يتبع الطلب حلقة دفع x402 V2 كاملة:

1. تُرجع واجهة API الاستجابة 402 Payment Required مع تحدٍّ PAYMENT-REQUIRED.
2. يتحقق Pay من متطلبات x402 ويعرض شروط الدفع.
3. بعد الموافقة، توقّع المحفظة التجريبية ويعيد Pay محاولة الطلب مع PAYMENT-SIGNATURE.
4. تُرجع واجهة API النتيجة مع إيصال PAYMENT-RESPONSE.

لا تُنقل أي أموال حقيقية. ويؤدي رفض الموافقة إلى إيقاف الطلب.

تابع مع x402 على سولانا لبناء عميل x402 V2 وخادم موارد، أو كن ميسّر x402.