mppx 0.8.6 → 0.8.7

package/dist/validation/core.js

@@ -0,0 +1,256 @@
+import { validateChallenge, validateErrorHandling } from '../cli/validate/challenge.js';
+import { buildUrl, extractEndpointsFromDiscovery, extractRequestBodyFromDiscovery, fetchDiscoveryDoc, } from '../cli/validate/discovery.js';
+import { isValidIntegerAmount, parseEndpointArg, resolveBodyForEndpoint, } from '../cli/validate/helpers.js';
+import { validatePaymentFlow } from '../cli/validate/payment.js';
+import { validate as validateDiscoveryDoc } from '../discovery/Validate.js';
+export { buildUrl };
+/** Streams validation results as each phase completes. */
+export async function* validateStream(options) {
+    const baseUrl = options.url.replace(/\/$/, '').replace(/\/openapi\.json$/i, '');
+    const verbose = options.verbose ?? false;
+    const discovery = await runDiscovery(baseUrl, options);
+    yield { phase: 'discovery', discovery, results: discovery.checks };
+    for (const endpoint of discovery.endpoints) {
+        yield { phase: 'endpoint', endpoint };
+        let body;
+        if (options.endpoint) {
+            body = options.body;
+        }
+        else {
+            body = resolveBodyForEndpoint(options.body, endpoint.path);
+            if (!body && discovery.doc) {
+                body = extractRequestBodyFromDiscovery(discovery.doc, endpoint);
+            }
+        }
+        const { results: challengeResults, resolvedBody } = await validateChallenge(baseUrl, endpoint, verbose, {
+            body,
+            query: options.query,
+            discoveryDoc: discovery.doc ?? undefined,
+        });
+        const effectiveBody = resolvedBody ?? body;
+        const isMpp = challengeResults.some((r) => r.severity === 'pass' && r.label === 'Challenge parseable');
+        const isTestnet = challengeResults.some((r) => r.severity === 'pass' &&
+            r.label.endsWith('Valid currency address') &&
+            r.detail === 'testnet');
+        const isNonMppPayment = !isMpp && challengeResults.some((r) => r.label === 'Not an MPP endpoint');
+        const hasPaymentScheme = challengeResults.some((r) => r.severity === 'pass' && r.label === 'WWW-Authenticate header present');
+        const challengeFailed = challengeResults.some((r) => r.severity === 'fail' && r.label === 'Challenge parseable');
+        const isMalformedChallenge = !isMpp && hasPaymentScheme && challengeFailed;
+        yield {
+            phase: 'challenge',
+            endpoint,
+            results: challengeResults,
+            isMpp,
+            isTestnet,
+            isNonMppPayment,
+            isMalformedChallenge,
+        };
+        if (isMpp) {
+            const errorResults = await validateErrorHandling(baseUrl, endpoint, {
+                body: effectiveBody,
+                query: options.query,
+            });
+            yield { phase: 'errorHandling', endpoint, results: errorResults };
+            if (!options.skipPayment) {
+                const onResults = options.onPaymentResults;
+                const paymentResults = await validatePaymentFlow(baseUrl, endpoint, verbose, {
+                    body: effectiveBody,
+                    query: options.query,
+                    yes: options.yes,
+                    ...(onResults && { onResults }),
+                });
+                const succeeded = paymentResults.some((r) => r.severity === 'pass' && r.label === 'Payment: successful');
+                yield { phase: 'payment', endpoint, results: paymentResults, succeeded };
+            }
+        }
+    }
+}
+/** Runs the full validation suite and returns all results as a batch. */
+export async function validate(options) {
+    const baseUrl = options.url.replace(/\/$/, '').replace(/\/openapi\.json$/i, '');
+    let discovery;
+    const endpointResults = [];
+    let current;
+    let sawTestnet = false;
+    let sawMainnet = false;
+    let paymentSucceeded = false;
+    let sawMppEndpoint = false;
+    let sawNonMppPaymentEndpoint = false;
+    let sawMalformedChallenge = false;
+    for await (const event of validateStream(options)) {
+        switch (event.phase) {
+            case 'discovery':
+                discovery = event.discovery;
+                break;
+            case 'endpoint':
+                current = {
+                    method: event.endpoint.method,
+                    path: event.endpoint.path,
+                    challenge: [],
+                    errorHandling: [],
+                    payment: [],
+                };
+                endpointResults.push(current);
+                break;
+            case 'challenge':
+                if (current)
+                    current.challenge = event.results;
+                if (event.isMpp) {
+                    sawMppEndpoint = true;
+                    if (event.isTestnet)
+                        sawTestnet = true;
+                    else
+                        sawMainnet = true;
+                }
+                if (event.isNonMppPayment)
+                    sawNonMppPaymentEndpoint = true;
+                if (event.isMalformedChallenge)
+                    sawMalformedChallenge = true;
+                break;
+            case 'errorHandling':
+                if (current)
+                    current.errorHandling = event.results;
+                break;
+            case 'payment':
+                if (current)
+                    current.payment = event.results;
+                if (event.succeeded)
+                    paymentSucceeded = true;
+                break;
+        }
+    }
+    const summary = { passed: 0, failed: 0, warnings: 0, skipped: 0 };
+    if (discovery) {
+        for (const r of discovery.checks) {
+            if (r.severity === 'pass')
+                summary.passed++;
+            else if (r.severity === 'fail')
+                summary.failed++;
+            else if (r.severity === 'warn')
+                summary.warnings++;
+            else if (r.severity === 'skip')
+                summary.skipped++;
+        }
+    }
+    for (const ep of endpointResults) {
+        for (const r of [...ep.challenge, ...ep.errorHandling, ...ep.payment]) {
+            if (r.severity === 'pass')
+                summary.passed++;
+            else if (r.severity === 'fail')
+                summary.failed++;
+            else if (r.severity === 'warn')
+                summary.warnings++;
+            else if (r.severity === 'skip')
+                summary.skipped++;
+        }
+    }
+    if (!discovery)
+        throw new Error('Discovery phase did not complete');
+    return {
+        url: baseUrl,
+        discovery,
+        endpoints: endpointResults,
+        summary,
+        flags: {
+            sawMppEndpoint,
+            sawNonMppPaymentEndpoint,
+            sawMalformedChallenge,
+            sawTestnet,
+            sawMainnet,
+            paymentSucceeded,
+        },
+    };
+}
+async function runDiscovery(baseUrl, options) {
+    const checks = [];
+    let endpoints = [];
+    let discoveryDoc = null;
+    let found = false;
+    let valid = false;
+    // Try the user's path first, then root, then /api.
+    const origin = new URL(baseUrl).origin;
+    let candidates;
+    if (options.discoveryPath) {
+        candidates = [
+            new URL(options.discoveryPath, baseUrl + '/').href.replace(/\/openapi\.json$/i, ''),
+        ];
+    }
+    else {
+        candidates = [baseUrl, origin, `${origin}/api`];
+        candidates = [...new Set(candidates)];
+    }
+    let discoveryResult;
+    const attemptedErrors = [];
+    for (const candidate of candidates) {
+        discoveryResult = await fetchDiscoveryDoc(candidate);
+        if ('error' in discoveryResult) {
+            attemptedErrors.push(`${candidate}/openapi.json: ${discoveryResult.error}`);
+        }
+        else {
+            break;
+        }
+    }
+    if (!discoveryResult || 'error' in discoveryResult) {
+        checks.push({
+            label: 'Document found',
+            detail: attemptedErrors.join('; '),
+            hint: 'MPP servers must serve an OpenAPI document at /openapi.json with x-payment-info extensions.',
+            severity: 'fail',
+        });
+    }
+    else {
+        found = true;
+        checks.push({ label: 'Document found and parseable', severity: 'pass' });
+        const issues = validateDiscoveryDoc(discoveryResult.doc);
+        const errors = issues.filter((i) => i.severity === 'error');
+        const warnings = issues.filter((i) => i.severity === 'warning');
+        if (errors.length > 0) {
+            checks.push({
+                label: 'Valid OpenAPI structure',
+                detail: `${errors.length} error(s)`,
+                severity: 'fail',
+            });
+            for (const e of errors) {
+                checks.push({ label: e.message, detail: e.path, severity: 'fail' });
+            }
+        }
+        else {
+            valid = true;
+            checks.push({ label: 'Valid OpenAPI structure', severity: 'pass' });
+        }
+        for (const w of warnings) {
+            checks.push({ label: w.message, detail: w.path, severity: 'warn' });
+        }
+        discoveryDoc = discoveryResult.doc;
+    }
+    if (options.endpoint) {
+        const parsed = parseEndpointArg(options.endpoint);
+        if (parsed)
+            endpoints.push(parsed);
+    }
+    else if (discoveryDoc) {
+        endpoints = extractEndpointsFromDiscovery(discoveryDoc);
+        const NO_AMOUNT = BigInt('999999999999999999');
+        endpoints.sort((a, b) => {
+            const aAmt = isValidIntegerAmount(a.amount) ? BigInt(a.amount) : NO_AMOUNT;
+            const bAmt = isValidIntegerAmount(b.amount) ? BigInt(b.amount) : NO_AMOUNT;
+            return aAmt < bAmt ? -1 : aAmt > bAmt ? 1 : 0;
+        });
+        if (endpoints.length > 0) {
+            checks.push({
+                label: 'Paid endpoints found',
+                detail: `${endpoints.length} endpoint(s)`,
+                severity: 'pass',
+            });
+        }
+        else {
+            checks.push({
+                label: 'Paid endpoints found',
+                detail: 'No endpoints with x-payment-info',
+                severity: 'warn',
+            });
+        }
+    }
+    return { found, valid, endpoints, checks, doc: discoveryDoc };
+}
+//# sourceMappingURL=core.js.map

