@armory-sh/middleware-hono 0.3.29 → 0.3.31

package/README.md

@@ -14,24 +14,47 @@ bun add @armory-sh/middleware-hono
 
 Armory enables HTTP API payments via EIP-3009 `transferWithAuthorization`. Accept payments from any x402-compatible client—Coinbase SDK, Armory SDK, or your own implementation.
 
-## Key Exports
+## API Reference
+
+### Middleware
 
 ```typescript
 import {
-  // Middleware
   paymentMiddleware,
   routeAwarePaymentMiddleware,
 
-  // Requirements
-  createPaymentRequirements,
-
   // Types
   type PaymentConfig,
   type RouteAwarePaymentConfig,
-  type HonoPaymentContext,
+  type AugmentedContext,
 } from '@armory-sh/middleware-hono';
 ```
 
+### Payment Requirements
+
+```typescript
+import {
+  createPaymentRequirements,
+
+  // Types
+  type ResolvedRequirementsConfig,
+} from '@armory-sh/middleware-hono';
+```
+
+### Extensions
+
+```typescript
+import {
+  buildExtensions,
+  extractExtension,
+
+  // Types
+  type ExtensionConfig,
+} from '@armory-sh/middleware-hono';
+```
+
+---
+
 ## Quick Start
 
 ### Basic Middleware
