@x402/extensions 2.3.1 → 2.5.0

package/dist/cjs/index.js

@@ -31,6 +31,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   BAZAAR: () => BAZAAR,
+  EIP2612_GAS_SPONSORING: () => EIP2612_GAS_SPONSORING,
+  ERC20_APPROVAL_GAS_SPONSORING: () => ERC20_APPROVAL_GAS_SPONSORING,
+  ERC20_APPROVAL_GAS_SPONSORING_VERSION: () => ERC20_APPROVAL_GAS_SPONSORING_VERSION,
   InMemorySIWxStorage: () => InMemorySIWxStorage,
   PAYMENT_IDENTIFIER: () => PAYMENT_IDENTIFIER,
   PAYMENT_ID_MAX_LENGTH: () => PAYMENT_ID_MAX_LENGTH,
@@ -44,22 +47,28 @@ __export(src_exports, {
   appendPaymentIdentifierToExtensions: () => appendPaymentIdentifierToExtensions,
   bazaarResourceServerExtension: () => bazaarResourceServerExtension,
   buildSIWxSchema: () => buildSIWxSchema,
+  createErc20ApprovalGasSponsoringExtension: () => createErc20ApprovalGasSponsoringExtension,
   createSIWxClientHook: () => createSIWxClientHook,
   createSIWxMessage: () => createSIWxMessage,
   createSIWxPayload: () => createSIWxPayload,
   createSIWxRequestHook: () => createSIWxRequestHook,
   createSIWxSettleHook: () => createSIWxSettleHook,
   declareDiscoveryExtension: () => declareDiscoveryExtension,
+  declareEip2612GasSponsoringExtension: () => declareEip2612GasSponsoringExtension,
+  declareErc20ApprovalGasSponsoringExtension: () => declareErc20ApprovalGasSponsoringExtension,
   declarePaymentIdentifierExtension: () => declarePaymentIdentifierExtension,
   declareSIWxExtension: () => declareSIWxExtension,
   decodeBase58: () => decodeBase58,
   encodeBase58: () => encodeBase58,
   encodeSIWxHeader: () => encodeSIWxHeader,
+  erc20ApprovalGasSponsoringSchema: () => erc20ApprovalGasSponsoringSchema,
   extractAndValidatePaymentIdentifier: () => extractAndValidatePaymentIdentifier,
   extractDiscoveryInfo: () => extractDiscoveryInfo,
   extractDiscoveryInfoFromExtension: () => extractDiscoveryInfoFromExtension,
   extractDiscoveryInfoV1: () => extractDiscoveryInfoV1,
   extractEVMChainId: () => extractEVMChainId,
+  extractEip2612GasSponsoringInfo: () => extractEip2612GasSponsoringInfo,
+  extractErc20ApprovalGasSponsoringInfo: () => extractErc20ApprovalGasSponsoringInfo,
   extractPaymentIdentifier: () => extractPaymentIdentifier,
   extractResourceMetadataV1: () => extractResourceMetadataV1,
   extractSolanaChainReference: () => extractSolanaChainReference,
@@ -69,10 +78,13 @@ __export(src_exports, {
   getEVMAddress: () => getEVMAddress,
   getSolanaAddress: () => getSolanaAddress,
   hasPaymentIdentifier: () => hasPaymentIdentifier,
+  isBodyExtensionConfig: () => isBodyExtensionConfig,
   isDiscoverableV1: () => isDiscoverableV1,
   isEVMSigner: () => isEVMSigner,
+  isMcpExtensionConfig: () => isMcpExtensionConfig,
   isPaymentIdentifierExtension: () => isPaymentIdentifierExtension,
   isPaymentIdentifierRequired: () => isPaymentIdentifierRequired,
+  isQueryExtensionConfig: () => isQueryExtensionConfig,
   isSolanaSigner: () => isSolanaSigner,
   isValidPaymentId: () => isValidPaymentId,
   parseSIWxHeader: () => parseSIWxHeader,
@@ -83,6 +95,8 @@ __export(src_exports, {
   siwxResourceServerExtension: () => siwxResourceServerExtension,
   validateAndExtract: () => validateAndExtract,
   validateDiscoveryExtension: () => validateDiscoveryExtension,
+  validateEip2612GasSponsoringInfo: () => validateEip2612GasSponsoringInfo,
+  validateErc20ApprovalGasSponsoringInfo: () => validateErc20ApprovalGasSponsoringInfo,
   validatePaymentIdentifier: () => validatePaymentIdentifier,
   validatePaymentIdentifierRequirement: () => validatePaymentIdentifierRequirement,
   validateSIWxMessage: () => validateSIWxMessage,
@@ -94,10 +108,23 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/bazaar/http/types.ts
+var isQueryExtensionConfig = (config) => {
+  return !("bodyType" in config) && !("toolName" in config);
+};
+var isBodyExtensionConfig = (config) => {
+  return "bodyType" in config;
+};
+
+// src/bazaar/mcp/types.ts
+var isMcpExtensionConfig = (config) => {
+  return "toolName" in config;
+};
+
 // src/bazaar/types.ts
-var BAZAAR = "bazaar";
+var BAZAAR = { key: "bazaar" };
 
-// src/bazaar/resourceService.ts
+// src/bazaar/http/resourceService.ts
 function createQueryDiscoveryExtension({
   method,
   input = {},
@@ -229,7 +256,97 @@ function createBodyDiscoveryExtension({
     }
   };
 }
+
+// src/bazaar/mcp/resourceService.ts
+function createMcpDiscoveryExtension({
+  toolName,
+  description,
+  transport,
+  inputSchema,
+  example,
+  output
+}) {
+  return {
+    info: {
+      input: {
+        type: "mcp",
+        toolName,
+        ...description !== void 0 ? { description } : {},
+        ...transport !== void 0 ? { transport } : {},
+        inputSchema,
+        ...example !== void 0 ? { example } : {}
+      },
+      ...output?.example ? {
+        output: {
+          type: "json",
+          example: output.example
+        }
+      } : {}
+    },
+    schema: {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: {
+        input: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              const: "mcp"
+            },
+            toolName: {
+              type: "string"
+            },
+            ...description !== void 0 ? {
+              description: {
+                type: "string"
+              }
+            } : {},
+            ...transport !== void 0 ? {
+              transport: {
+                type: "string",
+                enum: ["streamable-http", "sse"]
+              }
+            } : {},
+            inputSchema: {
+              type: "object"
+            },
+            ...example !== void 0 ? {
+              example: {
+                type: "object"
+              }
+            } : {}
+          },
+          required: ["type", "toolName", "inputSchema"],
+          additionalProperties: false
+        },
+        ...output?.example ? {
+          output: {
+            type: "object",
+            properties: {
+              type: {
+                type: "string"
+              },
+              example: {
+                type: "object",
+                ...output.schema && typeof output.schema === "object" ? output.schema : {}
+              }
+            },
+            required: ["type"]
+          }
+        } : {}
+      },
+      required: ["input"]
+    }
+  };
+}
+
+// src/bazaar/resourceService.ts
 function declareDiscoveryExtension(config) {
+  if ("toolName" in config) {
+    const extension2 = createMcpDiscoveryExtension(config);
+    return { bazaar: extension2 };
+  }
   const bodyType = config.bodyType;
   const isBodyMethod2 = bodyType !== void 0;
   const extension = isBodyMethod2 ? createBodyDiscoveryExtension(config) : createQueryDiscoveryExtension(config);
@@ -241,12 +358,15 @@ function isHTTPRequestContext(ctx) {
   return ctx !== null && typeof ctx === "object" && "method" in ctx && "adapter" in ctx;
 }
 var bazaarResourceServerExtension = {
-  key: BAZAAR,
+  key: BAZAAR.key,
   enrichDeclaration: (declaration, transportContext) => {
     if (!isHTTPRequestContext(transportContext)) {
       return declaration;
     }
     const extension = declaration;
+    if (extension.info?.input?.type === "mcp") {
+      return declaration;
+    }
     const method = transportContext.method;
     const existingInputProps = extension.schema?.properties?.input?.properties || {};
     const updatedInputProps = {
@@ -429,7 +549,7 @@ function extractDiscoveryInfo(paymentPayload, paymentRequirements, validate = tr
   if (paymentPayload.x402Version === 2) {
     resourceUrl = paymentPayload.resource?.url ?? "";
     if (paymentPayload.extensions) {
-      const bazaarExtension = paymentPayload.extensions[BAZAAR];
+      const bazaarExtension = paymentPayload.extensions[BAZAAR.key];
       if (bazaarExtension && typeof bazaarExtension === "object") {
         try {
           const extension = bazaarExtension;
@@ -472,14 +592,17 @@ function extractDiscoveryInfo(paymentPayload, paymentRequirements, validate = tr
     description = requirementsV1.description;
     mimeType = requirementsV1.mimeType;
   }
-  return {
+  const base = {
     resourceUrl: normalizedResourceUrl,
     description,
     mimeType,
-    method: discoveryInfo.input.method,
     x402Version: paymentPayload.x402Version,
     discoveryInfo
   };
+  if (discoveryInfo.input.type === "mcp") {
+    return { ...base, toolName: discoveryInfo.input.toolName };
+  }
+  return { ...base, method: discoveryInfo.input.method };
 }
 function extractDiscoveryInfoFromExtension(extension, validate = true) {
   if (validate) {
@@ -1202,7 +1325,9 @@ function createSIWxSettleHook(options) {
     if (!ctx.result.success) return;
     const address = ctx.result.payer;
     if (!address) return;
-    const resource = new URL(ctx.paymentPayload.resource.url).pathname;
+    const resourceUrl = ctx.paymentPayload.resource?.url;
+    if (!resourceUrl) return;
+    const resource = new URL(resourceUrl).pathname;
     await storage.recordPayment(resource, address);
     onEvent?.({ type: "payment_recorded", resource, address });
   };
@@ -1499,9 +1624,187 @@ var paymentIdentifierResourceServerExtension = {
   // No enrichment needed - the declaration is static
   // Future hooks for idempotency could be added here if needed
 };
+
+// src/eip2612-gas-sponsoring/types.ts
+var EIP2612_GAS_SPONSORING = { key: "eip2612GasSponsoring" };
+
+// src/eip2612-gas-sponsoring/resourceService.ts
+var eip2612GasSponsoringSchema = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  type: "object",
+  properties: {
+    from: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the sender."
+    },
+    asset: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the ERC-20 token contract."
+    },
+    spender: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the spender (Canonical Permit2)."
+    },
+    amount: {
+      type: "string",
+      pattern: "^[0-9]+$",
+      description: "The amount to approve (uint256). Typically MaxUint."
+    },
+    nonce: {
+      type: "string",
+      pattern: "^[0-9]+$",
+      description: "The current nonce of the sender."
+    },
+    deadline: {
+      type: "string",
+      pattern: "^[0-9]+$",
+      description: "The timestamp at which the signature expires."
+    },
+    signature: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]+$",
+      description: "The 65-byte concatenated signature (r, s, v) as a hex string."
+    },
+    version: {
+      type: "string",
+      pattern: "^[0-9]+(\\.[0-9]+)*$",
+      description: "Schema version identifier."
+    }
+  },
+  required: ["from", "asset", "spender", "amount", "nonce", "deadline", "signature", "version"]
+};
+function declareEip2612GasSponsoringExtension() {
+  const key = EIP2612_GAS_SPONSORING.key;
+  return {
+    [key]: {
+      info: {
+        description: "The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract.",
+        version: "1"
+      },
+      schema: eip2612GasSponsoringSchema
+    }
+  };
+}
+
+// src/eip2612-gas-sponsoring/facilitator.ts
+function extractEip2612GasSponsoringInfo(paymentPayload) {
+  if (!paymentPayload.extensions) {
+    return null;
+  }
+  const extension = paymentPayload.extensions[EIP2612_GAS_SPONSORING.key];
+  if (!extension?.info) {
+    return null;
+  }
+  const info = extension.info;
+  if (!info.from || !info.asset || !info.spender || !info.amount || !info.nonce || !info.deadline || !info.signature || !info.version) {
+    return null;
+  }
+  return info;
+}
+function validateEip2612GasSponsoringInfo(info) {
+  const addressPattern = /^0x[a-fA-F0-9]{40}$/;
+  const numericPattern = /^[0-9]+$/;
+  const hexPattern = /^0x[a-fA-F0-9]+$/;
+  const versionPattern = /^[0-9]+(\.[0-9]+)*$/;
+  return addressPattern.test(info.from) && addressPattern.test(info.asset) && addressPattern.test(info.spender) && numericPattern.test(info.amount) && numericPattern.test(info.nonce) && numericPattern.test(info.deadline) && hexPattern.test(info.signature) && versionPattern.test(info.version);
+}
+
+// src/erc20-approval-gas-sponsoring/types.ts
+var ERC20_APPROVAL_GAS_SPONSORING = {
+  key: "erc20ApprovalGasSponsoring"
+};
+var ERC20_APPROVAL_GAS_SPONSORING_VERSION = "1";
+function createErc20ApprovalGasSponsoringExtension(signer, client) {
+  return {
+    ...ERC20_APPROVAL_GAS_SPONSORING,
+    signer: {
+      ...signer,
+      sendRawTransaction: client.sendRawTransaction.bind(client)
+    }
+  };
+}
+
+// src/erc20-approval-gas-sponsoring/resourceService.ts
+var erc20ApprovalGasSponsoringSchema = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  type: "object",
+  properties: {
+    from: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the sender (token owner)."
+    },
+    asset: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the ERC-20 token contract."
+    },
+    spender: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]{40}$",
+      description: "The address of the spender (Canonical Permit2)."
+    },
+    amount: {
+      type: "string",
+      pattern: "^[0-9]+$",
+      description: "The amount approved (uint256). Always MaxUint256."
+    },
+    signedTransaction: {
+      type: "string",
+      pattern: "^0x[a-fA-F0-9]+$",
+      description: "The RLP-encoded signed EIP-1559 transaction as a hex string."
+    },
+    version: {
+      type: "string",
+      pattern: "^[0-9]+(\\.[0-9]+)*$",
+      description: "Schema version identifier."
+    }
+  },
+  required: ["from", "asset", "spender", "amount", "signedTransaction", "version"]
+};
+function declareErc20ApprovalGasSponsoringExtension() {
+  const key = ERC20_APPROVAL_GAS_SPONSORING.key;
+  return {
+    [key]: {
+      info: {
+        description: "The facilitator broadcasts a pre-signed ERC-20 approve() transaction to grant Permit2 allowance.",
+        version: ERC20_APPROVAL_GAS_SPONSORING_VERSION
+      },
+      schema: erc20ApprovalGasSponsoringSchema
+    }
+  };
+}
+
+// src/erc20-approval-gas-sponsoring/facilitator.ts
+var import__3 = __toESM(require("ajv/dist/2020.js"));
+function extractErc20ApprovalGasSponsoringInfo(paymentPayload) {
+  if (!paymentPayload.extensions) {
+    return null;
+  }
+  const extension = paymentPayload.extensions[ERC20_APPROVAL_GAS_SPONSORING.key];
+  if (!extension?.info) {
+    return null;
+  }
+  const info = extension.info;
+  if (!info.from || !info.asset || !info.spender || !info.amount || !info.signedTransaction || !info.version) {
+    return null;
+  }
+  return info;
+}
+function validateErc20ApprovalGasSponsoringInfo(info) {
+  const ajv = new import__3.default({ strict: false, allErrors: true });
+  const validate = ajv.compile(erc20ApprovalGasSponsoringSchema);
+  return validate(info);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BAZAAR,
+  EIP2612_GAS_SPONSORING,
+  ERC20_APPROVAL_GAS_SPONSORING,
+  ERC20_APPROVAL_GAS_SPONSORING_VERSION,
   InMemorySIWxStorage,
   PAYMENT_IDENTIFIER,
   PAYMENT_ID_MAX_LENGTH,
@@ -1515,22 +1818,28 @@ var paymentIdentifierResourceServerExtension = {
   appendPaymentIdentifierToExtensions,
   bazaarResourceServerExtension,
   buildSIWxSchema,
+  createErc20ApprovalGasSponsoringExtension,
   createSIWxClientHook,
   createSIWxMessage,
   createSIWxPayload,
   createSIWxRequestHook,
   createSIWxSettleHook,
   declareDiscoveryExtension,
+  declareEip2612GasSponsoringExtension,
+  declareErc20ApprovalGasSponsoringExtension,
   declarePaymentIdentifierExtension,
   declareSIWxExtension,
   decodeBase58,
   encodeBase58,
   encodeSIWxHeader,
+  erc20ApprovalGasSponsoringSchema,
   extractAndValidatePaymentIdentifier,
   extractDiscoveryInfo,
   extractDiscoveryInfoFromExtension,
   extractDiscoveryInfoV1,
   extractEVMChainId,
+  extractEip2612GasSponsoringInfo,
+  extractErc20ApprovalGasSponsoringInfo,
   extractPaymentIdentifier,
   extractResourceMetadataV1,
   extractSolanaChainReference,
@@ -1540,10 +1849,13 @@ var paymentIdentifierResourceServerExtension = {
   getEVMAddress,
   getSolanaAddress,
   hasPaymentIdentifier,
+  isBodyExtensionConfig,
   isDiscoverableV1,
   isEVMSigner,
+  isMcpExtensionConfig,
   isPaymentIdentifierExtension,
   isPaymentIdentifierRequired,
+  isQueryExtensionConfig,
   isSolanaSigner,
   isValidPaymentId,
   parseSIWxHeader,
@@ -1554,6 +1866,8 @@ var paymentIdentifierResourceServerExtension = {
   siwxResourceServerExtension,
   validateAndExtract,
   validateDiscoveryExtension,
+  validateEip2612GasSponsoringInfo,
+  validateErc20ApprovalGasSponsoringInfo,
   validatePaymentIdentifier,
   validatePaymentIdentifierRequirement,
   validateSIWxMessage,