@t402/evm 2.6.1 → 2.7.1

package/dist/esm/permit2-proxy/index.d.mts

@@ -0,0 +1,344 @@
+export { Permit2ProxyEvmClientConfig, Permit2ProxyEvmScheme as Permit2ProxyEvmClientScheme, registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmClientScheme } from './client/index.mjs';
+export { Permit2ProxyEvmResourceServerConfig, Permit2ProxyEvmScheme as Permit2ProxyEvmServerScheme, Permit2ProxyEvmSchemeConfig as Permit2ProxyEvmServerSchemeConfig, registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmServerScheme } from './server/index.mjs';
+export { Permit2ProxyEvmFacilitatorConfig, Permit2ProxyEvmScheme as Permit2ProxyEvmFacilitatorScheme, Permit2ProxyEvmSchemeConfig as Permit2ProxyEvmFacilitatorSchemeConfig, registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmFacilitatorScheme } from './facilitator/index.mjs';
+import { b as PermitTransferFrom } from '../constants-05D7IZJA.mjs';
+export { P as PERMIT2_ADDRESS, T as TokenPermissions } from '../constants-05D7IZJA.mjs';
+import '@t402/core/types';
+import '../signer-DcavxxZt.mjs';
+import '@t402/core/client';
+import '@t402/core/server';
+import '@t402/core/facilitator';
+
+/**
+ * Permit2 Proxy Types
+ *
+ * Type definitions for T402 Permit2 proxy scheme with witness-based
+ * facilitator binding via proxy contracts.
+ */
+
+/**
+ * Witness data bound into the payer's EIP-712 signature.
+ * Matches the Witness struct in T402BasePermit2Proxy.sol.
+ */
+type T402Witness = {
+    /** Destination address for the token transfer */
+    to: `0x${string}`;
+    /** Address authorized to call settle (must match facilitator) */
+    facilitator: `0x${string}`;
+    /** Earliest timestamp when settlement is permitted (0 = immediate) */
+    validAfter: string;
+};
+/**
+ * Permit2 Proxy payment payload (V2)
+ */
+type Permit2ProxyPayloadV2 = {
+    /** The permit parameters */
+    permit: PermitTransferFrom;
+    /** Witness data bound into the signature */
+    witness: T402Witness;
+    /** EIP-712 signature over PermitWitnessTransferFrom with Witness */
+    signature: `0x${string}`;
+    /** Token owner address */
+    owner: `0x${string}`;
+};
+
+/**
+ * Permit2 Proxy Constants
+ *
+ * Contract addresses, EIP-712 type definitions, and ABI fragments
+ * for T402 Permit2 proxy contracts with witness-based settlement.
+ */
+
+/** Scheme identifier for Permit2 proxy */
+declare const SCHEME_PERMIT2_PROXY: "permit2-proxy";
+/** T402 Exact Permit2 Proxy contract address (TBD - not yet deployed) */
+declare const T402_EXACT_PERMIT2_PROXY: `0x${string}`;
+/** T402 Upto Permit2 Proxy contract address (TBD - not yet deployed) */
+declare const T402_UPTO_PERMIT2_PROXY: `0x${string}`;
+/**
+ * EIP-712 typehash for the Witness struct.
+ * Must match WITNESS_TYPEHASH in T402BasePermit2Proxy.sol:
+ * keccak256("Witness(address to,address facilitator,uint256 validAfter)")
+ */
+declare const WITNESS_TYPEHASH: "0x5e3bbbe812684a9a24e1e1b7fe7c5b763bfb791ee8423aed3b4e1a5a9e25c255";
+/**
+ * Witness type string for Permit2's permitWitnessTransferFrom.
+ * Format: "Witness witness)TokenPermissions(...)Witness(...)" -- types listed alphabetically.
+ * Must match WITNESS_TYPE_STRING in T402BasePermit2Proxy.sol.
+ */
+declare const WITNESS_TYPE_STRING: "Witness witness)TokenPermissions(address token,uint256 amount)Witness(address to,address facilitator,uint256 validAfter)";
+/**
+ * EIP-712 type definitions for PermitWitnessTransferFrom with Witness.
+ * Used by clients when signing the permit with witness data.
+ */
+declare const permit2WitnessTypes: {
+    readonly PermitWitnessTransferFrom: readonly [{
+        readonly name: "permitted";
+        readonly type: "TokenPermissions";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "witness";
+        readonly type: "Witness";
+    }];
+    readonly TokenPermissions: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly Witness: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "facilitator";
+        readonly type: "address";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }];
+};
+/**
+ * ABI for T402ExactPermit2Proxy contract.
+ * Includes settle() and settleWithPermit() functions.
+ */
+declare const permit2ProxyExactABI: readonly [{
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }];
+            readonly name: "permitted";
+            readonly type: "tuple";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+        readonly name: "permit";
+        readonly type: "tuple";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+        }];
+        readonly name: "witness";
+        readonly type: "tuple";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly name: "settle";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly name: "value";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }, {
+            readonly name: "v";
+            readonly type: "uint8";
+        }, {
+            readonly name: "r";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "s";
+            readonly type: "bytes32";
+        }];
+        readonly name: "permit2612";
+        readonly type: "tuple";
+    }, {
+        readonly components: readonly [{
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }];
+            readonly name: "permitted";
+            readonly type: "tuple";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+        readonly name: "permit";
+        readonly type: "tuple";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+        }];
+        readonly name: "witness";
+        readonly type: "tuple";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly name: "settleWithPermit";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];
+/**
+ * ABI for T402UptoPermit2Proxy contract.
+ * Includes settle() and settleWithPermit() functions.
+ */
+declare const permit2ProxyUptoABI: readonly [{
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }];
+            readonly name: "permitted";
+            readonly type: "tuple";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+        readonly name: "permit";
+        readonly type: "tuple";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+        }];
+        readonly name: "witness";
+        readonly type: "tuple";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly name: "settle";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}, {
+    readonly inputs: readonly [{
+        readonly components: readonly [{
+            readonly name: "value";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }, {
+            readonly name: "v";
+            readonly type: "uint8";
+        }, {
+            readonly name: "r";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "s";
+            readonly type: "bytes32";
+        }];
+        readonly name: "permit2612";
+        readonly type: "tuple";
+    }, {
+        readonly components: readonly [{
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+            }];
+            readonly name: "permitted";
+            readonly type: "tuple";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+        }];
+        readonly name: "permit";
+        readonly type: "tuple";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+        }];
+        readonly name: "witness";
+        readonly type: "tuple";
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly name: "settleWithPermit";
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+    readonly type: "function";
+}];
+
+export { type Permit2ProxyPayloadV2, PermitTransferFrom, SCHEME_PERMIT2_PROXY, type T402Witness, T402_EXACT_PERMIT2_PROXY, T402_UPTO_PERMIT2_PROXY, WITNESS_TYPEHASH, WITNESS_TYPE_STRING, permit2ProxyExactABI, permit2ProxyUptoABI, permit2WitnessTypes };

