@warppay402/sdk 1.1.4 → 1.1.7

package/.env.example

@@ -0,0 +1,12 @@
+# EVM / Base Mainnet Wallet Setup
+# Private key for funding Base x402 USDC micropayments (must start with 0x)
+CUSTOMER_BASE_KEY=0x_your_evm_private_key_here
+
+# Solana L1 Wallet Setup
+# Base58-encoded secret key for funding Solana SPL USDC micropayments
+CUSTOMER_SOLANA_KEY=base58_encoded_solana_secret_key_here
+
+# Optional Configuration Overrides
+# BASE_URL=https://api.warppay402.com
+# BASE_RPC_URL=https://mainnet.base.org
+# SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

package/README.md

@@ -7,10 +7,10 @@ Official TypeScript SDK for **WarpPay402**—pay-per-use AI tools monetized via
 ```bash
 npm install @warppay402/sdk
 ```
+
 ## 🚀 Quickstart
-```typescript
-import { WarpPayClient } from "@warppay402/sdk";
 
+```typescript
 import { WarpPayClient } from "@warppay402/sdk";
 
 // Initialize with Base EVM, Solana L1, or both
@@ -45,24 +45,33 @@ async function main() {
   console.log("ETH Balance:", analytics.ethBalance);
 
   // 6. Extract PDF Text Preview ($0.05 USDC)
-  const pdf = await client.extractPdf("https://example.com/document.pdf");  
+  const pdf = await client.extractPdf("https://example.com/document.pdf");
   console.log("Preview:", pdf.textPreview);
 }
 
 main();
 ```
+
 ## 🛠️ Available Methods & Pricing
 
-* **`getPublicDataFeed(filename)`** -- `$0.0001 USDC` -- Retrieves signed attestation JSON payloads.
-* **`getDataFeed(feedId)`** -- `$0.001 USDC` -- Fetches pre-scraped market and protocol intelligence feeds.
-* **`scrapeWeb(url)`** -- `$0.001 USDC` -- Extracts clean Markdown from web pages.
-* **`getBaseAnalytics(address)`** -- `$0.002 USDC` -- Fetches ETH balance and nonce stats.
-* **`browserScrape(url)`** -- `$0.005 USDC` -- Unblockable JS browser scraping via proxy workers.
-* **`extractPdf(pdfUrl)`** -- `$0.005 USDC` -- Parses text preview from public PDF URLs.
-* **`renderScreenshot(url)`** -- `$0.01 USDC` -- Renders target URL and returns full-page screenshot data.
-* **`extractJson(url, schema?)`** -- `$0.01 USDC` -- Parses web pages into structured JSON data.
-* **`verifySmartContract(address)`** -- `$0.02 USDC` -- Source code analysis, ABI fetching, and proxy validation.
+- **`getPublicDataFeed(filename)`** — `$0.0001 USDC` — Retrieves signed attestation JSON payloads.
+- **`getDataFeed(feedId)`** — `$0.001 USDC` — Fetches pre-scraped market and protocol intelligence feeds.
+- **`scrapeWeb(url)`** — `$0.001 USDC` — Extracts clean Markdown from web pages.
+- **`getBaseAnalytics(address)`** — `$0.002 USDC` — Fetches ETH balance and nonce stats.
+- **`getAerodromeYields()`** — `$0.003 USDC` — Top live Aerodrome pool yields and APYs on Base.
+- **`browserScrape(url)`** — `$0.005 USDC` — Unblockable JS browser scraping via proxy workers.
+- **`extractPdf(pdfUrl)`** — `$0.005 USDC` — Parses text preview from public PDF URLs.
+- **`renderScreenshot(url)`** — `$0.01 USDC` — Renders target URL and returns full-page screenshot data.
+- **`extractJson(url, schema?)`** — `$0.01 USDC` — Parses web pages into structured JSON data.
+- **`executeAerodromeSwap(params)`** — `$0.01 USDC` — Executes token swaps via Aerodrome Router on Base.
+- **`manageAerodromeClamm(params)`** — `$0.01 USDC` — Concentrated liquidity LP management on Aerodrome Slipstream.
+- **`manageAerodromeVeaero(params)`** — `$0.01 USDC` — $AERO locking, gauge voting, and bribe reward harvesting.
+- **`verifySmartContract(address)`** — `$0.02 USDC` — Source code analysis, ABI fetching, and proxy validation.
+- **`deployBaseContract(contractType)`** — `$5.00 USDC` — Programmatically deploys custom smart contracts to Base Mainnet.
+- **`deploySolanaContract(type, params)`** — `$5.00 USDC` — Initializes SPL Escrows, cNFTs, or Raydium Vaults on Solana.
+
 ## 🛠️ LangChain Integration
+
 ```typescript
 import { WarpPayClient, createWarpPayLangChainTools } from "@warppay402/sdk";
 
