Blockchain0x ഒരു യഥാർത്ഥ Python package, , നൽകുന്നു; ഇത് ഒരു LangChain agent-ന് native wallet tools നൽകുന്നു: Base-ൽ USDC അയയ്ക്കുക, on-chain proof ഉപയോഗിച്ച് invoice settle ചെയ്യുക, wallets, transactions എന്നിവ വായിക്കുക. ഇത് install ചെയ്യുക, സജ്ജീകരിക്കുക, വിളിക്കുക, തുടർന്ന് 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 കീ ആണ്. adapter-ിന് ആവശ്യമായ ഏക variable അതാണ്; അത് key backend-ലേക്ക് forward ചെയ്യുന്നു, സ്വതന്ത്ര secret ഒന്നും സൂക്ഷിക്കുന്നില്ല. താഴെ കാണിച്ചിരിക്കുന്ന webhook handler-ിന് നിങ്ങൾ BLOCKCHAIN0X_WEBHOOK_SECRET കൂടി set ചെയ്യണം, ഇത് ഒരു webhook create ചെയ്യുമ്പോഴോ rotate ചെയ്യുമ്പോഴോ dashboard ഒരിക്കൽ return ചെയ്യും.

ഉപയോക്താവ് പണം നൽകുന്നതിന് ശേഷം എന്താണ് സംഭവിക്കുന്നത്.

നിങ്ങളുടെ ഏജന്റിന്റെ വെബ്ഹുക്ക് URL (Blockchain0x ഡാഷ്ബോർഡിൽ സജ്ജീകരിച്ച) ഒരു പേയ്മെന്റ് തീരുമ്പോൾ ഒരു POST സ്വീകരിക്കുന്നു. വെബ്ഹുക്ക് സ്ഥിരീകരണ സഹായി Node SDK-യിൽ ആണ്, അതിനാൽ നിങ്ങളുടെ ഏജന്റ് പൈതൺ ആണെങ്കിലും ഈ ഹാൻഡ്ലർ TypeScript ആണ്. ഒപ്പം സിഗ്നേച്ചർ പരിശോധിക്കുന്ന ഒരു എക്സ്പ്രസ് ഹാൻഡ്ലർ ആണ്, പേയ്ഡ് ജോലികൾ പ്രവർത്തിക്കുന്നു. ഏതെങ്കിലും 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 നടത്തുകയും discriminated union തിരികെ നൽകുകയും ചെയ്യുന്നു, അതിനാൽ try/catch ഇല്ലാതെ result.ok പ്രകാരം branch ചെയ്ത് result.eventType വായിക്കാം. raw body തന്നെ വായിക്കുക, parsed copy അല്ല: parse ചെയ്ത് വീണ്ടും serialize ചെയ്യുന്നത് signature തകർക്കും. നൽകിയിരിക്കുന്ന events payment.received, payment.sent, wallet.deployed, webhook.test എന്നിവയാണ്; നിങ്ങളുടെ agent-ലേക്ക് വരുന്ന inbound charge payment.received ആണ്.

ആദ്യ ഇന്റഗ്രേഷനിൽ കടിക്കാനുള്ള അഞ്ചു കാര്യങ്ങൾ.

ഇവ നമ്മുടെ പിന്തുണ ഇൻബോക്സിൽ നിന്നാണ്. ഇവയിൽ ഒന്നും ഇടപാടുകൾ തകരാൻ കാരണമല്ല, പക്ഷേ അവയെ മുൻകൂട്ടി അറിയുന്നത് ഓരോന്നിനും ഒരു മണിക്കൂർ തലച്ചോറിന്റെ കുഴപ്പങ്ങൾ സംരക്ഷിക്കുന്നു.