@tanakayuto/intmax402-client 0.1.2 → 0.2.1

package/dist/client.d.ts

@@ -1,22 +1,29 @@
+import { Token } from "intmax2-server-sdk";
 export interface INTMAX402ClientOptions {
     privateKey: string;
     environment?: "mainnet" | "testnet";
+    l1RpcUrl?: string;
 }
 export declare class INTMAX402Client {
     private wallet;
     private environment;
     private initialized;
+    private intmaxClient;
     constructor(options: INTMAX402ClientOptions);
     init(): Promise<void>;
+    initPayment(l1RpcUrl?: string): Promise<void>;
     getAddress(): string;
+    getIntMaxAddress(): string;
     getRpcUrl(): string;
-    /**
-     * Sign a nonce using Ethereum personal_sign (compatible with ethers.verifyMessage).
-     */
     sign(nonce: string): Promise<string>;
+    sendPayment(recipientAddress: string, amount: string, token: Token): Promise<{
+        txTreeRoot: string;
+        transferDigest: string;
+    }>;
     /**
      * Fetch a resource, automatically handling 401/402 INTMAX402 challenges.
-     * Flow: GET → 401/402 + nonce → sign → GET + Authorization → 200
+     * For identity mode: GET -> 401 + nonce -> sign -> GET + Authorization -> 200
+     * For payment mode: GET -> 402 + nonce + payment info -> pay + sign -> GET + Authorization (with txHash) -> 200
      */
     fetch(url: string, options?: RequestInit): Promise<Response>;
 }

package/dist/client.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.INTMAX402Client = void 0;
 const ethers_1 = require("ethers");
 const intmax402_core_1 = require("@tanakayuto/intmax402-core");
+const intmax2_server_sdk_1 = require("intmax2-server-sdk");
 const RPC_URLS = {
     mainnet: "https://api.rpc.intmax.io?network=ethereum",
     testnet: "https://sepolia.gateway.tenderly.co",
@@ -11,29 +12,58 @@ class INTMAX402Client {
     wallet;
     environment;
     initialized = false;
+    intmaxClient = null;
     constructor(options) {
+        // Validate private key before creating wallet
+        if (!ethers_1.ethers.isHexString(options.privateKey, 32)) {
+            throw new Error("Invalid private key: must be a 32-byte hex string (0x-prefixed)");
+        }
         this.wallet = new ethers_1.ethers.Wallet(options.privateKey);
         this.environment = options.environment || "testnet";
     }
     async init() {
-        // In production: IntMaxNodeClient.login() (~7s one-time)
+        this.initialized = true;
+    }
+    async initPayment(l1RpcUrl) {
+        this.intmaxClient = new intmax2_server_sdk_1.IntMaxNodeClient({
+            environment: this.environment,
+            eth_private_key: this.wallet.privateKey,
+            l1_rpc_url: l1RpcUrl || RPC_URLS[this.environment],
+            loggerLevel: "warn",
+        });
+        await this.intmaxClient.login();
         this.initialized = true;
     }
     getAddress() {
         return this.wallet.address;
     }
+    getIntMaxAddress() {
+        if (!this.intmaxClient)
+            throw new Error("Call initPayment() first");
+        return this.intmaxClient.address;
+    }
     getRpcUrl() {
         return RPC_URLS[this.environment];
     }
-    /**
-     * Sign a nonce using Ethereum personal_sign (compatible with ethers.verifyMessage).
-     */
     async sign(nonce) {
         return await this.wallet.signMessage(nonce);
     }
+    async sendPayment(recipientAddress, amount, token) {
+        if (!this.intmaxClient) {
+            throw new Error("Call initPayment() before sending payments");
+        }
+        const result = await this.intmaxClient.broadcastTransaction([
+            { address: recipientAddress, amount, token },
+        ]);
+        return {
+            txTreeRoot: result.txTreeRoot,
+            transferDigest: result.transferDigests[0],
+        };
+    }
     /**
      * Fetch a resource, automatically handling 401/402 INTMAX402 challenges.
-     * Flow: GET → 401/402 + nonce → sign → GET + Authorization → 200
+     * For identity mode: GET -> 401 + nonce -> sign -> GET + Authorization -> 200
+     * For payment mode: GET -> 402 + nonce + payment info -> pay + sign -> GET + Authorization (with txHash) -> 200
      */
     async fetch(url, options) {
         const initialResponse = await globalThis.fetch(url, options);
@@ -46,11 +76,33 @@ class INTMAX402Client {
         const challenge = (0, intmax402_core_1.parseWWWAuthenticate)(wwwAuth);
         if (!challenge)
             return initialResponse;
-        // Sign the nonce
         const signature = await this.sign(challenge.nonce);
-        // Build authorization header
-        const authHeader = `INTMAX402 address="${this.wallet.address}", nonce="${challenge.nonce}", signature="${signature}"`;
-        // Retry with credentials
+        let authHeader = `INTMAX402 address="${this.wallet.address}", nonce="${challenge.nonce}", signature="${signature}"`;
+        // Payment mode: send payment and include txHash
+        if (challenge.mode === "payment") {
+            if (!this.intmaxClient) {
+                throw new Error("Payment required but intmax client not initialized. Call initPayment() first.");
+            }
+            if (!challenge.serverAddress || !challenge.amount) {
+                throw new Error("Server did not provide serverAddress or amount in challenge");
+            }
+            // Get token list and find matching token
+            const tokens = await this.intmaxClient.getTokensList();
+            let paymentToken;
+            if (challenge.tokenAddress) {
+                const found = tokens.find((t) => t.contractAddress.toLowerCase() === challenge.tokenAddress.toLowerCase());
+                if (!found) {
+                    throw new Error(`Token ${challenge.tokenAddress} not found in token list`);
+                }
+                paymentToken = found;
+            }
+            else {
+                // Default: native token (index 0)
+                paymentToken = tokens.find((t) => t.tokenIndex === 0) || tokens[0];
+            }
+            const { transferDigest } = await this.sendPayment(challenge.serverAddress, challenge.amount, paymentToken);
+            authHeader += `, txHash="${transferDigest}"`;
+        }
         return globalThis.fetch(url, {
             ...options,
             headers: {

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@tanakayuto/intmax402-client",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@tanakayuto/intmax402-core": "0.1.2",
-    "ethers": "^6.0.0"
+    "@tanakayuto/intmax402-core": "0.2.0",
+    "ethers": "^6.0.0",
+    "intmax2-server-sdk": "^1.5.2"
   },
   "devDependencies": {
-    "typescript": "^5.4.0",
     "@types/node": "^20.0.0",
-    "ethers": "^6.0.0"
+    "ethers": "^6.0.0",
+    "typescript": "^5.4.0"
   },
   "files": [
     "dist",