@t402/evm 2.4.0 → 2.6.0

package/dist/esm/chunk-3KHB6QTD.mjs

@@ -0,0 +1,112 @@
+import {
+  PERMIT2_ADDRESS,
+  permit2Types
+} from "./chunk-URG4HEYQ.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
+
+// src/permit2/client/scheme.ts
+import { getAddress } from "viem";
+var Permit2EvmScheme = class {
+  /**
+   * Creates a new Permit2EvmScheme instance.
+   *
+   * @param signer - The EVM signer for client operations
+   */
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", "permit2");
+  }
+  /**
+   * 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
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    const now = Math.floor(Date.now() / 1e3);
+    const deadline = now + paymentRequirements.maxTimeoutSeconds;
+    const nonce = BigInt(
+      "0x" + Array.from(globalThis.crypto.getRandomValues(new Uint8Array(32))).map((b) => b.toString(16).padStart(2, "0")).join("")
+    ).toString();
+    const permit = {
+      permitted: {
+        token: getAddress(paymentRequirements.asset),
+        amount: paymentRequirements.amount
+      },
+      nonce,
+      deadline: deadline.toString()
+    };
+    const transferDetails = {
+      to: getAddress(paymentRequirements.payTo),
+      requestedAmount: paymentRequirements.amount
+    };
+    const signature = await this.signPermit2(permit, transferDetails.to, paymentRequirements);
+    const payload = {
+      permit,
+      transferDetails,
+      signature,
+      owner: this.signer.address
+    };
+    return {
+      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
+   */
+  async signPermit2(permit, spender, requirements) {
+    const chainId = parseInt(requirements.network.split(":")[1]);
+    const domain = {
+      name: "Permit2",
+      chainId,
+      verifyingContract: PERMIT2_ADDRESS
+    };
+    const message = {
+      permitted: {
+        token: permit.permitted.token,
+        amount: BigInt(permit.permitted.amount)
+      },
+      spender,
+      nonce: BigInt(permit.nonce),
+      deadline: BigInt(permit.deadline)
+    };
+    return await this.signer.signTypedData({
+      domain,
+      types: permit2Types,
+      primaryType: "PermitTransferFrom",
+      message
+    });
+  }
+};
+
+// src/permit2/client/register.ts
+function registerPermit2EvmScheme(client, config) {
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      client.register(network, new Permit2EvmScheme(config.signer));
+    });
+  } else {
+    client.register("eip155:*", new Permit2EvmScheme(config.signer));
+  }
+  if (config.policies) {
+    config.policies.forEach((policy) => {
+      client.registerPolicy(policy);
+    });
+  }
+  return client;
+}
+
+export {
+  Permit2EvmScheme,
+  registerPermit2EvmScheme
+};
+//# sourceMappingURL=chunk-3KHB6QTD.mjs.map

