@t402/evm 2.2.0 → 2.3.0

package/dist/{cjs/scheme-yqGaK9rK.d.ts → esm/scheme-B4rXSKCN.d.mts}

@@ -15,7 +15,25 @@ declare class ExactEvmScheme implements SchemeNetworkServer {
     readonly scheme = "exact";
     private moneyParsers;
     private config;
+    /**
+     * Creates a new ExactEvmScheme instance.
+     *
+     * @param config - Optional configuration options for the scheme
+     */
     constructor(config?: ExactEvmSchemeConfig);
+    /**
+     * Get all supported networks
+     *
+     * @returns Array of network identifiers in CAIP-2 format
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     *
+     * @param network - The network identifier to check
+     * @returns True if the network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
     /**
      * Register a custom money parser in the parser chain.
      * Multiple parsers can be registered - they will be tried in registration order.
@@ -101,14 +119,6 @@ declare class ExactEvmScheme implements SchemeNetworkServer {
      * @returns The asset information including address, name, version, and decimals
      */
     private getDefaultAsset;
-    /**
-     * Get asset info for a given symbol on a network
-     *
-     * @param symbol - The asset symbol (e.g., "USDT0", "USDC", "USDT")
-     * @param network - The network to use
-     * @returns The token configuration
-     */
-    private getAssetInfo;
     /**
      * Get the number of decimals for the asset on a network
      *
@@ -117,14 +127,6 @@ declare class ExactEvmScheme implements SchemeNetworkServer {
      * @returns The number of decimals for the asset
      */
     private getAssetDecimals;
-    /**
-     * Get all supported networks
-     */
-    static getSupportedNetworks(): string[];
-    /**
-     * Check if a network is supported
-     */
-    static isNetworkSupported(network: string): boolean;
 }
 
 export { ExactEvmScheme as E, type ExactEvmSchemeConfig as a };

package/dist/esm/scheme-DATfd6oM.d.mts

