x402-express-mantle 1.0.0 → 1.0.3

package/README.md

@@ -14,55 +14,55 @@ Complete x402 Express middleware SDK with built-in Mantle testnet support and US
 ## Installation
 
 ```bash
-npm install x402-express-mantle
+npm install x402-express-mantle@1.0.2
 ```
 
 ## Quick Start
 
 ```javascript
-import express from 'express';
-import { paymentMiddlewareFromConfig } from 'x402-express-mantle';
-import { ExactEvmScheme } from 'x402-express-mantle';
-import { HTTPFacilitatorClient } from 'x402-express-mantle';
+import express from "express";
+import { paymentMiddlewareFromConfig } from "x402-express-mantle";
+import { ExactEvmScheme } from "x402-express-mantle";
+import { HTTPFacilitatorClient } from "x402-express-mantle";
 
 const app = express();
 
 // Connect to your Mantle facilitator
-const facilitatorClient = new HTTPFacilitatorClient({ 
-  url: 'https://your-mantle-facilitator.com' 
+const facilitatorClient = new HTTPFacilitatorClient({
+  url: "https://your-mantle-facilitator.com",
 });
 
 // Routes with automatic Mantle payment processing
 const routes = {
-  'GET /premium-data': {
-    accepts: [{
-      scheme: 'exact',
-      price: '$0.001',
-      network: 'eip155:5003', // Mantle testnet (pre-configured)
-      payTo: '0xYourMantleWalletAddress'
-    }],
-    description: 'Premium data access'
-  }
+  "GET /premium-data": {
+    accepts: [
+      {
+        scheme: "exact",
+        price: "$0.001",
+        network: "eip155:5003", // Mantle testnet (pre-configured)
+        payTo: "0xYourMantleWalletAddress",
+      },
+    ],
+    description: "Premium data access",
+  },
 };
 
 // Configure payment schemes (Mantle support built-in)
-const schemes = [{
-  network: 'eip155:5003', // Mantle testnet
-  server: new ExactEvmScheme()
-}];
+const schemes = [
+  {
+    network: "eip155:5003", // Mantle testnet
+    server: new ExactEvmScheme(),
+  },
+];
 
 // Add payment middleware
-app.use(paymentMiddlewareFromConfig(
-  routes,
-  facilitatorClient,
-  schemes
-));
+app.use(paymentMiddlewareFromConfig(routes, facilitatorClient, schemes));
 
 // Your protected route
-app.get('/premium-data', (req, res) => {
+app.get("/premium-data", (req, res) => {
   res.json({
-    data: 'Premium Mantle content!',
-    network: 'Mantle Testnet'
+    data: "Premium Mantle content!",
+    network: "Mantle Testnet",
   });
 });
 
@@ -90,6 +90,7 @@ Direct middleware function using a pre-configured server instance.
 Configuration-based middleware that creates the server internally.
 
 ### Core Classes
+
 - `x402ResourceServer` - Resource server for advanced configurations
 - `x402HTTPResourceServer` - HTTP resource server
 - `HTTPFacilitatorClient` - Client for connecting to facilitators
@@ -116,7 +117,7 @@ EVM_ADDRESS=0xYourMantleWalletAddress
 Check the `examples/` directory for complete working examples:
 
 ```bash
-cd node_modules/x402-express-mantle/examples
+cd examples/express
 npm install
 npm start
 ```
@@ -134,9 +135,29 @@ This SDK includes custom Mantle configurations:
 
 ### Vercel
 
+````bash
+npm install x402-express-mantle@1.0.2
+
+## Quick Example
+
 ```bash
-npm install x402-express-mantle
+# Try the example server
+cd examples/express
+npm install
+cp .env-local .env
+# Edit .env with your facilitator URL and EVM address
+npm run dev
+````
+
+The example server demonstrates:
+
+- Mantle testnet payment integration
+- Multiple pricing tiers ($0.001 and $0.005 USDC)
+- Free and paid endpoints
+- Complete payment flow
+
 # Deploy to Vercel with your environment variables