package/dist/esm/permit2-proxy/index.mjs

@@ -0,0 +1,45 @@
+import {
+  Permit2ProxyEvmScheme,
+  registerPermit2ProxyEvmScheme
+} from "../chunk-HUUYTNV2.mjs";
+import {
+  Permit2ProxyEvmScheme as Permit2ProxyEvmScheme2,
+  registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmScheme2
+} from "../chunk-A2U6NWHQ.mjs";
+import {
+  Permit2ProxyEvmScheme as Permit2ProxyEvmScheme3,
+  registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmScheme3
+} from "../chunk-THXENBBU.mjs";
+import {
+  SCHEME_PERMIT2_PROXY,
+  T402_EXACT_PERMIT2_PROXY,
+  T402_UPTO_PERMIT2_PROXY,
+  WITNESS_TYPEHASH,
+  WITNESS_TYPE_STRING,
+  permit2ProxyExactABI,
+  permit2ProxyUptoABI,
+  permit2WitnessTypes
+} from "../chunk-UK2POASM.mjs";
+import {
+  PERMIT2_ADDRESS
+} from "../chunk-URG4HEYQ.mjs";
+import "../chunk-FUUW3JGG.mjs";
+import "../chunk-NSSMTXJJ.mjs";
+export {
+  PERMIT2_ADDRESS,
+  Permit2ProxyEvmScheme as Permit2ProxyEvmClientScheme,
+  Permit2ProxyEvmScheme3 as Permit2ProxyEvmFacilitatorScheme,
+  Permit2ProxyEvmScheme2 as Permit2ProxyEvmServerScheme,
+  SCHEME_PERMIT2_PROXY,
+  T402_EXACT_PERMIT2_PROXY,
+  T402_UPTO_PERMIT2_PROXY,
+  WITNESS_TYPEHASH,
+  WITNESS_TYPE_STRING,
+  permit2ProxyExactABI,
+  permit2ProxyUptoABI,
+  permit2WitnessTypes,
+  registerPermit2ProxyEvmScheme as registerPermit2ProxyEvmClientScheme,
+  registerPermit2ProxyEvmScheme3 as registerPermit2ProxyEvmFacilitatorScheme,
+  registerPermit2ProxyEvmScheme2 as registerPermit2ProxyEvmServerScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/permit2-proxy/index.mjs.map

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

package/dist/esm/permit2-proxy/server/index.d.mts

@@ -0,0 +1,130 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * Configuration options for Permit2ProxyEvmScheme server
+ */
+interface Permit2ProxyEvmSchemeConfig {
+    /** Preferred token symbol (e.g., "USDT0", "USDC"). Defaults to network's highest priority token. */
+    preferredToken?: string;
+    /** Override exact proxy contract address */
+    exactProxyAddress?: `0x${string}`;
+    /** Override upto proxy contract address */
+    uptoProxyAddress?: `0x${string}`;
+}
+/**
+ * EVM server implementation for the Permit2 Proxy payment scheme.
+ * Supports USDT0, USDC, and other ERC20 tokens via T402 Permit2 proxy contracts.
+ */
+declare class Permit2ProxyEvmScheme implements SchemeNetworkServer {
+    readonly scheme: "permit2-proxy";
+    private moneyParsers;
+    private config;
+    /**
+     * Creates a new Permit2ProxyEvmScheme server instance.
+     *
+     * @param config - Server configuration options
+     */
+    constructor(config?: Permit2ProxyEvmSchemeConfig);
+    /**
+     * Get the list of supported EVM networks.
+     *
+     * @returns Array of supported network identifiers
+     */
+    static getSupportedNetworks(): string[];
+    /**
+     * Check if a network is supported.
+     *
+     * @param network - Network identifier to check
+     * @returns Whether the network is supported
+     */
+    static isNetworkSupported(network: string): boolean;
+    /**
+     * Register a custom money parser for price conversion.
+     *
+     * @param parser - The money parser to register
+     * @returns This instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): Permit2ProxyEvmScheme;
+    /**
+     * Parse a price into an AssetAmount for the given network.
+     *
+     * @param price - The price to parse
+     * @param network - The target network
+     * @returns The parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements with Permit2 Proxy-specific data.
+     *
+     * @param paymentRequirements - The base payment requirements
+     * @param supportedKind - The supported kind metadata
+     * @param supportedKind.t402Version - Protocol version
+     * @param supportedKind.scheme - Payment scheme
+     * @param supportedKind.network - Target network
+     * @param supportedKind.extra - Extra metadata
+     * @param extensionKeys - Active extension keys
+     * @returns Enhanced payment requirements
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        t402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse a money value into a decimal number.
+     *
+     * @param money - The money value to parse
+     * @returns The decimal amount
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Convert a decimal amount to a token amount using default network token.
+     *
+     * @param amount - The decimal amount
+     * @param network - The target network
+     * @returns The asset amount with token details
+     */
+    private defaultMoneyConversion;
+    /**
+     * Convert a decimal amount string to token smallest units.
+     *
+     * @param decimalAmount - The decimal amount as a string
+     * @param decimals - The token's decimal places
+     * @returns The amount in smallest units
+     */
+    private convertToTokenAmount;
+    /**
+     * Get the default token asset for a network.
+     *
+     * @param network - The target network
+     * @returns The token configuration
+     */
+    private getDefaultAsset;
+}
+
+/**
+ * Configuration options for registering Permit2 Proxy schemes to an t402ResourceServer
+ */
+interface Permit2ProxyEvmResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (eip155:*)
+     */
+    networks?: Network[];
+    /**
+     * Optional scheme configuration
+     */
+    schemeConfig?: Permit2ProxyEvmSchemeConfig;
+}
+/**
+ * Registers Permit2 Proxy EVM payment schemes to an t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for Permit2 Proxy resource server registration
+ * @returns The server instance for chaining
+ */
+declare function registerPermit2ProxyEvmScheme(server: t402ResourceServer, config?: Permit2ProxyEvmResourceServerConfig): t402ResourceServer;
+
+export { type Permit2ProxyEvmResourceServerConfig, Permit2ProxyEvmScheme, type Permit2ProxyEvmSchemeConfig, registerPermit2ProxyEvmScheme };

