Blockchain0x, bir LangChain ajanına yerel cüzdan araçları sağlayan gerçek bir Python paketi, , sunar: Base üzerinde USDC gönderin, zincir üstü kanıtla bir faturayı kapatın ve cüzdanlar ile işlemleri okuyun. Kurun, ayarlayın, çağırın ve araçları ajanınıza verin. TypeScript'te mi? Bir npm adapter yok - x402 client'ı bir LangChain.js tool içine sarın.

Bir kurulum. Bir ortam değişkeni. Hazır.

Paketin Python 3.9 veya daha yenisi gereklidir. Temel blockchain0x SDK'sını ve langchain-core'u bağımlılık olarak çeker; ekleyecek başka bir şey yoktur.

pip install blockchain0x-langchain

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

BLOCKCHAIN0X_API_KEY, Blockchain0x dashboard'unuzdan alınan bir sk_test_ testnet veya sk_live_ mainnet anahtarıdır. Adapter'ın ihtiyaç duyduğu tek değişken budur; anahtarı backend'e iletir ve kendi içinde hiçbir sır tutmaz. Aşağıda gösterilen webhook handler için ayrıca BLOCKCHAIN0X_WEBHOOK_SECRET ayarlarsınız; bu değer, bir webhook oluşturduğunuzda veya rotate ettiğinizde dashboard tarafından bir kez gösterilir.

Kullanıcı ödendikten sonra ne olur.

Agent'ınızın webhook URL'si (Blockchain0x dashboard'da ayarlanır), bir ödeme settle olduğunda bir POST alır. Webhook verify helper Node SDK içindedir, bu yüzden agent'ınız Python olsa da bu handler TypeScript'tir. Aşağıda signature'ı kontrol eden ve ücretli işi çalıştıran bir Express handler'ı var. Aynı pattern'i herhangi bir HTTP framework'ünde kullanın.

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, sabit zamanda HMAC-SHA256 yapar ve ayrıştırılmış bir birleşim döndürür, bu nedenle result.ok üzerinde try/catch olmadan dallanırsınız ve result.eventType'ı okursunuz. Ham gövdeyi okuyun, ayrıştırılmış bir kopyayı değil: ayrıştırma ve ardından yeniden serileştirme imzayı bozar. Gönderilen olaylar payment.received, payment.sent, wallet.deployed ve webhook.test'tir; ajana gelen bir ücret payment.received'dır.

İlk entegrasyonda sorun çıkaran beş şey.

Bunlar destek gelen kutumuzdan gelmektedir. Hiçbiri anlaşma bozucu değildir, ancak önceden bilmek, her birinde bir saat kafa karışıklığı tasarrufu sağlar.