Blockchain0x поставляет реальный Python package, , который дает агенту LangChain нативные инструменты кошелька: отправлять USDC на Base, закрывать счет с on-chain proof и читать кошельки и транзакции. Установите его, задайте , вызовите и передайте инструменты вашему агенту. На TypeScript? npm adapter нет - оберните 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 из вашего dashboard Blockchain0x. Это единственная переменная, которая нужна адаптеру; он передает ключ на backend и не хранит собственных секретов. Для показанного ниже обработчика webhook также задайте BLOCKCHAIN0X_WEBHOOK_SECRET, который dashboard выдает один раз при создании или ротации webhook.

Что происходит после того, как пользователь платит.

URL вебхука вашего агента (установленный на панели управления Blockchain0x) получает POST, когда платеж завершается. Помощник проверки вебхука находится в 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. Читайте сырое тело, а не разобранную копию: разбор, а затем повторная сериализация нарушает подпись. Доставленные события: payment.received, payment.sent, wallet.deployed и webhook.test; входящий платеж вашему агенту - это payment.received.

Пять вещей, которые подводят при первой интеграции.

Эти данные поступают из нашего почтового ящика поддержки. Ни одно из них не является критическим, но знание о них заранее экономит по часу размышлений на каждом.