package/dist/validation/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/validation/core.ts"],"names":[],"mappings":"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"}

package/dist/validation/index.d.ts

@@ -0,0 +1,3 @@
+export { buildUrl, validate, validateStream } from './core.js';
+export type { CheckResult, DiscoveryResult, EndpointSpec, EndpointValidationResult, PathParameter, ValidateEvent, ValidateOptions, ValidateResult, } from './core.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC9D,YAAY,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,WAAW,CAAA"}

package/dist/validation/index.js

@@ -0,0 +1,2 @@
+export { buildUrl, validate, validateStream } from './core.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA"}

package/dist/x402/Assets.d.ts

@@ -43,6 +43,15 @@ export declare const base: {
 export declare const baseSepolia: {
     readonly USDC: KnownAsset;
 };
+/** Celo network known assets. */
+export declare const celo: {
+    readonly USDC: KnownAsset;
+    readonly USDT: KnownAsset;
+};
+/** Celo Sepolia known assets. */
+export declare const celoSepolia: {
+    readonly USDC: KnownAsset;
+};
 /** Returns true when a value is known x402 asset metadata. */
 export declare function isAsset(value: unknown): value is KnownAsset;
 /** Returns true when a value is a `viem/tokens` token definition. */

package/dist/x402/Assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Assets.d.ts","sourceRoot":"","sources":["../../src/x402/Assets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Assets.d.ts","sourceRoot":"","sources":["../../src/x402/Assets.ts"],"names":[],"mappings":"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"}

package/dist/x402/Assets.js

@@ -48,6 +48,44 @@ export const baseSepolia = {
         },
     }),
 };
