moltspay 1.2.1 → 1.4.0

package/dist/client/index.d.mts

@@ -1,4 +1,5 @@
-import { T as TokenSymbol } from '../index-DgJPZMBG.mjs';
+import { Wallet } from 'ethers';
+import { T as TokenSymbol } from '../index-D_2FkLwV.mjs';
 
 /**
  * MoltsPay Client Types
@@ -78,8 +79,8 @@ interface PayOptions {
     token?: TokenSymbol;
     /** Auto-select token based on balance (default: false) */
     autoSelect?: boolean;
-    /** Chain to pay on (base, polygon, or base_sepolia, default: base) */
-    chain?: 'base' | 'polygon' | 'base_sepolia';
+    /** Chain to pay on */
+    chain?: 'base' | 'polygon' | 'base_sepolia' | 'tempo_moderato' | 'bnb' | 'bnb_testnet' | 'solana' | 'solana_devnet';
 }
 declare class MoltsPayClient {
     private configDir;
@@ -97,6 +98,10 @@ declare class MoltsPayClient {
      * Get wallet address
      */
     get address(): string | null;
+    /**
+     * Get wallet instance (for direct operations like approvals)
+     */
+    getWallet(): Wallet | null;
     /**
      * Get current config
      */
@@ -121,6 +126,34 @@ declare class MoltsPayClient {
      * @param options - Payment options (token selection)
      */
     pay(serverUrl: string, service: string, params: Record<string, any>, options?: PayOptions): Promise<Record<string, any>>;
+    /**
+     * Handle MPP (Machine Payments Protocol) payment flow
+     * Called when pay() detects WWW-Authenticate header in 402 response
+     */
+    private handleMPPPayment;
+    /**
+     * Handle BNB Chain payment flow (pre-approval + intent signature)
+     *
+     * Flow:
+     * 1. Check client has approved server wallet (done via `moltspay init`)
+     * 2. Sign EIP-712 payment intent (no gas, just signature)
+     * 3. Send intent to server
+     * 4. Server executes service
+     * 5. Server calls transferFrom if successful (pay-for-success)
+     */
+    private handleBNBPayment;
+    /**
+     * Handle Solana payment flow
+     *
+     * Solana uses SPL token transfers with pay-for-success model:
+     * 1. Client creates and signs a transfer transaction
+     * 2. Server submits the transaction after service completes
+     */
+    private handleSolanaPayment;
+    /**
+     * Check ERC20 allowance for a spender
+     */
+    private checkAllowance;
     /**
      * Sign EIP-3009 transferWithAuthorization (GASLESS)
      * This only signs - no on-chain transaction, no gas needed.
@@ -166,13 +199,36 @@ declare class MoltsPayClient {
         native: number;
     }>;
     /**
-     * Get wallet balances on all supported chains (Base + Polygon)
+     * Get wallet balances on all supported chains (Base + Polygon + Tempo)
      */
     getAllBalances(): Promise<Record<string, {
         usdc: number;
         usdt: number;
         native: number;
+        tempo?: {
+            pathUSD: number;
+            alphaUSD: number;
+            betaUSD: number;
+            thetaUSD: number;
+        };
     }>>;
+    /**
+     * Pay for a service using MPP (Machine Payments Protocol)
+     *
+     * This implements the MPP flow manually for EOA wallets:
+     * 1. Request service → get 402 with WWW-Authenticate
+     * 2. Parse payment requirements
+     * 3. Execute transfer on Tempo chain
+     * 4. Retry with transaction hash as credential
+     *
+     * @param url - Full URL of the MPP-enabled endpoint
+     * @param options - Request options (body, headers)
+     * @returns Response from the service
+     */
+    payWithMPP(url: string, options?: {
+        body?: any;
+        headers?: Record<string, string>;
+    }): Promise<any>;
 }
 
 export { type ClientConfig, MoltsPayClient, type MoltsPayClientOptions, type PayOptions, type PaymentRequired, type ProviderInfo, type ServiceInfo, type ServicesResponse, type VerifyResponse, type WalletData };

package/dist/client/index.d.ts

@@ -1,4 +1,5 @@
-import { T as TokenSymbol } from '../index-DgJPZMBG.js';
+import { Wallet } from 'ethers';
+import { T as TokenSymbol } from '../index-D_2FkLwV.js';
 
 /**
  * MoltsPay Client Types
@@ -78,8 +79,8 @@ interface PayOptions {
     token?: TokenSymbol;
     /** Auto-select token based on balance (default: false) */
     autoSelect?: boolean;
-    /** Chain to pay on (base, polygon, or base_sepolia, default: base) */
-    chain?: 'base' | 'polygon' | 'base_sepolia';
+    /** Chain to pay on */
+    chain?: 'base' | 'polygon' | 'base_sepolia' | 'tempo_moderato' | 'bnb' | 'bnb_testnet' | 'solana' | 'solana_devnet';
 }
 declare class MoltsPayClient {
     private configDir;
@@ -97,6 +98,10 @@ declare class MoltsPayClient {
      * Get wallet address
      */
     get address(): string | null;
+    /**
+     * Get wallet instance (for direct operations like approvals)
+     */
+    getWallet(): Wallet | null;
     /**
      * Get current config
      */
@@ -121,6 +126,34 @@ declare class MoltsPayClient {
      * @param options - Payment options (token selection)
      */
     pay(serverUrl: string, service: string, params: Record<string, any>, options?: PayOptions): Promise<Record<string, any>>;
+    /**
+     * Handle MPP (Machine Payments Protocol) payment flow
+     * Called when pay() detects WWW-Authenticate header in 402 response
+     */
+    private handleMPPPayment;
+    /**
+     * Handle BNB Chain payment flow (pre-approval + intent signature)
+     *
+     * Flow:
+     * 1. Check client has approved server wallet (done via `moltspay init`)
+     * 2. Sign EIP-712 payment intent (no gas, just signature)
+     * 3. Send intent to server
+     * 4. Server executes service
+     * 5. Server calls transferFrom if successful (pay-for-success)
+     */
+    private handleBNBPayment;
+    /**
+     * Handle Solana payment flow
+     *
+     * Solana uses SPL token transfers with pay-for-success model:
+     * 1. Client creates and signs a transfer transaction
+     * 2. Server submits the transaction after service completes
+     */
+    private handleSolanaPayment;
+    /**
+     * Check ERC20 allowance for a spender
+     */
+    private checkAllowance;
     /**
      * Sign EIP-3009 transferWithAuthorization (GASLESS)
      * This only signs - no on-chain transaction, no gas needed.
@@ -166,13 +199,36 @@ declare class MoltsPayClient {
         native: number;
     }>;
     /**
-     * Get wallet balances on all supported chains (Base + Polygon)
+     * Get wallet balances on all supported chains (Base + Polygon + Tempo)
      */
     getAllBalances(): Promise<Record<string, {
         usdc: number;
         usdt: number;
         native: number;
+        tempo?: {
+            pathUSD: number;
+            alphaUSD: number;
+            betaUSD: number;
+            thetaUSD: number;
+        };
     }>>;
+    /**
+     * Pay for a service using MPP (Machine Payments Protocol)
+     *
+     * This implements the MPP flow manually for EOA wallets:
+     * 1. Request service → get 402 with WWW-Authenticate
+     * 2. Parse payment requirements
+     * 3. Execute transfer on Tempo chain
+     * 4. Retry with transaction hash as credential
+     *
+     * @param url - Full URL of the MPP-enabled endpoint
+     * @param options - Request options (body, headers)
+     * @returns Response from the service
+     */
+    payWithMPP(url: string, options?: {
+        body?: any;
+        headers?: Record<string, string>;
+    }): Promise<any>;
 }
 
 export { type ClientConfig, MoltsPayClient, type MoltsPayClientOptions, type PayOptions, type PaymentRequired, type ProviderInfo, type ServiceInfo, type ServicesResponse, type VerifyResponse, type WalletData };