@@ -168,6 +191,7 @@ interface RouteAwarePaymentConfig extends PaymentConfig {
 | Base Sepolia | 84532 |
 | SKALE Base | 1187947933 |
 | SKALE Base Sepolia | 324705682 |
+| Ethereum Sepolia | 11155111 |
 
 ## License
 

package/dist/index.d.ts

@@ -23,6 +23,7 @@ interface PaymentConfig {
     facilitatorUrl?: string;
     facilitatorUrlByChain?: Record<string, string>;
     facilitatorUrlByToken?: Record<string, Record<string, string>>;
+    extensions?: Record<string, unknown>;
 }
 interface ResolvedRequirementsConfig {
     requirements: PaymentRequirementsV2[];

package/dist/index.js

@@ -1,5 +1,5 @@
 export { buildExtensions, extractExtension } from './chunk-XYM6YXAQ.js';
-import { matchRoute, V2_HEADERS, safeBase64Encode, decodePayloadHeader, findRequirementByAccepted, verifyPayment, createPaymentRequiredHeaders, settlePayment, createSettlementHeaders, resolveNetwork, isValidationError, resolveToken, createPaymentRequirements as createPaymentRequirements$1, PAYMENT_SIGNATURE_HEADER, PAYMENT_REQUIRED_HEADER, validateRouteConfig, TOKENS, registerToken } from '@armory-sh/base';
+import { matchRoute, V2_HEADERS, safeBase64Encode, decodePayloadHeader, findRequirementByAccepted, verifyPayment, createPaymentRequiredHeaders, settlePayment, createSettlementHeaders, resolveNetwork, isValidationError, resolveToken, enrichPaymentRequirements, createPaymentRequirements as createPaymentRequirements$1, PAYMENT_SIGNATURE_HEADER, PAYMENT_REQUIRED_HEADER, validateRouteConfig, TOKENS, registerToken, getSupported } from '@armory-sh/base';
 
 var resolveRouteConfig = (config) => {
   const validationError = validateRouteConfig(config);
@@ -155,6 +155,8 @@ var routeAwarePaymentMiddleware = (config) => {
 };
 
 // src/index.ts
+var extensionCapabilityCache = /* @__PURE__ */ new Map();
+var EXTENSION_CAPABILITY_TTL_MS = 5 * 60 * 1e3;
 function ensureTokensRegistered() {
   for (const token of Object.values(TOKENS)) {
     try {
@@ -171,17 +173,13 @@ function resolveFacilitatorUrlFromRequirement(config, requirement) {
       config.facilitatorUrlByToken
     )) {
       const resolvedChain = resolveNetwork(chainKey);
-      if (!isValidationError(resolvedChain) && resolvedChain.config.chainId === chainId) {
-        for (const [, url] of Object.entries(tokenMap)) {
-          const network = resolveNetwork(chainKey);
-          if (!isValidationError(network)) {
-            for (const tokenKey of Object.keys(tokenMap)) {
-              const resolvedToken = resolveToken(tokenKey, network);
-              if (!isValidationError(resolvedToken) && resolvedToken.config.contractAddress.toLowerCase() === assetAddress) {
-                return url;
-              }
-            }
-          }
+      if (isValidationError(resolvedChain) || resolvedChain.config.chainId !== chainId) {
+        continue;
+      }
+      for (const [tokenKey, url] of Object.entries(tokenMap)) {
+        const resolvedToken = resolveToken(tokenKey, resolvedChain);
+        if (!isValidationError(resolvedToken) && resolvedToken.config.contractAddress.toLowerCase() === assetAddress) {
+          return url;
         }
       }
     }
@@ -200,8 +198,9 @@ function resolveFacilitatorUrlFromRequirement(config, requirement) {
 }
 function createPaymentRequirements(config) {
   if (config.requirements) {
+    const requirements = Array.isArray(config.requirements) ? config.requirements : [config.requirements];
     return {
-      requirements: Array.isArray(config.requirements) ? config.requirements : [config.requirements]
+      requirements: enrichPaymentRequirements(requirements)
     };
   }
   if (!config.payTo) {
@@ -216,8 +215,56 @@ function createPaymentRequirements(config) {
   ensureTokensRegistered();
   return createPaymentRequirements$1(config);
 }
+async function resolvePaymentRequiredExtensions(config, requirements) {
+  if (!config.extensions) {
+    return {};
+  }
+  let filtered = { ...config.extensions };
+  for (const requirement of requirements) {
+    const facilitatorUrl = resolveFacilitatorUrlFromRequirement(config, requirement);
+    if (!facilitatorUrl) {
+      continue;
+    }
+    const cacheKey = `${facilitatorUrl}|${requirement.network.toLowerCase()}`;
+    const now = Date.now();
+    let keys = extensionCapabilityCache.get(cacheKey);
+    if (!keys || keys.expiresAt <= now) {
+      try {
+        const supported = await getSupported({ url: facilitatorUrl });
+        const nextKeys = /* @__PURE__ */ new Set();
+        for (const kind of supported.kinds) {
+          if (kind.network.toLowerCase() !== requirement.network.toLowerCase()) {
+            continue;
+          }
+          if (kind.extra && typeof kind.extra === "object") {
+            for (const key of Object.keys(kind.extra)) {
+              nextKeys.add(key);
+            }
+          }
+        }
+        keys = { expiresAt: now + EXTENSION_CAPABILITY_TTL_MS, keys: nextKeys };
+      } catch {
+        keys = { expiresAt: now + EXTENSION_CAPABILITY_TTL_MS, keys: /* @__PURE__ */ new Set() };
+      }
+      extensionCapabilityCache.set(cacheKey, keys);
+    }
+    filtered = Object.fromEntries(
+      Object.entries(filtered).filter(([key]) => keys.keys.has(key))
+    );
+    if (Object.keys(filtered).length === 0) {
+      return {};
+    }
+  }
+  return filtered;
+}
 function paymentMiddleware(config) {
   const { requirements, error } = createPaymentRequirements(config);
+  const resolvePaymentRequiredHeader = async () => createPaymentRequiredHeaders(requirements, {
+    extensions: await resolvePaymentRequiredExtensions(
+      config,
+      requirements
+    )
+  })[PAYMENT_REQUIRED_HEADER];
   return async (c, next) => {
     if (error) {
       c.status(500);
@@ -250,7 +297,7 @@ function paymentMiddleware(config) {
       c.status(402);
       c.header(
         PAYMENT_REQUIRED_HEADER,
-        safeBase64Encode(JSON.stringify(paymentRequired))
+        await resolvePaymentRequiredHeader() ?? safeBase64Encode(JSON.stringify(paymentRequired))
       );
       return c.json({
         error: "Payment required",
@@ -297,7 +344,7 @@ function paymentMiddleware(config) {
       c.status(402);
       c.header(
         PAYMENT_REQUIRED_HEADER,
-        createPaymentRequiredHeaders(requirements)[PAYMENT_REQUIRED_HEADER]
+        await resolvePaymentRequiredHeader()
       );
       return c.json({
         error: "Payment verification failed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armory-sh/middleware-hono",
-  "version": "0.3.29",
+  "version": "0.3.31",
   "license": "MIT",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",
   "keywords": [
@@ -52,8 +52,8 @@
     "hono": "^4"
   },
   "dependencies": {
-    "@armory-sh/base": "0.2.29",
-    "@armory-sh/extensions": "0.1.10"
+    "@armory-sh/base": "0.2.31",
+    "@armory-sh/extensions": "0.1.12"
   },
   "devDependencies": {
     "bun-types": "latest",