package/dist/esm/chunk-3KHB6QTD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/permit2/client/scheme.ts","../../src/permit2/client/register.ts"],"sourcesContent":["import { PaymentPayload, PaymentRequirements, SchemeNetworkClient } from \"@t402/core/types\";\nimport { getAddress } from \"viem\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { Permit2PayloadV2 } from \"../types\";\nimport { PERMIT2_ADDRESS, permit2Types } from \"../constants\";\n\n/**\n * EVM client implementation for the Permit2 payment scheme.\n *\n * Uses Uniswap Permit2 SignatureTransfer for gasless token approvals.\n */\nexport class Permit2EvmScheme implements SchemeNetworkClient {\n  readonly scheme = \"permit2\";\n\n  /**\n   * Creates a new Permit2EvmScheme 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 Permit2 scheme.\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\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    const now = Math.floor(Date.now() / 1000);\n    const deadline = now + paymentRequirements.maxTimeoutSeconds;\n\n    // Use a random nonce (Permit2 nonces are not sequential for SignatureTransfer)\n    const nonce = BigInt(\n      \"0x\" +\n        Array.from(globalThis.crypto.getRandomValues(new Uint8Array(32)))\n          .map(b => b.toString(16).padStart(2, \"0\"))\n          .join(\"\"),\n    ).toString();\n\n    const permit = {\n      permitted: {\n        token: getAddress(paymentRequirements.asset) as `0x${string}`,\n        amount: paymentRequirements.amount,\n      },\n      nonce,\n      deadline: deadline.toString(),\n    };\n\n    const transferDetails = {\n      to: getAddress(paymentRequirements.payTo) as `0x${string}`,\n      requestedAmount: paymentRequirements.amount,\n    };\n\n    // Sign the Permit2 typed data\n    const signature = await this.signPermit2(permit, transferDetails.to, paymentRequirements);\n\n    const payload: Permit2PayloadV2 = {\n      permit,\n      transferDetails,\n      signature,\n      owner: this.signer.address,\n    };\n\n    return {\n      t402Version,\n      payload,\n    };\n  }\n\n  /**\n   * Sign the Permit2 SignatureTransfer using EIP-712\n   *\n   * @param permit - The permit transfer data\n   * @param spender - The spender address\n   * @param requirements - The payment requirements\n   * @returns Signed typed data hex string\n   */\n  private async signPermit2(\n    permit: Permit2PayloadV2[\"permit\"],\n    spender: `0x${string}`,\n    requirements: PaymentRequirements,\n  ): Promise<`0x${string}`> {\n    const chainId = parseInt(requirements.network.split(\":\")[1]);\n\n    const domain = {\n      name: \"Permit2\",\n      chainId,\n      verifyingContract: PERMIT2_ADDRESS,\n    };\n\n    const message = {\n      permitted: {\n        token: permit.permitted.token,\n        amount: BigInt(permit.permitted.amount),\n      },\n      spender,\n      nonce: BigInt(permit.nonce),\n      deadline: BigInt(permit.deadline),\n    };\n\n    return await this.signer.signTypedData({\n      domain,\n      types: permit2Types,\n      primaryType: \"PermitTransferFrom\",\n      message,\n    });\n  }\n}\n","import { t402Client, SelectPaymentRequirements, PaymentPolicy } from \"@t402/core/client\";\nimport { Network } from \"@t402/core/types\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { Permit2EvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering Permit2 EVM schemes to an t402Client\n */\nexport interface Permit2EvmClientConfig {\n  /**\n   * The EVM signer to use for creating payment payloads\n   */\n  signer: ClientEvmSigner;\n\n  /**\n   * Optional payment requirements selector function\n   * If not provided, uses the default selector (first available option)\n   */\n  paymentRequirementsSelector?: SelectPaymentRequirements;\n\n  /**\n   * Optional policies to apply to the client\n   */\n  policies?: PaymentPolicy[];\n\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (eip155:*)\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers Permit2 EVM payment schemes to an t402Client instance.\n *\n * @param client - The t402Client instance to register schemes to\n * @param config - Configuration for Permit2 EVM client registration\n * @returns The client instance for chaining\n *\n * @example\n * ```typescript\n * import { registerPermit2EvmScheme } from \"@t402/evm/permit2/client\";\n * import { t402Client } from \"@t402/core/client\";\n * import { privateKeyToAccount } from \"viem/accounts\";\n *\n * const account = privateKeyToAccount(\"0x...\");\n * const client = new t402Client();\n * registerPermit2EvmScheme(client, { signer: account });\n * ```\n */\nexport function registerPermit2EvmScheme(\n  client: t402Client,\n  config: Permit2EvmClientConfig,\n): t402Client {\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      client.register(network, new Permit2EvmScheme(config.signer));\n    });\n  } else {\n    client.register(\"eip155:*\", new Permit2EvmScheme(config.signer));\n  }\n\n  if (config.policies) {\n    config.policies.forEach(policy => {\n      client.registerPolicy(policy);\n    });\n  }\n\n  return client;\n}\n"],"mappings":";;;;;;;;;AACA,SAAS,kBAAkB;AAUpB,IAAM,mBAAN,MAAsD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ3D,YAA6B,QAAyB;AAAzB;AAP7B,wBAAS,UAAS;AAAA,EAOqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASvD,MAAM,qBACJ,aACA,qBAC0D;AAC1D,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AACxC,UAAM,WAAW,MAAM,oBAAoB;AAG3C,UAAM,QAAQ;AAAA,MACZ,OACE,MAAM,KAAK,WAAW,OAAO,gBAAgB,IAAI,WAAW,EAAE,CAAC,CAAC,EAC7D,IAAI,OAAK,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EACxC,KAAK,EAAE;AAAA,IACd,EAAE,SAAS;AAEX,UAAM,SAAS;AAAA,MACb,WAAW;AAAA,QACT,OAAO,WAAW,oBAAoB,KAAK;AAAA,QAC3C,QAAQ,oBAAoB;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,UAAU,SAAS,SAAS;AAAA,IAC9B;AAEA,UAAM,kBAAkB;AAAA,MACtB,IAAI,WAAW,oBAAoB,KAAK;AAAA,MACxC,iBAAiB,oBAAoB;AAAA,IACvC;AAGA,UAAM,YAAY,MAAM,KAAK,YAAY,QAAQ,gBAAgB,IAAI,mBAAmB;AAExF,UAAM,UAA4B;AAAA,MAChC;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,KAAK,OAAO;AAAA,IACrB;AAEA,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,YACZ,QACA,SACA,cACwB;AACxB,UAAM,UAAU,SAAS,aAAa,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC;AAE3D,UAAM,SAAS;AAAA,MACb,MAAM;AAAA,MACN;AAAA,MACA,mBAAmB;AAAA,IACrB;AAEA,UAAM,UAAU;AAAA,MACd,WAAW;AAAA,QACT,OAAO,OAAO,UAAU;AAAA,QACxB,QAAQ,OAAO,OAAO,UAAU,MAAM;AAAA,MACxC;AAAA,MACA;AAAA,MACA,OAAO,OAAO,OAAO,KAAK;AAAA,MAC1B,UAAU,OAAO,OAAO,QAAQ;AAAA,IAClC;AAEA,WAAO,MAAM,KAAK,OAAO,cAAc;AAAA,MACrC;AAAA,MACA,OAAO;AAAA,MACP,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;AC7DO,SAAS,yBACd,QACA,QACY;AACZ,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,IAC9D,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,iBAAiB,OAAO,MAAM,CAAC;AAAA,EACjE;AAEA,MAAI,OAAO,UAAU;AACnB,WAAO,SAAS,QAAQ,YAAU;AAChC,aAAO,eAAe,MAAM;AAAA,IAC9B,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/{chunk-SURTCHSX.mjs → chunk-AH3XB4XD.mjs}