+
 ```
 
 ### Other Platforms
@@ -153,3 +174,4 @@ Works with any Node.js platform supporting Express.js.
 ## License
 
 Apache-2.0
+```

package/lib/cjs/index.d.ts

@@ -1,91 +1,111 @@
-import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient } from '@x402/core/server';
-export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
-import { Network, SchemeNetworkServer } from '@x402/core/types';
-export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@x402/core/types';
-import { Request, Response, NextFunction } from 'express';
+import {
+  HTTPAdapter,
+  RoutesConfig,
+  x402ResourceServer,
+  PaywallConfig,
+  PaywallProvider,
+  FacilitatorClient,
+} from "x402-core-mantle/server";
+export {
+  PaywallConfig,
+  PaywallProvider,
+  RouteConfigurationError,
+  RouteValidationError,
+  x402HTTPResourceServer,
+  x402ResourceServer,
+} from "x402-core-mantle/server";
+import { Network, SchemeNetworkServer } from "x402-core-mantle/types";
+export {
+  Network,
+  PaymentPayload,
+  PaymentRequired,
+  PaymentRequirements,
+  SchemeNetworkServer,
+} from "x402-core-mantle/types";
+import { Request, Response, NextFunction } from "express";
 
 /**
  * Express adapter implementation
  */
 declare class ExpressAdapter implements HTTPAdapter {
-    private req;
-    /**
-     * Creates a new ExpressAdapter instance.
-     *
-     * @param req - The Express request object
-     */
-    constructor(req: Request);
-    /**
-     * Gets a header value from the request.
-     *
-     * @param name - The header name
-     * @returns The header value or undefined
-     */
-    getHeader(name: string): string | undefined;
-    /**
-     * Gets the HTTP method of the request.
-     *
-     * @returns The HTTP method
-     */
-    getMethod(): string;
-    /**
-     * Gets the path of the request.
-     *
-     * @returns The request path
-     */
-    getPath(): string;
-    /**
-     * Gets the full URL of the request.
-     *
-     * @returns The full request URL
-     */
-    getUrl(): string;
-    /**
-     * Gets the Accept header from the request.
-     *
-     * @returns The Accept header value or empty string
-     */
-    getAcceptHeader(): string;
-    /**
-     * Gets the User-Agent header from the request.
-     *
-     * @returns The User-Agent header value or empty string
-     */
-    getUserAgent(): string;
-    /**
-     * Gets all query parameters from the request URL.
-     *
-     * @returns Record of query parameter key-value pairs
-     */
-    getQueryParams(): Record<string, string | string[]>;
-    /**
-     * Gets a specific query parameter by name.
-     *
-     * @param name - The query parameter name
-     * @returns The query parameter value(s) or undefined
-     */
-    getQueryParam(name: string): string | string[] | undefined;
-    /**
-     * Gets the parsed request body.
-     * Requires express.json() or express.urlencoded() middleware.
-     *
-     * @returns The parsed request body
-     */
-    getBody(): unknown;
+  private req;
+  /**
+   * Creates a new ExpressAdapter instance.
+   *
+   * @param req - The Express request object
+   */
+  constructor(req: Request);
+  /**
+   * Gets a header value from the request.
+   *
+   * @param name - The header name
+   * @returns The header value or undefined
+   */
+  getHeader(name: string): string | undefined;
+  /**
+   * Gets the HTTP method of the request.
+   *
+   * @returns The HTTP method
+   */
+  getMethod(): string;
+  /**
+   * Gets the path of the request.
+   *
+   * @returns The request path
+   */
+  getPath(): string;
+  /**
+   * Gets the full URL of the request.
+   *
+   * @returns The full request URL
+   */
+  getUrl(): string;
+  /**
+   * Gets the Accept header from the request.
+   *
+   * @returns The Accept header value or empty string
+   */
+  getAcceptHeader(): string;
+  /**
+   * Gets the User-Agent header from the request.
+   *
+   * @returns The User-Agent header value or empty string
+   */
+  getUserAgent(): string;
+  /**
+   * Gets all query parameters from the request URL.
+   *
+   * @returns Record of query parameter key-value pairs
+   */
+  getQueryParams(): Record<string, string | string[]>;
+  /**
+   * Gets a specific query parameter by name.
+   *
+   * @param name - The query parameter name
+   * @returns The query parameter value(s) or undefined
+   */
+  getQueryParam(name: string): string | string[] | undefined;
+  /**
+   * Gets the parsed request body.
+   * Requires express.json() or express.urlencoded() middleware.
+   *
+   * @returns The parsed request body
+   */
+  getBody(): unknown;
 }
 
 /**
  * Configuration for registering a payment scheme with a specific network
  */
 interface SchemeRegistration {
-    /**
-     * The network identifier (e.g., 'eip155:84532', 'solana:mainnet')
-     */
-    network: Network;
-    /**
-     * The scheme server implementation for this network
-     */
-    server: SchemeNetworkServer;
+  /**
+   * The network identifier (e.g., 'eip155:84532', 'solana:mainnet')
+   */
+  network: Network;
+  /**
+   * The scheme server implementation for this network
+   */
+  server: SchemeNetworkServer;
 }
 /**
  * Express payment middleware for x402 protocol (direct server instance).
@@ -104,7 +124,7 @@ interface SchemeRegistration {
  * @example
  * ```typescript
  * import { paymentMiddleware } from "@x402/express";
- * import { x402ResourceServer } from "@x402/core/server";
+ * import { x402ResourceServer } from "x402-core-mantle/server";
  * import { registerExactEvmScheme } from "@x402/evm/exact/server";
  *
  * const server = new x402ResourceServer(myFacilitatorClient);
@@ -113,7 +133,13 @@ interface SchemeRegistration {
  * app.use(paymentMiddleware(routes, server, paywallConfig));
  * ```
  */
-declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceServer, paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+declare function paymentMiddleware(
+  routes: RoutesConfig,
+  server: x402ResourceServer,
+  paywallConfig?: PaywallConfig,
+  paywall?: PaywallProvider,
+  syncFacilitatorOnStart?: boolean
+): (req: Request, res: Response, next: NextFunction) => Promise<void>;
 /**
  * Express payment middleware for x402 protocol (configuration-based).
  *
@@ -140,6 +166,18 @@ declare function paymentMiddleware(routes: RoutesConfig, server: x402ResourceSer
  * ));
  * ```
  */
-declare function paymentMiddlewareFromConfig(routes: RoutesConfig, facilitatorClients?: FacilitatorClient | FacilitatorClient[], schemes?: SchemeRegistration[], paywallConfig?: PaywallConfig, paywall?: PaywallProvider, syncFacilitatorOnStart?: boolean): (req: Request, res: Response, next: NextFunction) => Promise<void>;
+declare function paymentMiddlewareFromConfig(
+  routes: RoutesConfig,
+  facilitatorClients?: FacilitatorClient | FacilitatorClient[],
+  schemes?: SchemeRegistration[],
+  paywallConfig?: PaywallConfig,
+  paywall?: PaywallProvider,
+  syncFacilitatorOnStart?: boolean
+): (req: Request, res: Response, next: NextFunction) => Promise<void>;
 
-export { ExpressAdapter, type SchemeRegistration, paymentMiddleware, paymentMiddlewareFromConfig };
+export {
+  ExpressAdapter,
+  type SchemeRegistration,
+  paymentMiddleware,
+  paymentMiddlewareFromConfig,
+};

package/lib/cjs/index.js

@@ -38,7 +38,7 @@ __export(src_exports, {
   x402ResourceServer: () => import_server2.x402ResourceServer
 });
 module.exports = __toCommonJS(src_exports);
