@t402/extensions 2.4.0 → 2.6.0

package/dist/esm/chunk-OAWKCEAR.mjs

@@ -0,0 +1,226 @@
+// src/erc20-approval-gas-sponsoring/server.ts
+var ERC20_APPROVAL_GAS_SPONSOR_SCHEMA = {
+  type: "object",
+  required: ["network", "from", "asset", "amount", "signedApprovalTx", "chainId"],
+  properties: {
+    network: { type: "string" },
+    from: { type: "string" },
+    asset: { type: "string" },
+    amount: { type: "string" },
+    signedApprovalTx: { type: "string" },
+    chainId: { type: "number" },
+    nonce: { type: "number" }
+  }
+};
+function declareERC20ApprovalGasSponsorExtension(options) {
+  const info = {
+    sponsoredNetworks: options.sponsoredNetworks,
+    maxAmount: options.maxAmount,
+    sponsorAddress: options.sponsorAddress,
+    requiresAtomicBatch: options.requiresAtomicBatch ?? false
+  };
+  if (options.permit2Address) {
+    info.permit2Address = options.permit2Address;
+  }
+  return {
+    info,
+    schema: ERC20_APPROVAL_GAS_SPONSOR_SCHEMA
+  };
+}
+function parseERC20ApprovalGasSponsorHeader(header) {
+  if (!header) {
+    throw new Error("Missing ERC-20 approval gas sponsor header");
+  }
+  try {
+    const decoded = Buffer.from(header, "base64").toString("utf-8");
+    const payload = JSON.parse(decoded);
+    const required = ["network", "from", "asset", "amount", "signedApprovalTx", "chainId"];
+    for (const field of required) {
+      if (!(field in payload)) {
+        throw new Error(`Missing required field: ${field}`);
+      }
+    }
+    return payload;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error("Invalid ERC-20 approval gas sponsor header: malformed JSON");
+    }
+    throw error;
+  }
+}
+function validateERC20ApprovalGasSponsorPayload(payload, extensionInfo, options = {}) {
+  if (!extensionInfo.sponsoredNetworks.includes(payload.network)) {
+    return {
+      valid: false,
+      error: `Network ${payload.network} is not in sponsored networks: ${extensionInfo.sponsoredNetworks.join(", ")}`
+    };
+  }
+  const payloadAmount = BigInt(payload.amount);
+  const maxAmount = BigInt(extensionInfo.maxAmount);
+  if (payloadAmount > maxAmount) {
+    return {
+      valid: false,
+      error: `Amount ${payload.amount} exceeds maximum amount ${extensionInfo.maxAmount}`
+    };
+  }
+  if (options.expectedChainIds) {
+    const expectedChainId = options.expectedChainIds[payload.network];
+    if (expectedChainId !== void 0 && payload.chainId !== expectedChainId) {
+      return {
+        valid: false,
+        error: `Chain ID ${payload.chainId} does not match expected chain ID ${expectedChainId} for network ${payload.network}`
+      };
+    }
+  }
+  const txHex = payload.signedApprovalTx.startsWith("0x") ? payload.signedApprovalTx.slice(2) : payload.signedApprovalTx;
+  if (txHex.length === 0) {
+    return {
+      valid: false,
+      error: "Signed approval transaction is empty"
+    };
+  }
+  if (!/^[0-9a-fA-F]+$/.test(txHex)) {
+    return {
+      valid: false,
+      error: "Signed approval transaction is not valid hex"
+    };
+  }
+  const fromHex = payload.from.startsWith("0x") ? payload.from.slice(2) : payload.from;
+  if (fromHex.length !== 40 || !/^[0-9a-fA-F]+$/.test(fromHex)) {
+    return {
+      valid: false,
+      error: `Invalid from address: ${payload.from}`
+    };
+  }
+  const assetHex = payload.asset.startsWith("0x") ? payload.asset.slice(2) : payload.asset;
+  if (assetHex.length !== 40 || !/^[0-9a-fA-F]+$/.test(assetHex)) {
+    return {
+      valid: false,
+      error: `Invalid asset address: ${payload.asset}`
+    };
+  }
+  return { valid: true };
+}
+
+// src/erc20-approval-gas-sponsoring/client.ts
+var ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY = "erc20ApprovalGasSponsoring";
+var ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME = "X-T402-ERC20-Approval-Gas-Sponsoring";
+var APPROVE_FUNCTION_SELECTOR = "0x095ea7b3";
+function encodeApproveCalldata(spender, amount) {
+  const spenderHex = spender.startsWith("0x") ? spender.slice(2) : spender;
+  const paddedSpender = spenderHex.toLowerCase().padStart(64, "0");
+  const amountBigInt = BigInt(amount);
+  const amountHex = amountBigInt.toString(16).padStart(64, "0");
+  return APPROVE_FUNCTION_SELECTOR + paddedSpender + amountHex;
+}
+function createERC20ApprovalGasSponsorPayload(_info, params) {
+  const payload = {
+    network: params.network,
+    from: params.from,
+    asset: params.asset,
+    amount: params.amount,
+    signedApprovalTx: params.signedApprovalTx.startsWith("0x") ? params.signedApprovalTx : "0x" + params.signedApprovalTx,
+    chainId: params.chainId
+  };
+  if (params.nonce !== void 0) {
+    payload.nonce = params.nonce;
+  }
+  return payload;
+}
+function encodeERC20ApprovalGasSponsorHeader(payload) {
+  const json = JSON.stringify(payload);
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(json, "utf-8").toString("base64");
+  }
+  return btoa(json);
+}
+
+// src/erc20-approval-gas-sponsoring/facilitator.ts
+function extractERC20ApprovalGasSponsorPayload(extensions) {
+  if (!extensions) {
+    return null;
+  }
+  const raw = extensions[ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY];
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+  const payload = raw;
+  const required = ["network", "from", "asset", "amount", "signedApprovalTx", "chainId"];
+  for (const field of required) {
+    if (!(field in payload)) {
+      return null;
+    }
+  }
+  const result = {
+    network: payload.network,
+    from: payload.from,
+    asset: payload.asset,
+    amount: payload.amount,
+    signedApprovalTx: payload.signedApprovalTx,
+    chainId: payload.chainId
+  };
+  if ("nonce" in payload && payload.nonce !== void 0) {
+    result.nonce = payload.nonce;
+  }
+  return result;
+}
+function processERC20ApprovalPayload(payload, extensionInfo) {
+  const validationResult = validateERC20ApprovalGasSponsorPayload(payload, extensionInfo);
+  if (!validationResult.valid) {
+    return validationResult;
+  }
+  const txHex = payload.signedApprovalTx.startsWith("0x") ? payload.signedApprovalTx.slice(2) : payload.signedApprovalTx;
+  if (txHex.length < 8) {
+    return {
+      valid: false,
+      error: "Signed approval transaction is too short to contain function selector"
+    };
+  }
+  return { valid: true };
+}
+function validateAndExtractApproval(extensions, extensionInfo) {
+  const payload = extractERC20ApprovalGasSponsorPayload(extensions);
+  if (!payload) {
+    return {
+      valid: false,
+      error: `Missing or invalid ${ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY} extension in payment`
+    };
+  }
+  const result = processERC20ApprovalPayload(payload, extensionInfo);
+  if (!result.valid) {
+    return result;
+  }
+  return { valid: true, payload };
+}
+function decodeApproveCalldata(calldata) {
+  const hex = calldata.startsWith("0x") ? calldata.slice(2) : calldata;
+  if (hex.length < 136) {
+    return null;
+  }
+  const selector = "0x" + hex.slice(0, 8);
+  if (selector !== APPROVE_FUNCTION_SELECTOR) {
+    return null;
+  }
+  const spenderWord = hex.slice(8, 72);
+  const spender = "0x" + spenderWord.slice(24);
+  const amountHex = hex.slice(72, 136);
+  const amount = BigInt("0x" + amountHex).toString(10);
+  return { spender, amount };
+}
+
+export {
+  declareERC20ApprovalGasSponsorExtension,
+  parseERC20ApprovalGasSponsorHeader,
+  validateERC20ApprovalGasSponsorPayload,
+  ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY,
+  ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME,
+  APPROVE_FUNCTION_SELECTOR,
+  encodeApproveCalldata,
+  createERC20ApprovalGasSponsorPayload,
+  encodeERC20ApprovalGasSponsorHeader,
+  extractERC20ApprovalGasSponsorPayload,
+  processERC20ApprovalPayload,
+  validateAndExtractApproval,
+  decodeApproveCalldata
+};
+//# sourceMappingURL=chunk-OAWKCEAR.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/erc20-approval-gas-sponsoring/server.ts","../../src/erc20-approval-gas-sponsoring/client.ts","../../src/erc20-approval-gas-sponsoring/facilitator.ts"],"sourcesContent":["/**\n * ERC-20 Approval Gas Sponsoring Extension Server-Side Implementation\n *\n * Provides functions for servers to declare gas sponsoring requirements,\n * parse client headers, and validate approval payloads.\n */\n\nimport type {\n  ERC20ApprovalGasSponsorExtension,\n  ERC20ApprovalGasSponsorExtensionInfo,\n  ERC20ApprovalGasSponsorPayload,\n  DeclareERC20ApprovalGasSponsorOptions,\n  ValidateERC20ApprovalGasSponsorOptions,\n  ERC20ApprovalGasSponsorValidationResult,\n} from \"./types.js\";\n\n/**\n * JSON Schema for ERC-20 approval gas sponsor payload validation.\n */\nconst ERC20_APPROVAL_GAS_SPONSOR_SCHEMA = {\n  type: \"object\",\n  required: [\"network\", \"from\", \"asset\", \"amount\", \"signedApprovalTx\", \"chainId\"],\n  properties: {\n    network: { type: \"string\" },\n    from: { type: \"string\" },\n    asset: { type: \"string\" },\n    amount: { type: \"string\" },\n    signedApprovalTx: { type: \"string\" },\n    chainId: { type: \"number\" },\n    nonce: { type: \"number\" },\n  },\n};\n\n/**\n * Declares an ERC-20 approval gas sponsor extension for server responses.\n *\n * @param options - Extension declaration options\n * @returns Gas sponsor extension object ready for response\n *\n * @example\n * ```typescript\n * const extension = declareERC20ApprovalGasSponsorExtension({\n *   sponsoredNetworks: [\"eip155:8453\", \"eip155:42161\"],\n *   maxAmount: \"1000000000\",\n *   sponsorAddress: \"0xFacilitator...\",\n *   requiresAtomicBatch: true,\n * });\n * ```\n */\nexport function declareERC20ApprovalGasSponsorExtension(\n  options: DeclareERC20ApprovalGasSponsorOptions,\n): ERC20ApprovalGasSponsorExtension {\n  const info: ERC20ApprovalGasSponsorExtensionInfo = {\n    sponsoredNetworks: options.sponsoredNetworks,\n    maxAmount: options.maxAmount,\n    sponsorAddress: options.sponsorAddress,\n    requiresAtomicBatch: options.requiresAtomicBatch ?? false,\n  };\n\n  if (options.permit2Address) {\n    info.permit2Address = options.permit2Address;\n  }\n\n  return {\n    info,\n    schema: ERC20_APPROVAL_GAS_SPONSOR_SCHEMA,\n  };\n}\n\n/**\n * Parses an ERC-20 approval gas sponsor header from client request.\n *\n * The header format is base64-encoded JSON.\n *\n * @param header - Base64-encoded gas sponsor header value\n * @returns Parsed gas sponsor payload\n * @throws Error if header is invalid\n *\n * @example\n * ```typescript\n * const payload = parseERC20ApprovalGasSponsorHeader(\n *   request.headers['x-t402-erc20-approval-gas-sponsoring']\n * );\n * ```\n */\nexport function parseERC20ApprovalGasSponsorHeader(header: string): ERC20ApprovalGasSponsorPayload {\n  if (!header) {\n    throw new Error(\"Missing ERC-20 approval gas sponsor header\");\n  }\n\n  try {\n    const decoded = Buffer.from(header, \"base64\").toString(\"utf-8\");\n    const payload = JSON.parse(decoded) as ERC20ApprovalGasSponsorPayload;\n\n    const required = [\"network\", \"from\", \"asset\", \"amount\", \"signedApprovalTx\", \"chainId\"];\n    for (const field of required) {\n      if (!(field in payload)) {\n        throw new Error(`Missing required field: ${field}`);\n      }\n    }\n\n    return payload;\n  } catch (error) {\n    if (error instanceof SyntaxError) {\n      throw new Error(\"Invalid ERC-20 approval gas sponsor header: malformed JSON\");\n    }\n    throw error;\n  }\n}\n\n/**\n * Validates an ERC-20 approval gas sponsor payload against server extension info.\n *\n * @param payload - The gas sponsor payload from the client\n * @param extensionInfo - The server's gas sponsor extension info\n * @param options - Validation options\n * @returns Validation result\n *\n * @example\n * ```typescript\n * const result = validateERC20ApprovalGasSponsorPayload(payload, extension.info);\n * if (!result.valid) {\n *   throw new Error(result.error);\n * }\n * ```\n */\nexport function validateERC20ApprovalGasSponsorPayload(\n  payload: ERC20ApprovalGasSponsorPayload,\n  extensionInfo: ERC20ApprovalGasSponsorExtensionInfo,\n  options: ValidateERC20ApprovalGasSponsorOptions = {},\n): ERC20ApprovalGasSponsorValidationResult {\n  // Validate network is in sponsoredNetworks\n  if (!extensionInfo.sponsoredNetworks.includes(payload.network)) {\n    return {\n      valid: false,\n      error: `Network ${payload.network} is not in sponsored networks: ${extensionInfo.sponsoredNetworks.join(\", \")}`,\n    };\n  }\n\n  // Validate amount does not exceed maxAmount\n  const payloadAmount = BigInt(payload.amount);\n  const maxAmount = BigInt(extensionInfo.maxAmount);\n  if (payloadAmount > maxAmount) {\n    return {\n      valid: false,\n      error: `Amount ${payload.amount} exceeds maximum amount ${extensionInfo.maxAmount}`,\n    };\n  }\n\n  // Validate chainId matches expected value for network (if provided)\n  if (options.expectedChainIds) {\n    const expectedChainId = options.expectedChainIds[payload.network];\n    if (expectedChainId !== undefined && payload.chainId !== expectedChainId) {\n      return {\n        valid: false,\n        error: `Chain ID ${payload.chainId} does not match expected chain ID ${expectedChainId} for network ${payload.network}`,\n      };\n    }\n  }\n\n  // Validate signedApprovalTx is hex-encoded\n  const txHex = payload.signedApprovalTx.startsWith(\"0x\")\n    ? payload.signedApprovalTx.slice(2)\n    : payload.signedApprovalTx;\n  if (txHex.length === 0) {\n    return {\n      valid: false,\n      error: \"Signed approval transaction is empty\",\n    };\n  }\n  if (!/^[0-9a-fA-F]+$/.test(txHex)) {\n    return {\n      valid: false,\n      error: \"Signed approval transaction is not valid hex\",\n    };\n  }\n\n  // Validate from address format\n  const fromHex = payload.from.startsWith(\"0x\") ? payload.from.slice(2) : payload.from;\n  if (fromHex.length !== 40 || !/^[0-9a-fA-F]+$/.test(fromHex)) {\n    return {\n      valid: false,\n      error: `Invalid from address: ${payload.from}`,\n    };\n  }\n\n  // Validate asset address format\n  const assetHex = payload.asset.startsWith(\"0x\") ? payload.asset.slice(2) : payload.asset;\n  if (assetHex.length !== 40 || !/^[0-9a-fA-F]+$/.test(assetHex)) {\n    return {\n      valid: false,\n      error: `Invalid asset address: ${payload.asset}`,\n    };\n  }\n\n  return { valid: true };\n}\n","/**\n * ERC-20 Approval Gas Sponsoring Extension Client-Side Implementation\n *\n * Provides functions for clients to construct ERC-20 approve() calldata\n * and encode gas sponsor payloads for transmission.\n */\n\nimport type {\n  ERC20ApprovalGasSponsorPayload,\n  ERC20ApprovalGasSponsorExtensionInfo,\n  CreateERC20ApprovalParams,\n} from \"./types.js\";\n\n/**\n * Extension key for ERC-20 approval gas sponsoring in payment requirements.\n */\nexport const ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY = \"erc20ApprovalGasSponsoring\";\n\n/**\n * HTTP header name for ERC-20 approval gas sponsor payload.\n */\nexport const ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME = \"X-T402-ERC20-Approval-Gas-Sponsoring\";\n\n/**\n * ERC-20 approve(address,uint256) function selector.\n */\nexport const APPROVE_FUNCTION_SELECTOR = \"0x095ea7b3\";\n\n/**\n * Encodes ERC-20 approve(address spender, uint256 amount) calldata.\n *\n * @param spender - The spender address to approve\n * @param amount - The approval amount in base units\n * @returns Hex-encoded calldata with 0x prefix\n *\n * @example\n * ```typescript\n * const calldata = encodeApproveCalldata(\"0xFacilitator...\", \"1000000\");\n * // Returns \"0x095ea7b3\" + abi-encoded args\n * ```\n */\nexport function encodeApproveCalldata(spender: string, amount: string): string {\n  // Remove 0x prefix from spender address\n  const spenderHex = spender.startsWith(\"0x\") ? spender.slice(2) : spender;\n\n  // Pad spender address to 32 bytes (left-padded with zeros)\n  const paddedSpender = spenderHex.toLowerCase().padStart(64, \"0\");\n\n  // Convert amount to hex and pad to 32 bytes (left-padded with zeros)\n  const amountBigInt = BigInt(amount);\n  const amountHex = amountBigInt.toString(16).padStart(64, \"0\");\n\n  return APPROVE_FUNCTION_SELECTOR + paddedSpender + amountHex;\n}\n\n/**\n * Creates an ERC-20 approval gas sponsor payload from params and extension info.\n *\n * @param info - The server's extension info\n * @param params - The approval parameters\n * @returns Gas sponsor payload ready for header encoding\n *\n * @example\n * ```typescript\n * const payload = createERC20ApprovalGasSponsorPayload(extensionInfo, {\n *   network: \"eip155:8453\",\n *   from: wallet.address,\n *   asset: \"0xUSDT...\",\n *   amount: \"1000000\",\n *   signedApprovalTx: signedTx,\n *   chainId: 8453,\n * });\n * ```\n */\nexport function createERC20ApprovalGasSponsorPayload(\n  _info: ERC20ApprovalGasSponsorExtensionInfo,\n  params: CreateERC20ApprovalParams,\n): ERC20ApprovalGasSponsorPayload {\n  const payload: ERC20ApprovalGasSponsorPayload = {\n    network: params.network,\n    from: params.from,\n    asset: params.asset,\n    amount: params.amount,\n    signedApprovalTx: params.signedApprovalTx.startsWith(\"0x\")\n      ? params.signedApprovalTx\n      : \"0x\" + params.signedApprovalTx,\n    chainId: params.chainId,\n  };\n\n  if (params.nonce !== undefined) {\n    payload.nonce = params.nonce;\n  }\n\n  return payload;\n}\n\n/**\n * Encodes an ERC-20 approval gas sponsor payload for transmission in HTTP header.\n *\n * @param payload - The gas sponsor payload to encode\n * @returns Base64-encoded JSON string\n *\n * @example\n * ```typescript\n * const header = encodeERC20ApprovalGasSponsorHeader(payload);\n * fetch(url, {\n *   headers: { [ERC20_APPROVAL_GAS_SPONSOR_HEADER_NAME]: header }\n * });\n * ```\n */\nexport function encodeERC20ApprovalGasSponsorHeader(\n  payload: ERC20ApprovalGasSponsorPayload,\n): string {\n  const json = JSON.stringify(payload);\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(json, \"utf-8\").toString(\"base64\");\n  }\n  return btoa(json);\n}\n","/**\n * ERC-20 Approval Gas Sponsoring Extension Facilitator-Side Implementation\n *\n * Provides functions for facilitators to extract approval data from payment\n * extensions, validate the signed approve() transaction, and prepare for\n * on-chain submission.\n */\n\nimport type {\n  ERC20ApprovalGasSponsorPayload,\n  ERC20ApprovalGasSponsorExtensionInfo,\n  ERC20ApprovalGasSponsorValidationResult,\n} from \"./types.js\";\nimport { ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY, APPROVE_FUNCTION_SELECTOR } from \"./client.js\";\nimport { validateERC20ApprovalGasSponsorPayload } from \"./server.js\";\n\n/**\n * Extracts the ERC-20 approval gas sponsor payload from payment extensions.\n *\n * @param extensions - The extensions map from a PaymentPayload\n * @returns The gas sponsor payload if present, or null\n *\n * @example\n * ```typescript\n * const approval = extractERC20ApprovalGasSponsorPayload(paymentPayload.extensions);\n * if (approval) {\n *   // Validate and broadcast the approval tx, then settle\n * }\n * ```\n */\nexport function extractERC20ApprovalGasSponsorPayload(\n  extensions: Record<string, unknown> | undefined,\n): ERC20ApprovalGasSponsorPayload | null {\n  if (!extensions) {\n    return null;\n  }\n\n  const raw = extensions[ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY];\n  if (!raw || typeof raw !== \"object\") {\n    return null;\n  }\n\n  const payload = raw as Record<string, unknown>;\n\n  // Validate required fields are present\n  const required = [\"network\", \"from\", \"asset\", \"amount\", \"signedApprovalTx\", \"chainId\"];\n  for (const field of required) {\n    if (!(field in payload)) {\n      return null;\n    }\n  }\n\n  const result: ERC20ApprovalGasSponsorPayload = {\n    network: payload.network as string,\n    from: payload.from as string,\n    asset: payload.asset as string,\n    amount: payload.amount as string,\n    signedApprovalTx: payload.signedApprovalTx as string,\n    chainId: payload.chainId as number,\n  };\n\n  if (\"nonce\" in payload && payload.nonce !== undefined) {\n    result.nonce = payload.nonce as number;\n  }\n\n  return result;\n}\n\n/**\n * Processes and validates an ERC-20 approval payload for the facilitator.\n *\n * Combines extraction validation with approve() function selector verification.\n * Checks that the signed transaction data contains the correct approve() selector\n * and that the approval amount matches the declared amount.\n *\n * @param payload - The ERC-20 approval gas sponsor payload\n * @param extensionInfo - The server's gas sponsor extension info\n * @returns Validation result\n *\n * @example\n * ```typescript\n * const result = processERC20ApprovalPayload(payload, extensionInfo);\n * if (result.valid) {\n *   // Safe to broadcast the approval tx and settle\n * }\n * ```\n */\nexport function processERC20ApprovalPayload(\n  payload: ERC20ApprovalGasSponsorPayload,\n  extensionInfo: ERC20ApprovalGasSponsorExtensionInfo,\n): ERC20ApprovalGasSponsorValidationResult {\n  // Run standard validation\n  const validationResult = validateERC20ApprovalGasSponsorPayload(payload, extensionInfo);\n  if (!validationResult.valid) {\n    return validationResult;\n  }\n\n  // Verify the signed tx is not empty\n  const txHex = payload.signedApprovalTx.startsWith(\"0x\")\n    ? payload.signedApprovalTx.slice(2)\n    : payload.signedApprovalTx;\n\n  if (txHex.length < 8) {\n    return {\n      valid: false,\n      error: \"Signed approval transaction is too short to contain function selector\",\n    };\n  }\n\n  return { valid: true };\n}\n\n/**\n * Validates and extracts the ERC-20 approval gas sponsor payload in one step.\n *\n * This is a convenience function for facilitators that combines extraction\n * and validation against the server's extension info.\n *\n * @param extensions - The extensions map from a PaymentPayload\n * @param extensionInfo - The server's gas sponsor extension info\n * @returns Validation result with the extracted payload if valid\n *\n * @example\n * ```typescript\n * const result = validateAndExtractApproval(\n *   paymentPayload.extensions,\n *   extensionInfo\n * );\n * if (result.valid && result.payload) {\n *   // Broadcast approval tx, then settle\n * }\n * ```\n */\nexport function validateAndExtractApproval(\n  extensions: Record<string, unknown> | undefined,\n  extensionInfo: ERC20ApprovalGasSponsorExtensionInfo,\n): ERC20ApprovalGasSponsorValidationResult & { payload?: ERC20ApprovalGasSponsorPayload } {\n  const payload = extractERC20ApprovalGasSponsorPayload(extensions);\n\n  if (!payload) {\n    return {\n      valid: false,\n      error: `Missing or invalid ${ERC20_APPROVAL_GAS_SPONSOR_EXTENSION_KEY} extension in payment`,\n    };\n  }\n\n  const result = processERC20ApprovalPayload(payload, extensionInfo);\n\n  if (!result.valid) {\n    return result;\n  }\n\n  return { valid: true, payload };\n}\n\n/**\n * Decodes the approve() calldata from a hex string to extract spender and amount.\n *\n * @param calldata - Hex-encoded approve() calldata (with or without 0x prefix)\n * @returns Decoded spender and amount, or null if not valid approve() calldata\n *\n * @example\n * ```typescript\n * const decoded = decodeApproveCalldata(\"0x095ea7b3...\");\n * if (decoded) {\n *   console.log(decoded.spender, decoded.amount);\n * }\n * ```\n */\nexport function decodeApproveCalldata(\n  calldata: string,\n): { spender: string; amount: string } | null {\n  const hex = calldata.startsWith(\"0x\") ? calldata.slice(2) : calldata;\n\n  // approve(address,uint256) = 4 byte selector + 32 byte address + 32 byte amount = 136 hex chars\n  if (hex.length < 136) {\n    return null;\n  }\n\n  const selector = \"0x\" + hex.slice(0, 8);\n  if (selector !== APPROVE_FUNCTION_SELECTOR) {\n    return null;\n  }\n\n  // Extract spender address (bytes 4-36, last 20 bytes of the 32-byte word)\n  const spenderWord = hex.slice(8, 72);\n  const spender = \"0x\" + spenderWord.slice(24);\n\n  // Extract amount (bytes 36-68)\n  const amountHex = hex.slice(72, 136);\n  const amount = BigInt(\"0x\" + amountHex).toString(10);\n\n  return { spender, amount };\n}\n"],"mappings":"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","names":[]}

