@t402/evm 2.6.1 → 2.7.1

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

@@ -1,145 +1,9 @@
 export { Permit2EvmClientConfig, Permit2EvmScheme as Permit2EvmClientScheme, registerPermit2EvmScheme as registerPermit2EvmClientScheme } from './client/index.mjs';
 export { P as Permit2EvmResourceServerConfig, a as Permit2EvmServerScheme, b as Permit2EvmServerSchemeConfig, r as registerPermit2EvmServerScheme } from '../index-fzI2FyBT.mjs';
 export { Permit2EvmFacilitatorConfig, Permit2EvmScheme as Permit2EvmFacilitatorScheme, Permit2EvmSchemeConfig as Permit2EvmFacilitatorSchemeConfig, registerPermit2EvmScheme as registerPermit2EvmFacilitatorScheme } from './facilitator/index.mjs';
+export { P as PERMIT2_ADDRESS, a as Permit2PayloadV2, b as PermitTransferFrom, S as SignatureTransferDetails, T as TokenPermissions, p as permit2ABI, c as permit2Types } 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 Types
- *
- * Type definitions for Uniswap Permit2 SignatureTransfer scheme.
- */
-/**
- * Token permissions for Permit2
- */
-type TokenPermissions = {
-    /** ERC20 token address */
-    token: `0x${string}`;
-    /** Maximum amount permitted to transfer */
-    amount: string;
-};
-/**
- * Permit2 PermitTransferFrom parameters
- */
-type PermitTransferFrom = {
-    /** Token and amount permissions */
-    permitted: TokenPermissions;
-    /** Unique nonce (monotonically increasing per owner on the Permit2 contract) */
-    nonce: string;
-    /** Unix timestamp deadline for the permit */
-    deadline: string;
-};
-/**
- * Transfer details for Permit2
- */
-type SignatureTransferDetails = {
-    /** Recipient address */
-    to: `0x${string}`;
-    /** Requested transfer amount */
-    requestedAmount: string;
-};
-/**
- * Permit2 payment payload (V2)
- */
-type Permit2PayloadV2 = {
-    /** The permit parameters */
-    permit: PermitTransferFrom;
-    /** Transfer destination and amount */
-    transferDetails: SignatureTransferDetails;
-    /** EIP-712 signature */
-    signature: `0x${string}`;
-    /** Token owner address */
-    owner: `0x${string}`;
-};
-
-/**
- * Permit2 Constants
- *
- * Uniswap Permit2 contract addresses, type hashes, and ABI fragments.
- */
-/** Canonical Permit2 contract address (same on all EVM chains) */
-declare const PERMIT2_ADDRESS: "0x000000000022D473030F116dDEE9F6B43aC78BA3";
-/** EIP-712 type definitions for Permit2 SignatureTransfer */
-declare const permit2Types: {
-    readonly PermitTransferFrom: 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 TokenPermissions: readonly [{
-        readonly name: "token";
-        readonly type: "address";
-    }, {
-        readonly name: "amount";
-        readonly type: "uint256";
-    }];
-};
-/** Permit2 ABI for permitTransferFrom */
-declare const permit2ABI: 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 components: readonly [{
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly name: "requestedAmount";
-            readonly type: "uint256";
-        }];
-        readonly name: "transferDetails";
-        readonly type: "tuple";
-    }, {
-        readonly name: "owner";
-        readonly type: "address";
-    }, {
-        readonly name: "signature";
-        readonly type: "bytes";
-    }];
-    readonly name: "permitTransferFrom";
-    readonly outputs: readonly [];
-    readonly stateMutability: "nonpayable";
-    readonly type: "function";
-}, {
-    readonly inputs: readonly [{
-        readonly name: "account";
-        readonly type: "address";
-    }];
-    readonly name: "balanceOf";
-    readonly outputs: readonly [{
-        readonly name: "";
-        readonly type: "uint256";
-    }];
-    readonly stateMutability: "view";
-    readonly type: "function";
-}];
-
-export { PERMIT2_ADDRESS, type Permit2PayloadV2, type PermitTransferFrom, type SignatureTransferDetails, type TokenPermissions, permit2ABI, permit2Types };

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

