@t402/evm 2.5.0 → 2.6.1

package/dist/esm/chunk-NIGKNI66.mjs

@@ -0,0 +1,224 @@
+import {
+  PERMIT2_ADDRESS,
+  erc20BalanceABI,
+  permit2ABI
+} from "./chunk-URG4HEYQ.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
+
+// src/permit2/facilitator/scheme.ts
+import { getAddress } from "viem";
+var Permit2EvmScheme = class {
+  /**
+   * Creates a new Permit2 facilitator instance.
+   *
+   * @param signer - The facilitator EVM signer
+   */
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", "permit2");
+    __publicField(this, "caipFamily", "eip155:*");
+  }
+  /**
+   * Get mechanism-specific extra data for supported kinds.
+   *
+   * @param _ - The network identifier
+   * @returns Extra data including permit2 contract address
+   */
+  getExtra(_) {
+    return { permit2Address: PERMIT2_ADDRESS };
+  }
+  /**
+   * Get signer addresses for this facilitator.
+   *
+   * @param _ - The network identifier
+   * @returns Array of signer addresses
+   */
+  getSigners(_) {
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verify a Permit2 payment payload.
+   *
+   * @param payload - The payment payload to verify
+   * @param requirements - The payment requirements
+   * @returns Verification result
+   */
+  async verify(payload, requirements) {
+    const permit2Payload = payload.payload;
+    if (!permit2Payload?.permit?.permitted?.token || !permit2Payload?.owner) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_payload_structure",
+        payer: void 0
+      };
+    }
+    if (payload.accepted.scheme !== "permit2" || requirements.scheme !== "permit2") {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_scheme",
+        payer: permit2Payload.owner
+      };
+    }
+    if (payload.accepted.network !== requirements.network) {
+      return {
+        isValid: false,
+        invalidReason: "network_mismatch",
+        payer: permit2Payload.owner
+      };
+    }
+    if (getAddress(permit2Payload.permit.permitted.token) !== getAddress(requirements.asset)) {
+      return {
+        isValid: false,
+        invalidReason: "token_mismatch",
+        payer: permit2Payload.owner
+      };
+    }
+    if (getAddress(permit2Payload.transferDetails.to) !== getAddress(requirements.payTo)) {
+      return {
+        isValid: false,
+        invalidReason: "recipient_mismatch",
+        payer: permit2Payload.owner
+      };
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    if (BigInt(permit2Payload.permit.deadline) < BigInt(now + 6)) {
+      return {
+        isValid: false,
+        invalidReason: "permit_expired",
+        payer: permit2Payload.owner
+      };
+    }
+    if (BigInt(permit2Payload.permit.permitted.amount) < BigInt(requirements.amount)) {
+      return {
+        isValid: false,
+        invalidReason: "insufficient_permitted_amount",
+        payer: permit2Payload.owner
+      };
+    }
+    if (BigInt(permit2Payload.transferDetails.requestedAmount) < BigInt(requirements.amount)) {
+      return {
+        isValid: false,
+        invalidReason: "insufficient_requested_amount",
+        payer: permit2Payload.owner
+      };
+    }
+    try {
+      const balance = await this.signer.readContract({
+        address: getAddress(requirements.asset),
+        abi: erc20BalanceABI,
+        functionName: "balanceOf",
+        args: [getAddress(permit2Payload.owner)]
+      });
+      if (BigInt(balance) < BigInt(requirements.amount)) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_funds",
+          payer: permit2Payload.owner
+        };
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        isValid: false,
+        invalidReason: `balance_check_failed: ${errorMessage}`,
+        payer: permit2Payload.owner
+      };
+    }
+    return {
+      isValid: true,
+      invalidReason: void 0,
+      payer: permit2Payload.owner
+    };
+  }
+  /**
+   * Settle a Permit2 payment by executing permitTransferFrom.
+   *
+   * @param payload - The payment payload
+   * @param requirements - The payment requirements
+   * @returns Settlement result
+   */
+  async settle(payload, requirements) {
+    const permit2Payload = payload.payload;
+    if (!permit2Payload?.permit?.permitted?.token || !permit2Payload?.owner) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "invalid_payload_structure",
+        payer: void 0
+      };
+    }
+    const valid = await this.verify(payload, requirements);
+    if (!valid.isValid) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: valid.invalidReason ?? "invalid_scheme",
+        payer: permit2Payload.owner
+      };
+    }
+    try {
+      const tx = await this.signer.writeContract({
+        address: PERMIT2_ADDRESS,
+        abi: permit2ABI,
+        functionName: "permitTransferFrom",
+        args: [
+          {
+            permitted: {
+              token: getAddress(permit2Payload.permit.permitted.token),
+              amount: BigInt(permit2Payload.permit.permitted.amount)
+            },
+            nonce: BigInt(permit2Payload.permit.nonce),
+            deadline: BigInt(permit2Payload.permit.deadline)
+          },
+          {
+            to: getAddress(permit2Payload.transferDetails.to),
+            requestedAmount: BigInt(permit2Payload.transferDetails.requestedAmount)
+          },
+          getAddress(permit2Payload.owner),
+          permit2Payload.signature
+        ]
+      });
+      const receipt = await this.signer.waitForTransactionReceipt({ hash: tx });
+      if (receipt.status !== "success") {
+        return {
+          success: false,
+          errorReason: "invalid_transaction_state",
+          transaction: tx,
+          network: payload.accepted.network,
+          payer: permit2Payload.owner
+        };
+      }
+      return {
+        success: true,
+        transaction: tx,
+        network: payload.accepted.network,
+        payer: permit2Payload.owner
+      };
+    } catch (error) {
+      console.error("Failed to settle Permit2 transaction:", error);
+      return {
+        success: false,
+        errorReason: "transaction_failed",
+        transaction: "",
+        network: payload.accepted.network,
+        payer: permit2Payload.owner
+      };
+    }
+  }
+};
+
+// src/permit2/facilitator/register.ts
+function registerPermit2EvmScheme(facilitator, config) {
+  facilitator.register(config.networks, new Permit2EvmScheme(config.signer));
+  return facilitator;
+}
+
+export {
+  Permit2EvmScheme,
+  registerPermit2EvmScheme
+};
+//# sourceMappingURL=chunk-NIGKNI66.mjs.map