package/dist/esm/chunk-S36A7YLQ.mjs

@@ -0,0 +1,70 @@
+// src/payment-id/types.ts
+var PAYMENT_ID_EXTENSION_KEY = "paymentId";
+
+// src/payment-id/server.ts
+import { randomUUID } from "crypto";
+var PAYMENT_ID_SCHEMA = {
+  type: "object",
+  required: ["id"],
+  properties: {
+    id: { type: "string", format: "uuid" },
+    clientId: { type: "string" }
+  }
+};
+function declarePaymentIdExtension(options = {}) {
+  const info = {
+    id: options.id || randomUUID(),
+    idempotencyKey: options.idempotencyKey,
+    groupId: options.groupId,
+    metadata: options.metadata
+  };
+  return {
+    info,
+    schema: PAYMENT_ID_SCHEMA
+  };
+}
+function parsePaymentIdPayload(extensions) {
+  if (!extensions || !(PAYMENT_ID_EXTENSION_KEY in extensions)) {
+    return null;
+  }
+  const raw = extensions[PAYMENT_ID_EXTENSION_KEY];
+  if (typeof raw !== "object" || raw === null) {
+    throw new Error("Invalid paymentId extension: expected object");
+  }
+  const obj = raw;
+  if (typeof obj.id !== "string" || obj.id.length === 0) {
+    throw new Error("Invalid paymentId extension: missing or empty id");
+  }
+  return {
+    id: obj.id,
+    clientId: typeof obj.clientId === "string" ? obj.clientId : void 0
+  };
+}
+function validatePaymentId(payload, expected) {
+  return payload.id === expected.id;
+}
+
+// src/payment-id/client.ts
+function createPaymentIdPayload(extension, clientId) {
+  return {
+    id: extension.info.id,
+    clientId
+  };
+}
+function encodePaymentIdHeader(payload) {
+  const json = JSON.stringify(payload);
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(json, "utf-8").toString("base64");
+  }
+  return btoa(json);
+}
+
+export {
+  PAYMENT_ID_EXTENSION_KEY,
+  declarePaymentIdExtension,
+  parsePaymentIdPayload,
+  validatePaymentId,
+  createPaymentIdPayload,
+  encodePaymentIdHeader
+};
+//# sourceMappingURL=chunk-S36A7YLQ.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/payment-id/types.ts","../../src/payment-id/server.ts","../../src/payment-id/client.ts"],"sourcesContent":["/**\n * Payment ID Extension Type Definitions\n *\n * Allows servers to attach unique identifiers to payments for\n * correlation, idempotency, and audit trails.\n */\n\n/**\n * Extension key for payment ID in requirements/payload extensions.\n */\nexport const PAYMENT_ID_EXTENSION_KEY = \"paymentId\";\n\n/**\n * Information provided by server about the payment identifier.\n */\nexport interface PaymentIdExtensionInfo {\n  /** Unique payment identifier (UUID v4) */\n  id: string;\n\n  /** Optional idempotency key for replay protection */\n  idempotencyKey?: string;\n\n  /** Optional payment group for batching */\n  groupId?: string;\n\n  /** Optional metadata */\n  metadata?: Record<string, string>;\n}\n\n/**\n * Payment ID extension declaration for server responses.\n */\nexport interface PaymentIdExtension {\n  /** Extension information */\n  info: PaymentIdExtensionInfo;\n\n  /** JSON Schema for validation */\n  schema: object;\n}\n\n/**\n * Payment ID payload echoed back by the client.\n */\nexport interface PaymentIdPayload {\n  /** Payment ID echoed back from requirements */\n  id: string;\n\n  /** Optional client-generated correlation ID */\n  clientId?: string;\n}\n\n/**\n * Options for declaring a payment ID extension.\n */\nexport interface DeclarePaymentIdOptions {\n  /** Custom payment ID (defaults to crypto.randomUUID()) */\n  id?: string;\n\n  /** Optional idempotency key for replay protection */\n  idempotencyKey?: string;\n\n  /** Optional payment group for batching */\n  groupId?: string;\n\n  /** Optional metadata */\n  metadata?: Record<string, string>;\n}\n","/**\n * Payment ID Extension Server-Side Implementation\n *\n * Provides functions for servers to declare payment ID requirements,\n * parse client payloads, and validate payment IDs.\n */\n\nimport { randomUUID } from \"crypto\";\nimport {\n  PaymentIdExtension,\n  PaymentIdExtensionInfo,\n  PaymentIdPayload,\n  DeclarePaymentIdOptions,\n  PAYMENT_ID_EXTENSION_KEY,\n} from \"./types.js\";\n\n/**\n * JSON Schema for payment ID payload validation.\n */\nconst PAYMENT_ID_SCHEMA = {\n  type: \"object\",\n  required: [\"id\"],\n  properties: {\n    id: { type: \"string\", format: \"uuid\" },\n    clientId: { type: \"string\" },\n  },\n};\n\n/**\n * Declares a payment ID extension for server responses.\n *\n * @param options - Optional configuration for the payment ID\n * @returns Payment ID extension object ready for response\n *\n * @example\n * ```typescript\n * const extension = declarePaymentIdExtension();\n * // Include in PaymentRequired response extensions:\n * // extensions: { [PAYMENT_ID_EXTENSION_KEY]: extension }\n * ```\n */\nexport function declarePaymentIdExtension(\n  options: DeclarePaymentIdOptions = {},\n): PaymentIdExtension {\n  const info: PaymentIdExtensionInfo = {\n    id: options.id || randomUUID(),\n    idempotencyKey: options.idempotencyKey,\n    groupId: options.groupId,\n    metadata: options.metadata,\n  };\n\n  return {\n    info,\n    schema: PAYMENT_ID_SCHEMA,\n  };\n}\n\n/**\n * Parses a payment ID payload from client request extensions.\n *\n * @param extensions - Extensions object from the payment payload\n * @returns Parsed payment ID payload, or null if not present\n * @throws Error if payload is present but invalid\n *\n * @example\n * ```typescript\n * const payload = parsePaymentIdPayload(paymentPayload.extensions);\n * if (payload) {\n *   console.log(\"Payment ID:\", payload.id);\n * }\n * ```\n */\nexport function parsePaymentIdPayload(\n  extensions?: Record<string, unknown>,\n): PaymentIdPayload | null {\n  if (!extensions || !(PAYMENT_ID_EXTENSION_KEY in extensions)) {\n    return null;\n  }\n\n  const raw = extensions[PAYMENT_ID_EXTENSION_KEY];\n  if (typeof raw !== \"object\" || raw === null) {\n    throw new Error(\"Invalid paymentId extension: expected object\");\n  }\n\n  const obj = raw as Record<string, unknown>;\n\n  if (typeof obj.id !== \"string\" || obj.id.length === 0) {\n    throw new Error(\"Invalid paymentId extension: missing or empty id\");\n  }\n\n  return {\n    id: obj.id,\n    clientId: typeof obj.clientId === \"string\" ? obj.clientId : undefined,\n  };\n}\n\n/**\n * Validates that a client's payment ID payload matches the expected extension.\n *\n * @param payload - The client's payment ID payload\n * @param expected - The expected payment ID from the server extension\n * @returns True if the payment ID matches\n *\n * @example\n * ```typescript\n * const isValid = validatePaymentId(clientPayload, serverExtension.info);\n * if (!isValid) {\n *   throw new Error(\"Payment ID mismatch\");\n * }\n * ```\n */\nexport function validatePaymentId(\n  payload: PaymentIdPayload,\n  expected: PaymentIdExtensionInfo,\n): boolean {\n  return payload.id === expected.id;\n}\n","/**\n * Payment ID Extension Client-Side Implementation\n *\n * Provides functions for clients to echo payment IDs back to servers.\n */\n\nimport { PaymentIdExtension, PaymentIdPayload } from \"./types.js\";\n\n/**\n * Creates a payment ID payload from a server extension.\n *\n * Reads the payment ID from requirements and echoes it back.\n *\n * @param extension - Payment ID extension from server's 402 response\n * @param clientId - Optional client-generated correlation ID\n * @returns Payment ID payload for inclusion in payment extensions\n *\n * @example\n * ```typescript\n * const extension = paymentRequirements.extensions?.paymentId;\n * const payload = createPaymentIdPayload(extension, \"my-correlation-id\");\n * // Include in payment payload extensions:\n * // extensions: { [PAYMENT_ID_EXTENSION_KEY]: payload }\n * ```\n */\nexport function createPaymentIdPayload(\n  extension: PaymentIdExtension,\n  clientId?: string,\n): PaymentIdPayload {\n  return {\n    id: extension.info.id,\n    clientId,\n  };\n}\n\n/**\n * Encodes a payment ID payload for header-based transport.\n *\n * @param payload - The payment ID payload to encode\n * @returns Base64-encoded JSON string\n */\nexport function encodePaymentIdHeader(payload: PaymentIdPayload): string {\n  const json = JSON.stringify(payload);\n  if (typeof Buffer !== \"undefined\") {\n    return Buffer.from(json, \"utf-8\").toString(\"base64\");\n  }\n  return btoa(json);\n}\n"],"mappings":";AAUO,IAAM,2BAA2B;;;ACHxC,SAAS,kBAAkB;AAY3B,IAAM,oBAAoB;AAAA,EACxB,MAAM;AAAA,EACN,UAAU,CAAC,IAAI;AAAA,EACf,YAAY;AAAA,IACV,IAAI,EAAE,MAAM,UAAU,QAAQ,OAAO;AAAA,IACrC,UAAU,EAAE,MAAM,SAAS;AAAA,EAC7B;AACF;AAeO,SAAS,0BACd,UAAmC,CAAC,GAChB;AACpB,QAAM,OAA+B;AAAA,IACnC,IAAI,QAAQ,MAAM,WAAW;AAAA,IAC7B,gBAAgB,QAAQ;AAAA,IACxB,SAAS,QAAQ;AAAA,IACjB,UAAU,QAAQ;AAAA,EACpB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ;AAAA,EACV;AACF;AAiBO,SAAS,sBACd,YACyB;AACzB,MAAI,CAAC,cAAc,EAAE,4BAA4B,aAAa;AAC5D,WAAO;AAAA,EACT;AAEA,QAAM,MAAM,WAAW,wBAAwB;AAC/C,MAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;AAC3C,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AAEA,QAAM,MAAM;AAEZ,MAAI,OAAO,IAAI,OAAO,YAAY,IAAI,GAAG,WAAW,GAAG;AACrD,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,SAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,UAAU,OAAO,IAAI,aAAa,WAAW,IAAI,WAAW;AAAA,EAC9D;AACF;AAiBO,SAAS,kBACd,SACA,UACS;AACT,SAAO,QAAQ,OAAO,SAAS;AACjC;;;AC3FO,SAAS,uBACd,WACA,UACkB;AAClB,SAAO;AAAA,IACL,IAAI,UAAU,KAAK;AAAA,IACnB;AAAA,EACF;AACF;AAQO,SAAS,sBAAsB,SAAmC;AACvE,QAAM,OAAO,KAAK,UAAU,OAAO;AACnC,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO,OAAO,KAAK,MAAM,OAAO,EAAE,SAAS,QAAQ;AAAA,EACrD;AACA,SAAO,KAAK,IAAI;AAClB;","names":[]}