@@ -126,4 +126,4 @@ export {
   UptoEvmScheme,
   createUptoEvmScheme
 };
-//# sourceMappingURL=chunk-SURTCHSX.mjs.map
+//# sourceMappingURL=chunk-AH3XB4XD.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/upto/client/scheme.ts","../../src/types.ts"],"sourcesContent":["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    // The permit nonce must be provided by the caller via extra.permitNonce.\n    // This is the owner's current nonce from the token contract's nonces(owner) function.\n    // If not provided, defaults to 0 (valid only for the first permit from this owner).\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"],"mappings":"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","names":[]}

package/dist/esm/{chunk-SJ52GTJJ.mjs → chunk-EEZNFYCW.mjs}

@@ -1,13 +1,13 @@
+import {
+  isUptoEIP2612Payload,
+  permitTypes
+} from "./chunk-AH3XB4XD.mjs";
 import {
   TOKEN_REGISTRY,
   getDefaultToken,
   getTokenByAddress,
   getTokenConfig
-} from "./chunk-IWSDEZKI.mjs";
-import {
-  isUptoEIP2612Payload,
-  permitTypes
-} from "./chunk-SURTCHSX.mjs";
+} from "./chunk-FUUW3JGG.mjs";
 import {
   __publicField
 } from "./chunk-NSSMTXJJ.mjs";
@@ -408,4 +408,4 @@ export {
   UptoEvmFacilitatorScheme,
   createUptoEvmFacilitatorScheme
 };
-//# sourceMappingURL=chunk-SJ52GTJJ.mjs.map
+//# sourceMappingURL=chunk-EEZNFYCW.mjs.map

package/dist/esm/{chunk-IWSDEZKI.mjs → chunk-FUUW3JGG.mjs}

@@ -56,6 +56,10 @@ var USDC_ADDRESSES = {
   // Polygon Mainnet
   "eip155:137": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359"
 };