+/** Celo network known assets. */
+export const celo = {
+    USDC: define({
+        address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',
+        decimals: 6,
+        network: 'eip155:42220',
+        transfer: {
+            // Celo USDC signs with the shorter EIP-712 domain name.
+            name: 'USDC',
+            type: 'eip3009',
+            version: '2',
+        },
+    }),
+    USDT: define({
+        address: '0x48065fbBE25f71C9282ddf5e1cD6D6A887483D5e',
+        decimals: 6,
+        network: 'eip155:42220',
+        transfer: {
+            // Celo USDT signs with domain version "1", unlike Circle's FiatToken "2".
+            name: 'Tether USD',
+            type: 'eip3009',
+            version: '1',
+        },
+    }),
+};
+/** Celo Sepolia known assets. */
+export const celoSepolia = {
+    USDC: define({
+        address: '0x01C5C0122039549AD1493B8220cABEdD739BC44E',
+        decimals: 6,
+        network: 'eip155:11142220',
+        transfer: {
+            name: 'USDC',
+            type: 'eip3009',
+            version: '2',
+        },
+    }),
+};
 /** Returns true when a value is known x402 asset metadata. */
 export function isAsset(value) {
     if (typeof value !== 'object' || value === null)

package/dist/x402/Assets.js.map

@@ -1 +1 @@
-{"version":3,"file":"Assets.js","sourceRoot":"","sources":["../../src/x402/Assets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Assets.js","sourceRoot":"","sources":["../../src/x402/Assets.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mppx",
   "type": "module",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "main": "./dist/index.js",
   "license": "MIT",
   "homepage": "https://github.com/wevm/mppx#readme",
@@ -133,6 +133,11 @@
       "src": "./src/middlewares/elysia.ts",
       "types": "./dist/middlewares/elysia.d.ts",
       "default": "./dist/middlewares/elysia.js"
+    },
+    "./validation": {
+      "src": "./src/validation/index.ts",
+      "types": "./dist/validation/index.d.ts",
+      "default": "./dist/validation/index.js"
     }
   },
   "peerDependencies": {
@@ -157,10 +162,10 @@
     }
   },
   "dependencies": {
-    "@stripe/stripe-js": "9.8.0",
+    "@stripe/stripe-js": "9.9.0",
     "eventsource-parser": "3.1.0",
-    "incur": "^0.4.9",
-    "ox": "0.14.29",
+    "incur": "^0.4.10",
+    "ox": "0.14.30",
     "zod": "^4.4.3"
   },
   "repository": {

package/src/cli/internal.ts

@@ -5,10 +5,10 @@ import type * as Challenge from '../Challenge.js'
 import * as AcceptPayment from '../internal/AcceptPayment.js'
 import type * as Method from '../Method.js'
 import type { Config } from './config.js'
-import { stripe as stripePlugin, tempo as tempoPlugin } from './plugins/index.js'
+import { evm as evmPlugin, stripe as stripePlugin, tempo as tempoPlugin } from './plugins/index.js'
 import type { Plugin } from './plugins/plugin.js'
 
-const builtinPlugins: Plugin[] = [tempoPlugin(), stripePlugin()]
+const builtinPlugins: Plugin[] = [tempoPlugin(), stripePlugin(), evmPlugin()]
 
 export function resolvePlugin(
   challenge: Challenge.Challenge,

package/src/cli/plugins/evm.ts

@@ -0,0 +1,55 @@
+import { type Address, type Chain, createClient, erc20Abi, http } from 'viem'
+import { readContract } from 'viem/actions'
+import * as viemChains from 'viem/chains'
+
+import { evm as evmMethods, assets as evmAssets } from '../../evm/client/index.js'
+import { resolveAccount } from '../account.js'
+import { createPlugin } from './plugin.js'
+
+export function evm() {
+  return createPlugin({
+    method: 'evm',
+
+    async setup({ challenge }) {
+      const request = challenge.request as Record<string, unknown>
+      const methodDetails = request.methodDetails as Record<string, unknown> | undefined
+      const chainId = methodDetails?.chainId as number | undefined
+      const chain = chainId ? resolveChain(chainId) : undefined
+      const currency = request.currency as string | undefined
+
+      const account = await resolveAccount()
+      // Known assets provide EIP-712 domain metadata (token name/version) needed for EIP-3009 signing
+      const knownCurrencies = [
+        ...Object.values(evmAssets.base),
+        ...Object.values(evmAssets.baseSepolia),
+        ...Object.values(evmAssets.celo),
+        ...Object.values(evmAssets.celoSepolia),
+      ]
+
+      let tokenSymbol = currency ?? ''
+      if (chain && currency) {
+        try {
+          const client = createClient({ chain, transport: http() })
+          const symbol = await readContract(client, {
+            address: currency as Address,
+            abi: erc20Abi,
+            functionName: 'symbol',
+          })
+          if (symbol) tokenSymbol = symbol
+        } catch {}
+      }
+
+      return {
+        tokenSymbol,
+        tokenDecimals: (methodDetails?.decimals as number | undefined) ?? 6,
+        explorerUrl: chain?.blockExplorers?.default?.url,
+        methods: [...evmMethods({ account, currencies: knownCurrencies })],
+      }
+    },
+  })
+}
+
+function resolveChain(chainId: number): Chain | undefined {
+  const all = Object.values(viemChains) as Chain[]
+  return all.find((c) => c.id === chainId)
+}

package/src/cli/plugins/index.ts

@@ -1,3 +1,4 @@
+export { evm } from './evm.js'
 export { createPlugin, type Plugin } from './plugin.js'
 export { stripe } from './stripe.js'
 export { tempo } from './tempo.js'