التحدث إلى الوكلاء

أردت أن أرى ما إذا كان بإمكان أحد الوكلاء الدفع مقابل إرسال رسالة إليّ.

ليس شخصًا يملأ نموذج اتصال. وليس اختبار CAPTCHA. بل وكيل لديه محفظة، ومهمة، ورغبة في التواصل معي.

أنا لست فريدًا. أنا مجرد شخص عادي قد يرغب الكمبيوتر في التحدث إليه.

يمكن لأي شخص التواصل معي على LinkedIn أو X متى شاء، كما هو موضح في صفحة الاتصال.

إذا وضعت نقطة اتصال على هذا الموقع، فسأحصل على صندوق بريد وارد جديد لأراقبه. رسائل غير مرغوب فيها، وروبوتات، وتواصل غير مرغوب فيه. اختبار CAPTCHA يمنع البشر. الدفع يمنع الجميع، لكن بطاقات الائتمان تمنع البشر أيضًا. كنت بحاجة إلى شيء متأصل في طريقة عمل الوكلاء.

x402 هو هذا البوابة. إنه بروتوكول مبني على HTTP 402 Payment Required، رمز الحالة الذي خصصه الإنترنت للمدفوعات ولكن لم يتم تعريفه أبدًا. x402 يحدده. يقوم الخادم بإرجاع 402 مع سعر وعنوان stablecoin. يقرأ الوكيل الرد، ويوقع على تصريح باستخدام محفظته، ويعيد المحاولة مع رأس دفع، ويقوم الخادم بالتسوية على السلسلة. لا توجد صفحة دفع. لا يوجد نموذج. لا يوجد حساب. مجرد رمز حالة وتوقيع.

هذه تجربة سيئة للغاية بالنسبة للشخص العادي. لكنها تجربة رائعة بالنسبة للوكيل.

كيف يعمل

توجد نقطة النهاية في /contact/send على هذا الموقع. يكتشف الوكيل ذلك من خلال مواصفات OpenAPI أو agents.md. لا يحتوي أول POST على رأس دفع. يعرض الخادم رمز 402 مع السعر والأصول المقبولة ومخطط يصف الحقول التي يجب تضمينها. لا يحتاج الوكيل إلى وثائق بخلاف الرد نفسه.

sequenceDiagram
    participant Human as Human
    participant Agent as Agent
    participant Site as benmilne.com
    participant Facilitator as x402 Facilitator
    participant Chain as Blockchain
    participant Admin as Admin Panel

    Human-->>Agent: "Contact Ben Milne about X"
    Agent-->>Site: POST /contact/send (no payment)
    Site-->>Agent: 402 + price + assets + field schema
    Agent-->>Agent: Sign stablecoin permit
    Agent-->>Site: POST + PAYMENT-SIGNATURE + message body
    Site-->>Facilitator: Verify signature
    Facilitator-->>Site: Valid
    Site-->>Facilitator: Settle
    Facilitator->>Chain: On-chain transfer (SBC)
    Chain-->>Facilitator: Tx hash
    Facilitator-->>Site: Settlement confirmed
    Site-->>Site: Store message in D1
    Site-->>Agent: 200 + receipt with tx hash
    Admin-->>Admin: Message appears with block explorer link

    rect rgba(200, 120, 50, 0.08)
    Note over Human,Admin: Future: callback URL enables two-way communication
    end

تدير شركة Stable Coin Company وسيطًا يتحقق من التصريح الموقع من الوكيل وينفذ التحويل على السلسلة، ويدفع رسوم الغاز نيابة عن الطرفين. لا يحتاج الوكيل إلى الاحتفاظ بـ ETH أو SOL. فهو يحتفظ بأصل واحد، وهو الأصل الذي يدفع به.

البدء

لقد كتبت مكتبة صغيرة تسمى x402-payment-path لهذا الغرض. وهي تتولى معالجة التحدي 402، والتحقق من التوقيع، والتسوية، وإنشاء الإيصالات.

البروتوكول الأساسي هو x402، وهو معيار الدفع الأصلي لـ "stablecoin" الذي أطلقته Coinbase كمصدر مفتوح وتقوم مؤسسة x402 الآن بصيانته كمشروع تابع لمؤسسة Linux. تدير شركة Stable Coin Company الميسر، الذي يدعم كلاً من "USDC" و SBC على Base و Solana و Radius. استخدمت SBC لأنه الأصل الذي أعرفه أفضل.

إذا كنت ترغب في تطبيق هذا على منتج بدلاً من رسالة، فستقوم بتغيير ما يحدث بعد الدفع. بدلاً من تخزين رسالة، ستقوم بإنشاء رابط تنزيل، أو تشغيل webhook، أو بدء عملية شحن. لا تهتم المكتبة بطبيعة الإجراء. فهي تربط الإجراء بالدفع.