package/dist/esm/chunk-NIGKNI66.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/permit2/facilitator/scheme.ts","../../src/permit2/facilitator/register.ts"],"sourcesContent":["import {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport { getAddress } from \"viem\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { Permit2PayloadV2 } from \"../types\";\nimport { PERMIT2_ADDRESS, permit2ABI, erc20BalanceABI } from \"../constants\";\n\n/**\n * Configuration for Permit2 EVM facilitator\n */\nexport interface Permit2EvmSchemeConfig {\n  [key: string]: unknown;\n}\n\n/**\n * EVM facilitator implementation for the Permit2 payment scheme.\n *\n * Verifies Permit2 signatures and settles payments by calling\n * permitTransferFrom on the Permit2 contract.\n */\nexport class Permit2EvmScheme implements SchemeNetworkFacilitator {\n  readonly scheme = \"permit2\";\n  readonly caipFamily = \"eip155:*\";\n\n  /**\n   * Creates a new Permit2 facilitator instance.\n   *\n   * @param signer - The facilitator EVM signer\n   */\n  constructor(private readonly signer: FacilitatorEvmSigner) {}\n\n  /**\n   * Get mechanism-specific extra data for supported kinds.\n   *\n   * @param _ - The network identifier\n   * @returns Extra data including permit2 contract address\n   */\n  getExtra(_: string): Record<string, unknown> | undefined {\n    return { permit2Address: PERMIT2_ADDRESS };\n  }\n\n  /**\n   * Get signer addresses for this facilitator.\n   *\n   * @param _ - The network identifier\n   * @returns Array of signer addresses\n   */\n  getSigners(_: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verify a Permit2 payment payload.\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @returns Verification result\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const permit2Payload = payload.payload as Permit2PayloadV2 | undefined;\n\n    // Validate payload structure\n    if (!permit2Payload?.permit?.permitted?.token || !permit2Payload?.owner) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_payload_structure\",\n        payer: undefined,\n      };\n    }\n\n    // Verify scheme matches\n    if (payload.accepted.scheme !== \"permit2\" || requirements.scheme !== \"permit2\") {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Verify network matches\n    if (payload.accepted.network !== requirements.network) {\n      return {\n        isValid: false,\n        invalidReason: \"network_mismatch\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Verify token matches\n    if (getAddress(permit2Payload.permit.permitted.token) !== getAddress(requirements.asset)) {\n      return {\n        isValid: false,\n        invalidReason: \"token_mismatch\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Verify recipient matches\n    if (getAddress(permit2Payload.transferDetails.to) !== getAddress(requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: \"recipient_mismatch\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Verify deadline is in the future\n    const now = Math.floor(Date.now() / 1000);\n    if (BigInt(permit2Payload.permit.deadline) < BigInt(now + 6)) {\n      return {\n        isValid: false,\n        invalidReason: \"permit_expired\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Verify amount is sufficient\n    if (BigInt(permit2Payload.permit.permitted.amount) < BigInt(requirements.amount)) {\n      return {\n        isValid: false,\n        invalidReason: \"insufficient_permitted_amount\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    if (BigInt(permit2Payload.transferDetails.requestedAmount) < BigInt(requirements.amount)) {\n      return {\n        isValid: false,\n        invalidReason: \"insufficient_requested_amount\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    // Check balance\n    try {\n      const balance = (await this.signer.readContract({\n        address: getAddress(requirements.asset),\n        abi: erc20BalanceABI,\n        functionName: \"balanceOf\",\n        args: [getAddress(permit2Payload.owner)],\n      })) as bigint;\n\n      if (BigInt(balance) < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_funds\",\n          payer: permit2Payload.owner,\n        };\n      }\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      return {\n        isValid: false,\n        invalidReason: `balance_check_failed: ${errorMessage}`,\n        payer: permit2Payload.owner,\n      };\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer: permit2Payload.owner,\n    };\n  }\n\n  /**\n   * Settle a Permit2 payment by executing permitTransferFrom.\n   *\n   * @param payload - The payment payload\n   * @param requirements - The payment requirements\n   * @returns Settlement result\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const permit2Payload = payload.payload as Permit2PayloadV2 | undefined;\n\n    if (!permit2Payload?.permit?.permitted?.token || !permit2Payload?.owner) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: \"invalid_payload_structure\",\n        payer: undefined,\n      };\n    }\n\n    // Re-verify before settling\n    const valid = await this.verify(payload, requirements);\n    if (!valid.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: valid.invalidReason ?? \"invalid_scheme\",\n        payer: permit2Payload.owner,\n      };\n    }\n\n    try {\n      // Call permitTransferFrom on the Permit2 contract\n      const tx = await this.signer.writeContract({\n        address: PERMIT2_ADDRESS,\n        abi: permit2ABI,\n        functionName: \"permitTransferFrom\",\n        args: [\n          {\n            permitted: {\n              token: getAddress(permit2Payload.permit.permitted.token),\n              amount: BigInt(permit2Payload.permit.permitted.amount),\n            },\n            nonce: BigInt(permit2Payload.permit.nonce),\n            deadline: BigInt(permit2Payload.permit.deadline),\n          },\n          {\n            to: getAddress(permit2Payload.transferDetails.to),\n            requestedAmount: BigInt(permit2Payload.transferDetails.requestedAmount),\n          },\n          getAddress(permit2Payload.owner),\n          permit2Payload.signature,\n        ],\n      });\n\n      // Wait for transaction confirmation\n      const receipt = await this.signer.waitForTransactionReceipt({ hash: tx });\n\n      if (receipt.status !== \"success\") {\n        return {\n          success: false,\n          errorReason: \"invalid_transaction_state\",\n          transaction: tx,\n          network: payload.accepted.network,\n          payer: permit2Payload.owner,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: tx,\n        network: payload.accepted.network,\n        payer: permit2Payload.owner,\n      };\n    } catch (error) {\n      console.error(\"Failed to settle Permit2 transaction:\", error);\n      return {\n        success: false,\n        errorReason: \"transaction_failed\",\n        transaction: \"\",\n        network: payload.accepted.network,\n        payer: permit2Payload.owner,\n      };\n    }\n  }\n}\n","import { t402Facilitator } from \"@t402/core/facilitator\";\nimport { Network } from \"@t402/core/types\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { Permit2EvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering Permit2 schemes to an t402Facilitator\n */\nexport interface Permit2EvmFacilitatorConfig {\n  /**\n   * The EVM signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorEvmSigner;\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"eip155:84532\", [\"eip155:84532\", \"eip155:1\"]\n   */\n  networks: Network | Network[];\n}\n\n/**\n * Registers Permit2 EVM payment schemes to an t402Facilitator instance.\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for Permit2 EVM facilitator registration\n * @returns The facilitator instance for chaining\n */\nexport function registerPermit2EvmScheme(\n  facilitator: t402Facilitator,\n  config: Permit2EvmFacilitatorConfig,\n): t402Facilitator {\n  facilitator.register(config.networks, new Permit2EvmScheme(config.signer));\n\n  return facilitator;\n}\n"],"mappings":";;;;;;;;;;AAOA,SAAS,kBAAkB;AAkBpB,IAAM,mBAAN,MAA2D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAShE,YAA6B,QAA8B;AAA9B;AAR7B,wBAAS,UAAS;AAClB,wBAAS,cAAa;AAAA,EAOsC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ5D,SAAS,GAAgD;AACvD,WAAO,EAAE,gBAAgB,gBAAgB;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAW,GAAqB;AAC9B,WAAO,CAAC,GAAG,KAAK,OAAO,aAAa,CAAC;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB,QAAQ;AAG/B,QAAI,CAAC,gBAAgB,QAAQ,WAAW,SAAS,CAAC,gBAAgB,OAAO;AACvE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,WAAW,aAAa,aAAa,WAAW,WAAW;AAC9E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS,YAAY,aAAa,SAAS;AACrD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,QAAI,WAAW,eAAe,OAAO,UAAU,KAAK,MAAM,WAAW,aAAa,KAAK,GAAG;AACxF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,QAAI,WAAW,eAAe,gBAAgB,EAAE,MAAM,WAAW,aAAa,KAAK,GAAG;AACpF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,QAAI,OAAO,eAAe,OAAO,QAAQ,IAAI,OAAO,MAAM,CAAC,GAAG;AAC5D,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,QAAI,OAAO,eAAe,OAAO,UAAU,MAAM,IAAI,OAAO,aAAa,MAAM,GAAG;AAChF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAEA,QAAI,OAAO,eAAe,gBAAgB,eAAe,IAAI,OAAO,aAAa,MAAM,GAAG;AACxF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAGA,QAAI;AACF,YAAM,UAAW,MAAM,KAAK,OAAO,aAAa;AAAA,QAC9C,SAAS,WAAW,aAAa,KAAK;AAAA,QACtC,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,WAAW,eAAe,KAAK,CAAC;AAAA,MACzC,CAAC;AAED,UAAI,OAAO,OAAO,IAAI,OAAO,aAAa,MAAM,GAAG;AACjD,eAAO;AAAA,UACL,SAAS;AAAA,UACT,eAAe;AAAA,UACf,OAAO,eAAe;AAAA,QACxB;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC1E,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe,yBAAyB,YAAY;AAAA,QACpD,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAEA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,eAAe;AAAA,MACf,OAAO,eAAe;AAAA,IACxB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB,QAAQ;AAE/B,QAAI,CAAC,gBAAgB,QAAQ,WAAW,SAAS,CAAC,gBAAgB,OAAO;AACvE,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb,OAAO;AAAA,MACT;AAAA,IACF;AAGA,UAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,YAAY;AACrD,QAAI,CAAC,MAAM,SAAS;AAClB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa,MAAM,iBAAiB;AAAA,QACpC,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,KAAK,MAAM,KAAK,OAAO,cAAc;AAAA,QACzC,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM;AAAA,UACJ;AAAA,YACE,WAAW;AAAA,cACT,OAAO,WAAW,eAAe,OAAO,UAAU,KAAK;AAAA,cACvD,QAAQ,OAAO,eAAe,OAAO,UAAU,MAAM;AAAA,YACvD;AAAA,YACA,OAAO,OAAO,eAAe,OAAO,KAAK;AAAA,YACzC,UAAU,OAAO,eAAe,OAAO,QAAQ;AAAA,UACjD;AAAA,UACA;AAAA,YACE,IAAI,WAAW,eAAe,gBAAgB,EAAE;AAAA,YAChD,iBAAiB,OAAO,eAAe,gBAAgB,eAAe;AAAA,UACxE;AAAA,UACA,WAAW,eAAe,KAAK;AAAA,UAC/B,eAAe;AAAA,QACjB;AAAA,MACF,CAAC;AAGD,YAAM,UAAU,MAAM,KAAK,OAAO,0BAA0B,EAAE,MAAM,GAAG,CAAC;AAExE,UAAI,QAAQ,WAAW,WAAW;AAChC,eAAO;AAAA,UACL,SAAS;AAAA,UACT,aAAa;AAAA,UACb,aAAa;AAAA,UACb,SAAS,QAAQ,SAAS;AAAA,UAC1B,OAAO,eAAe;AAAA,QACxB;AAAA,MACF;AAEA,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,eAAe;AAAA,MACxB;AAAA,IACF,SAAS,OAAO;AACd,cAAQ,MAAM,yCAAyC,KAAK;AAC5D,aAAO;AAAA,QACL,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,SAAS,QAAQ,SAAS;AAAA,QAC1B,OAAO,eAAe;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AACF;;;AC1OO,SAAS,yBACd,aACA,QACiB;AACjB,cAAY,SAAS,OAAO,UAAU,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAEzE,SAAO;AACT;","names":[]}