@@ -0,0 +1,200 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements, SchemeNetworkFacilitator, PaymentPayload, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorEvmSigner } from './signer-DcavxxZt.mjs';
+
+/**
+ * Configuration options for UptoEvmServerScheme
+ */
+interface UptoEvmServerSchemeConfig {
+    /** Preferred token symbol (e.g., "USDT0", "USDC"). Defaults to network's highest priority token. */
+    preferredToken?: string;
+    /** Router contract address for upto payments. If not set, payTo address is used as spender. */
+    routerAddress?: string;
+    /** Default billing unit */
+    defaultUnit?: string;
+    /** Default unit price in smallest denomination */
+    defaultUnitPrice?: string;
+}
+/**
+ * EVM server implementation for the Up-To payment scheme.
+ *
+ * Enables usage-based billing by creating payment requirements
+ * that authorize up to a maximum amount, with actual settlement
+ * determined by usage.
+ *
+ * @example
+ * ```typescript
+ * import { UptoEvmServerScheme } from "@t402/evm/upto/server";
+ *
+ * const scheme = new UptoEvmServerScheme({
+ *   routerAddress: "0x...",  // T402UptoRouter contract
+ *   defaultUnit: "token",
+ *   defaultUnitPrice: "100", // $0.0001 per token
+ * });
+ *
+ * server.registerScheme("eip155:8453", scheme);
+ * ```
+ */
+declare class UptoEvmServerScheme implements SchemeNetworkServer {
+    readonly scheme = "upto";
+    private moneyParsers;
+    private config;
+    /**
+     * Creates a new UptoEvmServerScheme instance.
+     *
+     * @param config - Optional configuration options for the scheme
+     */
+    constructor(config?: UptoEvmServerSchemeConfig);
+    /**
+     * Get all supported networks
+     *
+     * @returns Array of network identifiers in CAIP-2 format
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported
+     *
+     * @param network - The network identifier to check
+     * @returns True if the network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+    /**
+     * Register a custom money parser in the parser chain.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount
+     * @returns The server instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): UptoEvmServerScheme;
+    /**
+     * Parses a price into an asset amount for maxAmount.
+     *
+     * @param price - The price to parse (represents maxAmount)
+     * @param network - The network to use
+     * @returns Promise resolving to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements for the upto scheme.
+     *
+     * @param paymentRequirements - Base payment requirements
+     * @param supportedKind - The supported kind from facilitator
+     * @param supportedKind.t402Version - T402 protocol version
+     * @param supportedKind.scheme - Payment scheme
+     * @param supportedKind.network - Network identifier
+     * @param supportedKind.extra - Extra configuration
+     * @param facilitatorExtensions - Extensions supported by the facilitator
+     * @returns Enhanced payment requirements for upto scheme
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, facilitatorExtensions: string[]): Promise<PaymentRequirements>;
+    /**
+     * Get the preferred token for a network.
+     *
+     * @param network - The network identifier
+     * @returns Token configuration
+     * @throws Error if no token is found for the network
+     */
+    private getPreferredToken;
+    /**
+     * Parse price to decimal value.
+     *
+     * @param price - Price string or number
+     * @returns Decimal amount
+     */
+    private parseToDecimal;
+}
+/**
+ * Factory function to create an UptoEvmServerScheme.
+ *
+ * @param config - Configuration options
+ * @returns A new UptoEvmServerScheme instance
+ */
+declare function createUptoEvmServerScheme(config?: UptoEvmServerSchemeConfig): UptoEvmServerScheme;
+
+/**
+ * Configuration for UptoEvmFacilitatorScheme
+ */
+interface UptoEvmFacilitatorSchemeConfig {
+    /**
+     * Router contract addresses by network (CAIP-2 format)
+     *
+     * @example { "eip155:8453": "0x..." }
+     */
+    routerAddresses?: Record<string, string>;
+}
+/**
+ * EVM facilitator implementation for the Up-To payment scheme.
+ *
+ * Handles verification and settlement of upto payments using
+ * the T402UptoRouter contract.
+ *
+ * @example
+ * ```typescript
+ * import { UptoEvmFacilitatorScheme } from "@t402/evm/upto/facilitator";
+ *
+ * const facilitator = new UptoEvmFacilitatorScheme(signer, {
+ *   routerAddresses: {
+ *     "eip155:8453": "0x...",  // Base mainnet router
+ *     "eip155:84532": "0x...", // Base Sepolia router
+ *   },
+ * });
+ *
+ * facilitatorServer.registerScheme(facilitator);
+ * ```
+ */
+declare class UptoEvmFacilitatorScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "upto";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    /**
+     * Creates a new UptoEvmFacilitatorScheme instance.
+     *
+     * @param signer - The EVM signer for facilitator operations
+     * @param config - Optional configuration
+     */
+    constructor(signer: FacilitatorEvmSigner, config?: UptoEvmFacilitatorSchemeConfig);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     *
+     * @param network - The network identifier
+     * @returns Extra data including router address if configured
+     */
+    getExtra(network: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     *
+     * @param _ - The network identifier (unused for EVM)
+     * @returns Array of facilitator wallet addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies an upto payment payload.
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles an upto payment by calling the T402UptoRouter contract.
+     *
+     * @param payload - The verified payment payload
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+/**
+ * Factory function to create an UptoEvmFacilitatorScheme.
+ *
+ * @param signer - The EVM signer
+ * @param config - Configuration options
+ * @returns A new UptoEvmFacilitatorScheme instance
+ */
+declare function createUptoEvmFacilitatorScheme(signer: FacilitatorEvmSigner, config?: UptoEvmFacilitatorSchemeConfig): UptoEvmFacilitatorScheme;
+
+export { UptoEvmServerScheme as U, type UptoEvmServerSchemeConfig as a, UptoEvmFacilitatorScheme as b, createUptoEvmServerScheme as c, createUptoEvmFacilitatorScheme as d, type UptoEvmFacilitatorSchemeConfig as e };

package/dist/esm/{scheme-D4mOqq9l.d.mts → scheme-Ddb0dG_F.d.mts}

@@ -1,5 +1,5 @@
 import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
-import { C as ClientEvmSigner } from './signer-BkcAzwYi.mjs';
+import { C as ClientEvmSigner } from './signer-DcavxxZt.mjs';
 
 /**
  * EVM client implementation for the Exact payment scheme.

package/dist/{cjs/signer-BkcAzwYi.d.ts → esm/signer-DcavxxZt.d.mts}

@@ -58,22 +58,5 @@ type FacilitatorEvmSigner = {
         address: `0x${string}`;
     }): Promise<`0x${string}` | undefined>;
 };
-/**
- * Converts a signer to a ClientEvmSigner
- *
- * @param signer - The signer to convert to a ClientEvmSigner
- * @returns The converted signer
- */
-declare function toClientEvmSigner(signer: ClientEvmSigner): ClientEvmSigner;
-/**
- * Converts a viem client with single address to a FacilitatorEvmSigner
- * Wraps the single address in a getAddresses() function for compatibility
- *
- * @param client - The client to convert (must have 'address' property)
- * @returns FacilitatorEvmSigner with getAddresses() support
- */
-declare function toFacilitatorEvmSigner(client: Omit<FacilitatorEvmSigner, "getAddresses"> & {
-    address: `0x${string}`;
-}): FacilitatorEvmSigner;
 
-export { type ClientEvmSigner as C, type FacilitatorEvmSigner as F, toFacilitatorEvmSigner as a, toClientEvmSigner as t };
+export type { ClientEvmSigner as C, FacilitatorEvmSigner as F };

package/dist/esm/upto/client/index.d.mts

@@ -0,0 +1,61 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { C as ClientEvmSigner } from '../../signer-DcavxxZt.mjs';
+
+/**
+ * EVM client implementation for the Up-To payment scheme.
+ *
+ * Uses EIP-2612 Permit to authorize up to a maximum amount,
+ * enabling usage-based billing where the actual settlement
+ * amount is determined by the server based on usage.
+ *
+ * @example
+ * ```typescript
+ * import { UptoEvmScheme } from "@t402/evm/upto/client";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const signer = privateKeyToAccount(privateKey);
+ * const scheme = new UptoEvmScheme(signer);
+ *
+ * // Client will register this with the t402 client
+ * client.registerScheme("eip155:8453", scheme);
+ * ```
+ */
+declare class UptoEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "upto";
+    /**
+     * Creates a new UptoEvmScheme instance.
+     *
+     * @param signer - The EVM signer for client operations
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Creates a payment payload for the Up-To scheme.
+     *
+     * The payload contains an EIP-2612 permit signature authorizing
+     * the router contract (or facilitator) to transfer up to the
+     * specified maximum amount.
+     *
+     * @param t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements (must include maxAmount)
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Sign the EIP-2612 permit using EIP-712
+     *
+     * @param authorization - The permit authorization to sign
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to the signature components
+     */
+    private signPermit;
+}
+/**
+ * Factory function to create an UptoEvmScheme.
+ *
+ * @param signer - The EVM signer
+ * @returns A new UptoEvmScheme instance
+ */
+declare function createUptoEvmScheme(signer: ClientEvmSigner): UptoEvmScheme;
+
+export { UptoEvmScheme, createUptoEvmScheme };

