@puga-labs/x402-mantle-sdk 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/dist/chunk-33WHNZDS.js +74 -0
  2. package/dist/chunk-B4GST723.js +101 -0
  3. package/dist/chunk-CKBTOS7X.js +86 -0
  4. package/dist/chunk-IEJB5W26.js +113 -0
  5. package/dist/chunk-IXIFGPJ2.js +250 -0
  6. package/dist/chunk-OW2BDRGZ.js +239 -0
  7. package/dist/chunk-T4DIHTBP.js +83 -0
  8. package/dist/chunk-T63MVWX3.js +71 -0
  9. package/dist/express-D8L5Dg1D.d.ts +68 -0
  10. package/dist/express-DqyVgO5n.d.cts +68 -0
  11. package/dist/express-DxxlKmmF.d.ts +68 -0
  12. package/dist/express-Pukmnwuu.d.cts +68 -0
  13. package/dist/index.cjs +39 -12
  14. package/dist/index.d.cts +3 -3
  15. package/dist/index.d.ts +3 -3
  16. package/dist/index.js +2 -2
  17. package/dist/nextjs-CSUWjcxv.d.cts +89 -0
  18. package/dist/nextjs-DGcN_MGa.d.ts +89 -0
  19. package/dist/nextjs-DUdgN0d_.d.ts +89 -0
  20. package/dist/nextjs-EoISXVEo.d.cts +89 -0
  21. package/dist/server-express.cjs +39 -12
  22. package/dist/server-express.d.cts +2 -2
  23. package/dist/server-express.d.ts +2 -2
  24. package/dist/server-express.js +2 -2
  25. package/dist/server-nextjs.cjs +38 -12
  26. package/dist/server-nextjs.d.cts +2 -2
  27. package/dist/server-nextjs.d.ts +2 -2
  28. package/dist/server-nextjs.js +2 -2
  29. package/dist/server-web.cjs +38 -12
  30. package/dist/server-web.d.cts +2 -2
  31. package/dist/server-web.d.ts +2 -2
  32. package/dist/server-web.js +2 -2
  33. package/dist/server.cjs +69 -16
  34. package/dist/server.d.cts +6 -6
  35. package/dist/server.d.ts +6 -6
  36. package/dist/server.js +4 -4
  37. package/dist/types-B87bD2yo.d.cts +102 -0
  38. package/dist/types-BWfKovFm.d.cts +103 -0
  39. package/dist/types-BmK0G74m.d.cts +93 -0
  40. package/dist/types-CXdNC0Ra.d.ts +93 -0
  41. package/dist/types-DgfVPQFb.d.ts +103 -0
  42. package/dist/types-DvKDSdL6.d.ts +106 -0
  43. package/dist/types-X6DeBEgb.d.cts +106 -0
  44. package/dist/types-vicT7qsY.d.ts +102 -0
  45. package/dist/web-standards-BJcdcxD6.d.ts +77 -0
  46. package/dist/web-standards-BvMLEKlU.d.cts +77 -0
  47. package/dist/web-standards-C6JwCDmd.d.cts +77 -0
  48. package/dist/web-standards-g2rYUpgc.d.ts +77 -0
  49. package/package.json +1 -1
