Blockchain0x ஒரு உண்மையான Python package-ஐ, , வழங்குகிறது; இது ஒரு LangChain agent-க்கு native wallet tools-ஐ தருகிறது: Base-ல் USDC அனுப்ப, on-chain proof உடன் invoice-ஐ settle செய்ய, மேலும் wallets மற்றும் transactions-ஐ படிக்க. அதை install செய்து, ஐ set செய்து, ஐ call செய்து, அந்த tools-ஐ உங்கள் agent-க்கு கொடுங்கள். TypeScript-ல்? npm adapter இல்லை - x402 client-ஐ LangChain.js tool-ஆக wrap செய்யுங்கள்.

ஒரு நிறுவல். ஒரு சுற்றுப்புற மாறி. தயாராக.

தொகுப்பு Python 3.9 அல்லது புதியதாக இருக்க வேண்டும். இது அடிப்படை blockchain0x SDK மற்றும் langchain-core ஐ சார்ந்ததாகக் கொண்டுள்ளது; மேலும் எதுவும் சேர்க்க வேண்டாம்.

pip install blockchain0x-langchain

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

BLOCKCHAIN0X_API_KEY என்பது உங்கள் Blockchain0x dashboard-இல் உள்ள sk_test_ testnet அல்லது sk_live_ mainnet key ஆகும். adapter-க்கு தேவைப்படும் ஒரே மாறி அதுதான்; அது key-ஐ backend-க்கு அனுப்புகிறது மற்றும் தனியாக எந்த secret-ஐயும் வைத்திருக்காது. கீழே காட்டப்பட்டுள்ள webhook handler-க்கு நீங்கள் BLOCKCHAIN0X_WEBHOOK_SECRET-ஐயும் அமைக்க வேண்டும், webhook-ஐ create அல்லது rotate செய்யும் போது dashboard அதை ஒருமுறை வழங்கும்.

பயனர் பணம் செலுத்திய பிறகு என்ன நடக்கிறது.

உங்கள் agent-இன் webhook URL (Blockchain0x dashboard-இல் அமைக்கப்பட்டது) payment settle ஆனபோது ஒரு POST-ஐ பெறுகிறது. webhook verify helper Node SDK-இல் உள்ளது, எனவே உங்கள் agent Python ஆனாலும் இந்த handler TypeScript ஆகும். கீழே உள்ள Express handler signature-ஐ சரிபார்த்து, கட்டணமான பணியை இயக்குகிறது. இதே pattern-ஐ எந்த HTTP framework-இலும் பயன்படுத்தவும்.

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-ஐ constant time-இல் செய்கிறது மற்றும் ஒரு discriminated union-ஐ return செய்கிறது, ஆகவே try/catch இல்லாமல் result.ok-ஐ வைத்து branch செய்து result.eventType-ஐ படிக்கலாம். parsed copy அல்ல, raw body-ஐ படிக்கவும்: parse செய்து பின்னர் மீண்டும் serialize செய்வது signature-ஐ உடைக்கும். வழங்கப்பட்ட events payment.received, payment.sent, wallet.deployed, மற்றும் webhook.test; உங்கள் agent-க்கு வரும் inbound charge என்பது payment.received.

முதல் ஒருங்கிணைப்பில் கசப்பாக்கும் ஐந்து விஷயங்கள்.

இவை எங்கள் ஆதரவு மின்னஞ்சலிலிருந்து வருகின்றன. இவைகளில் எவையும்தான் ஒப்பந்தத்தை உடைக்கும், ஆனால் இவற்றைப் பற்றிய தகவல் முன்கூட்டியே தெரிந்தால் ஒவ்வொன்றும் ஒரு மணி நேரம் சிந்திக்கச் சேமிக்கிறது.