@payroute/x402-sdk 1.0.1 → 1.0.2

package/README.md

@@ -15,11 +15,9 @@ This SDK abstracts the complexity of **HTTP 402 Pay-Per-Hit** workflows, enablin
 ## Installation
 
 ```bash
-npm install @payroute/x402-sdk ethers
+npm install @payroute/x402-sdk
 ```
 
-_Note: `ethers` peer dependency (v6) is required._
-
 ## Quick Start
 
 ### 1. Initialize the Service
@@ -43,7 +41,7 @@ Use this method for direct peer-to-peer payments to a receiver.
 
 ```typescript
 try {
-  const content = await service.getProxyEndpoint("test09");
+  const content = await service.getProxyEndpoint("MantleDocs");
   console.log("Accessed Content:", content);
 } catch (error) {
   console.error("Payment or Fetch Failed:", error);
@@ -56,7 +54,7 @@ Use this method when the gateway requires payment via an escrow smart contract.
 
 ```typescript
 try {
-  const contentStart = await service.getProxyEndpointEscrow("test09");
+  const contentStart = await service.getProxyEndpointEscrow("BitcoinOutlook");
   console.log("Accessed Escrow Content:", contentStart);
 } catch (error) {
   console.error("Payment or Fetch Failed:", error);
@@ -71,7 +69,10 @@ Send messages to an AI agent that requires per-message payments.
 
 ```typescript
 try {
-  const response = await service.generateAIResponse("agentTest1", "Hello");
+  const response = await service.generateAIResponse(
+    "mantleAgent",
+    "How to build smart contract on Mantle Network?"
+  );
   console.log("AI Response:", response);
 } catch (error) {
   console.error("Agent Interaction Failed:", error);
@@ -83,8 +84,8 @@ try {
 ```typescript
 try {
   const responseEscrow = await service.generateAIResponseEscrow(
-    "agentTest1",
-    "Hello"
+    "mantleAgent",
+    "How to build AVS on EigenLayer?"
   );
   console.log("AI Response Escrow:", responseEscrow);
 } catch (error) {
@@ -105,6 +106,75 @@ const service = new PaymentService({
 });
 ```
 
+## Integration with AI Agents & LLMs
+
+One of the most powerful use cases for `@payroute/x402-sdk` is enabling **Autonomous Economic Agents**. Because the SDK handles the entire payment lifecycle programmatically, LLMs can "pay" for their own resources without user intervention.
+
+### Example: Autonomous Research Agent
+
+Imagine an AI agent tasked with gathering premium market data. It can use this SDK to automatically pay for each data point it accesses using its own wallet.
+
+```typescript
+import { PaymentService } from "@payroute/x402-sdk";
+import { openai } from "./my-llm-setup"; // Hypothetical LLM client
+
+// 1. Give the Agent a Wallet
+const agentWalletKey = process.env.AGENT_PRIVATE_KEY;
+const payroute = new PaymentService({
+  privateKey: agentWalletKey,
+  network: "mantle",
+});
+
+async function autonomousResearchTask(topic: string) {
+  console.log(`Agent starting research on: ${topic}...`);
+
+  // 2. Agent decides it needs premium data (e.g., from 'HighValueData' endpoint)
+  // The SDK handles the 402 challenge, approves tokens, pays, and returns the data.
+  console.log("Accessing premium data source...");
+
+  // THIS SINGLE LINE handles the entire negotiation and payment
+  const premiumData = await payroute.getProxyEndpointEscrow("HighValueData");
+
+  // 3. Agent processes the purchased data
+  console.log("Data acquired. Analyzing...");
+  const analysis = await openai.chat.completions.create({
+    model: "gpt-4",
+    messages: [
+      {
+        role: "user",
+        content: `Analyze this data: ${JSON.stringify(premiumData)}`,
+      },
+    ],
+  });
+
+  return analysis.choices[0].message.content;
+}
+```
+
+This pattern transforms **passive tools** into **economically active agents** capable of trading value for information or services on the open market.
+
+### Example: Agent-to-Agent Consultation
+
+Your agent can also pay to converse with other specialized AI agents (e.g., a "Legal Expert" or "Medical Advisor").
+
+```typescript
+async function consultExpertAgent(problem: string) {
+  // Agent identifies it needs help from a specific expert agent slug
+  const expertAgentSlug = "legal-expert-v1";
+
+  console.log(`Consulting ${expertAgentSlug}...`);
+
+  // The SDK handles payment for the conversation turn
+  const expertAdvice = await payroute.generateAIResponseEscrow(
+    expertAgentSlug,
+    `I have a user asking about: ${problem}. What are the compliance risks?`
+  );
+
+  // Initial Agent integrates the paid advice into its final response
+  return expertAdvice.response;
+}
+```
+
 ## Architecture
 
 The SDK implements the **Payroute x402 Protocol**:

package/dist/index.d.mts

@@ -13,6 +13,7 @@ interface PaymentServiceConfig {
     privateKey: string;
     network?: 'mantle' | 'mantleTestnet' | 'localhost';
     rpcUrl?: string;
+    apiBaseUrl?: string;
 }
 /**
  * PaymentService class
@@ -21,6 +22,7 @@ interface PaymentServiceConfig {
 declare class PaymentService {
     private wallet;
     private provider;
+    private apiBaseUrl;
     constructor(config: PaymentServiceConfig);
     /**
      * Performs a payment on-chain and retries the original request with proof of payment.

package/dist/index.d.ts

@@ -13,6 +13,7 @@ interface PaymentServiceConfig {
     privateKey: string;
     network?: 'mantle' | 'mantleTestnet' | 'localhost';
     rpcUrl?: string;
+    apiBaseUrl?: string;
 }
 /**
  * PaymentService class
@@ -21,6 +22,7 @@ interface PaymentServiceConfig {
 declare class PaymentService {
     private wallet;
     private provider;
+    private apiBaseUrl;
     constructor(config: PaymentServiceConfig);
     /**
      * Performs a payment on-chain and retries the original request with proof of payment.

package/dist/index.js

@@ -43,7 +43,6 @@ var NETWORKS = {
     chainId: 31337
   }
 };
-var BASE_ENDPOINT = "http://localhost:3000";
 var ESCROW_ABI = [
   "function createTx(bytes32 txId, address creator, uint256 amount)"
 ];
@@ -55,6 +54,7 @@ var ERC20_ABI = [
 var PaymentService = class {
   wallet;
   provider;
+  apiBaseUrl;
   constructor(config) {
     const networkKey = config.network || "mantle";
     const networkConfig = NETWORKS[networkKey];
@@ -68,6 +68,7 @@ var PaymentService = class {
     } catch (error) {
       throw new Error("Invalid private key provided.");
     }
+    this.apiBaseUrl = config.apiBaseUrl || "https://x402-services.vercel.app";
   }
   /**
    * Performs a payment on-chain and retries the original request with proof of payment.
@@ -124,7 +125,7 @@ var PaymentService = class {
    */
   async generateAIResponse(agentSlug, message) {
     try {
-      const initialResponse = await fetch(`${BASE_ENDPOINT}/agent/${agentSlug}/chat`, {
+      const initialResponse = await fetch(`${this.apiBaseUrl}/agent/${agentSlug}/chat`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
@@ -164,7 +165,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log(`Retry with txHash: ${finalTxHash}`);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/agent/${agentSlug}/chat`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/agent/${agentSlug}/chat`, {
         method: "POST",
         headers,
         body: JSON.stringify({
@@ -189,7 +190,7 @@ var PaymentService = class {
   */
   async generateAIResponseEscrow(agentSlug, message) {
     try {
-      const initialResponse = await fetch(`${BASE_ENDPOINT}/agent/escrow/${agentSlug}/chat`, {
+      const initialResponse = await fetch(`${this.apiBaseUrl}/agent/escrow/${agentSlug}/chat`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
@@ -236,7 +237,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log(`Retry with txHash: ${finalTxHash}`);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/agent/escrow/${agentSlug}/chat`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/agent/escrow/${agentSlug}/chat`, {
         method: "POST",
         headers,
         body: JSON.stringify({
@@ -263,7 +264,7 @@ var PaymentService = class {
     try {
       let initialResponse;
       try {
-        initialResponse = await fetch(`${BASE_ENDPOINT}/${gatewaySlug}`);
+        initialResponse = await fetch(`${this.apiBaseUrl}/${gatewaySlug}`);
       } catch (e) {
         throw new Error(`Initial Endpoint Failed: ${e}`);
       }
@@ -297,7 +298,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log("view header: ", headers);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/${gatewaySlug}`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/${gatewaySlug}`, {
         method: "GET",
         headers
       });
@@ -321,7 +322,7 @@ var PaymentService = class {
     try {
       let initialResponse;
       try {
-        initialResponse = await fetch(`${BASE_ENDPOINT}/escrow/${gatewaySlug}`);
+        initialResponse = await fetch(`${this.apiBaseUrl}/escrow/${gatewaySlug}`);
       } catch (e) {
         throw new Error(`Initial Endpoint Failed: ${e}`);
       }
@@ -365,7 +366,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log("view header: ", headers);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/escrow/${gatewaySlug}`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/escrow/${gatewaySlug}`, {
         method: "GET",
         headers
       });

package/dist/index.mjs

@@ -17,7 +17,6 @@ var NETWORKS = {
     chainId: 31337
   }
 };
-var BASE_ENDPOINT = "http://localhost:3000";
 var ESCROW_ABI = [
   "function createTx(bytes32 txId, address creator, uint256 amount)"
 ];
@@ -29,6 +28,7 @@ var ERC20_ABI = [
 var PaymentService = class {
   wallet;
   provider;
+  apiBaseUrl;
   constructor(config) {
     const networkKey = config.network || "mantle";
     const networkConfig = NETWORKS[networkKey];
@@ -42,6 +42,7 @@ var PaymentService = class {
     } catch (error) {
       throw new Error("Invalid private key provided.");
     }
+    this.apiBaseUrl = config.apiBaseUrl || "https://x402-services.vercel.app";
   }
   /**
    * Performs a payment on-chain and retries the original request with proof of payment.
@@ -98,7 +99,7 @@ var PaymentService = class {
    */
   async generateAIResponse(agentSlug, message) {
     try {
-      const initialResponse = await fetch(`${BASE_ENDPOINT}/agent/${agentSlug}/chat`, {
+      const initialResponse = await fetch(`${this.apiBaseUrl}/agent/${agentSlug}/chat`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
@@ -138,7 +139,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log(`Retry with txHash: ${finalTxHash}`);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/agent/${agentSlug}/chat`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/agent/${agentSlug}/chat`, {
         method: "POST",
         headers,
         body: JSON.stringify({
@@ -163,7 +164,7 @@ var PaymentService = class {
   */
   async generateAIResponseEscrow(agentSlug, message) {
     try {
-      const initialResponse = await fetch(`${BASE_ENDPOINT}/agent/escrow/${agentSlug}/chat`, {
+      const initialResponse = await fetch(`${this.apiBaseUrl}/agent/escrow/${agentSlug}/chat`, {
         method: "POST",
         headers: {
           "Content-Type": "application/json"
@@ -210,7 +211,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log(`Retry with txHash: ${finalTxHash}`);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/agent/escrow/${agentSlug}/chat`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/agent/escrow/${agentSlug}/chat`, {
         method: "POST",
         headers,
         body: JSON.stringify({
@@ -237,7 +238,7 @@ var PaymentService = class {
     try {
       let initialResponse;
       try {
-        initialResponse = await fetch(`${BASE_ENDPOINT}/${gatewaySlug}`);
+        initialResponse = await fetch(`${this.apiBaseUrl}/${gatewaySlug}`);
       } catch (e) {
         throw new Error(`Initial Endpoint Failed: ${e}`);
       }
@@ -271,7 +272,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log("view header: ", headers);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/${gatewaySlug}`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/${gatewaySlug}`, {
         method: "GET",
         headers
       });
@@ -295,7 +296,7 @@ var PaymentService = class {
     try {
       let initialResponse;
       try {
-        initialResponse = await fetch(`${BASE_ENDPOINT}/escrow/${gatewaySlug}`);
+        initialResponse = await fetch(`${this.apiBaseUrl}/escrow/${gatewaySlug}`);
       } catch (e) {
         throw new Error(`Initial Endpoint Failed: ${e}`);
       }
@@ -339,7 +340,7 @@ var PaymentService = class {
         "x-payment-tx": finalTxHash
       };
       console.log("view header: ", headers);
-      const retryResponse = await fetch(`${BASE_ENDPOINT}/escrow/${gatewaySlug}`, {
+      const retryResponse = await fetch(`${this.apiBaseUrl}/escrow/${gatewaySlug}`, {
         method: "GET",
         headers
       });

package/package.json

@@ -1,10 +1,27 @@
 {
   "name": "@payroute/x402-sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "SDK for automation payment gateway with x402",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsup"
   },