@warppay402/sdk 1.1.3 → 1.1.4

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WarpPay402
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -17,7 +17,7 @@ export declare class WarpPayClient {
     /**
      * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
      */
-    private executePaidRequest;
+    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>;

package/dist/index.js

@@ -36,36 +36,41 @@ class WarpPayClient {
     /**
      * Handles multi-chain HTTP 402 Payment Required challenges dynamically.
      */
-    async executePaidRequest(endpoint, payload) {
+    async executePaidRequest(endpoint, payload, method = "POST") {
         const url = `${this.baseUrl}${endpoint}`;
-        // 1. Initial Request Probe
-        let response = await fetch(url, {
-            method: "POST",
+        console.log(`\n🔍 [SDK DEBUG] Initiating ${method} request to: ${url}`);
+        const fetchOptions = {
+            method,
             headers: { "Content-Type": "application/json" },
-            body: JSON.stringify(payload),
-        });
+        };
+        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 || [];
-            // Check for Solana offer if solanaKeypair is available
+            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) {
-                // Execute Solana L1 SPL-USDC Transaction Authorization
+                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"); // $0.01 USDC
+                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;
-                // Idempotently create recipient ATA if required
                 tx.add((0, spl_token_1.createAssociatedTokenAccountIdempotentInstruction)(senderPubkey, recipientAta, payToPubkey, usdcMint));
-                // Append SPL-USDC Transfer instruction
                 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");
@@ -81,10 +86,11 @@ class WarpPayClient {
                 };
             }
             else if (evmReq && this.account) {
-                // EVM EIP-712 Base Path
+                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",
@@ -121,36 +127,44 @@ class WarpPayClient {
                     x402Version: 2,
                     scheme: evmReq.scheme || "exact",
                     network: evmReq.network || "eip155:8453",
-                    payload: {
-                        authorization: {
-                            from: this.account.address,
-                            to: payTo,
-                            value: value.toString(),
-                            validAfter: "0",
-                            validBefore: (now + 3600).toString(),
-                            nonce,
-                        },
-                        signature,
+                    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");
-            // Resubmit request with signed x402 headers
-            response = await fetch(url, {
-                method: "POST",
-                headers: {
-                    "Content-Type": "application/json",
-                    "X-PAYMENT": encodedPayload,
-                    "PAYMENT-SIGNATURE": encodedPayload,
-                },
-                body: JSON.stringify(payload),
-            });
+            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());

package/openclaw.plugin.json

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

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@warppay402/sdk",
-  "version": "1.1.3",
-  "description": "Official WarpPay402 TypeScript SDK: Enabling seamless pay-per-use AI tools across both Base Mainnet and Solana.",
+  "version": "1.1.4",
+  "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",
   "scripts": {
@@ -9,15 +10,17 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/golfgolfgolf200/warppay402-sdk.git"
+    "url": "git+https://github.com/Warppay402/warppay402-sdk.git"
   },
   "bugs": {
-    "url": "https://github.com/golfgolfgolf200/warppay402-sdk/issues"
+    "url": "https://github.com/Warppay402/warppay402-sdk/issues"
   },
-  "homepage": "https://github.com/golfgolfgolf200/warppay402-sdk#readme",
+  "homepage": "https://github.com/Warppay402/warppay402-sdk#readme",
   "keywords": [
     "x402",
     "base",
+    "solana",
+    "arbitrum",
     "ai-agents",
     "mcp",
     "monetization",
@@ -50,7 +53,7 @@
       "properties": {
         "privateKey": {
           "type": "string",
-          "description": "Base wallet private key for paying x402 micropayments"
+          "description": "Base/Arbitrum wallet private key for paying x402 micropayments"
         }
       }
     }

package/src/index.ts

@@ -1,228 +0,0 @@
-import crypto from "node:crypto";
-import { Buffer } from "node:buffer";
-import { privateKeyToAccount } from "viem/accounts";
-import { Keypair, Connection, Transaction, PublicKey } from "@solana/web3.js";
-import { 
-  getAssociatedTokenAddress, 
-  createTransferInstruction, 
-  createAssociatedTokenAccountIdempotentInstruction 
-} from "@solana/spl-token";
-import bs58 from "bs58";
-
-export 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;
-}
-
-export class WarpPayClient {
-  private baseUrl: string;
-  private account?: ReturnType<typeof privateKeyToAccount>;
-  private solanaKeypair?: Keypair;
-  private solanaConnection: Connection;
-
-  constructor(config: WarpPayConfig) {
-    this.baseUrl = (config.baseUrl || "https://api.warppay402.com").replace(/\/$/, "");
-    this.solanaConnection = new 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}`) as `0x${string}`;
-      this.account = privateKeyToAccount(formattedKey);
-    }
-
-    // Solana Account Setup
-    if (config.solanaPrivateKey) {
-      const decodedSecret = bs58.decode(config.solanaPrivateKey.trim());
-      this.solanaKeypair = 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.
-   */
-  private async executePaidRequest<T>(endpoint: string, payload: Record<string, any>): Promise<T> {
-    const url = `${this.baseUrl}${endpoint}`;
-
-    // 1. Initial Request Probe
-    let response = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(payload),
-    });
-
-    // 2. Multi-Chain Settlement Challenge Response
-    if (response.status === 402) {
-      const challenge = await response.json();
-      const accepts: Array<any> = challenge.x402?.accepts || challenge.accepts || [];
-
-      // Check for Solana offer if solanaKeypair is available
-      const solanaReq = accepts.find((a) => a.network?.includes("solana"));
-      const evmReq = accepts.find((a) => a.network?.includes("eip155"));
-
-      let paymentPayload: any;
-
-      if (solanaReq && this.solanaKeypair) {
-        // Execute Solana L1 SPL-USDC Transaction Authorization
-        const payToPubkey = new PublicKey(solanaReq.payTo);
-        const usdcMint = new PublicKey(solanaReq.asset || "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
-        const amountUnits = BigInt(solanaReq.amount || solanaReq.maxAmountRequired || "10000"); // $0.01 USDC
-
-        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;
-
-        // Idempotently create recipient ATA if required
-        tx.add(
-          createAssociatedTokenAccountIdempotentInstruction(
-            senderPubkey,
-            recipientAta,
-            payToPubkey,
-            usdcMint
-          )
-        );
-
-        // Append SPL-USDC Transfer instruction
-        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) {
-        // EVM EIP-712 Base Path
-        const payTo = (evmReq.payToAddress || evmReq.payTo) as `0x${string}`;
-        const assetContract = (evmReq.asset || evmReq.usdcAddress) as `0x${string}`;
-        const value = BigInt(evmReq.maxAmountRequired || evmReq.amount || "10000");
-
-        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${crypto.randomBytes(32).toString("hex")}` as `0x${string}`;
-
-        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",
-          payload: {
-            authorization: {
-              from: this.account.address,
-              to: payTo,
-              value: value.toString(),
-              validAfter: "0",
-              validBefore: (now + 3600).toString(),
-              nonce,
-            },
-            signature,
-          },
-        };
-      } else {
-        throw new Error("No matching private key configured for returned 402 networks.");
-      }
-
-      const encodedPayload = Buffer.from(JSON.stringify(paymentPayload)).toString("base64");
-
-      // Resubmit request with signed x402 headers
-      response = await fetch(url, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          "X-PAYMENT": encodedPayload,
-          "PAYMENT-SIGNATURE": encodedPayload,
-        },
-        body: JSON.stringify(payload),
-      });
-    }
-
-    if (!response.ok) {
-      const errText = await response.text();
-      throw new Error(`WarpPay API Error (${response.status}): ${errText}`);
-    }
-
-    return (await response.json()) as T;
-  }
-
-  public async scrapeWeb(url: string): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/web-scraper", { url });
-  }
-
-  public async getBaseAnalytics(address: string): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/base-analytics", { address });
-  }
-
-  public async extractPdf(pdfUrl: string): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/pdf-extractor", { pdfUrl });
-  }
-
-  public async browserScrape(url: string): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/browser-scraper", { url });
-  }
-
-  public async renderScreenshot(url: string): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/render-screenshot", { url });
-  }
-
-  public async extractJson(url: string, schema?: object): Promise<any> {
-    return this.executePaidRequest("/api/v1/tools/extract-json", { url, schema });
-  }
-}

package/src/langchain.ts

@@ -1,33 +0,0 @@
-import { WarpPayClient } from "./index.js";
-
-/**
- * Generates LangChain-compatible tool definitions initialized with WarpPay402
- */
-export function createWarpPayLangChainTools(client: WarpPayClient) {
-  return [
-    {
-      name: "web_scraper",
-      description: "Scrapes a web page URL and returns clean markdown content. Costs $0.01 USDC on Base.",
-      func: async ({ url }: { url: string }) => {
-        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 }: { address: string }) => {
-        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 }: { pdfUrl: string }) => {
-        const result = await client.extractPdf(pdfUrl);
-        return result.textPreview;
-      },
-    },
-  ];
-}

package/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "declaration": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "types": ["node"]
-  },
-  "include": ["src/**/*"]
-}