package/dist/esm/upto/client/index.mjs

@@ -0,0 +1,11 @@
+import {
+  UptoEvmScheme,
+  createUptoEvmScheme
+} from "../../chunk-SURTCHSX.mjs";
+import "../../chunk-SYVPLXYV.mjs";
+import "../../chunk-NSSMTXJJ.mjs";
+export {
+  UptoEvmScheme,
+  createUptoEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/upto/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/upto/index.d.mts

@@ -0,0 +1,111 @@
+export { UptoEvmScheme, createUptoEvmScheme } from './client/index.mjs';
+export { b as UptoEvmFacilitatorScheme, e as UptoEvmFacilitatorSchemeConfig, U as UptoEvmServerScheme, a as UptoEvmServerSchemeConfig, d as createUptoEvmFacilitatorScheme, c as createUptoEvmServerScheme } from '../scheme-DATfd6oM.mjs';
+import '@t402/core/types';
+import '../signer-DcavxxZt.mjs';
+
+/**
+ * EIP-2612 Permit signature components
+ */
+type PermitSignature = {
+    v: number;
+    r: `0x${string}`;
+    s: `0x${string}`;
+};
+/**
+ * EIP-2612 Permit authorization parameters
+ */
+type PermitAuthorization = {
+    /** Token owner address */
+    owner: `0x${string}`;
+    /** Spender address (router contract or facilitator) */
+    spender: `0x${string}`;
+    /** Maximum authorized value */
+    value: string;
+    /** Permit deadline (unix timestamp) */
+    deadline: string;
+    /** Permit nonce from token contract */
+    nonce: number;
+};
+/**
+ * Payload for upto scheme using EIP-2612 Permit
+ */
+type UptoEIP2612Payload = {
+    /** EIP-2612 permit signature */
+    signature: PermitSignature;
+    /** Permit authorization parameters */
+    authorization: PermitAuthorization;
+    /** Unique payment nonce (separate from permit nonce) */
+    paymentNonce: `0x${string}`;
+};
+/**
+ * Compact payload with combined signature bytes
+ */
+type UptoEIP2612PayloadCompact = {
+    /** Combined permit signature (65 bytes) */
+    signature: `0x${string}`;
+    /** Permit authorization parameters */
+    authorization: PermitAuthorization;
+    /** Unique payment nonce */
+    paymentNonce: `0x${string}`;
+};
+type UptoEvmPayloadV2 = UptoEIP2612Payload | UptoEIP2612PayloadCompact;
+/**
+ * Extra fields for upto scheme requirements on EVM
+ */
+type UptoEvmExtra = {
+    /** EIP-712 domain name (from token contract) */
+    name: string;
+    /** EIP-712 domain version */
+    version: string;
+    /** Router contract address for settlement */
+    routerAddress?: `0x${string}`;
+    /** Billing unit */
+    unit?: string;
+    /** Price per unit */
+    unitPrice?: string;
+};
+/**
+ * Settlement data for upto scheme
+ */
+type UptoEvmSettlement = {
+    /** Actual amount to settle (must be <= maxAmount) */
+    settleAmount: string;
+    /** Usage details for auditing */
+    usageDetails?: {
+        unitsConsumed?: number;
+        unitPrice?: string;
+        unitType?: string;
+        startTime?: number;
+        endTime?: number;
+    };
+};
+/**
+ * EIP-712 typed data for EIP-2612 Permit
+ */
+declare const permitTypes: {
+    readonly Permit: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }];
+};
+/**
+ * Type guard for UptoEIP2612Payload
+ *
+ * @param payload - The payload to check
+ * @returns True if the payload is a valid UptoEIP2612Payload
+ */
+declare function isUptoEIP2612Payload(payload: unknown): payload is UptoEIP2612Payload;
+
+export { type PermitAuthorization, type PermitSignature, type UptoEIP2612Payload, type UptoEIP2612PayloadCompact, type UptoEvmExtra, type UptoEvmPayloadV2, type UptoEvmSettlement, isUptoEIP2612Payload, permitTypes };

