@warppay402/sdk 1.1.5 → 1.1.8

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/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.5",
+  "version": "1.1.8",
   "description": "Official WarpPay402 TypeScript SDK: Enabling seamless pay-per-use AI tools across Base Mainnet, Solana, and Arbitrum One."
-}
+}

package/package.json

@@ -1,13 +1,23 @@
-
 {
   "name": "@warppay402/sdk",
-  "version": "1.1.5",
+  "version": "1.1.8",
   "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",
+    "version": "node -e \"const fs = require('fs'); const p = JSON.parse(fs.readFileSync('openclaw.plugin.json')); p.version = process.env.npm_package_version; fs.writeFileSync('openclaw.plugin.json', JSON.stringify(p, null, 2) + '\\n');\" && git add openclaw.plugin.json"
   },
   "repository": {
     "type": "git",
@@ -36,6 +46,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "tsup": "^8.5.1",
     "typescript": "^5.0.0"
   },
   "openclaw": {
@@ -59,4 +70,4 @@
       }
     }
   }
-}
+}

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;
-            },
-        },
-    ];
-}