@ic402/client 0.1.5 → 2.0.0

package/dist/client.d.ts

@@ -1,12 +1,12 @@
-import type { ContentDelivery, PaymentReceipt } from './types.js';
-import { type VoucherSigner } from './voucher.js';
-export interface BudgetConfig {
-    maxPerRequest?: bigint;
-    maxPerDay?: bigint;
-    maxTotal?: bigint;
-    maxSessionDeposit?: bigint;
-    alertThreshold?: bigint;
+/** Minimal identity interface — any ICP identity that can provide a principal. */
+export interface Ic402Identity {
+    getPrincipal(): {
+        toText(): string;
+    };
 }
+import type { ContentDelivery, Job, PaymentReceipt, ServiceDefinition } from './types.js';
+import { type VoucherSigner } from './voucher.js';
+import { type FetchX402Result } from './evm.js';
 export interface SessionPreferences {
     preferSession?: boolean;
     maxDeposit?: bigint;
@@ -22,26 +22,40 @@ export interface SessionPreferences {
     evmToken?: string;
     /** For EVM sessions: the canister's EVM address (settlement recipient). */
     evmRecipient?: string;
+    /** For EVM sessions: the EIP-3009 authorization (signed by the payer). */
+    authorization?: {
+        from: string;
+        to: string;
+        value: number | bigint;
+        validAfter: number | bigint;
+        validBefore: number | bigint;
+        nonce: number[];
+        v: number;
+        r: number[];
+        s: number[];
+    };
 }
 export interface Ic402ClientConfig {
+    /** Target canister ID. Required for all operations. */
+    canisterId: string;
+    /** Factory to create actors for canister calls. Required for all operations. */
+    actorFactory: (canisterId: string) => any;
     /** ICP identity for signing payments */
-    identity: unknown;
-    /** CAIP-2 network identifier */
+    identity: Ic402Identity | null;
+    /** CAIP-2 network identifier (e.g., "icp:1" for ICP, "eip155:84532" for Base Sepolia) */
     network: string;
-    /** Automatically handle 402 responses */
+    /** Automatically handle 402 responses (ICP: ICRC-2 approve + retry) */
     autoPayment?: boolean;
-    /** Budget limits */
-    budget?: BudgetConfig;
     /** Session preferences */
     sessions?: SessionPreferences;
-    /** Callback when budget alert threshold is hit */
-    onBudgetAlert?: (spent: bigint, limit: bigint) => Promise<void>;
-    /** Ledger canister ID for ICRC-2 auto-approval */
+    /** Ledger canister ID for ICRC-2 auto-approval (ICP payments) */
     ledger?: string;
-    /** Default target canister ID (spender for ICRC-2 approval) */
-    canisterId?: string;
-    /** Factory to create a ledger actor for ICRC-2 calls. Required for autoPayment. */
+    /** Factory for ledger actors. Required for ICP auto-payment. */
     ledgerActorFactory?: (ledgerCanisterId: string) => any;
+    /** Custom EVM RPC URL. If omitted, uses a public RPC for the chain. */
+    evmRpcUrl?: string;
+    /** Fee buffer added to ICRC-2 approval amount (default: 100_000). */
+    approvalFeeBuffer?: bigint;
 }
 export interface SessionHandle {
     id: string;
@@ -60,20 +74,19 @@ export interface SessionHandle {
  */
 export declare class Ic402Client {
     private config;
-    private totalSpent;
     constructor(config: Ic402ClientConfig);
     /**
      * Call a canister method, auto-handling 402 payment if needed.
      *
      * Flow: call method → if #paymentRequired → icrc2_approve → create sig → retry
      */
-    call(canisterId: string, method: string, args: unknown[], actorFactory?: (canisterId: string) => any): Promise<unknown>;
+    call(method: string, args: unknown[], canisterId?: string): Promise<unknown>;
     /**
      * Open a streaming session with escrow deposit.
      *
      * Flow: requestSession → calculate deposit → icrc2_approve → openSession → SessionHandle
      */
-    openSession(canisterId: string, config?: Partial<SessionPreferences>, actorFactory?: (canisterId: string) => any, signer?: VoucherSigner): Promise<SessionHandle>;
+    openSession(sessionConfig?: Partial<SessionPreferences>, signer?: VoucherSigner, canisterId?: string): Promise<SessionHandle>;
     /**
      * Fetch content from a ContentDelivery response.
      * Handles all delivery methods: inline, httpUrl, canisterQuery, assetCanister.
@@ -82,6 +95,67 @@ export declare class Ic402Client {
         canisterId?: string;
         actorFactory?: (canisterId: string) => any;
     }): Promise<Uint8Array>;
+    /**
+     * Fetch from an x402-gated URL. The full flow:
+     * 1. Client probes the URL → gets 402 with payment requirements
+     * 2. Client calls canister signX402Payment → gets signed EIP-3009 header
+     * 3. Client retries the URL with the signed X-Payment header
+     *
+     * @param url - The x402-gated URL to fetch
+     * @param actorFactory - Factory to create canister actor
+     */
+    fetchX402(url: string, options?: {
+        init?: RequestInit;
+        chainId?: number;
+    }): Promise<FetchX402Result>;
+    /**
+     * Register the canister as an agent on the ERC-8004 IdentityRegistry.
+     * Full flow: get chain state → canister signs → client broadcasts → poll receipt.
+     *
+     * @param actorFactory - Factory to create canister actor
+     * @param rpcUrl - Optional custom RPC URL for the target chain
+     */
+    registerAgent(rpcUrl?: string, chainId?: number): Promise<{
+        tokenId: bigint | null;
+        txHash: string;
+    }>;
+    /**
+     * Sign and broadcast an ERC-20 transfer.
+     * Client fetches chain state, canister signs, client broadcasts.
+     */
+    sendErc20Transfer(tokenAddress: string, recipient: string, amount: bigint, rpcUrl?: string): Promise<{
+        txHash: string;
+    }>;
+    /**
+     * Sign and broadcast a native ETH transfer.
+     */
+    sendEthTransfer(recipient: string, amountWei: bigint, rpcUrl?: string): Promise<{
+        txHash: string;
+    }>;
+    /** Extract numeric chain ID from CAIP-2 network string, or null if not EVM. */
+    private tryExtractChainId;
+    /** Extract chain ID or throw. */
+    private extractChainId;
+    /**
+     * List available services from the canister.
+     */
+    listServices(): Promise<ServiceDefinition[]>;
+    /**
+     * Submit a paid service request. Handles x402 payment automatically.
+     * Returns the job ID for polling.
+     */
+    submitServiceRequest(serviceId: string, params: Uint8Array): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Poll for a job result until completed or max attempts reached.
+     * Returns the full job record when done.
+     */
+    pollJobResult(jobId: string, maxAttempts?: number, intervalMs?: number): Promise<Job>;
+    /**
+     * Dispute a job result (for BuyerConfirm verification).
+     */
+    disputeJob(jobId: string, reason: string): Promise<void>;
     /**
      * Discover agents via ERC-8004 registries.
      *

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}