package/dist/esm/permit2-proxy/server/index.mjs

@@ -0,0 +1,13 @@
+import {
+  Permit2ProxyEvmScheme,
+  registerPermit2ProxyEvmScheme
+} from "../../chunk-A2U6NWHQ.mjs";
+import "../../chunk-UK2POASM.mjs";
+import "../../chunk-URG4HEYQ.mjs";
+import "../../chunk-FUUW3JGG.mjs";
+import "../../chunk-NSSMTXJJ.mjs";
+export {
+  Permit2ProxyEvmScheme,
+  registerPermit2ProxyEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/permit2-proxy/server/index.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t402/evm",
-  "version": "2.6.1",
+  "version": "2.7.1",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
   "types": "./dist/cjs/index.d.ts",
@@ -38,8 +38,8 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@t402/core": "2.6.1",
-    "@t402/evm-core": "2.6.1"
+    "@t402/core": "2.7.1",
+    "@t402/evm-core": "2.7.1"
   },
   "peerDependencies": {
     "viem": "^2.0.0"
@@ -155,6 +155,46 @@
         "default": "./dist/cjs/permit2/facilitator/index.js"
       }
     },
+    "./permit2-proxy": {
+      "import": {
+        "types": "./dist/esm/permit2-proxy/index.d.mts",
+        "default": "./dist/esm/permit2-proxy/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/permit2-proxy/index.d.ts",
+        "default": "./dist/cjs/permit2-proxy/index.js"
+      }
+    },
+    "./permit2-proxy/client": {
+      "import": {
+        "types": "./dist/esm/permit2-proxy/client/index.d.mts",
+        "default": "./dist/esm/permit2-proxy/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/permit2-proxy/client/index.d.ts",
+        "default": "./dist/cjs/permit2-proxy/client/index.js"
+      }
+    },
+    "./permit2-proxy/server": {
+      "import": {
+        "types": "./dist/esm/permit2-proxy/server/index.d.mts",
+        "default": "./dist/esm/permit2-proxy/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/permit2-proxy/server/index.d.ts",
+        "default": "./dist/cjs/permit2-proxy/server/index.js"
+      }
+    },
+    "./permit2-proxy/facilitator": {
+      "import": {
+        "types": "./dist/esm/permit2-proxy/facilitator/index.d.mts",
+        "default": "./dist/esm/permit2-proxy/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/permit2-proxy/facilitator/index.d.ts",
+        "default": "./dist/cjs/permit2-proxy/facilitator/index.js"
+      }
+    },
     "./upto": {
       "import": {
         "types": "./dist/esm/upto/index.d.mts",