القرارات

تقبل نقطة النهاية كلاً من USDC و SBC. استخدمت SBC لأنه الأصل الذي أعرفه أفضل والأصل الذي أردت التحقق منه من البداية إلى النهاية على كلتا السلسلتين.

لدي محفظتان. تتلقى محفظتي EVM SBC على Base. وتتلقى محفظة Solana منفصلة SBC على Solana. نفس نقطة النهاية، نفس السعر، قنوات تسوية مختلفة.

تصل الرسائل إلى جدول D1. أقرأها في لوحة الإدارة. لا إعادة توجيه للبريد الإلكتروني، ولا صندوق وارد لمراقبته. لا ينبغي أن تكون الرسالة قادرة على فعل أي شيء سوى أن تكون رسالة.

السعر هو 0.10 دولار. مرتفع بما يكفي لجعل البريد العشوائي غير مربح. منخفض بما يكفي ليكون تافهًا بالنسبة لوكيل شرعي.

إنها تعمل

فيما يلي معاملات حقيقية من 13 يونيو 2026. كلفت كل رسالة 0.10 دولار في SBC. تمت التسوية على السلسلة.

المرسل	الشبكة	المبلغ	المعاملة
cursor-agent/0.46.2	الأساس	0.10 دولار SBC	0x5265bdd1…963cd · BaseScan
deal-flow-scout@vcscan.ai	Base	0.10 دولار SBC	0xe0aa91c4…4313d · BaseScan
claude-research-agent/1.2	Base	0.10 دولار SBC	0xb0c96326…4dd05 · BaseScan
e2e-test-agent	Base	0.10 دولار SBC	0x0fca4265…c1b08 · BaseScan
e2e-test-agent	سولانا	0.10 دولار SBC	2typCyWo…hsYc · Solscan

هذه هي لوحة الإدارة الخاصة بي. سبع رسائل. Base و Solana. تمت تسوية كل واحدة منها على السلسلة قبل ظهورها.

إرسال رسالة إلي

إذا كنت تقوم بإنشاء وكيل، فإن نقطة النهاية هي POST benmilne.com /contact/send. وهي موثقة في مواصفات OpenAPI و agents.md.

POST بدون رأس دفع ويقوم الخادم بإرجاع 402 مع كل ما تحتاجه. تتولى مكتبة عميل x402 التوقيع وإعادة المحاولة من هناك. السعر هو 0.10 دولار. SBC و USDC على Base و Solana. إذا قمت بتضمين عنوان URL للرد، فسأتمكن من الرد على هذا العنوان في المستقبل.

ما تعلمته

الاستجابة 402 هي فاتورة قابلة للقراءة آليًا. لا يحتاج الوكيل إلى واجهة مستخدم. إنه يحتاج إلى سعر وعنوان أصل وشبكة. يقوم بالتوقيع والدفع وإعادة المحاولة.

حاولت إضافة دعم USDC من خلال ميسرين مجتمعيين يعلنون عن أنفسهم على أنهم لا يحتاجون إلى مفتاح. لم يعمل أي منهم بدون إذن. أحدهم تطلب تسجيل العنوان. وآخر كان يعاني من عدم توافق الإصدارات. كان SBC من خلال The Stable Coin Company هو الميسر الوحيد الذي عمل دون أي إعداد على الإطلاق. لا مفاتيح، ولا حسابات، ولا تسجيل. هذا أمر مهم إذا كنت تريد أن يتمكن الوكلاء من الدفع دون أن يقوم شخص ما بتكوين شيء ما أولاً.

هناك شيء آخر فاجأني أيضًا: استمر كل من MetaMask و Phantom في إخفاء SBC في محفظتي، حتى بعد أن وافقت عليه عدة مرات. كنت أضيف الرمز المميز، وأؤكد المعاملة، وأتحقق من رصيدي، ثم يختفي الأصل مرة أخرى. حدث هذا مرارًا وتكرارًا أثناء الاختبار. لا أشعر سوى بالاحترام تجاه كلا الفريقين، لكن الاضطرار إلى إخبار محفظتي على جهازي الخاص أنني أريد استخدام أصولي الخاصة من جهة إصدار خاضعة للتنظيم، مرارًا وتكرارًا، كان أمرًا سخيفًا. الإنترنت واسع. يجب أن تثق المحافظ في الخيارات التي اتخذها مستخدموها بالفعل.

الرمز الذي استخدمته لهذا الغرض مفتوح المصدر، ولديك الحرية في فعل ما تريد به، على افتراض أن MetaMask أو Phantom لا تريدان التأثير على ما تفعله بدلاً من ذلك.