Add supported payment workflows to LangChain.

AgentCredia ଏକ real 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 କରନ୍ତୁ।

ଗୋଟିଏ ଇନ୍‌ସ୍ଟଲ୍। ଗୋଟିଏ ପରିବେଶ ଚଳକ। ପ୍ରସ୍ତୁତ।

ଏହି package କୁ Python 3.9 କିମ୍ବା ତାହାଠାରୁ ନୂତନ ଆବଶ୍ୟକ। ଏହା core agentcredia SDK ଏବଂ langchain-core କୁ dependencies ଭାବେ ନେଇଆସେ; ଆଉ କିଛି ଯୋଡ଼ିବାକୁ ନାହିଁ।

pip install agentcredia-langchain

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

AGENTCREDIA_API_KEY ହେଉଛି ଆପଣଙ୍କ AgentCredia dashboard ରୁ ମିଳୁଥିବା sk_test_ testnet କିମ୍ବା sk_live_ mainnet key। ଏହାହିଁ adapter ଦ୍ୱାରା ଆବଶ୍ୟକ ଏକମାତ୍ର variable; ଏହା key କୁ backend କୁ ପଠାଏ ଏବଂ ନିଜସ୍ୱ କୌଣସି secret ରଖେ ନାହିଁ। ନିମ୍ନରେ ଦେଖାଯାଇଥିବା webhook handler ପାଇଁ ଆପଣ AGENTCREDIA_WEBHOOK_SECRET ମଧ୍ୟ set କରନ୍ତି, ଯାହା dashboard webhook create କିମ୍ବା rotate କରିବାବେଳେ ଗୋଟିଏଥର ଦେଉଛି।

ବ୍ୟବହାରକାରୀ ଦେୟ କରିବା ପରେ କଣ ଘଟେ।

ଆପଣଙ୍କ agent ର webhook URL (AgentCredia dashboard ରେ ସେଟ୍ କରାଯାଇଥିବା) payment settle ହେଲେ ଗୋଟିଏ POST ଗ୍ରହଣ କରେ। webhook verify helper Node SDK ରେ ଅଛି, ସେଥିପାଇଁ ଆପଣଙ୍କ agent Python ହେଲେ ମଧ୍ୟ ଏହି handler TypeScript ରେ ଅଛି। ତଳେ ଗୋଟିଏ Express handler ଅଛି ଯାହା signature check କରେ ଏବଂ paid work ଚଲାଏ। ଯେକୌଣସି HTTP framework ରେ ସେହି pattern ବ୍ୟବହାର କରନ୍ତୁ।

import express from "express";
import { webhooks } from "@agentcredia/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.AGENTCREDIA_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 constant time ରେ HMAC-SHA256 କରେ ଏବଂ discriminated union ଫେରାଏ, ସେଥିପାଇଁ ଆପଣ try/catch ବିନା result.ok ଉପରେ branch କରନ୍ତୁ ଏବଂ result.eventType ପଢ଼ନ୍ତୁ। parsed copy ନୁହେଁ, raw body ପଢ଼ନ୍ତୁ: parse କରି ପୁନଃ serialize କଲେ signature ଭାଙ୍ଗିଯାଏ। shipped events ହେଉଛି payment.received, payment.sent, wallet.deployed, ଏବଂ webhook.test; ଆପଣଙ୍କ agent କୁ ଆସୁଥିବା inbound charge ହେଉଛି payment.received।

ପ୍ରଥମ ସଂଯୋଜନରେ ଦାନ୍ତ କାଟିବାକୁ ଯୋଗ୍ୟ ପାଞ୍ଚ ଜିନିଷ।

ଏହାଗୁଡିକ ଆମର ସମର୍ଥନ ଇନବକ୍ସରୁ ଆସିଛି। ଏହାର କୌଣସି ଏକ ଦେଲ-ବ୍ରେକର ନୁହେଁ, କିନ୍ତୁ ଏହାଗୁଡିକୁ ପୂର୍ବରୁ ଜାଣିବା ଏକ ଘଣ୍ଟାର ମୁଣ୍ଡ ଘୁରାଇବା ସଂରକ୍ଷଣ କରେ।