package/dist/esm/chunk-URG4HEYQ.mjs

@@ -0,0 +1,74 @@
+// src/permit2/constants.ts
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+var permit2Types = {
+  PermitTransferFrom: [
+    { name: "permitted", type: "TokenPermissions" },
+    { name: "spender", type: "address" },
+    { name: "nonce", type: "uint256" },
+    { name: "deadline", type: "uint256" }
+  ],
+  TokenPermissions: [
+    { name: "token", type: "address" },
+    { name: "amount", type: "uint256" }
+  ]
+};
+var permit2ABI = [
+  {
+    inputs: [
+      {
+        components: [
+          {
+            components: [
+              { name: "token", type: "address" },
+              { name: "amount", type: "uint256" }
+            ],
+            name: "permitted",
+            type: "tuple"
+          },
+          { name: "nonce", type: "uint256" },
+          { name: "deadline", type: "uint256" }
+        ],
+        name: "permit",
+        type: "tuple"
+      },
+      {
+        components: [
+          { name: "to", type: "address" },
+          { name: "requestedAmount", type: "uint256" }
+        ],
+        name: "transferDetails",
+        type: "tuple"
+      },
+      { name: "owner", type: "address" },
+      { name: "signature", type: "bytes" }
+    ],
+    name: "permitTransferFrom",
+    outputs: [],
+    stateMutability: "nonpayable",
+    type: "function"
+  },
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+var erc20BalanceABI = [
+  {
+    inputs: [{ name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function"
+  }
+];
+
+export {
+  PERMIT2_ADDRESS,
+  permit2Types,
+  permit2ABI,
+  erc20BalanceABI
+};
+//# sourceMappingURL=chunk-URG4HEYQ.mjs.map

package/dist/esm/chunk-URG4HEYQ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/permit2/constants.ts"],"sourcesContent":["/**\n * Permit2 Constants\n *\n * Uniswap Permit2 contract addresses, type hashes, and ABI fragments.\n */\n\n/** Canonical Permit2 contract address (same on all EVM chains) */\nexport const PERMIT2_ADDRESS = \"0x000000000022D473030F116dDEE9F6B43aC78BA3\" as const;\n\n/** EIP-712 type definitions for Permit2 SignatureTransfer */\nexport const permit2Types = {\n  PermitTransferFrom: [\n    { name: \"permitted\", type: \"TokenPermissions\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n  ],\n  TokenPermissions: [\n    { name: \"token\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n  ],\n} as const;\n\n/** Permit2 ABI for permitTransferFrom */\nexport const permit2ABI = [\n  {\n    inputs: [\n      {\n        components: [\n          {\n            components: [\n              { name: \"token\", type: \"address\" },\n              { name: \"amount\", type: \"uint256\" },\n            ],\n            name: \"permitted\",\n            type: \"tuple\",\n          },\n          { name: \"nonce\", type: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\" },\n        ],\n        name: \"permit\",\n        type: \"tuple\",\n      },\n      {\n        components: [\n          { name: \"to\", type: \"address\" },\n          { name: \"requestedAmount\", type: \"uint256\" },\n        ],\n        name: \"transferDetails\",\n        type: \"tuple\",\n      },\n      { name: \"owner\", type: \"address\" },\n      { name: \"signature\", type: \"bytes\" },\n    ],\n    name: \"permitTransferFrom\",\n    outputs: [],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n  {\n    inputs: [{ name: \"account\", type: \"address\" }],\n    name: \"balanceOf\",\n    outputs: [{ name: \"\", type: \"uint256\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n] as const;\n\n/** ERC20 balanceOf ABI for balance checks */\nexport const erc20BalanceABI = [\n  {\n    inputs: [{ name: \"account\", type: \"address\" }],\n    name: \"balanceOf\",\n    outputs: [{ name: \"\", type: \"uint256\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n] as const;\n"],"mappings":";AAOO,IAAM,kBAAkB;AAGxB,IAAM,eAAe;AAAA,EAC1B,oBAAoB;AAAA,IAClB,EAAE,MAAM,aAAa,MAAM,mBAAmB;AAAA,IAC9C,EAAE,MAAM,WAAW,MAAM,UAAU;AAAA,IACnC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,IACjC,EAAE,MAAM,YAAY,MAAM,UAAU;AAAA,EACtC;AAAA,EACA,kBAAkB;AAAA,IAChB,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,IACjC,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,EACpC;AACF;AAGO,IAAM,aAAa;AAAA,EACxB;AAAA,IACE,QAAQ;AAAA,MACN;AAAA,QACE,YAAY;AAAA,UACV;AAAA,YACE,YAAY;AAAA,cACV,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,cACjC,EAAE,MAAM,UAAU,MAAM,UAAU;AAAA,YACpC;AAAA,YACA,MAAM;AAAA,YACN,MAAM;AAAA,UACR;AAAA,UACA,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,UACjC,EAAE,MAAM,YAAY,MAAM,UAAU;AAAA,QACtC;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,MACA;AAAA,QACE,YAAY;AAAA,UACV,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,UAC9B,EAAE,MAAM,mBAAmB,MAAM,UAAU;AAAA,QAC7C;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,MACA,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,MACjC,EAAE,MAAM,aAAa,MAAM,QAAQ;AAAA,IACrC;AAAA,IACA,MAAM;AAAA,IACN,SAAS,CAAC;AAAA,IACV,iBAAiB;AAAA,IACjB,MAAM;AAAA,EACR;AAAA,EACA;AAAA,IACE,QAAQ,CAAC,EAAE,MAAM,WAAW,MAAM,UAAU,CAAC;AAAA,IAC7C,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,UAAU,CAAC;AAAA,IACvC,iBAAiB;AAAA,IACjB,MAAM;AAAA,EACR;AACF;AAGO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,IACE,QAAQ,CAAC,EAAE,MAAM,WAAW,MAAM,UAAU,CAAC;AAAA,IAC7C,MAAM;AAAA,IACN,SAAS,CAAC,EAAE,MAAM,IAAI,MAAM,UAAU,CAAC;AAAA,IACvC,iBAAiB;AAAA,IACjB,MAAM;AAAA,EACR;AACF;","names":[]}

package/dist/esm/index-fzI2FyBT.d.mts

@@ -0,0 +1,122 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@t402/core/types';
+import { t402ResourceServer } from '@t402/core/server';
+
+/**
+ * Configuration options for Permit2EvmScheme server
+ */
+interface Permit2EvmSchemeConfig {
+    /** Preferred token symbol (e.g., "USDT0", "USDC"). Defaults to network's highest priority token. */
+    preferredToken?: string;
+}
+/**
+ * EVM server implementation for the Permit2 payment scheme.
+ * Supports USDT0, USDC, and other ERC20 tokens via Uniswap Permit2.
+ */
+declare class Permit2EvmScheme implements SchemeNetworkServer {
+    readonly scheme = "permit2";
+    private moneyParsers;
+    private config;
+    /**
+     * Creates a new Permit2EvmScheme server instance.
+     *
+     * @param config - Server configuration options
+     */
+    constructor(config?: Permit2EvmSchemeConfig);
+    /**
+     * 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): Permit2EvmScheme;
+    /**
+     * 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-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 schemes to an t402ResourceServer
+ */
+interface Permit2EvmResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (eip155:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers Permit2 EVM payment schemes to an t402ResourceServer instance.
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for Permit2 resource server registration
+ * @returns The server instance for chaining
+ */
+declare function registerPermit2EvmScheme(server: t402ResourceServer, config?: Permit2EvmResourceServerConfig): t402ResourceServer;
+
+export { type Permit2EvmResourceServerConfig as P, Permit2EvmScheme as a, type Permit2EvmSchemeConfig as b, registerPermit2EvmScheme as r };

package/dist/esm/index.mjs

@@ -3,26 +3,26 @@ import {
   UptoEvmServerScheme,
   createUptoEvmFacilitatorScheme,
   createUptoEvmServerScheme
-} from "./chunk-ZDGWVHD5.mjs";
+} from "./chunk-EEZNFYCW.mjs";
+import {
+  UptoEvmScheme,
+  createUptoEvmScheme
+} from "./chunk-AH3XB4XD.mjs";
 import {
   ExactEvmScheme
 } from "./chunk-LM5RZBVP.mjs";
-import {
-  TOKEN_REGISTRY,
-  USDT_LEGACY_ADDRESSES,
-  getTokenConfig
-} from "./chunk-FUUW3JGG.mjs";
 import {
   erc20LegacyABI,
   legacyAuthorizationTypes
 } from "./chunk-Y4U7Q543.mjs";
-import {
-  UptoEvmScheme,
-  createUptoEvmScheme
-} from "./chunk-AH3XB4XD.mjs";
 import {
   createNonce
 } from "./chunk-SYVPLXYV.mjs";
+import {
+  TOKEN_REGISTRY,
+  USDT_LEGACY_ADDRESSES,
+  getTokenConfig
+} from "./chunk-FUUW3JGG.mjs";
 import {
   __publicField
 } from "./chunk-NSSMTXJJ.mjs";

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

@@ -0,0 +1,81 @@
+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 payment scheme.
+ *
+ * Uses Uniswap Permit2 SignatureTransfer for gasless token approvals.
+ */
+declare class Permit2EvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "permit2";
+    /**
+     * Creates a new Permit2EvmScheme instance.
+     *
+     * @param signer - The EVM signer for client operations
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Creates a payment payload for the Permit2 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 SignatureTransfer using EIP-712
+     *
+     * @param permit - The permit transfer data
+     * @param spender - The spender address
+     * @param requirements - The payment requirements
+     * @returns Signed typed data hex string
+     */
+    private signPermit2;
+}
+
+/**
+ * Configuration options for registering Permit2 EVM schemes to an t402Client
+ */
+interface Permit2EvmClientConfig {
+    /**
+     * 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 EVM payment schemes to an t402Client instance.
+ *
+ * @param client - The t402Client instance to register schemes to
+ * @param config - Configuration for Permit2 EVM client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerPermit2EvmScheme } from "@t402/evm/permit2/client";
+ * import { t402Client } from "@t402/core/client";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const account = privateKeyToAccount("0x...");
+ * const client = new t402Client();
+ * registerPermit2EvmScheme(client, { signer: account });
+ * ```
+ */
+declare function registerPermit2EvmScheme(client: t402Client, config: Permit2EvmClientConfig): t402Client;
+
+export { type Permit2EvmClientConfig, Permit2EvmScheme, registerPermit2EvmScheme };

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

@@ -0,0 +1,11 @@
+import {
+  Permit2EvmScheme,
+  registerPermit2EvmScheme
+} from "../../chunk-3KHB6QTD.mjs";
+import "../../chunk-URG4HEYQ.mjs";
+import "../../chunk-NSSMTXJJ.mjs";
+export {
+  Permit2EvmScheme,
+  registerPermit2EvmScheme
+};
+//# sourceMappingURL=index.mjs.map

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

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

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

@@ -0,0 +1,82 @@
+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 EVM facilitator
+ */
+interface Permit2EvmSchemeConfig {
+    [key: string]: unknown;
+}
+/**
+ * EVM facilitator implementation for the Permit2 payment scheme.
+ *
+ * Verifies Permit2 signatures and settles payments by calling
+ * permitTransferFrom on the Permit2 contract.
+ */
+declare class Permit2EvmScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "permit2";
+    readonly caipFamily = "eip155:*";
+    /**
+     * Creates a new Permit2 facilitator instance.
+     *
+     * @param signer - The facilitator EVM signer
+     */
+    constructor(signer: FacilitatorEvmSigner);
+    /**
+     * Get mechanism-specific extra data for supported kinds.
+     *
+     * @param _ - The network identifier
+     * @returns Extra data including permit2 contract address
+     */
+    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 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 payment by executing permitTransferFrom.
+     *
+     * @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 schemes to an t402Facilitator
+ */
+interface Permit2EvmFacilitatorConfig {
+    /**
+     * 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[];
+}
+/**
+ * Registers Permit2 EVM payment schemes to an t402Facilitator instance.
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for Permit2 EVM facilitator registration
+ * @returns The facilitator instance for chaining
+ */
+declare function registerPermit2EvmScheme(facilitator: t402Facilitator, config: Permit2EvmFacilitatorConfig): t402Facilitator;
+
+export { type Permit2EvmFacilitatorConfig, Permit2EvmScheme, type Permit2EvmSchemeConfig, registerPermit2EvmScheme };