@@ -0,0 +1,83 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { C as ClientEvmSigner } from '../../signer-DcavxxZt.mjs';
+import { SelectPaymentRequirements, PaymentPolicy, t402Client } from '@t402/core/client';
+
+/**
+ * EVM client implementation for the Permit2 Proxy payment scheme.
+ *
+ * Uses Uniswap Permit2 PermitWitnessTransferFrom with a Witness struct
+ * that binds the payment to a specific facilitator and destination.
+ */
+declare class Permit2ProxyEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme: "permit2-proxy";
+    /**
+     * Creates a new Permit2ProxyEvmScheme instance.
+     *
+     * @param signer - The EVM signer for client operations
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Creates a payment payload for the Permit2 Proxy scheme.
+     *
+     * @param t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Sign the Permit2 PermitWitnessTransferFrom using EIP-712.
+     *
+     * @param permit - The permit transfer data
+     * @param witness - The witness data
+     * @param spender - The proxy contract address (spender in Permit2)
+     * @param requirements - The payment requirements
+     * @returns Signed typed data hex string
+     */
+    private signPermit2Witness;
+}
+
+/**
+ * Configuration options for registering Permit2 Proxy EVM schemes to an t402Client
+ */
+interface Permit2ProxyEvmClientConfig {
+    /**
+     * The EVM signer to use for creating payment payloads
+     */
+    signer: ClientEvmSigner;
+    /**
+     * Optional payment requirements selector function
+     * If not provided, uses the default selector (first available option)
+     */
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    /**
+     * Optional policies to apply to the client
+     */
+    policies?: PaymentPolicy[];
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (eip155:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Permit2 Proxy EVM payment schemes to an t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for Permit2 Proxy EVM client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerPermit2ProxyEvmScheme } from "@t402/evm/permit2-proxy/client";
+ * import { t402Client } from "@t402/core/client";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const account = privateKeyToAccount("0x...");
+ * const client = new t402Client();
+ * registerPermit2ProxyEvmScheme(client, { signer: account });
+ * ```
+ */
+declare function registerPermit2ProxyEvmScheme(client: t402Client, config: Permit2ProxyEvmClientConfig): t402Client;
+
+export { type Permit2ProxyEvmClientConfig, Permit2ProxyEvmScheme, registerPermit2ProxyEvmScheme };

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

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

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

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

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

@@ -0,0 +1,93 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
+import { F as FacilitatorEvmSigner } from '../../signer-DcavxxZt.mjs';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+/**
+ * Configuration for Permit2 Proxy EVM facilitator
+ */
+interface Permit2ProxyEvmSchemeConfig {
+    /** Override exact proxy contract address */
+    exactProxyAddress?: `0x${string}`;
+    /** Override upto proxy contract address */
+    uptoProxyAddress?: `0x${string}`;
+    [key: string]: unknown;
+}
+/**
+ * EVM facilitator implementation for the Permit2 Proxy payment scheme.
+ *
+ * Verifies Permit2 witness-based signatures and settles payments by calling
+ * settle() on the T402 proxy contracts.
+ */
+declare class Permit2ProxyEvmScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme: "permit2-proxy";
+    readonly caipFamily = "eip155:*";
+    private exactProxyAddress;
+    private uptoProxyAddress;
+    /**
+     * Creates a new Permit2 Proxy facilitator instance.
+     *
+     * @param signer - The facilitator EVM signer
+     * @param config - Optional configuration
+     */
+    constructor(signer: FacilitatorEvmSigner, config?: Permit2ProxyEvmSchemeConfig);
+    /**
+     * Get mechanism-specific extra data for supported kinds.
+     *
+     * @param _ - The network identifier
+     * @returns Extra data including proxy contract addresses
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses for this facilitator.
+     *
+     * @param _ - The network identifier
+     * @returns Array of signer addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verify a Permit2 Proxy payment payload.
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Verification result
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settle a Permit2 Proxy payment by calling settle() on the proxy contract.
+     *
+     * @param payload - The payment payload
+     * @param requirements - The payment requirements
+     * @returns Settlement result
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * Configuration options for registering Permit2 Proxy schemes to an t402Facilitator
+ */
+interface Permit2ProxyEvmFacilitatorConfig {
+    /**
+     * The EVM signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorEvmSigner;
+    /**
+     * Networks to register (single network or array of networks)
+     * Examples: "eip155:84532", ["eip155:84532", "eip155:1"]
+     */
+    networks: Network | Network[];
+    /**
+     * Optional scheme configuration (proxy contract addresses, etc.)
+     */
+    schemeConfig?: Permit2ProxyEvmSchemeConfig;
+}
+/**
+ * Registers Permit2 Proxy EVM payment schemes to an t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Permit2 Proxy EVM facilitator registration
+ * @returns The facilitator instance for chaining
+ */
+declare function registerPermit2ProxyEvmScheme(facilitator: t402Facilitator, config: Permit2ProxyEvmFacilitatorConfig): t402Facilitator;
+
+export { type Permit2ProxyEvmFacilitatorConfig, Permit2ProxyEvmScheme, type Permit2ProxyEvmSchemeConfig, registerPermit2ProxyEvmScheme };

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

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

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

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