package/dist/esm/upto/index.mjs

@@ -0,0 +1,26 @@
+import {
+  UptoEvmFacilitatorScheme,
+  UptoEvmServerScheme,
+  createUptoEvmFacilitatorScheme,
+  createUptoEvmServerScheme
+} from "../chunk-SJ52GTJJ.mjs";
+import "../chunk-IWSDEZKI.mjs";
+import {
+  UptoEvmScheme,
+  createUptoEvmScheme,
+  isUptoEIP2612Payload,
+  permitTypes
+} from "../chunk-SURTCHSX.mjs";
+import "../chunk-SYVPLXYV.mjs";
+import "../chunk-NSSMTXJJ.mjs";
+export {
+  UptoEvmFacilitatorScheme,
+  UptoEvmScheme,
+  UptoEvmServerScheme,
+  createUptoEvmFacilitatorScheme,
+  createUptoEvmScheme,
+  createUptoEvmServerScheme,
+  isUptoEIP2612Payload,
+  permitTypes
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/upto/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/v1/index.d.mts

@@ -1,6 +1,6 @@
 export { ExactEvmSchemeV1 } from '../exact/v1/client/index.mjs';
 import '@t402/core/types';
-import '../signer-BkcAzwYi.mjs';
+import '../signer-DcavxxZt.mjs';
 
 declare const NETWORKS: string[];
 

package/dist/esm/v1/index.mjs

@@ -3,9 +3,11 @@ import {
 } from "../chunk-QLXM7BIB.mjs";
 import {
   ExactEvmSchemeV1
-} from "../chunk-JBWWBRYY.mjs";
-import "../chunk-ACDQ5QNT.mjs";
-import "../chunk-XYKAO6KJ.mjs";
+} from "../chunk-ZWEYARER.mjs";
+import "../chunk-4FBTQTNM.mjs";
+import "../chunk-Y4U7Q543.mjs";
+import "../chunk-SYVPLXYV.mjs";
+import "../chunk-NSSMTXJJ.mjs";
 export {
   ExactEvmSchemeV1,
   NETWORKS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t402/evm",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
@@ -24,18 +24,22 @@
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsdoc": "^50.6.9",
     "eslint-plugin-prettier": "^5.2.6",
+    "glob": "^13.0.0",
     "prettier": "3.5.2",
     "tsup": "^8.4.0",
-    "tsx": "^4.19.2",
+    "tsx": "^4.21.0",
     "typescript": "^5.7.3",
-    "vite": "^6.2.6",
+    "vite": "^7.3.1",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.0.5"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
-    "viem": "^2.39.3",
     "zod": "^3.24.2",
-    "@t402/core": "2.0.0"
+    "@t402/core": "2.3.0",
+    "@t402/evm-core": "2.3.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.0.0"
   },
   "exports": {
     ".": {
@@ -107,6 +111,26 @@
         "types": "./dist/cjs/exact/v1/facilitator/index.d.ts",
         "default": "./dist/cjs/exact/v1/facilitator/index.js"
       }
+    },
+    "./upto": {
+      "import": {
+        "types": "./dist/esm/upto/index.d.mts",
+        "default": "./dist/esm/upto/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/upto/index.d.ts",
+        "default": "./dist/cjs/upto/index.js"
+      }
+    },
+    "./upto/client": {
+      "import": {
+        "types": "./dist/esm/upto/client/index.d.mts",
+        "default": "./dist/esm/upto/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/upto/client/index.d.ts",
+        "default": "./dist/cjs/upto/client/index.js"
+      }
     }
   },
   "files": [