package/dist/esm/chunk-VINC22RD.mjs

@@ -0,0 +1,278 @@
+// src/eip2612-gas-sponsoring/server.ts
+var EIP2612_GAS_SPONSOR_SCHEMA = {
+  type: "object",
+  required: ["network", "permitSignature", "owner", "spender", "value", "deadline", "v", "r", "s"],
+  properties: {
+    network: { type: "string" },
+    permitSignature: { type: "string" },
+    owner: { type: "string" },
+    spender: { type: "string" },
+    value: { type: "string" },
+    deadline: { type: "number" },
+    v: { type: "number" },
+    r: { type: "string" },
+    s: { type: "string" }
+  }
+};
+function declareEip2612GasSponsorExtension(options) {
+  const info = {
+    sponsoredNetworks: options.sponsoredNetworks,
+    maxAmount: options.maxAmount,
+    permitDeadline: options.permitDeadline ?? 300,
+    sponsorAddress: options.sponsorAddress
+  };
+  return {
+    info,
+    schema: EIP2612_GAS_SPONSOR_SCHEMA
+  };
+}
+function parseEip2612GasSponsorHeader(header) {
+  if (!header) {
+    throw new Error("Missing EIP-2612 gas sponsor header");
+  }
+  try {
+    const decoded = Buffer.from(header, "base64").toString("utf-8");
+    const payload = JSON.parse(decoded);
+    const required = [
+      "network",
+      "permitSignature",
+      "owner",
+      "spender",
+      "value",
+      "deadline",
+      "v",
+      "r",
+      "s"
+    ];
+    for (const field of required) {
+      if (!(field in payload)) {
+        throw new Error(`Missing required field: ${field}`);
+      }
+    }
+    return payload;
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error("Invalid EIP-2612 gas sponsor header: malformed JSON");
+    }
+    throw error;
+  }
+}
+function validateEip2612GasSponsorPayload(payload, extensionInfo, options = {}) {
+  const now = options.now ? options.now() : Date.now();
+  const nowSeconds = Math.floor(now / 1e3);
+  if (!extensionInfo.sponsoredNetworks.includes(payload.network)) {
+    return {
+      valid: false,
+      error: `Network ${payload.network} is not in sponsored networks: ${extensionInfo.sponsoredNetworks.join(", ")}`
+    };
+  }
+  const payloadValue = BigInt(payload.value);
+  const maxAmount = BigInt(extensionInfo.maxAmount);
+  if (payloadValue > maxAmount) {
+    return {
+      valid: false,
+      error: `Value ${payload.value} exceeds maximum amount ${extensionInfo.maxAmount}`
+    };
+  }
+  if (payload.deadline <= nowSeconds) {
+    return {
+      valid: false,
+      error: "Permit deadline has expired"
+    };
+  }
+  const maxDeadline = nowSeconds + extensionInfo.permitDeadline;
+  if (payload.deadline > maxDeadline) {
+    return {
+      valid: false,
+      error: `Permit deadline ${payload.deadline} exceeds maximum allowed deadline ${maxDeadline}`
+    };
+  }
+  if (payload.spender.toLowerCase() !== extensionInfo.sponsorAddress.toLowerCase()) {
+    return {
+      valid: false,
+      error: `Spender ${payload.spender} does not match sponsor address ${extensionInfo.sponsorAddress}`
+    };
+  }
+  const sigHex = payload.permitSignature.startsWith("0x") ? payload.permitSignature.slice(2) : payload.permitSignature;
+  if (sigHex.length !== 130) {
+    return {
+      valid: false,
+      error: `Invalid permit signature length: expected 130 hex chars, got ${sigHex.length}`
+    };
+  }
+  if (payload.v !== 27 && payload.v !== 28) {
+    return {
+      valid: false,
+      error: `Invalid v value: expected 27 or 28, got ${payload.v}`
+    };
+  }
+  const rHex = payload.r.startsWith("0x") ? payload.r.slice(2) : payload.r;
+  if (rHex.length !== 64) {
+    return {
+      valid: false,
+      error: `Invalid r length: expected 64 hex chars, got ${rHex.length}`
+    };
+  }
+  const sHex = payload.s.startsWith("0x") ? payload.s.slice(2) : payload.s;
+  if (sHex.length !== 64) {
+    return {
+      valid: false,
+      error: `Invalid s length: expected 64 hex chars, got ${sHex.length}`
+    };
+  }
+  return { valid: true };
+}
+
+// src/eip2612-gas-sponsoring/client.ts
+var EIP2612_GAS_SPONSOR_EXTENSION_KEY = "eip2612GasSponsoring";
+var EIP2612_GAS_SPONSOR_HEADER_NAME = "X-T402-EIP2612-Gas-Sponsoring";
+async function createPermitSignature(params) {
+  const { signer, tokenAddress, tokenName, chainId, spender, value, deadline, nonce = 0 } = params;
+  const domain = {
+    name: tokenName,
+    version: "1",
+    chainId,
+    verifyingContract: tokenAddress
+  };
+  const types = {
+    Permit: [
+      { name: "owner", type: "address" },
+      { name: "spender", type: "address" },
+      { name: "value", type: "uint256" },
+      { name: "nonce", type: "uint256" },
+      { name: "deadline", type: "uint256" }
+    ]
+  };
+  const message = {
+    owner: signer.address,
+    spender,
+    value,
+    nonce,
+    deadline
+  };
+  const signature = await signer.signTypedData({
+    domain,
+    types,
+    primaryType: "Permit",
+    message
+  });
+  const sigHex = signature.startsWith("0x") ? signature.slice(2) : signature;
+  if (sigHex.length !== 130) {
+    throw new Error(`Invalid signature length: expected 130 hex chars, got ${sigHex.length}`);
+  }
+  const r = "0x" + sigHex.slice(0, 64);
+  const s = "0x" + sigHex.slice(64, 128);
+  let v = parseInt(sigHex.slice(128, 130), 16);
+  if (v < 27) {
+    v += 27;
+  }
+  return {
+    owner: signer.address,
+    spender,
+    value,
+    deadline,
+    v,
+    r,
+    s,
+    permitSignature: signature.startsWith("0x") ? signature : "0x" + signature
+  };
+}
+function createEip2612GasSponsorPayload(permit, network) {
+  return {
+    network,
+    permitSignature: permit.permitSignature,
+    owner: permit.owner,
+    spender: permit.spender,
+    value: permit.value,
+    deadline: permit.deadline,
+    v: permit.v,
+    r: permit.r,
+    s: permit.s
+  };
+}
+function encodeEip2612GasSponsorHeader(payload) {
+  const json = JSON.stringify(payload);
+  if (typeof Buffer !== "undefined") {
+    return Buffer.from(json, "utf-8").toString("base64");
+  }
+  return btoa(json);
+}
+
+// src/eip2612-gas-sponsoring/facilitator.ts
+function extractEip2612GasSponsorPayload(extensions) {
+  if (!extensions) {
+    return null;
+  }
+  const raw = extensions[EIP2612_GAS_SPONSOR_EXTENSION_KEY];
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+  const payload = raw;
+  const required = [
+    "network",
+    "permitSignature",
+    "owner",
+    "spender",
+    "value",
+    "deadline",
+    "v",
+    "r",
+    "s"
+  ];
+  for (const field of required) {
+    if (!(field in payload)) {
+      return null;
+    }
+  }
+  return {
+    network: payload.network,
+    permitSignature: payload.permitSignature,
+    owner: payload.owner,
+    spender: payload.spender,
+    value: payload.value,
+    deadline: payload.deadline,
+    v: payload.v,
+    r: payload.r,
+    s: payload.s
+  };
+}
+function validateAndExtractPermit(extensions, extensionInfo) {
+  const payload = extractEip2612GasSponsorPayload(extensions);
+  if (!payload) {
+    return {
+      valid: false,
+      error: `Missing or invalid ${EIP2612_GAS_SPONSOR_EXTENSION_KEY} extension in payment`
+    };
+  }
+  const result = validateEip2612GasSponsorPayload(payload, extensionInfo);
+  if (!result.valid) {
+    return result;
+  }
+  return { valid: true, payload };
+}
+function buildPermitCallData(payload) {
+  return {
+    owner: payload.owner,
+    spender: payload.spender,
+    value: payload.value,
+    deadline: payload.deadline,
+    v: payload.v,
+    r: payload.r,
+    s: payload.s
+  };
+}
+
+export {
+  declareEip2612GasSponsorExtension,
+  parseEip2612GasSponsorHeader,
+  validateEip2612GasSponsorPayload,
+  EIP2612_GAS_SPONSOR_EXTENSION_KEY,
+  EIP2612_GAS_SPONSOR_HEADER_NAME,
+  createPermitSignature,
+  createEip2612GasSponsorPayload,
+  encodeEip2612GasSponsorHeader,
+  extractEip2612GasSponsorPayload,
+  validateAndExtractPermit,
+  buildPermitCallData
+};
+//# sourceMappingURL=chunk-VINC22RD.mjs.map