Blockchain0x มี Python package จริงชื่อ ที่มอบเครื่องมือวอลเล็ทแบบ native ให้กับเอเจนต์ LangChain: ส่ง USDC บน Base, ชำระ invoice พร้อมหลักฐานบนเชน, และอ่านวอลเล็ทกับธุรกรรม ติดตั้งมัน ตั้งค่า เรียก แล้วส่งเครื่องมือให้เอเจนต์ของคุณ บน TypeScript? ไม่มี npm adapter - ให้ wrap x402 client เป็นเครื่องมือ LangChain.js

ติดตั้งหนึ่งครั้ง ตัวแปรสภาพแวดล้อมหนึ่งตัว พร้อม

แพ็คเกจต้องการ Python 3.9 หรือใหม่กว่า มันดึง SDK blockchain0x หลักและ langchain-core เป็นการพึ่งพา ไม่มีอะไรเพิ่มเติม.

pip install blockchain0x-langchain

export BLOCKCHAIN0X_API_KEY=sk_test_...   # sk_test_ = Base Sepolia, sk_live_ = Base mainnet

BLOCKCHAIN0X_API_KEY คือคีย์ sk_test_ สำหรับ testnet หรือ sk_live_ สำหรับ mainnet จากแดชบอร์ด Blockchain0x ของคุณ นั่นคือตัวแปรเดียวที่ adapter ต้องใช้ โดยมันส่งคีย์ไปยัง backend และไม่ได้เก็บ secret ใดของตัวเอง สำหรับ webhook handler ที่แสดงด้านล่าง คุณต้องตั้งค่า BLOCKCHAIN0X_WEBHOOK_SECRET เพิ่มเติมด้วย ซึ่งแดชบอร์ดจะแสดงให้เห็นเพียงครั้งเดียวเมื่อคุณสร้างหรือหมุนเวียน webhook

เกิดอะไรขึ้นหลังจากที่ผู้ใช้ชำระเงิน

URL webhook ของเอเจนต์ของคุณ (ตั้งค่าในแดชบอร์ด Blockchain0x) จะได้รับ POST เมื่อการชำระเงินตั้งอยู่ ตัวช่วยตรวจสอบ webhook อยู่ใน Node SDK ดังนั้นตัวจัดการนี้จึงเป็น TypeScript แม้ว่าเอเจนต์ของคุณจะเป็น Python ด้านล่างนี้คือตัวจัดการ Express ที่ตรวจสอบลายเซ็นและดำเนินการทำงานที่ชำระเงิน ใช้รูปแบบเดียวกันในกรอบ HTTP ใดๆ

import express from "express";
import { webhooks } from "@blockchain0x/node";

const app = express();
// Capture the RAW body. The HMAC is over the exact bytes on the wire.
app.use(express.raw({ type: "application/json" }));

app.post("/webhooks/payment", (req, res) => {
  const result = webhooks.verify({
    headers: req.headers,
    rawBody: req.body, // Buffer, raw bytes
    secret: process.env.BLOCKCHAIN0X_WEBHOOK_SECRET!,
  });
  if (!result.ok) return res.status(400).json({ code: result.code });

  if (result.eventType === "payment.received") {
    // USDC landed in your agent wallet - do the paid work
  }
  res.status(200).send("ok");
});

webhooks.verify ทำ HMAC-SHA256 ในเวลาคงที่และส่งคืนการรวมที่แยกแยะ ดังนั้นคุณจึงแยกตาม result.ok โดยไม่ต้องใช้ try/catch และอ่าน result.eventType อ่าน body ดิบ ไม่ใช่สำเนาที่ถูกวิเคราะห์: การวิเคราะห์แล้วทำการเรียกคืนจะทำให้ลายเซ็นเสียหาย เหตุการณ์ที่ส่งมาคือ payment.received, payment.sent, wallet.deployed และ webhook.test; การเรียกเก็บเงินที่เข้ามาสำหรับตัวแทนของคุณคือ payment.received.

ห้าสิ่งที่ทำให้เจ็บในการรวมระบบครั้งแรก

สิ่งเหล่านี้มาจากกล่องจดหมายสนับสนุนของเรา ไม่มีรายการใดเป็นอุปสรรคในการทำข้อตกลง แต่การทราบเกี่ยวกับพวกเขาล่วงหน้าช่วยประหยัดเวลาในการคิดมากได้หนึ่งชั่วโมงต่อรายการ