@@ -73,12 +82,10 @@ const client = new WarpPayClient({
 // Pass directly into your LangChain or AutoGen agent setup
 const tools = createWarpPayLangChainTools(client);
 ```
-## 🌐 API Gateway & Specs
-
-MCP Gateway Endpoint: https://api.warppay402.com/mcp
 
-MCP Manifest: https://api.warppay402.com/.well-known/mcp.json
-
-REST Gateway Base: https://api.warppay402.com
+## 🌐 API Gateway & Specs
 
-OpenAPI Spec: https://api.warppay402.com/openapi.json
+- MCP Gateway Endpoint: <https://api.warppay402.com/mcp>
+- MCP Manifest: <https://api.warppay402.com/.well-known/mcp.json>
+- REST Gateway Base: <https://api.warppay402.com>
+- OpenAPI Spec: <https://api.warppay402.com/openapi.json>

package/dist/index.cjs

@@ -0,0 +1,231 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  WarpPayClient: () => WarpPayClient
+});
+module.exports = __toCommonJS(index_exports);
+var import_node_crypto = __toESM(require("crypto"), 1);
+var import_node_buffer = require("buffer");
+var import_accounts = require("viem/accounts");
+var import_web3 = require("@solana/web3.js");
+var import_spl_token = require("@solana/spl-token");
+var import_bs58 = __toESM(require("bs58"), 1);
+var bs58 = import_bs58.default.default || import_bs58.default;
+var WarpPayClient = class {
+  baseUrl;
+  account;
+  solanaKeypair;
+  solanaConnection;
+  constructor(config) {
+    this.baseUrl = (config.baseUrl || "https://api.warppay402.com").replace(/\/$/, "");
+    this.solanaConnection = new import_web3.Connection(
+      config.solanaRpcUrl || "https://api.mainnet-beta.solana.com",
+      "confirmed"
+    );
+    if (config.privateKey) {
+      const rawKey = config.privateKey.trim();
+      const formattedKey = rawKey.startsWith("0x") ? rawKey : `0x${rawKey}`;
+      this.account = (0, import_accounts.privateKeyToAccount)(formattedKey);
+    }
+    if (config.solanaPrivateKey) {
+      const decodedSecret = bs58.decode(config.solanaPrivateKey.trim());
+      this.solanaKeypair = import_web3.Keypair.fromSecretKey(decodedSecret);
+    }
+    if (!this.account && !this.solanaKeypair) {
+      throw new Error("WarpPayClient requires either a Base privateKey or a solanaPrivateKey.");
+    }
+  }
+  /**
+   * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
+   */
+  async executePaidRequest(endpoint, payload, method = "POST") {
+    const url = `${this.baseUrl}${endpoint}`;
+    console.log(`
+\u{1F50D} [SDK DEBUG] Initiating ${method} request to: ${url}`);
+    const fetchOptions = {
+      method,
+      headers: { "Content-Type": "application/json" }
+    };
+    if (method === "POST" && payload) {
+      fetchOptions.body = JSON.stringify(payload);
+      console.log(`\u{1F50D} [SDK DEBUG] Request Payload:`, JSON.stringify(payload));
+    }
+    let response = await fetch(url, fetchOptions);
+    console.log(`\u{1F50D} [SDK DEBUG] Probe Response Status: ${response.status} ${response.statusText}`);
+    if (response.status === 402) {
+      const challenge = await response.json();
+      console.log(`\u{1F50D} [SDK DEBUG] Received 402 Challenge Payload:`, JSON.stringify(challenge, null, 2));
+      const accepts = challenge.x402?.accepts || challenge.accepts || [];
+      console.log(`\u{1F50D} [SDK DEBUG] Accepted Payment Rails (${accepts.length}):`, accepts.map((a) => a.network));
+      const solanaReq = accepts.find((a) => a.network?.includes("solana"));
+      const evmReq = accepts.find((a) => a.network?.includes("eip155"));
+      let paymentPayload;
+      if (solanaReq && this.solanaKeypair) {
+        console.log(`\u{1F50D} [SDK DEBUG] Processing Solana L1 SPL Payment challenge...`);
+        const payToPubkey = new import_web3.PublicKey(solanaReq.payTo);
+        const usdcMint = new import_web3.PublicKey(solanaReq.asset || "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+        const amountUnits = BigInt(solanaReq.amount || solanaReq.maxAmountRequired || "10000");
+        const senderPubkey = this.solanaKeypair.publicKey;
+        const senderAta = await (0, import_spl_token.getAssociatedTokenAddress)(usdcMint, senderPubkey);
+        const recipientAta = await (0, import_spl_token.getAssociatedTokenAddress)(usdcMint, payToPubkey);
+        const tx = new import_web3.Transaction();
+        tx.feePayer = senderPubkey;
+        tx.recentBlockhash = (await this.solanaConnection.getLatestBlockhash()).blockhash;
+        tx.add(
+          (0, import_spl_token.createAssociatedTokenAccountIdempotentInstruction)(
+            senderPubkey,
+            recipientAta,
+            payToPubkey,
+            usdcMint
+          )
+        );
+        tx.add(
+          (0, import_spl_token.createTransferInstruction)(senderAta, recipientAta, senderPubkey, amountUnits)
+        );
+        tx.sign(this.solanaKeypair);
+        const serializedTx = import_node_buffer.Buffer.from(tx.serialize()).toString("base64");
+        paymentPayload = {
+          x402Version: 2,
+          scheme: solanaReq.scheme || "exact",
+          network: solanaReq.network || "solana:5eykt4wA89m8E5b9B5658p445VTc28",
+          signature: serializedTx,
+          paymentPayload: {
+            signature: serializedTx,
+            network: solanaReq.network
+          }
+        };
+      } else if (evmReq && this.account) {
+        console.log(`\u{1F50D} [SDK DEBUG] Processing EVM EIP-712 Payment challenge...`);
+        const payTo = evmReq.payToAddress || evmReq.payTo;
+        const assetContract = evmReq.asset || evmReq.usdcAddress;
+        const value = BigInt(evmReq.maxAmountRequired || evmReq.amount || "10000");
+        console.log(`\u{1F50D} [SDK DEBUG] Signer Wallet: ${this.account.address} -> PayTo: ${payTo} | Amount: ${value.toString()}`);
+        const domain = {
+          name: evmReq.extra?.name || "USD Coin",
+          version: evmReq.extra?.version || "2",
+          chainId: 8453,
+          verifyingContract: assetContract
+        };
+        const types = {
+          TransferWithAuthorization: [
+            { name: "from", type: "address" },
+            { name: "to", type: "address" },
+            { name: "value", type: "uint256" },
+            { name: "validAfter", type: "uint256" },
+            { name: "validBefore", type: "uint256" },
+            { name: "nonce", type: "bytes32" }
+          ]
+        };
+        const now = Math.floor(Date.now() / 1e3);
+        const nonce = `0x${import_node_crypto.default.randomBytes(32).toString("hex")}`;
+        const message = {
+          from: this.account.address,
+          to: payTo,
+          value,
+          validAfter: BigInt(0),
+          validBefore: BigInt(now + 3600),
+          nonce
+        };
+        const signature = await this.account.signTypedData({
+          domain,
+          types,
+          primaryType: "TransferWithAuthorization",
+          message
+        });
+        paymentPayload = {
+          x402Version: 2,
+          scheme: evmReq.scheme || "exact",
+          network: evmReq.network || "eip155:8453",
+          authorization: {
+            from: this.account.address,
+            to: payTo,
+            value: value.toString(),
+            validAfter: "0",
+            validBefore: (now + 3600).toString(),
+            nonce
+          },
+          signature
+        };
+      } else {
+        console.error(`\u274C [SDK DEBUG] Matching key missing! EVM Account Present: ${Boolean(this.account)} | Solana Keypair Present: ${Boolean(this.solanaKeypair)}`);
+        throw new Error("No matching private key configured for returned 402 networks.");
+      }
+      const encodedPayload = import_node_buffer.Buffer.from(JSON.stringify(paymentPayload)).toString("base64");
+      console.log(`\u{1F50D} [SDK DEBUG] Generated Signed x402 Base64 Header (Length: ${encodedPayload.length})`);
+      const retryHeaders = {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": encodedPayload,
+        "X-PAYMENT-RESPONSE": encodedPayload,
+        "X-PAYMENT": encodedPayload,
+        "authorization": `Bearer ${encodedPayload}`
+      };
+      const retryOptions = {
+        method,
+        headers: retryHeaders
+      };
+      if (method === "POST" && payload) {
+        retryOptions.body = JSON.stringify(payload);
+      }
+      console.log(`\u{1F50D} [SDK DEBUG] Resubmitting paid ${method} request to: ${url}`);
+      response = await fetch(url, retryOptions);
+      console.log(`\u{1F50D} [SDK DEBUG] Paid Retry Response Status: ${response.status} ${response.statusText}`);
+    }
+    if (!response.ok) {
+      const errText = await response.text();
+      console.error(`\u274C [SDK DEBUG] Request Rejection Body:`, errText);
+      throw new Error(`WarpPay API Error (${response.status}): ${errText}`);
+    }
+    return await response.json();
+  }
+  async scrapeWeb(url) {
+    return this.executePaidRequest("/api/v1/tools/web-scraper", { url });
+  }
+  async getBaseAnalytics(address) {
+    return this.executePaidRequest("/api/v1/tools/base-analytics", { address });
+  }
+  async extractPdf(pdfUrl) {
+    return this.executePaidRequest("/api/v1/tools/pdf-extractor", { pdfUrl });
+  }
+  async browserScrape(url) {
+    return this.executePaidRequest("/api/v1/tools/browser-scraper", { url });
+  }
+  async renderScreenshot(url) {
+    return this.executePaidRequest("/api/v1/tools/render-screenshot", { url });
+  }
+  async extractJson(url, schema) {
+    return this.executePaidRequest("/api/v1/tools/extract-json", { url, schema });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WarpPayClient
+});

package/dist/index.d.cts

@@ -0,0 +1,29 @@
+interface WarpPayConfig {
+    /** Base Mainnet private key of the agent's wallet funding micro-payments */
+    privateKey?: `0x${string}`;
+    /** Solana Mainnet base58 private key funding micro-payments */
+    solanaPrivateKey?: string;
+    /** Custom gateway URL (Defaults to https://api.warppay402.com) */
+    baseUrl?: string;
+    /** Custom Solana RPC URL */
+    solanaRpcUrl?: string;
+}
+declare class WarpPayClient {
+    private baseUrl;
+    private account?;
+    private solanaKeypair?;
+    private solanaConnection;
+    constructor(config: WarpPayConfig);
+    /**
+     * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
+     */
+    executePaidRequest<T>(endpoint: string, payload?: Record<string, any>, method?: "GET" | "POST"): Promise<T>;
+    scrapeWeb(url: string): Promise<any>;
+    getBaseAnalytics(address: string): Promise<any>;
+    extractPdf(pdfUrl: string): Promise<any>;
+    browserScrape(url: string): Promise<any>;
+    renderScreenshot(url: string): Promise<any>;
+    extractJson(url: string, schema?: object): Promise<any>;
+}
+
+export { WarpPayClient, type WarpPayConfig };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export interface WarpPayConfig {
+interface WarpPayConfig {
     /** Base Mainnet private key of the agent's wallet funding micro-payments */
     privateKey?: `0x${string}`;
     /** Solana Mainnet base58 private key funding micro-payments */
@@ -8,7 +8,7 @@ export interface WarpPayConfig {
     /** Custom Solana RPC URL */
     solanaRpcUrl?: string;
 }
-export declare class WarpPayClient {
+declare class WarpPayClient {
     private baseUrl;
     private account?;
     private solanaKeypair?;
@@ -25,3 +25,5 @@ export declare class WarpPayClient {
     renderScreenshot(url: string): Promise<any>;
     extractJson(url: string, schema?: object): Promise<any>;
 }
+
+export { WarpPayClient, type WarpPayConfig };

package/dist/index.js

@@ -1,191 +1,200 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WarpPayClient = void 0;
-const node_crypto_1 = __importDefault(require("node:crypto"));
-const node_buffer_1 = require("node:buffer");
-const accounts_1 = require("viem/accounts");
-const web3_js_1 = require("@solana/web3.js");
-const spl_token_1 = require("@solana/spl-token");
-const bs58_1 = __importDefault(require("bs58"));
-class WarpPayClient {
-    baseUrl;
-    account;
-    solanaKeypair;
-    solanaConnection;
-    constructor(config) {
-        this.baseUrl = (config.baseUrl || "https://api.warppay402.com").replace(/\/$/, "");
-        this.solanaConnection = new web3_js_1.Connection(config.solanaRpcUrl || "https://api.mainnet-beta.solana.com", "confirmed");
-        // EVM Account Setup
-        if (config.privateKey) {
-            const rawKey = config.privateKey.trim();
-            const formattedKey = (rawKey.startsWith("0x") ? rawKey : `0x${rawKey}`);
-            this.account = (0, accounts_1.privateKeyToAccount)(formattedKey);
-        }
-        // Solana Account Setup
-        if (config.solanaPrivateKey) {
-            const decodedSecret = bs58_1.default.decode(config.solanaPrivateKey.trim());
-            this.solanaKeypair = web3_js_1.Keypair.fromSecretKey(decodedSecret);
-        }
-        if (!this.account && !this.solanaKeypair) {
-            throw new Error("WarpPayClient requires either a Base privateKey or a solanaPrivateKey.");
-        }
-    }
-    /**
-     * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
-     */
-    async executePaidRequest(endpoint, payload, method = "POST") {
-        const url = `${this.baseUrl}${endpoint}`;
-        console.log(`\n🔍 [SDK DEBUG] Initiating ${method} request to: ${url}`);
-        const fetchOptions = {
-            method,
-            headers: { "Content-Type": "application/json" },
-        };
-        if (method === "POST" && payload) {
-            fetchOptions.body = JSON.stringify(payload);
-            console.log(`🔍 [SDK DEBUG] Request Payload:`, JSON.stringify(payload));
-        }
-        // 1. Initial Request Probe
-        let response = await fetch(url, fetchOptions);
-        console.log(`🔍 [SDK DEBUG] Probe Response Status: ${response.status} ${response.statusText}`);
-        // 2. Multi-Chain Settlement Challenge Response
-        if (response.status === 402) {
-            const challenge = await response.json();
-            console.log(`🔍 [SDK DEBUG] Received 402 Challenge Payload:`, JSON.stringify(challenge, null, 2));
-            const accepts = challenge.x402?.accepts || challenge.accepts || [];
-            console.log(`🔍 [SDK DEBUG] Accepted Payment Rails (${accepts.length}):`, accepts.map((a) => a.network));
-            const solanaReq = accepts.find((a) => a.network?.includes("solana"));
-            const evmReq = accepts.find((a) => a.network?.includes("eip155"));
-            let paymentPayload;
-            if (solanaReq && this.solanaKeypair) {
-                console.log(`🔍 [SDK DEBUG] Processing Solana L1 SPL Payment challenge...`);
-                const payToPubkey = new web3_js_1.PublicKey(solanaReq.payTo);
-                const usdcMint = new web3_js_1.PublicKey(solanaReq.asset || "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
-                const amountUnits = BigInt(solanaReq.amount || solanaReq.maxAmountRequired || "10000");
-                const senderPubkey = this.solanaKeypair.publicKey;
-                const senderAta = await (0, spl_token_1.getAssociatedTokenAddress)(usdcMint, senderPubkey);
-                const recipientAta = await (0, spl_token_1.getAssociatedTokenAddress)(usdcMint, payToPubkey);
-                const tx = new web3_js_1.Transaction();
-                tx.feePayer = senderPubkey;
-                tx.recentBlockhash = (await this.solanaConnection.getLatestBlockhash()).blockhash;
-                tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(senderPubkey, recipientAta, payToPubkey, usdcMint));
-                tx.add((0, spl_token_1.createTransferInstruction)(senderAta, recipientAta, senderPubkey, amountUnits));
-                tx.sign(this.solanaKeypair);
-                const serializedTx = node_buffer_1.Buffer.from(tx.serialize()).toString("base64");
-                paymentPayload = {
-                    x402Version: 2,
-                    scheme: solanaReq.scheme || "exact",
-                    network: solanaReq.network || "solana:5eykt4wA89m8E5b9B5658p445VTc28",
-                    signature: serializedTx,
-                    paymentPayload: {
-                        signature: serializedTx,
-                        network: solanaReq.network
-                    }
-                };
-            }
-            else if (evmReq && this.account) {
-                console.log(`🔍 [SDK DEBUG] Processing EVM EIP-712 Payment challenge...`);
-                const payTo = (evmReq.payToAddress || evmReq.payTo);
-                const assetContract = (evmReq.asset || evmReq.usdcAddress);
-                const value = BigInt(evmReq.maxAmountRequired || evmReq.amount || "10000");
-                console.log(`🔍 [SDK DEBUG] Signer Wallet: ${this.account.address} -> PayTo: ${payTo} | Amount: ${value.toString()}`);
-                const domain = {
-                    name: evmReq.extra?.name || "USD Coin",
-                    version: evmReq.extra?.version || "2",
-                    chainId: 8453,
-                    verifyingContract: assetContract,
-                };
-                const types = {
-                    TransferWithAuthorization: [
-                        { name: "from", type: "address" },
-                        { name: "to", type: "address" },
-                        { name: "value", type: "uint256" },
-                        { name: "validAfter", type: "uint256" },
-                        { name: "validBefore", type: "uint256" },
-                        { name: "nonce", type: "bytes32" },
-                    ],
-                };
-                const now = Math.floor(Date.now() / 1000);
-                const nonce = `0x${node_crypto_1.default.randomBytes(32).toString("hex")}`;
-                const message = {
-                    from: this.account.address,
-                    to: payTo,
-                    value,
-                    validAfter: BigInt(0),
-                    validBefore: BigInt(now + 3600),
-                    nonce,
-                };
-                const signature = await this.account.signTypedData({
-                    domain,
-                    types,
-                    primaryType: "TransferWithAuthorization",
-                    message,
-                });
-                paymentPayload = {
-                    x402Version: 2,
-                    scheme: evmReq.scheme || "exact",
-                    network: evmReq.network || "eip155:8453",
-                    authorization: {
-                        from: this.account.address,
-                        to: payTo,
-                        value: value.toString(),
-                        validAfter: "0",
-                        validBefore: (now + 3600).toString(),
-                        nonce,
-                    },
-                    signature,
-                };
-            }
-            else {
-                console.error(`❌ [SDK DEBUG] Matching key missing! EVM Account Present: ${Boolean(this.account)} | Solana Keypair Present: ${Boolean(this.solanaKeypair)}`);
-                throw new Error("No matching private key configured for returned 402 networks.");
-            }
-            const encodedPayload = node_buffer_1.Buffer.from(JSON.stringify(paymentPayload)).toString("base64");
-            console.log(`🔍 [SDK DEBUG] Generated Signed x402 Base64 Header (Length: ${encodedPayload.length})`);
-            const retryHeaders = {
-                "Content-Type": "application/json",
-                "PAYMENT-SIGNATURE": encodedPayload,
-                "X-PAYMENT-RESPONSE": encodedPayload,
-                "X-PAYMENT": encodedPayload,
-                "authorization": `Bearer ${encodedPayload}`,
-            };
-            const retryOptions = {
-                method,
-                headers: retryHeaders,
-            };
-            if (method === "POST" && payload) {
-                retryOptions.body = JSON.stringify(payload);
-            }
-            console.log(`🔍 [SDK DEBUG] Resubmitting paid ${method} request to: ${url}`);
-            response = await fetch(url, retryOptions);
-            console.log(`🔍 [SDK DEBUG] Paid Retry Response Status: ${response.status} ${response.statusText}`);
-        }
-        if (!response.ok) {
-            const errText = await response.text();
-            console.error(`❌ [SDK DEBUG] Request Rejection Body:`, errText);
-            throw new Error(`WarpPay API Error (${response.status}): ${errText}`);
-        }
-        return (await response.json());
+// src/index.ts
+import crypto from "crypto";
+import { Buffer } from "buffer";
+import { privateKeyToAccount } from "viem/accounts";
+import { Keypair, Connection, Transaction, PublicKey } from "@solana/web3.js";
+import {
+  getAssociatedTokenAddress,
+  createTransferInstruction,
+  createAssociatedTokenAccountIdempotentInstruction
+} from "@solana/spl-token";
+import bs58Module from "bs58";
+var bs58 = bs58Module.default || bs58Module;
+var WarpPayClient = class {
+  baseUrl;
+  account;
+  solanaKeypair;
+  solanaConnection;
+  constructor(config) {
+    this.baseUrl = (config.baseUrl || "https://api.warppay402.com").replace(/\/$/, "");
+    this.solanaConnection = new Connection(
+      config.solanaRpcUrl || "https://api.mainnet-beta.solana.com",
+      "confirmed"
+    );
+    if (config.privateKey) {
+      const rawKey = config.privateKey.trim();
+      const formattedKey = rawKey.startsWith("0x") ? rawKey : `0x${rawKey}`;
+      this.account = privateKeyToAccount(formattedKey);
     }
-    async scrapeWeb(url) {
-        return this.executePaidRequest("/api/v1/tools/web-scraper", { url });
+    if (config.solanaPrivateKey) {
+      const decodedSecret = bs58.decode(config.solanaPrivateKey.trim());
+      this.solanaKeypair = Keypair.fromSecretKey(decodedSecret);
     }
-    async getBaseAnalytics(address) {
-        return this.executePaidRequest("/api/v1/tools/base-analytics", { address });
+    if (!this.account && !this.solanaKeypair) {
+      throw new Error("WarpPayClient requires either a Base privateKey or a solanaPrivateKey.");
     }
-    async extractPdf(pdfUrl) {
-        return this.executePaidRequest("/api/v1/tools/pdf-extractor", { pdfUrl });
+  }
+  /**
+   * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
+   */
+  async executePaidRequest(endpoint, payload, method = "POST") {
+    const url = `${this.baseUrl}${endpoint}`;
+    console.log(`
+\u{1F50D} [SDK DEBUG] Initiating ${method} request to: ${url}`);
+    const fetchOptions = {
+      method,
+      headers: { "Content-Type": "application/json" }
+    };
+    if (method === "POST" && payload) {
+      fetchOptions.body = JSON.stringify(payload);
+      console.log(`\u{1F50D} [SDK DEBUG] Request Payload:`, JSON.stringify(payload));
     }
-    async browserScrape(url) {
-        return this.executePaidRequest("/api/v1/tools/browser-scraper", { url });
-    }
-    async renderScreenshot(url) {
-        return this.executePaidRequest("/api/v1/tools/render-screenshot", { url });
+    let response = await fetch(url, fetchOptions);
+    console.log(`\u{1F50D} [SDK DEBUG] Probe Response Status: ${response.status} ${response.statusText}`);
+    if (response.status === 402) {
+      const challenge = await response.json();
+      console.log(`\u{1F50D} [SDK DEBUG] Received 402 Challenge Payload:`, JSON.stringify(challenge, null, 2));
+      const accepts = challenge.x402?.accepts || challenge.accepts || [];
+      console.log(`\u{1F50D} [SDK DEBUG] Accepted Payment Rails (${accepts.length}):`, accepts.map((a) => a.network));
+      const solanaReq = accepts.find((a) => a.network?.includes("solana"));
+      const evmReq = accepts.find((a) => a.network?.includes("eip155"));
+      let paymentPayload;
+      if (solanaReq && this.solanaKeypair) {
+        console.log(`\u{1F50D} [SDK DEBUG] Processing Solana L1 SPL Payment challenge...`);
+        const payToPubkey = new PublicKey(solanaReq.payTo);
+        const usdcMint = new PublicKey(solanaReq.asset || "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
+        const amountUnits = BigInt(solanaReq.amount || solanaReq.maxAmountRequired || "10000");
+        const senderPubkey = this.solanaKeypair.publicKey;
+        const senderAta = await getAssociatedTokenAddress(usdcMint, senderPubkey);
+        const recipientAta = await getAssociatedTokenAddress(usdcMint, payToPubkey);
+        const tx = new Transaction();
+        tx.feePayer = senderPubkey;
+        tx.recentBlockhash = (await this.solanaConnection.getLatestBlockhash()).blockhash;
+        tx.add(
+          createAssociatedTokenAccountIdempotentInstruction(
+            senderPubkey,
+            recipientAta,
+            payToPubkey,
+            usdcMint
+          )
+        );
+        tx.add(
+          createTransferInstruction(senderAta, recipientAta, senderPubkey, amountUnits)
+        );
+        tx.sign(this.solanaKeypair);
+        const serializedTx = Buffer.from(tx.serialize()).toString("base64");
+        paymentPayload = {
+          x402Version: 2,
+          scheme: solanaReq.scheme || "exact",
+          network: solanaReq.network || "solana:5eykt4wA89m8E5b9B5658p445VTc28",
+          signature: serializedTx,
+          paymentPayload: {
+            signature: serializedTx,
+            network: solanaReq.network
+          }
+        };
+      } else if (evmReq && this.account) {
+        console.log(`\u{1F50D} [SDK DEBUG] Processing EVM EIP-712 Payment challenge...`);
+        const payTo = evmReq.payToAddress || evmReq.payTo;
+        const assetContract = evmReq.asset || evmReq.usdcAddress;
+        const value = BigInt(evmReq.maxAmountRequired || evmReq.amount || "10000");
+        console.log(`\u{1F50D} [SDK DEBUG] Signer Wallet: ${this.account.address} -> PayTo: ${payTo} | Amount: ${value.toString()}`);
+        const domain = {
+          name: evmReq.extra?.name || "USD Coin",
+          version: evmReq.extra?.version || "2",
+          chainId: 8453,
+          verifyingContract: assetContract
+        };
+        const types = {
+          TransferWithAuthorization: [
+            { name: "from", type: "address" },
+            { name: "to", type: "address" },
+            { name: "value", type: "uint256" },
+            { name: "validAfter", type: "uint256" },
+            { name: "validBefore", type: "uint256" },
+            { name: "nonce", type: "bytes32" }
+          ]
+        };
+        const now = Math.floor(Date.now() / 1e3);
+        const nonce = `0x${crypto.randomBytes(32).toString("hex")}`;
+        const message = {
+          from: this.account.address,
+          to: payTo,
+          value,
+          validAfter: BigInt(0),
+          validBefore: BigInt(now + 3600),
+          nonce
+        };
+        const signature = await this.account.signTypedData({
+          domain,
+          types,
+          primaryType: "TransferWithAuthorization",
+          message
+        });
+        paymentPayload = {
+          x402Version: 2,
+          scheme: evmReq.scheme || "exact",
+          network: evmReq.network || "eip155:8453",
+          authorization: {
+            from: this.account.address,
+            to: payTo,
+            value: value.toString(),
+            validAfter: "0",
+            validBefore: (now + 3600).toString(),
+            nonce
+          },
+          signature
+        };
+      } else {
+        console.error(`\u274C [SDK DEBUG] Matching key missing! EVM Account Present: ${Boolean(this.account)} | Solana Keypair Present: ${Boolean(this.solanaKeypair)}`);
+        throw new Error("No matching private key configured for returned 402 networks.");
+      }
+      const encodedPayload = Buffer.from(JSON.stringify(paymentPayload)).toString("base64");
+      console.log(`\u{1F50D} [SDK DEBUG] Generated Signed x402 Base64 Header (Length: ${encodedPayload.length})`);
+      const retryHeaders = {
+        "Content-Type": "application/json",
+        "PAYMENT-SIGNATURE": encodedPayload,
+        "X-PAYMENT-RESPONSE": encodedPayload,
+        "X-PAYMENT": encodedPayload,
+        "authorization": `Bearer ${encodedPayload}`
+      };
+      const retryOptions = {
+        method,
+        headers: retryHeaders
+      };
+      if (method === "POST" && payload) {
+        retryOptions.body = JSON.stringify(payload);
+      }
+      console.log(`\u{1F50D} [SDK DEBUG] Resubmitting paid ${method} request to: ${url}`);
+      response = await fetch(url, retryOptions);
+      console.log(`\u{1F50D} [SDK DEBUG] Paid Retry Response Status: ${response.status} ${response.statusText}`);
     }
-    async extractJson(url, schema) {
-        return this.executePaidRequest("/api/v1/tools/extract-json", { url, schema });
+    if (!response.ok) {
+      const errText = await response.text();
+      console.error(`\u274C [SDK DEBUG] Request Rejection Body:`, errText);
+      throw new Error(`WarpPay API Error (${response.status}): ${errText}`);
     }
-}
-exports.WarpPayClient = WarpPayClient;
+    return await response.json();
+  }
+  async scrapeWeb(url) {
+    return this.executePaidRequest("/api/v1/tools/web-scraper", { url });
+  }
+  async getBaseAnalytics(address) {
+    return this.executePaidRequest("/api/v1/tools/base-analytics", { address });
+  }
+  async extractPdf(pdfUrl) {
+    return this.executePaidRequest("/api/v1/tools/pdf-extractor", { pdfUrl });
+  }
+  async browserScrape(url) {
+    return this.executePaidRequest("/api/v1/tools/browser-scraper", { url });
+  }
+  async renderScreenshot(url) {
+    return this.executePaidRequest("/api/v1/tools/render-screenshot", { url });
+  }
+  async extractJson(url, schema) {
+    return this.executePaidRequest("/api/v1/tools/extract-json", { url, schema });
+  }
+};
+export {
+  WarpPayClient
+};

package/openclaw.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "warppay402-sdk",
   "name": "warppay402-sdk",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Official WarpPay402 TypeScript SDK: Enabling seamless pay-per-use AI tools across Base Mainnet, Solana, and Arbitrum One."
 }

package/package.json

@@ -1,12 +1,22 @@
 {
   "name": "@warppay402/sdk",
-  "version": "1.1.4",
+  "version": "1.1.7",
   "license": "MIT",
   "description": "Official WarpPay402 TypeScript SDK: Enabling seamless pay-per-use AI tools across Base Mainnet, Solana, and Arbitrum One.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
   "scripts": {
-    "build": "tsc"
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external viem,@solana/web3.js,@solana/spl-token",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -29,12 +39,13 @@
   "dependencies": {
     "@solana/spl-token": "^0.4.15",
     "@solana/web3.js": "^1.98.4",
-    "@warppay402/server": "^1.0.0",
+    "@warppay402/server": "^1.2.3",
     "bs58": "^6.0.0",
     "viem": "^2.0.0"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.0.0"
   },
   "openclaw": {

package/dist/langchain.d.ts

@@ -1,23 +0,0 @@
-import { WarpPayClient } from "./index.js";
-/**
- * Generates LangChain-compatible tool definitions initialized with WarpPay402
- */
-export declare function createWarpPayLangChainTools(client: WarpPayClient): ({
-    name: string;
-    description: string;
-    func: ({ url }: {
-        url: string;
-    }) => Promise<any>;
-} | {
-    name: string;
-    description: string;
-    func: ({ address }: {
-        address: string;
-    }) => Promise<string>;
-} | {
-    name: string;
-    description: string;
-    func: ({ pdfUrl }: {
-        pdfUrl: string;
-    }) => Promise<any>;
-})[];

package/dist/langchain.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createWarpPayLangChainTools = createWarpPayLangChainTools;
-/**
- * Generates LangChain-compatible tool definitions initialized with WarpPay402
- */
-function createWarpPayLangChainTools(client) {
-    return [
-        {
-            name: "web_scraper",
-            description: "Scrapes a web page URL and returns clean markdown content. Costs $0.01 USDC on Base.",
-            func: async ({ url }) => {
-                const result = await client.scrapeWeb(url);
-                return result.markdown;
-            },
-        },
-        {
-            name: "base_analytics",
-            description: "Fetches ETH balance and nonce for a Base 0x wallet address. Costs $0.02 USDC on Base.",
-            func: async ({ address }) => {
-                const result = await client.getBaseAnalytics(address);
-                return JSON.stringify(result);
-            },
-        },
-        {
-            name: "pdf_extractor",
-            description: "Extracts text preview from a public PDF URL. Costs $0.05 USDC on Base.",
-            func: async ({ pdfUrl }) => {
-                const result = await client.extractPdf(pdfUrl);
-                return result.textPreview;
-            },
-        },
-    ];
-}