@t402/evm 2.2.0 → 2.3.0

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

@@ -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/cjs/scheme-CIar5W2B.d.ts

@@ -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.js';
+
+/**
+ * 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/cjs/{scheme-OojTBKAz.d.ts → scheme-CjijeY7y.d.ts}

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

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

@@ -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/cjs/upto/client/index.d.ts

@@ -0,0 +1,61 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { C as ClientEvmSigner } from '../../signer-DcavxxZt.js';
+
+/**
+ * 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/cjs/upto/client/index.js

@@ -0,0 +1,154 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/upto/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  UptoEvmScheme: () => UptoEvmScheme,
+  createUptoEvmScheme: () => createUptoEvmScheme
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/upto/client/scheme.ts
+var import_viem2 = require("viem");
+
+// src/types.ts
+var permitTypes = {
+  Permit: [
+    { name: "owner", type: "address" },
+    { name: "spender", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "nonce", type: "uint256" },
+    { name: "deadline", type: "uint256" }
+  ]
+};
+
+// src/utils.ts
+var import_viem = require("viem");
+function createNonce() {
+  const cryptoObj = typeof globalThis.crypto !== "undefined" ? globalThis.crypto : globalThis.crypto;
+  if (!cryptoObj) {
+    throw new Error("Crypto API not available");
+  }
+  return (0, import_viem.toHex)(cryptoObj.getRandomValues(new Uint8Array(32)));
+}
+
+// src/upto/client/scheme.ts
+var UptoEvmScheme = class {
+  /**
+   * Creates a new UptoEvmScheme instance.
+   *
+   * @param signer - The EVM signer for client operations
+   */
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", "upto");
+  }
+  /**
+   * 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
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    if (paymentRequirements.scheme !== "upto") {
+      throw new Error(`Expected upto scheme, got ${paymentRequirements.scheme}`);
+    }
+    const extra = paymentRequirements.extra;
+    if (!extra?.name || !extra?.version) {
+      throw new Error("EIP-712 domain parameters (name, version) are required for upto scheme");
+    }
+    const maxAmount = paymentRequirements.maxAmount;
+    if (!maxAmount) {
+      throw new Error("maxAmount is required for upto scheme");
+    }
+    const spender = extra.routerAddress ? (0, import_viem2.getAddress)(extra.routerAddress) : (0, import_viem2.getAddress)(paymentRequirements.payTo);
+    const now = Math.floor(Date.now() / 1e3);
+    const deadline = now + paymentRequirements.maxTimeoutSeconds;
+    const permitNonce = extra.permitNonce ?? 0;
+    const authorization = {
+      owner: this.signer.address,
+      spender,
+      value: maxAmount,
+      deadline: deadline.toString(),
+      nonce: permitNonce
+    };
+    const signature = await this.signPermit(authorization, paymentRequirements);
+    const paymentNonce = createNonce();
+    const payload = {
+      signature,
+      authorization,
+      paymentNonce
+    };
+    return {
+      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
+   */
+  async signPermit(authorization, requirements) {
+    const chainId = parseInt(requirements.network.split(":")[1]);
+    const extra = requirements.extra;
+    const domain = {
+      name: extra.name,
+      version: extra.version,
+      chainId,
+      verifyingContract: (0, import_viem2.getAddress)(requirements.asset)
+    };
+    const message = {
+      owner: (0, import_viem2.getAddress)(authorization.owner),
+      spender: (0, import_viem2.getAddress)(authorization.spender),
+      value: BigInt(authorization.value),
+      nonce: BigInt(authorization.nonce),
+      deadline: BigInt(authorization.deadline)
+    };
+    const signature = await this.signer.signTypedData({
+      domain,
+      types: permitTypes,
+      primaryType: "Permit",
+      message
+    });
+    const r = `0x${signature.slice(2, 66)}`;
+    const s = `0x${signature.slice(66, 130)}`;
+    const v = parseInt(signature.slice(130, 132), 16);
+    return { v, r, s };
+  }
+};
+function createUptoEvmScheme(signer) {
+  return new UptoEvmScheme(signer);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UptoEvmScheme,
+  createUptoEvmScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/upto/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/upto/client/index.ts","../../../../src/upto/client/scheme.ts","../../../../src/types.ts","../../../../src/utils.ts"],"sourcesContent":["/**\n * Up-To Scheme Client for EVM\n *\n * @example\n * ```typescript\n * import { UptoEvmScheme, createUptoEvmScheme } from \"@t402/evm/upto/client\";\n * import { privateKeyToAccount } from \"viem/accounts\";\n *\n * const signer = privateKeyToAccount(privateKey);\n * const scheme = createUptoEvmScheme(signer);\n *\n * // Register with t402 client\n * client.registerScheme(\"eip155:8453\", scheme);\n * ```\n */\nexport { UptoEvmScheme, createUptoEvmScheme } from \"./scheme\";\n","import { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport { getAddress } from \"viem\";\nimport { permitTypes, UptoEIP2612Payload, UptoEvmExtra } from \"../../types\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { createNonce } from \"../../utils\";\n\n/**\n * EVM client implementation for the Up-To payment scheme.\n *\n * Uses EIP-2612 Permit to authorize up to a maximum amount,\n * enabling usage-based billing where the actual settlement\n * amount is determined by the server based on usage.\n *\n * @example\n * ```typescript\n * import { UptoEvmScheme } from \"@t402/evm/upto/client\";\n * import { privateKeyToAccount } from \"viem/accounts\";\n *\n * const signer = privateKeyToAccount(privateKey);\n * const scheme = new UptoEvmScheme(signer);\n *\n * // Client will register this with the t402 client\n * client.registerScheme(\"eip155:8453\", scheme);\n * ```\n */\nexport class UptoEvmScheme implements SchemeNetworkClient {\n  readonly scheme = \"upto\";\n\n  /**\n   * Creates a new UptoEvmScheme instance.\n   *\n   * @param signer - The EVM signer for client operations\n   */\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  /**\n   * Creates a payment payload for the Up-To scheme.\n   *\n   * The payload contains an EIP-2612 permit signature authorizing\n   * the router contract (or facilitator) to transfer up to the\n   * specified maximum amount.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements (must include maxAmount)\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Validate that this is an upto requirement\n    if (paymentRequirements.scheme !== \"upto\") {\n      throw new Error(`Expected upto scheme, got ${paymentRequirements.scheme}`);\n    }\n\n    const extra = paymentRequirements.extra as UptoEvmExtra;\n    if (!extra?.name || !extra?.version) {\n      throw new Error(\"EIP-712 domain parameters (name, version) are required for upto scheme\");\n    }\n\n    // Get maxAmount from the requirements\n    const maxAmount = (paymentRequirements as unknown as { maxAmount: string }).maxAmount;\n    if (!maxAmount) {\n      throw new Error(\"maxAmount is required for upto scheme\");\n    }\n\n    // Determine the spender (router contract or payTo address)\n    const spender = extra.routerAddress\n      ? getAddress(extra.routerAddress)\n      : getAddress(paymentRequirements.payTo);\n\n    // Calculate deadline\n    const now = Math.floor(Date.now() / 1000);\n    const deadline = now + paymentRequirements.maxTimeoutSeconds;\n\n    // Get the permit nonce from the token contract\n    // Note: In a real implementation, this would query the token contract\n    // For now, we'll use 0 and expect the caller to provide it via extra\n    const permitNonce = (extra as { permitNonce?: number }).permitNonce ?? 0;\n\n    // Create the permit authorization\n    const authorization: UptoEIP2612Payload[\"authorization\"] = {\n      owner: this.signer.address,\n      spender,\n      value: maxAmount,\n      deadline: deadline.toString(),\n      nonce: permitNonce,\n    };\n\n    // Sign the permit\n    const signature = await this.signPermit(authorization, paymentRequirements);\n\n    // Create unique payment nonce\n    const paymentNonce = createNonce();\n\n    const payload: UptoEIP2612Payload = {\n      signature,\n      authorization,\n      paymentNonce,\n    };\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n\n  /**\n   * Sign the EIP-2612 permit using EIP-712\n   *\n   * @param authorization - The permit authorization to sign\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to the signature components\n   */\n  private async signPermit(\n    authorization: UptoEIP2612Payload[\"authorization\"],\n    requirements: PaymentRequirements,\n  ): Promise<UptoEIP2612Payload[\"signature\"]> {\n    const chainId = parseInt(requirements.network.split(\":\")[1]);\n    const extra = requirements.extra as UptoEvmExtra;\n\n    const domain = {\n      name: extra.name,\n      version: extra.version,\n      chainId,\n      verifyingContract: getAddress(requirements.asset),\n    };\n\n    const message = {\n      owner: getAddress(authorization.owner),\n      spender: getAddress(authorization.spender),\n      value: BigInt(authorization.value),\n      nonce: BigInt(authorization.nonce),\n      deadline: BigInt(authorization.deadline),\n    };\n\n    // Sign with EIP-712\n    const signature = await this.signer.signTypedData({\n      domain,\n      types: permitTypes,\n      primaryType: \"Permit\",\n      message,\n    });\n\n    // Parse signature into v, r, s components\n    const r = `0x${signature.slice(2, 66)}` as `0x${string}`;\n    const s = `0x${signature.slice(66, 130)}` as `0x${string}`;\n    const v = parseInt(signature.slice(130, 132), 16);\n\n    return { v, r, s };\n  }\n}\n\n/**\n * Factory function to create an UptoEvmScheme.\n *\n * @param signer - The EVM signer\n * @returns A new UptoEvmScheme instance\n */\nexport function createUptoEvmScheme(signer: ClientEvmSigner): UptoEvmScheme {\n  return new UptoEvmScheme(signer);\n}\n","export type ExactEIP3009Payload = {\n  signature?: `0x${string}`;\n  authorization: {\n    from: `0x${string}`;\n    to: `0x${string}`;\n    value: string;\n    validAfter: string;\n    validBefore: string;\n    nonce: `0x${string}`;\n  };\n};\n\nexport type ExactEvmPayloadV1 = ExactEIP3009Payload;\n\nexport type ExactEvmPayloadV2 = ExactEIP3009Payload;\n\n/**\n * Payload for exact-legacy scheme (approve + transferFrom pattern)\n * Used for legacy USDT and other tokens without EIP-3009 support\n */\nexport type ExactLegacyPayload = {\n  signature?: `0x${string}`;\n  authorization: {\n    /** Payer address */\n    from: `0x${string}`;\n    /** Recipient address */\n    to: `0x${string}`;\n    /** Payment amount in token units */\n    value: string;\n    /** Unix timestamp after which the authorization is valid */\n    validAfter: string;\n    /** Unix timestamp before which the authorization is valid */\n    validBefore: string;\n    /** Unique nonce to prevent replay attacks */\n    nonce: `0x${string}`;\n    /** Facilitator address that will call transferFrom */\n    spender: `0x${string}`;\n  };\n};\n\n// ============================================================================\n// Up-To Scheme Types (EIP-2612 Permit)\n// ============================================================================\n\n/**\n * EIP-2612 Permit signature components\n */\nexport type PermitSignature = {\n  v: number;\n  r: `0x${string}`;\n  s: `0x${string}`;\n};\n\n/**\n * EIP-2612 Permit authorization parameters\n */\nexport type PermitAuthorization = {\n  /** Token owner address */\n  owner: `0x${string}`;\n  /** Spender address (router contract or facilitator) */\n  spender: `0x${string}`;\n  /** Maximum authorized value */\n  value: string;\n  /** Permit deadline (unix timestamp) */\n  deadline: string;\n  /** Permit nonce from token contract */\n  nonce: number;\n};\n\n/**\n * Payload for upto scheme using EIP-2612 Permit\n */\nexport type UptoEIP2612Payload = {\n  /** EIP-2612 permit signature */\n  signature: PermitSignature;\n  /** Permit authorization parameters */\n  authorization: PermitAuthorization;\n  /** Unique payment nonce (separate from permit nonce) */\n  paymentNonce: `0x${string}`;\n};\n\n/**\n * Compact payload with combined signature bytes\n */\nexport type UptoEIP2612PayloadCompact = {\n  /** Combined permit signature (65 bytes) */\n  signature: `0x${string}`;\n  /** Permit authorization parameters */\n  authorization: PermitAuthorization;\n  /** Unique payment nonce */\n  paymentNonce: `0x${string}`;\n};\n\nexport type UptoEvmPayloadV2 = UptoEIP2612Payload | UptoEIP2612PayloadCompact;\n\n/**\n * Extra fields for upto scheme requirements on EVM\n */\nexport type UptoEvmExtra = {\n  /** EIP-712 domain name (from token contract) */\n  name: string;\n  /** EIP-712 domain version */\n  version: string;\n  /** Router contract address for settlement */\n  routerAddress?: `0x${string}`;\n  /** Billing unit */\n  unit?: string;\n  /** Price per unit */\n  unitPrice?: string;\n};\n\n/**\n * Settlement data for upto scheme\n */\nexport type UptoEvmSettlement = {\n  /** Actual amount to settle (must be <= maxAmount) */\n  settleAmount: string;\n  /** Usage details for auditing */\n  usageDetails?: {\n    unitsConsumed?: number;\n    unitPrice?: string;\n    unitType?: string;\n    startTime?: number;\n    endTime?: number;\n  };\n};\n\n/**\n * EIP-712 typed data for EIP-2612 Permit\n */\nexport const permitTypes = {\n  Permit: [\n    { name: \"owner\", type: \"address\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n  ],\n} as const;\n\n/**\n * Type guard for UptoEIP2612Payload\n *\n * @param payload - The payload to check\n * @returns True if the payload is a valid UptoEIP2612Payload\n */\nexport function isUptoEIP2612Payload(payload: unknown): payload is UptoEIP2612Payload {\n  if (typeof payload !== \"object\" || payload === null) return false;\n  const p = payload as Record<string, unknown>;\n  return (\n    \"signature\" in p &&\n    \"authorization\" in p &&\n    \"paymentNonce\" in p &&\n    typeof p.authorization === \"object\" &&\n    p.authorization !== null &&\n    \"owner\" in (p.authorization as Record<string, unknown>) &&\n    \"spender\" in (p.authorization as Record<string, unknown>) &&\n    \"value\" in (p.authorization as Record<string, unknown>) &&\n    \"deadline\" in (p.authorization as Record<string, unknown>) &&\n    \"nonce\" in (p.authorization as Record<string, unknown>)\n  );\n}\n","import { toHex } from \"viem\";\nimport { Network } from \"@t402/core/types\";\n\n/**\n * Extract chain ID from network string (e.g., \"base-sepolia\" -> 84532)\n * Used by v1 implementations\n *\n * @param network - The network identifier\n * @returns The numeric chain ID\n */\nexport function getEvmChainId(network: Network): number {\n  const networkMap: Record<string, number> = {\n    base: 8453,\n    \"base-sepolia\": 84532,\n    ethereum: 1,\n    sepolia: 11155111,\n    polygon: 137,\n    \"polygon-amoy\": 80002,\n  };\n  return networkMap[network] || 1;\n}\n\n/**\n * Create a random 32-byte nonce for authorization\n *\n * @returns A hex-encoded 32-byte nonce\n */\nexport function createNonce(): `0x${string}` {\n  // Use dynamic import to avoid require() in ESM context\n  const cryptoObj =\n    typeof globalThis.crypto !== \"undefined\"\n      ? globalThis.crypto\n      : (globalThis as { crypto?: Crypto }).crypto;\n\n  if (!cryptoObj) {\n    throw new Error(\"Crypto API not available\");\n  }\n\n  return toHex(cryptoObj.getRandomValues(new Uint8Array(32)));\n}\n"],"mappings":"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","names":["import_viem"]}

package/dist/cjs/upto/index.d.ts

@@ -0,0 +1,111 @@
+export { UptoEvmScheme, createUptoEvmScheme } from './client/index.js';
+export { b as UptoEvmFacilitatorScheme, e as UptoEvmFacilitatorSchemeConfig, U as UptoEvmServerScheme, a as UptoEvmServerSchemeConfig, d as createUptoEvmFacilitatorScheme, c as createUptoEvmServerScheme } from '../scheme-CIar5W2B.js';
+import '@t402/core/types';
+import '../signer-DcavxxZt.js';
+
+/**
+ * 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 };