@@ -0,0 +1,239 @@
1
+ import {
2
+ getDefaultAssetForNetwork
3
+ } from "./chunk-HEZZ74SI.js";
4
+
5
+ // src/server/core/utils.ts
6
+ function validateAddress(address, paramName = "address") {
7
+ if (!address) {
8
+ throw new Error(`${paramName} is required`);
9
+ }
10
+ if (typeof address !== "string") {
11
+ throw new Error(`${paramName} must be a string, got ${typeof address}`);
12
+ }
13
+ if (!address.startsWith("0x")) {
14
+ const preview = address.length > 10 ? `${address.substring(0, 10)}...` : address;
15
+ throw new Error(
16
+ `${paramName} must start with "0x", got: ${preview}`
17
+ );
18
+ }
19
+ if (address.length !== 42) {
20
+ throw new Error(
21
+ `${paramName} must be 42 characters (0x + 40 hex), got ${address.length} characters`
22
+ );
23
+ }
24
+ const hexPart = address.slice(2);
25
+ if (!/^[0-9a-fA-F]{40}$/.test(hexPart)) {
26
+ throw new Error(
27
+ `${paramName} must contain only hexadecimal characters (0-9, a-f, A-F) after "0x"`
28
+ );
29
+ }
30
+ }
31
+ function decodePaymentHeader(paymentHeaderBase64) {
32
+ try {
33
+ if (typeof Buffer !== "undefined") {
34
+ const json = Buffer.from(paymentHeaderBase64, "base64").toString("utf8");
35
+ return JSON.parse(json);
36
+ }
37
+ if (typeof atob === "function") {
38
+ const json = atob(paymentHeaderBase64);
39
+ return JSON.parse(json);
40
+ }
41
+ throw new Error("No base64 decoding available in this environment");
42
+ } catch (err) {
43
+ const msg = err instanceof Error ? err.message : "Unknown error";
44
+ throw new Error(`Failed to decode paymentHeader: ${msg}`);
45
+ }
46
+ }
47
+ function buildRouteKey(method, path) {
48
+ const normalizedMethod = (method || "GET").toUpperCase();
49
+ const normalizedPath = path || "/";
50
+ return `${normalizedMethod} ${normalizedPath}`;
51
+ }
52
+
53
+ // src/server/constants.ts
54
+ var DEFAULT_TELEMETRY_ENDPOINT = "https://x402mantlesdk.xyz/api/telemetry/settled";
55
+
56
+ // src/server/telemetry.ts
57
+ function createTelemetryEvent(entry, config) {
58
+ const assetConfig = getDefaultAssetForNetwork(entry.network);
59
+ return {
60
+ event: "payment_verified",
61
+ ts: entry.timestamp,
62
+ projectKey: config.projectKey,
63
+ network: entry.network,
64
+ buyer: entry.from,
65
+ payTo: entry.to,
66
+ amountAtomic: entry.valueAtomic,
67
+ asset: entry.asset,
68
+ decimals: assetConfig.decimals,
69
+ nonce: entry.id,
70
+ route: entry.route ?? "unknown",
71
+ // Facilitator metadata
72
+ facilitatorType: "hosted",
73
+ // SDK always uses hosted mode
74
+ facilitatorUrl: entry.facilitatorUrl,
75
+ // From PaymentLogEntry
76
+ // facilitatorAddress is undefined for SDK (not available)
77
+ // Optional metadata
78
+ txHash: entry.txHash,
79
+ priceUsd: entry.paymentRequirements?.price
80
+ };
81
+ }
82
+ async function sendTelemetry(event, endpoint) {
83
+ const targetEndpoint = endpoint ?? DEFAULT_TELEMETRY_ENDPOINT;
84
+ if (!targetEndpoint) {
85
+ return;
86
+ }
87
+ try {
88
+ const response = await fetch(targetEndpoint, {
89
+ method: "POST",
90
+ headers: {
91
+ "Content-Type": "application/json",
92
+ "Authorization": `Bearer ${event.projectKey}`
93
+ },
94
+ body: JSON.stringify(event)
95
+ });
96
+ if (!response.ok) {
97
+ console.warn(
98
+ `[x402-telemetry] Failed to send event: HTTP ${response.status}`
99
+ );
100
+ }
101
+ } catch (err) {
102
+ console.error("[x402-telemetry] Error sending telemetry:", err);
103
+ }
104
+ }
105
+
106
+ // src/server/core/verifyPayment.ts
107
+ async function checkPayment(input) {
108
+ const {
109
+ paymentHeader,
110
+ paymentRequirements,
111
+ facilitatorUrl,
112
+ apiKey,
113
+ routeKey,
114
+ network,
115
+ asset,
116
+ telemetry,
117
+ onPaymentSettled
118
+ } = input;
119
+ if (!paymentHeader || paymentHeader.trim() === "") {
120
+ return {
121
+ status: "require_payment",
122
+ statusCode: 402,
123
+ responseBody: {
124
+ error: "Payment Required",
125
+ paymentRequirements,
126
+ paymentHeader: null
127
+ },
128
+ isValid: false
129
+ };
130
+ }
131
+ try {
132
+ const verifyUrl = `${facilitatorUrl.replace(/\/+$/, "")}/verify`;
133
+ const verifyRes = await fetch(verifyUrl, {
134
+ method: "POST",
135
+ headers: {
136
+ "Content-Type": "application/json",
137
+ ...apiKey && { "Authorization": `Bearer ${apiKey}` }
138
+ },
139
+ body: JSON.stringify({
140
+ x402Version: 1,
141
+ paymentHeader,
142
+ paymentRequirements
143
+ })
144
+ });
145
+ if (!verifyRes.ok) {
146
+ const text = await verifyRes.text().catch(() => "");
147
+ console.error(
148
+ "[x402-mantle-sdk] Facilitator /verify returned non-OK:",
149
+ verifyRes.status,
150
+ text
151
+ );
152
+ return {
153
+ status: "verification_error",
154
+ statusCode: 500,
155
+ responseBody: {
156
+ error: "Payment verification error",
157
+ details: `Facilitator responded with HTTP ${verifyRes.status}`
158
+ },
159
+ isValid: false
160
+ };
161
+ }
162
+ const verifyJson = await verifyRes.json();
163
+ if (!verifyJson.isValid) {
164
+ return {
165
+ status: "invalid_payment",
166
+ statusCode: 402,
167
+ responseBody: {
168
+ error: "Payment verification failed",
169
+ invalidReason: verifyJson.invalidReason ?? null,
170
+ paymentRequirements,
171
+ paymentHeader: null
172
+ },
173
+ isValid: false
174
+ };
175
+ }
176
+ if (onPaymentSettled) {
177
+ try {
178
+ const headerObj = decodePaymentHeader(paymentHeader);
179
+ const { authorization } = headerObj.payload;
180
+ const assetConfig = getDefaultAssetForNetwork(network);
181
+ const logEntry = {
182
+ id: authorization.nonce,
183
+ from: authorization.from,
184
+ to: authorization.to,
185
+ valueAtomic: authorization.value,
186
+ network,
187
+ asset,
188
+ route: routeKey,
189
+ timestamp: Date.now(),
190
+ facilitatorUrl,
191
+ paymentRequirements
192
+ };
193
+ onPaymentSettled(logEntry);
194
+ if (telemetry) {
195
+ const event = createTelemetryEvent(logEntry, telemetry);
196
+ sendTelemetry(event, telemetry.endpoint).catch(
197
+ (err) => console.error("[x402-telemetry] Async send failed:", err)
198
+ );
199
+ }
200
+ } catch (err) {
201
+ console.error(
202
+ "[x402-mantle-sdk] Error calling onPaymentSettled hook:",
203
+ err
204
+ );
205
+ }
206
+ }
207
+ return {
208
+ status: "verified",
209
+ statusCode: 200,
210
+ responseBody: null,
211
+ isValid: true
212
+ };
213
+ } catch (err) {
214
+ console.error(
215
+ "[x402-mantle-sdk] Error while calling facilitator /verify:",
216
+ err
217
+ );
218
+ const message = err instanceof Error ? err.message : "Unknown verification error";
219
+ return {
220
+ status: "verification_error",
221
+ statusCode: 500,
222
+ responseBody: {
223
+ error: "Payment verification error",
224
+ details: message
225
+ },
226
+ isValid: false
227
+ };
228
+ }
229
+ }
230
+
231
+ export {
232
+ validateAddress,
233
+ decodePaymentHeader,
234
+ buildRouteKey,
235
+ DEFAULT_TELEMETRY_ENDPOINT,
236
+ createTelemetryEvent,
237
+ sendTelemetry,
238
+ checkPayment
239
+ };
@@ -0,0 +1,83 @@
1
+ import {
2
+ buildRouteKey,
3
+ checkPayment,
4
+ validateAddress
5
+ } from "./chunk-IXIFGPJ2.js";
6
+ import {
7
+ MANTLE_DEFAULTS,
8
+ __export,
9
+ getDefaultAssetForNetwork,
10
+ usdCentsToAtomic
11
+ } from "./chunk-HEZZ74SI.js";
12
+
13
+ // src/server/adapters/web-standards.ts
14
+ var web_standards_exports = {};
15
+ __export(web_standards_exports, {
16
+ mantlePaywall: () => mantlePaywall
17
+ });
18
+ function mantlePaywall(opts) {
19
+ const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
20
+ validateAddress(payTo, "payTo");
21
+ const priceUsdCents = Math.round(priceUsd * 100);
22
+ return function(handler) {
23
+ return async (request) => {
24
+ const url = new URL(request.url);
25
+ const method = request.method;
26
+ const path = url.pathname;
27
+ const routeKey = buildRouteKey(method, path);
28
+ const network = MANTLE_DEFAULTS.NETWORK;
29
+ const assetConfig = getDefaultAssetForNetwork(network);
30
+ const maxAmountRequiredBigInt = usdCentsToAtomic(
31
+ priceUsdCents,
32
+ assetConfig.decimals
33
+ );
34
+ const paymentRequirements = {
35
+ scheme: "exact",
36
+ network,
37
+ asset: assetConfig.address,
38
+ maxAmountRequired: maxAmountRequiredBigInt.toString(),
39
+ payTo,
40
+ price: `$${(priceUsdCents / 100).toFixed(2)}`,
41
+ currency: "USD"
42
+ };
43
+ const paymentHeader = request.headers.get("X-PAYMENT") || request.headers.get("x-payment") || null;
44
+ const result = await checkPayment({
45
+ paymentHeader,
46
+ paymentRequirements,
47
+ facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
48
+ apiKey,
49
+ routeKey,
50
+ network,
51
+ asset: assetConfig.address,
52
+ telemetry,
53
+ onPaymentSettled
54
+ });
55
+ if (!result.isValid) {
56
+ return new Response(JSON.stringify(result.responseBody), {
57
+ status: result.statusCode,
58
+ headers: {
59
+ "Content-Type": "application/json"
60
+ }
61
+ });
62
+ }
63
+ try {
64
+ const response = await handler(request);
65
+ if (result.sendTelemetryAfterResponse) {
66
+ result.sendTelemetryAfterResponse(response.status);
67
+ }
68
+ return response;
69
+ } catch (err) {
70
+ const errorMessage = err instanceof Error ? err.message : "Unknown error";
71
+ if (result.sendTelemetryAfterResponse) {
72
+ result.sendTelemetryAfterResponse(500, errorMessage);
73
+ }
74
+ throw err;
75
+ }
76
+ };
77
+ };
78
+ }
79
+
80
+ export {
81
+ mantlePaywall,
82
+ web_standards_exports
83
+ };
@@ -0,0 +1,71 @@
1
+ import {
2
+ buildRouteKey,
3
+ checkPayment,
4
+ validateAddress
5
+ } from "./chunk-OW2BDRGZ.js";
6
+ import {
7
+ MANTLE_DEFAULTS,
8
+ __export,
9
+ getDefaultAssetForNetwork,
10
+ usdCentsToAtomic
11
+ } from "./chunk-HEZZ74SI.js";
12
+
13
+ // src/server/adapters/web-standards.ts
14
+ var web_standards_exports = {};
15
+ __export(web_standards_exports, {
16
+ mantlePaywall: () => mantlePaywall
17
+ });
18
+ function mantlePaywall(opts) {
19
+ const { priceUsd, payTo, facilitatorUrl, apiKey, telemetry, onPaymentSettled } = opts;
20
+ validateAddress(payTo, "payTo");
21
+ const priceUsdCents = Math.round(priceUsd * 100);
22
+ return function(handler) {
23
+ return async (request) => {
24
+ const url = new URL(request.url);
25
+ const method = request.method;
26
+ const path = url.pathname;
27
+ const routeKey = buildRouteKey(method, path);
28
+ const network = MANTLE_DEFAULTS.NETWORK;
29
+ const assetConfig = getDefaultAssetForNetwork(network);
30
+ const maxAmountRequiredBigInt = usdCentsToAtomic(
31
+ priceUsdCents,
32
+ assetConfig.decimals
33
+ );
34
+ const paymentRequirements = {
35
+ scheme: "exact",
36
+ network,
37
+ asset: assetConfig.address,
38
+ maxAmountRequired: maxAmountRequiredBigInt.toString(),
39
+ payTo,
40
+ price: `$${(priceUsdCents / 100).toFixed(2)}`,
41
+ currency: "USD"
42
+ };
43
+ const paymentHeader = request.headers.get("X-PAYMENT") || request.headers.get("x-payment") || null;
44
+ const result = await checkPayment({
45
+ paymentHeader,
46
+ paymentRequirements,
47
+ facilitatorUrl: facilitatorUrl || MANTLE_DEFAULTS.FACILITATOR_URL,
48
+ apiKey,
49
+ routeKey,
50
+ network,
51
+ asset: assetConfig.address,
52
+ telemetry,
53
+ onPaymentSettled
54
+ });
55
+ if (!result.isValid) {
56
+ return new Response(JSON.stringify(result.responseBody), {
57
+ status: result.statusCode,
58
+ headers: {
59
+ "Content-Type": "application/json"
60
+ }
61
+ });
62
+ }
63
+ return handler(request);
64
+ };
65
+ };
66
+ }
67
+
68
+ export {
69
+ mantlePaywall,
70
+ web_standards_exports
71
+ };
@@ -0,0 +1,68 @@
1
+ import { Request, Response, NextFunction } from 'express';
2
+ import { b as RoutesConfig, M as MinimalPaywallOptions } from './types-CXdNC0Ra.js';
3
+
4
+ /**
5
+ * Express middleware function type for Mantle paywall.
6
+ */
7
+ type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
8
+ /** Config for createPaymentMiddleware. */
9
+ interface PaymentMiddlewareConfig {
10
+ /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
11
+ facilitatorUrl: string;
12
+ /** Recipient address (developer). Validated at runtime. */
13
+ receiverAddress: string;
14
+ /** Map of protected routes and their pricing. */
15
+ routes: RoutesConfig;
16
+ /** Optional API key for hosted facilitator billing. */
17
+ apiKey?: string;
18
+ /**
19
+ * Optional hook called whenever a payment is successfully settled.
20
+ */
21
+ onPaymentSettled?: MinimalPaywallOptions["onPaymentSettled"];
22
+ /** Optional: Send usage telemetry for billing/analytics. */
23
+ telemetry?: MinimalPaywallOptions["telemetry"];
24
+ }
25
+ /**
26
+ * Create Express middleware for x402 payment verification on multiple routes.
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * const middleware = createPaymentMiddleware({
31
+ * facilitatorUrl: 'https://facilitator.nosubs.ai',
32
+ * receiverAddress: '0x...',
33
+ * routes: {
34
+ * 'POST /api/generate': { priceUsdCents: 1, network: 'mantle-mainnet' },
35
+ * 'GET /api/data': { priceUsdCents: 5, network: 'mantle-mainnet' },
36
+ * }
37
+ * });
38
+ *
39
+ * app.use(middleware);
40
+ * ```
41
+ */
42
+ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): MantleMiddleware;
43
+ /**
44
+ * Simplified wrapper for protecting a single route with x402 payments.
45
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
46
+ *
47
+ * @example
48
+ * ```typescript
49
+ * const pay = mantlePaywall({ priceUsd: 0.01, payTo: "0x..." });
50
+ * app.post('/api/generate', pay, async (req, res) => {
51
+ * // Your handler code here
52
+ * });
53
+ * ```
54
+ *
55
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
56
+ * @returns Express middleware function for single-route protection.
57
+ */
58
+ declare function mantlePaywall(opts: MinimalPaywallOptions): MantleMiddleware;
59
+
60
+ type express_MantleMiddleware = MantleMiddleware;
61
+ type express_PaymentMiddlewareConfig = PaymentMiddlewareConfig;
62
+ declare const express_createPaymentMiddleware: typeof createPaymentMiddleware;
63
+ declare const express_mantlePaywall: typeof mantlePaywall;
64
+ declare namespace express {
65
+ export { type express_MantleMiddleware as MantleMiddleware, type express_PaymentMiddlewareConfig as PaymentMiddlewareConfig, express_createPaymentMiddleware as createPaymentMiddleware, express_mantlePaywall as mantlePaywall };
66
+ }
67
+
68
+ export { type MantleMiddleware as M, type PaymentMiddlewareConfig as P, createPaymentMiddleware as c, express as e, mantlePaywall as m };
@@ -0,0 +1,68 @@
1
+ import { Request, Response, NextFunction } from 'express';
2
+ import { b as RoutesConfig, M as MinimalPaywallOptions } from './types-B87bD2yo.cjs';
3
+
4
+ /**
5
+ * Express middleware function type for Mantle paywall.
6
+ */
7
+ type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
8
+ /** Config for createPaymentMiddleware. */
9
+ interface PaymentMiddlewareConfig {
10
+ /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
11
+ facilitatorUrl: string;
12
+ /** Recipient address (developer). Validated at runtime. */
13
+ receiverAddress: string;
14
+ /** Map of protected routes and their pricing. */
15
+ routes: RoutesConfig;
16
+ /** Optional API key for hosted facilitator billing. */
17
+ apiKey?: string;
18
+ /**
19
+ * Optional hook called whenever a payment is successfully settled.
20
+ */
21
+ onPaymentSettled?: MinimalPaywallOptions["onPaymentSettled"];
22
+ /** Optional: Send usage telemetry for billing/analytics. */
23
+ telemetry?: MinimalPaywallOptions["telemetry"];
24
+ }
25
+ /**
26
+ * Create Express middleware for x402 payment verification on multiple routes.
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * const middleware = createPaymentMiddleware({
31
+ * facilitatorUrl: 'https://facilitator.nosubs.ai',
32
+ * receiverAddress: '0x...',
33
+ * routes: {
34
+ * 'POST /api/generate': { priceUsdCents: 1, network: 'mantle-mainnet' },
35
+ * 'GET /api/data': { priceUsdCents: 5, network: 'mantle-mainnet' },
36
+ * }
37
+ * });
38
+ *
39
+ * app.use(middleware);
40
+ * ```
41
+ */
42
+ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): MantleMiddleware;
43
+ /**
44
+ * Simplified wrapper for protecting a single route with x402 payments.
45
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
46
+ *
47
+ * @example
48
+ * ```typescript
49
+ * const pay = mantlePaywall({ priceUsd: 0.01, payTo: "0x..." });
50
+ * app.post('/api/generate', pay, async (req, res) => {
51
+ * // Your handler code here
52
+ * });
53
+ * ```
54
+ *
55
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
56
+ * @returns Express middleware function for single-route protection.
57
+ */
58
+ declare function mantlePaywall(opts: MinimalPaywallOptions): MantleMiddleware;
59
+
60
+ type express_MantleMiddleware = MantleMiddleware;
61
+ type express_PaymentMiddlewareConfig = PaymentMiddlewareConfig;
62
+ declare const express_createPaymentMiddleware: typeof createPaymentMiddleware;
63
+ declare const express_mantlePaywall: typeof mantlePaywall;
64
+ declare namespace express {
65
+ export { type express_MantleMiddleware as MantleMiddleware, type express_PaymentMiddlewareConfig as PaymentMiddlewareConfig, express_createPaymentMiddleware as createPaymentMiddleware, express_mantlePaywall as mantlePaywall };
66
+ }
67
+
68
+ export { type MantleMiddleware as M, type PaymentMiddlewareConfig as P, createPaymentMiddleware as c, express as e, mantlePaywall as m };
@@ -0,0 +1,68 @@
1
+ import { Request, Response, NextFunction } from 'express';
2
+ import { b as RoutesConfig, M as MinimalPaywallOptions } from './types-vicT7qsY.js';
3
+
4
+ /**
5
+ * Express middleware function type for Mantle paywall.
6
+ */
7
+ type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
8
+ /** Config for createPaymentMiddleware. */
9
+ interface PaymentMiddlewareConfig {
10
+ /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
11
+ facilitatorUrl: string;
12
+ /** Recipient address (developer). Validated at runtime. */
13
+ receiverAddress: string;
14
+ /** Map of protected routes and their pricing. */
15
+ routes: RoutesConfig;
16
+ /** Optional API key for hosted facilitator billing. */
17
+ apiKey?: string;
18
+ /**
19
+ * Optional hook called whenever a payment is successfully settled.
20
+ */
21
+ onPaymentSettled?: MinimalPaywallOptions["onPaymentSettled"];
22
+ /** Optional: Send usage telemetry for billing/analytics. */
23
+ telemetry?: MinimalPaywallOptions["telemetry"];
24
+ }
25
+ /**
26
+ * Create Express middleware for x402 payment verification on multiple routes.
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * const middleware = createPaymentMiddleware({
31
+ * facilitatorUrl: 'https://facilitator.nosubs.ai',
32
+ * receiverAddress: '0x...',
33
+ * routes: {
34
+ * 'POST /api/generate': { priceUsdCents: 1, network: 'mantle-mainnet' },
35
+ * 'GET /api/data': { priceUsdCents: 5, network: 'mantle-mainnet' },
36
+ * }
37
+ * });
38
+ *
39
+ * app.use(middleware);
40
+ * ```
41
+ */
42
+ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): MantleMiddleware;
43
+ /**
44
+ * Simplified wrapper for protecting a single route with x402 payments.
45
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
46
+ *
47
+ * @example
48
+ * ```typescript
49
+ * const pay = mantlePaywall({ priceUsd: 0.01, payTo: "0x..." });
50
+ * app.post('/api/generate', pay, async (req, res) => {
51
+ * // Your handler code here
52
+ * });
53
+ * ```
54
+ *
55
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
56
+ * @returns Express middleware function for single-route protection.
57
+ */
58
+ declare function mantlePaywall(opts: MinimalPaywallOptions): MantleMiddleware;
59
+
60
+ type express_MantleMiddleware = MantleMiddleware;
61
+ type express_PaymentMiddlewareConfig = PaymentMiddlewareConfig;
62
+ declare const express_createPaymentMiddleware: typeof createPaymentMiddleware;
63
+ declare const express_mantlePaywall: typeof mantlePaywall;
64
+ declare namespace express {
65
+ export { type express_MantleMiddleware as MantleMiddleware, type express_PaymentMiddlewareConfig as PaymentMiddlewareConfig, express_createPaymentMiddleware as createPaymentMiddleware, express_mantlePaywall as mantlePaywall };
66
+ }
67
+
68
+ export { type MantleMiddleware as M, type PaymentMiddlewareConfig as P, createPaymentMiddleware as c, express as e, mantlePaywall as m };
@@ -0,0 +1,68 @@
1
+ import { Request, Response, NextFunction } from 'express';
2
+ import { b as RoutesConfig, M as MinimalPaywallOptions } from './types-BmK0G74m.cjs';
3
+
4
+ /**
5
+ * Express middleware function type for Mantle paywall.
6
+ */
7
+ type MantleMiddleware = (req: Request, res: Response, next: NextFunction) => Promise<void>;
8
+ /** Config for createPaymentMiddleware. */
9
+ interface PaymentMiddlewareConfig {
10
+ /** Base URL of facilitator, e.g. https://facilitator.nosubs.ai */
11
+ facilitatorUrl: string;
12
+ /** Recipient address (developer). Validated at runtime. */
13
+ receiverAddress: string;
14
+ /** Map of protected routes and their pricing. */
15
+ routes: RoutesConfig;
16
+ /** Optional API key for hosted facilitator billing. */
17
+ apiKey?: string;
18
+ /**
19
+ * Optional hook called whenever a payment is successfully settled.
20
+ */
21
+ onPaymentSettled?: MinimalPaywallOptions["onPaymentSettled"];
22
+ /** Optional: Send usage telemetry for billing/analytics. */
23
+ telemetry?: MinimalPaywallOptions["telemetry"];
24
+ }
25
+ /**
26
+ * Create Express middleware for x402 payment verification on multiple routes.
27
+ *
28
+ * @example
29
+ * ```typescript
30
+ * const middleware = createPaymentMiddleware({
31
+ * facilitatorUrl: 'https://facilitator.nosubs.ai',
32
+ * receiverAddress: '0x...',
33
+ * routes: {
34
+ * 'POST /api/generate': { priceUsdCents: 1, network: 'mantle-mainnet' },
35
+ * 'GET /api/data': { priceUsdCents: 5, network: 'mantle-mainnet' },
36
+ * }
37
+ * });
38
+ *
39
+ * app.use(middleware);
40
+ * ```
41
+ */
42
+ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): MantleMiddleware;
43
+ /**
44
+ * Simplified wrapper for protecting a single route with x402 payments.
45
+ * Uses Mantle mainnet defaults (USDC, exact scheme, etc.).
46
+ *
47
+ * @example
48
+ * ```typescript
49
+ * const pay = mantlePaywall({ priceUsd: 0.01, payTo: "0x..." });
50
+ * app.post('/api/generate', pay, async (req, res) => {
51
+ * // Your handler code here
52
+ * });
53
+ * ```
54
+ *
55
+ * @param opts - Minimal configuration (price, payTo, optional facilitator/telemetry).
56
+ * @returns Express middleware function for single-route protection.
57
+ */
58
+ declare function mantlePaywall(opts: MinimalPaywallOptions): MantleMiddleware;
59
+
60
+ type express_MantleMiddleware = MantleMiddleware;
61
+ type express_PaymentMiddlewareConfig = PaymentMiddlewareConfig;
62
+ declare const express_createPaymentMiddleware: typeof createPaymentMiddleware;
63
+ declare const express_mantlePaywall: typeof mantlePaywall;
64
+ declare namespace express {
65
+ export { type express_MantleMiddleware as MantleMiddleware, type express_PaymentMiddlewareConfig as PaymentMiddlewareConfig, express_createPaymentMiddleware as createPaymentMiddleware, express_mantlePaywall as mantlePaywall };
66
+ }
67
+
68
+ export { type MantleMiddleware as M, type PaymentMiddlewareConfig as P, createPaymentMiddleware as c, express as e, mantlePaywall as m };