+var USAT_ADDRESSES = {
+  // Ethereum Mainnet
+  "eip155:1": "0x07041776f5007aca2a54844f50503a18a72a8b68"
+};
 var USDT_LEGACY_ADDRESSES = {
   // Ethereum Mainnet
   "eip155:1": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
@@ -93,6 +97,15 @@ var TOKEN_REGISTRY = {
       tokenType: "eip3009",
       priority: 2
     },
+    USAT: {
+      address: USAT_ADDRESSES["eip155:1"],
+      symbol: "USAT",
+      name: "Tether America USD",
+      version: "1",
+      decimals: 6,
+      tokenType: "legacy",
+      priority: 3
+    },
     USDT: {
       address: USDT_LEGACY_ADDRESSES["eip155:1"],
       symbol: "USDT",
@@ -474,4 +487,4 @@ export {
   getDefaultToken,
   getTokenByAddress
 };
-//# sourceMappingURL=chunk-IWSDEZKI.mjs.map
+//# sourceMappingURL=chunk-FUUW3JGG.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tokens.ts"],"sourcesContent":["/**\n * Token configuration for T402 EVM payments\n *\n * This module provides comprehensive token definitions including:\n * - USDT0 (Tether's new omnichain token with EIP-3009 support)\n * - USDC (USD Coin with EIP-3009 support)\n * - Legacy tokens configuration\n */\n\nimport type { Address } from \"viem\";\n\n/**\n * Token type classification for payment scheme selection\n */\nexport type TokenType = \"eip3009\" | \"legacy\";\n\n/**\n * Token configuration with EIP-712 domain parameters\n */\nexport interface TokenConfig {\n  /** Token contract address */\n  address: Address;\n  /** Token symbol (e.g., \"USDT0\", \"USDC\") */\n  symbol: string;\n  /** EIP-712 domain name for signing */\n  name: string;\n  /** EIP-712 domain version for signing */\n  version: string;\n  /** Number of decimal places */\n  decimals: number;\n  /** Token type for scheme selection */\n  tokenType: TokenType;\n  /** Payment priority (lower = higher priority) */\n  priority: number;\n}\n\n/**\n * Network token registry mapping network -> symbol -> config\n */\nexport type NetworkTokenRegistry = Record<string, Record<string, TokenConfig>>;\n\n/**\n * USDT0 Contract Addresses by Network\n * Source: https://docs.tether.io/usdt0/integration-guide/deployed-contracts\n *\n * USDT0 is Tether's new omnichain token using LayerZero OFT standard.\n * Key features:\n * - Supports EIP-3009 transferWithAuthorization (gasless transfers)\n * - Supports EIP-2612 permit\n * - Native cross-chain via LayerZero\n */\nexport const USDT0_ADDRESSES: Record<string, Address> = {\n  // === Existing Networks ===\n  // Ethereum Mainnet - OFT Adapter (bridge endpoint)\n  \"eip155:1\": \"0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee\",\n  // Arbitrum One - Native USDT0\n  \"eip155:42161\": \"0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9\",\n  // Ink Mainnet\n  \"eip155:57073\": \"0x0200C29006150606B650577BBE7B6248F58470c1\",\n  // Berachain Mainnet\n  \"eip155:80094\": \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n  // Unichain Mainnet (updated address)\n  \"eip155:130\": \"0x9151434b16b9763660705744891fA906F660EcC5\",\n\n  // === Phase 1: High Priority Networks ===\n  // Polygon PoS\n  \"eip155:137\": \"0xc2132D05D31c914a87C6611C10748AEb04B58e8F\",\n  // Mantle\n  \"eip155:5000\": \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n  // Optimism\n  \"eip155:10\": \"0x01bFF41798a0BcF287b996046Ca68b395DbC1071\",\n  // Plasma\n  \"eip155:9745\": \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\",\n  // Sei\n  \"eip155:1329\": \"0x9151434b16b9763660705744891fA906F660EcC5\",\n  // Conflux eSpace\n  \"eip155:1030\": \"0xaf37E8B6C9ED7f6318979f56Fc287d76c30847ff\",\n  // Monad\n  \"eip155:143\": \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\",\n\n  // === Phase 2: Medium Priority Networks ===\n  // Rootstock (Bitcoin sidechain)\n  \"eip155:30\": \"0x779dED0C9e1022225F8e0630b35A9B54Be713736\",\n  // XLayer (OKX L2)\n  \"eip155:196\": \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n  // Flare\n  \"eip155:14\": \"0xe7cd86e13AC4309349F30B3435a9d337750fC82D\",\n  // Corn\n  \"eip155:21000000\": \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\",\n  // HyperEVM\n  \"eip155:999\": \"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb\",\n  // MegaETH\n  \"eip155:4326\": \"0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb\",\n  // Stable\n  \"eip155:988\": \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n};\n\n/**\n * USDC Contract Addresses by Network\n * Native USDC with EIP-3009 support\n */\nexport const USDC_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet\n  \"eip155:1\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n  // Base Mainnet\n  \"eip155:8453\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n  // Base Sepolia (testnet)\n  \"eip155:84532\": \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n  // Sepolia (testnet)\n  \"eip155:11155111\": \"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238\",\n  // Arbitrum One\n  \"eip155:42161\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  // Polygon Mainnet\n  \"eip155:137\": \"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359\",\n};\n\n/**\n * USAT (Tether America USD) Addresses\n * Tether's federally-regulated US stablecoin.\n * - Supports EIP-2612 permit (can use `upto` scheme)\n * - Does NOT support EIP-3009 (must use `exact-legacy` scheme)\n */\nexport const USAT_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet\n  \"eip155:1\": \"0x07041776f5007aca2a54844f50503a18a72a8b68\",\n};\n\n/**\n * Traditional USDT Addresses (Legacy - no EIP-3009 support)\n * These require the approve + transferFrom pattern\n */\nexport const USDT_LEGACY_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet\n  \"eip155:1\": \"0xdAC17F958D2ee523a2206206994597C13D831ec7\",\n  // Polygon Mainnet (native USDT, not USDT0)\n  \"eip155:137\": \"0xc2132D05D31c914a87C6611C10748AEb04B58e8F\",\n  // BNB Chain (BSC) - BEP-20 USDT\n  \"eip155:56\": \"0x55d398326f99059fF775485246999027B3197955\",\n  // Avalanche C-Chain\n  \"eip155:43114\": \"0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7\",\n  // Fantom\n  \"eip155:250\": \"0x049d68029688eabf473097a2fc38ef61633a3c7a\",\n  // Celo\n  \"eip155:42220\": \"0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e\",\n  // Kaia (formerly Klaytn)\n  \"eip155:8217\": \"0xcee8faf64bb97a73bb51e115aa89c17ffa8dd167\",\n};\n\n/**\n * Complete token registry with all supported tokens per network\n */\nexport const TOKEN_REGISTRY: NetworkTokenRegistry = {\n  // Ethereum Mainnet\n  \"eip155:1\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n    USAT: {\n      address: USAT_ADDRESSES[\"eip155:1\"],\n      symbol: \"USAT\",\n      name: \"Tether America USD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 3,\n    },\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDT\",\n      name: \"TetherUSD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10, // Lower priority due to legacy flow\n    },\n  },\n\n  // Arbitrum One\n  \"eip155:42161\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:42161\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:42161\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Ink Mainnet\n  \"eip155:57073\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:57073\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Berachain Mainnet\n  \"eip155:80094\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:80094\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Unichain Mainnet\n  \"eip155:130\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:130\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Base Mainnet\n  \"eip155:8453\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:8453\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Base Sepolia (testnet)\n  \"eip155:84532\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:84532\"],\n      symbol: \"USDC\",\n      name: \"USDC\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Sepolia (testnet)\n  \"eip155:11155111\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:11155111\"],\n      symbol: \"USDC\",\n      name: \"USDC\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Polygon Mainnet\n  \"eip155:137\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:137\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:137\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:137\"],\n      symbol: \"USDT\",\n      name: \"TetherUSD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n\n  // === Phase 1: High Priority USDT0 Networks ===\n\n  // Optimism Mainnet\n  \"eip155:10\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:10\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Mantle Mainnet\n  \"eip155:5000\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:5000\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Plasma Mainnet\n  \"eip155:9745\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:9745\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Sei Mainnet\n  \"eip155:1329\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:1329\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Conflux eSpace Mainnet\n  \"eip155:1030\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:1030\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Monad Mainnet\n  \"eip155:143\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:143\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // === Phase 2: Medium Priority USDT0 Networks ===\n\n  // Flare Mainnet\n  \"eip155:14\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:14\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Rootstock Mainnet (Bitcoin sidechain)\n  \"eip155:30\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:30\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // XLayer Mainnet (OKX L2)\n  \"eip155:196\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:196\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Stable Mainnet\n  \"eip155:988\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:988\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // HyperEVM Mainnet\n  \"eip155:999\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:999\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // MegaETH Mainnet\n  \"eip155:4326\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:4326\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Corn Mainnet\n  \"eip155:21000000\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:21000000\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // === Legacy USDT Networks (no EIP-3009 support) ===\n\n  // BNB Chain (BSC) - BEP-20 USDT\n  \"eip155:56\": {\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:56\"],\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      version: \"1\",\n      decimals: 18, // BSC USDT uses 18 decimals\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n\n  // Avalanche C-Chain\n  \"eip155:43114\": {\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:43114\"],\n      symbol: \"USDT\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n\n  // Fantom\n  \"eip155:250\": {\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:250\"],\n      symbol: \"USDT\",\n      name: \"Frapped USDT\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n\n  // Celo\n  \"eip155:42220\": {\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:42220\"],\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      version: \"1\",\n      decimals: 18,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n\n  // Kaia (formerly Klaytn)\n  \"eip155:8217\": {\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:8217\"],\n      symbol: \"USDT\",\n      name: \"Tether USD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n};\n\n/**\n * Token priority for payment method selection\n * Lower number = higher priority\n */\nexport const TOKEN_PRIORITY: Record<string, number> = {\n  USDT0: 1, // Highest priority - gasless, cross-chain\n  USDC: 2, // Second - wide support, EIP-3009\n  USAT: 3, // Third - US-regulated, EIP-2612 permit\n  USDT: 10, // Lower - requires approval transaction\n  DAI: 5, // Medium - good support\n};\n\n/**\n * Get token configuration for a specific token on a network\n *\n * @param network - The network identifier in CAIP-2 format\n * @param symbol - The token symbol (e.g., \"USDT0\", \"USDC\")\n * @returns The token configuration if found, undefined otherwise\n */\nexport function getTokenConfig(network: string, symbol: string): TokenConfig | undefined {\n  return TOKEN_REGISTRY[network]?.[symbol.toUpperCase()];\n}\n\n/**\n * Get all tokens available on a network\n *\n * @param network - The network identifier in CAIP-2 format\n * @returns Array of token configurations sorted by priority\n */\nexport function getNetworkTokens(network: string): TokenConfig[] {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return [];\n  return Object.values(tokens).sort((a, b) => a.priority - b.priority);\n}\n\n/**\n * Get the default/preferred token for a network\n * Prefers USDT0 > USDC > others based on priority\n *\n * @param network - The network identifier in CAIP-2 format\n * @returns The highest priority token configuration, or undefined if none found\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  const tokens = getNetworkTokens(network);\n  return tokens[0]; // Already sorted by priority\n}\n\n/**\n * Get token by contract address on a network\n *\n * @param network - The network identifier in CAIP-2 format\n * @param address - The token contract address\n * @returns The token configuration if found, undefined otherwise\n */\nexport function getTokenByAddress(network: string, address: Address): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n\n  const lowerAddress = address.toLowerCase();\n  return Object.values(tokens).find(t => t.address.toLowerCase() === lowerAddress);\n}\n\n/**\n * Check if a token supports EIP-3009 (gasless transfers)\n *\n * @param network - The network identifier in CAIP-2 format\n * @param symbol - The token symbol to check\n * @returns True if the token supports EIP-3009 gasless transfers\n */\nexport function supportsEIP3009(network: string, symbol: string): boolean {\n  const config = getTokenConfig(network, symbol);\n  return config?.tokenType === \"eip3009\";\n}\n\n/**\n * Get all networks that support a specific token\n *\n * @param symbol - The token symbol to search for\n * @returns Array of network identifiers that support the token\n */\nexport function getNetworksForToken(symbol: string): string[] {\n  const networks: string[] = [];\n  for (const [network, tokens] of Object.entries(TOKEN_REGISTRY)) {\n    if (tokens[symbol.toUpperCase()]) {\n      networks.push(network);\n    }\n  }\n  return networks;\n}\n\n/**\n * Get USDT0 networks (primary T402 token)\n *\n * @returns Array of network identifiers that support USDT0\n */\nexport function getUsdt0Networks(): string[] {\n  return getNetworksForToken(\"USDT0\");\n}\n\n/**\n * EIP-712 domain configuration for a token\n *\n * @param network - The network identifier in CAIP-2 format\n * @param tokenAddress - The token contract address\n * @param chainId - The numeric chain ID\n * @returns The EIP-712 domain configuration, or undefined if token not found\n */\nexport function getEIP712Domain(\n  network: string,\n  tokenAddress: Address,\n  chainId: number,\n): { name: string; version: string; chainId: number; verifyingContract: Address } | undefined {\n  const token = getTokenByAddress(network, tokenAddress);\n  if (!token) return undefined;\n\n  return {\n    name: token.name,\n    version: token.version,\n    chainId,\n    verifyingContract: token.address,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/esm/chunk-MMQSLAA2.mjs

@@ -0,0 +1,190 @@
+import {
+  PERMIT2_ADDRESS
+} from "./chunk-URG4HEYQ.mjs";
+import {
+  TOKEN_REGISTRY,
+  getDefaultToken,
+  getTokenConfig
+} from "./chunk-FUUW3JGG.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
+
+// src/permit2/server/scheme.ts
+var Permit2EvmScheme = class {
+  /**
+   * Creates a new Permit2EvmScheme server instance.
+   *
+   * @param config - Server configuration options
+   */
+  constructor(config = {}) {
+    __publicField(this, "scheme", "permit2");
+    __publicField(this, "moneyParsers", []);
+    __publicField(this, "config");
+    this.config = config;
+  }
+  /**
+   * Get the list of supported EVM networks.
+   *
+   * @returns Array of supported network identifiers
+   */
+  static getSupportedNetworks() {
+    return Object.keys(TOKEN_REGISTRY);
+  }
+  /**
+   * Check if a network is supported.
+   *
+   * @param network - Network identifier to check
+   * @returns Whether the network is supported
+   */
+  static isNetworkSupported(network) {
+    return network in TOKEN_REGISTRY;
+  }
+  /**
+   * Register a custom money parser for price conversion.
+   *
+   * @param parser - The money parser to register
+   * @returns This instance for chaining
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * 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
+   */
+  async parsePrice(price, network) {
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * 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, supportedKind, extensionKeys) {
+    void supportedKind;
+    void extensionKeys;
+    if (!paymentRequirements.extra) {
+      paymentRequirements.extra = {};
+    }
+    paymentRequirements.extra.permit2Address = PERMIT2_ADDRESS;
+    return Promise.resolve(paymentRequirements);
+  }
+  /**
+   * Parse a money value into a decimal number.
+   *
+   * @param money - The money value to parse
+   * @returns The decimal amount
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      if (!Number.isFinite(money)) {
+        throw new Error(`Invalid money value: ${money} (must be a finite number)`);
+      }
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (!Number.isFinite(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * 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
+   */
+  defaultMoneyConversion(amount, network) {
+    const token = this.getDefaultAsset(network);
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), token.decimals);
+    return {
+      amount: tokenAmount,
+      asset: token.address,
+      extra: {
+        symbol: token.symbol,
+        permit2Address: PERMIT2_ADDRESS
+      }
+    };
+  }
+  /**
+   * 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
+   */
+  convertToTokenAmount(decimalAmount, decimals) {
+    if (!/^-?\d+(\.\d+)?$/.test(decimalAmount)) {
+      throw new Error(`Invalid amount format: ${decimalAmount}`);
+    }
+    const [wholePart, fracPart = ""] = decimalAmount.split(".");
+    const paddedFrac = fracPart.padEnd(decimals, "0").slice(0, decimals);
+    const combined = wholePart + paddedFrac;
+    const result = combined.replace(/^0+/, "") || "0";
+    return result;
+  }
+  /**
+   * Get the default token asset for a network.
+   *
+   * @param network - The target network
+   * @returns The token configuration
+   */
+  getDefaultAsset(network) {
+    if (this.config.preferredToken) {
+      const preferred = getTokenConfig(network, this.config.preferredToken);
+      if (preferred) return preferred;
+    }
+    const defaultToken = getDefaultToken(network);
+    if (defaultToken) return defaultToken;
+    throw new Error(`No tokens configured for network ${network}`);
+  }
+};
+
+// src/permit2/server/register.ts
+function registerPermit2EvmScheme(server, config = {}) {
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, new Permit2EvmScheme());
+    });
+  } else {
+    server.register("eip155:*", new Permit2EvmScheme());
+  }
+  return server;
+}
+
+export {
+  Permit2EvmScheme,
+  registerPermit2EvmScheme
+};
+//# sourceMappingURL=chunk-MMQSLAA2.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/permit2/server/scheme.ts","../../src/permit2/server/register.ts"],"sourcesContent":["import {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport { getDefaultToken, getTokenConfig, TokenConfig, TOKEN_REGISTRY } from \"../../tokens.js\";\nimport { PERMIT2_ADDRESS } from \"../constants\";\n\n/**\n * Configuration options for Permit2EvmScheme server\n */\nexport interface Permit2EvmSchemeConfig {\n  /** Preferred token symbol (e.g., \"USDT0\", \"USDC\"). Defaults to network's highest priority token. */\n  preferredToken?: string;\n}\n\n/**\n * EVM server implementation for the Permit2 payment scheme.\n * Supports USDT0, USDC, and other ERC20 tokens via Uniswap Permit2.\n */\nexport class Permit2EvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"permit2\";\n  private moneyParsers: MoneyParser[] = [];\n  private config: Permit2EvmSchemeConfig;\n\n  /**\n   * Creates a new Permit2EvmScheme server instance.\n   *\n   * @param config - Server configuration options\n   */\n  constructor(config: Permit2EvmSchemeConfig = {}) {\n    this.config = config;\n  }\n\n  /**\n   * Get the list of supported EVM networks.\n   *\n   * @returns Array of supported network identifiers\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(TOKEN_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported.\n   *\n   * @param network - Network identifier to check\n   * @returns Whether the network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in TOKEN_REGISTRY;\n  }\n\n  /**\n   * Register a custom money parser for price conversion.\n   *\n   * @param parser - The money parser to register\n   * @returns This instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): Permit2EvmScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parse a price into an AssetAmount for the given network.\n   *\n   * @param price - The price to parse\n   * @param network - The target network\n   * @returns The parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    const amount = this.parseMoneyToDecimal(price);\n\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements with Permit2-specific data.\n   *\n   * @param paymentRequirements - The base payment requirements\n   * @param supportedKind - The supported kind metadata\n   * @param supportedKind.t402Version - Protocol version\n   * @param supportedKind.scheme - Payment scheme\n   * @param supportedKind.network - Target network\n   * @param supportedKind.extra - Extra metadata\n   * @param extensionKeys - Active extension keys\n   * @returns Enhanced payment requirements\n   */\n  enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      t402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    void supportedKind;\n    void extensionKeys;\n\n    // Add permit2Address to extra for clients\n    if (!paymentRequirements.extra) {\n      paymentRequirements.extra = {};\n    }\n    paymentRequirements.extra.permit2Address = PERMIT2_ADDRESS;\n\n    return Promise.resolve(paymentRequirements);\n  }\n\n  /**\n   * Parse a money value into a decimal number.\n   *\n   * @param money - The money value to parse\n   * @returns The decimal amount\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      if (!Number.isFinite(money)) {\n        throw new Error(`Invalid money value: ${money} (must be a finite number)`);\n      }\n      return money;\n    }\n\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (!Number.isFinite(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Convert a decimal amount to a token amount using default network token.\n   *\n   * @param amount - The decimal amount\n   * @param network - The target network\n   * @returns The asset amount with token details\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const token = this.getDefaultAsset(network);\n\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), token.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: token.address,\n      extra: {\n        symbol: token.symbol,\n        permit2Address: PERMIT2_ADDRESS,\n      },\n    };\n  }\n\n  /**\n   * Convert a decimal amount string to token smallest units.\n   *\n   * @param decimalAmount - The decimal amount as a string\n   * @param decimals - The token's decimal places\n   * @returns The amount in smallest units\n   */\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    if (!/^-?\\d+(\\.\\d+)?$/.test(decimalAmount)) {\n      throw new Error(`Invalid amount format: ${decimalAmount}`);\n    }\n\n    const [wholePart, fracPart = \"\"] = decimalAmount.split(\".\");\n    const paddedFrac = fracPart.padEnd(decimals, \"0\").slice(0, decimals);\n    const combined = wholePart + paddedFrac;\n    const result = combined.replace(/^0+/, \"\") || \"0\";\n\n    return result;\n  }\n\n  /**\n   * Get the default token asset for a network.\n   *\n   * @param network - The target network\n   * @returns The token configuration\n   */\n  private getDefaultAsset(network: Network): TokenConfig {\n    if (this.config.preferredToken) {\n      const preferred = getTokenConfig(network, this.config.preferredToken);\n      if (preferred) return preferred;\n    }\n\n    const defaultToken = getDefaultToken(network);\n    if (defaultToken) return defaultToken;\n\n    throw new Error(`No tokens configured for network ${network}`);\n  }\n}\n","import { t402ResourceServer } from \"@t402/core/server\";\nimport { Network } from \"@t402/core/types\";\nimport { Permit2EvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering Permit2 schemes to an t402ResourceServer\n */\nexport interface Permit2EvmResourceServerConfig {\n  /**\n   * Optional specific networks to register\n   * If not provided, registers wildcard support (eip155:*)\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers Permit2 EVM payment schemes to an t402ResourceServer instance.\n *\n * @param server - The t402ResourceServer instance to register schemes to\n * @param config - Configuration for Permit2 resource server registration\n * @returns The server instance for chaining\n */\nexport function registerPermit2EvmScheme(\n  server: t402ResourceServer,\n  config: Permit2EvmResourceServerConfig = {},\n): t402ResourceServer {\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      server.register(network, new Permit2EvmScheme());\n    });\n  } else {\n    server.register(\"eip155:*\", new Permit2EvmScheme());\n  }\n\n  return server;\n}\n"],"mappings":"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","names":[]}