-var import_server = require("@x402/core/server");
+var import_server = require("x402-core-mantle/server");
 
 // src/adapter.ts
 var ExpressAdapter = class {
@@ -130,8 +130,8 @@ var ExpressAdapter = class {
 };
 
 // src/index.ts
-var import_server2 = require("@x402/core/server");
-var import_server3 = require("@x402/core/server");
+var import_server2 = require("x402-core-mantle/server");
+var import_server3 = require("x402-core-mantle/server");
 function checkIfBazaarNeeded(routes) {
   if ("accepts" in routes) {
     return !!(routes.extensions && "bazaar" in routes.extensions);

package/lib/esm/index.d.mts

@@ -1,7 +1,7 @@
-import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient } from '@x402/core/server';
-export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
-import { Network, SchemeNetworkServer } from '@x402/core/types';
-export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from '@x402/core/types';
+import { HTTPAdapter, RoutesConfig, x402ResourceServer, PaywallConfig, PaywallProvider, FacilitatorClient } from 'x402-core-mantle/server';
+export { PaywallConfig, PaywallProvider, RouteConfigurationError, RouteValidationError, x402HTTPResourceServer, x402ResourceServer } from 'x402-core-mantle/server';
+import { Network, SchemeNetworkServer } from 'x402-core-mantle/types';
+export { Network, PaymentPayload, PaymentRequired, PaymentRequirements, SchemeNetworkServer } from 'x402-core-mantle/types';
 import { Request, Response, NextFunction } from 'express';
 
 /**
@@ -104,7 +104,7 @@ interface SchemeRegistration {
  * @example
  * ```typescript
  * import { paymentMiddleware } from "@x402/express";
- * import { x402ResourceServer } from "@x402/core/server";
+ * import { x402ResourceServer } from "x402-core-mantle/server";
  * import { registerExactEvmScheme } from "@x402/evm/exact/server";
  *
  * const server = new x402ResourceServer(myFacilitatorClient);

package/lib/esm/index.mjs

@@ -2,7 +2,7 @@
 import {
   x402HTTPResourceServer,
   x402ResourceServer
-} from "@x402/core/server";
+} from "x402-core-mantle/server";
 
 // src/adapter.ts
 var ExpressAdapter = class {
@@ -94,8 +94,8 @@ var ExpressAdapter = class {
 };
 
 // src/index.ts
-import { x402ResourceServer as x402ResourceServer2, x402HTTPResourceServer as x402HTTPResourceServer2 } from "@x402/core/server";
-import { RouteConfigurationError } from "@x402/core/server";
+import { x402ResourceServer as x402ResourceServer2, x402HTTPResourceServer as x402HTTPResourceServer2 } from "x402-core-mantle/server";
+import { RouteConfigurationError } from "x402-core-mantle/server";
 function checkIfBazaarNeeded(routes) {
   if ("accepts" in routes) {
     return !!(routes.extensions && "bazaar" in routes.extensions);

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "x402-express-mantle",
-  "version": "1.0.0",
-  "main": "./src/index.js",
+  "version": "1.0.3",
+  "main": "./lib/cjs/index.js",
+  "module": "./lib/esm/index.mjs",
+  "types": "./lib/cjs/index.d.ts",
   "type": "module",
   "scripts": {
     "test": "echo 'No tests specified'",
@@ -20,6 +22,9 @@
   "author": "Mantle x402 Team",
   "description": "x402 Express middleware SDK with built-in Mantle testnet support and USDC Token configurations",
   "dependencies": {
+    "x402-core-mantle": "2.1.1-mantle",
+    "x402-evm-mantle": "2.1.1-mantle",
+    "x402-svm-mantle": "2.1.1-mantle",
     "@solana/kit": "^2.1.1",
     "viem": "^2.39.3",
     "zod": "^3.24.2"
@@ -28,12 +33,19 @@
     "express": "^4.0.0 || ^5.0.0"
   },
   "exports": {
-    ".": "./src/index.js"
+    ".": {
+      "import": {
+        "types": "./lib/esm/index.d.mts",
+        "default": "./lib/esm/index.mjs"
+      },
+      "require": {
+        "types": "./lib/cjs/index.d.ts",
+        "default": "./lib/cjs/index.js"
+      }
+    }
   },
   "files": [
-    "src",
     "lib",
-    "examples",
     "README.md"
   ]
 }