@oobe-protocol-labs/sap-mcp-server 0.1.0

package/dist/payments/monetization-gate.js

@@ -0,0 +1,398 @@
+/**
+ * @name McpMonetizationGate
+ * @description x402/pay.sh payment gate for hosted SAP MCP Streamable HTTP requests.
+ */
+import { HTTPFacilitatorClient, x402HTTPResourceServer, x402ResourceServer } from '@x402/core/server';
+import { registerExactSvmScheme } from '@x402/svm/exact/server';
+import { logger } from '../core/logger.js';
+import { NativeHttpAdapter, parseJsonBody, readRequestBody, replayRequest } from './http-adapter.js';
+import { parseJsonRpcBody } from './json-rpc.js';
+import { formatUsdPrice, resolvePaymentDecision } from './pricing.js';
+import { hashRequestBody, UsageLedger } from './usage-ledger.js';
+const SOLANA_MAINNET_CAIP2 = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
+const SOLANA_DEVNET_CAIP2 = 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1';
+const SOLANA_TESTNET_CAIP2 = 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z';
+const PAID_ROUTE_PATTERN = 'POST /mcp/paid/*';
+/**
+ * @name McpMonetizationGate
+ * @description Applies x402 payment verification and settlement before forwarding requests to the MCP transport.
+ */
+export class McpMonetizationGate {
+    appConfig;
+    monetization;
+    httpResourceServer;
+    usageLedger;
+    constructor(appConfig, httpResourceServer, usageLedger = new UsageLedger()) {
+        this.appConfig = appConfig;
+        this.monetization = appConfig.monetization;
+        this.httpResourceServer = httpResourceServer;
+        this.usageLedger = usageLedger;
+    }
+    /**
+     * @name create
+     * @description Builds and initializes an x402 HTTP resource server for SAP MCP requests.
+     */
+    static async create(appConfig) {
+        if (!appConfig.monetization.enabled) {
+            return undefined;
+        }
+        validateMonetizationConfig(appConfig.monetization);
+        const facilitatorUrl = appConfig.monetization.facilitatorUrl;
+        if (!facilitatorUrl) {
+            throw new Error('SAP MCP monetization requires SAP_MCP_X402_FACILITATOR_URL');
+        }
+        const authToken = appConfig.monetization.facilitatorAuthToken;
+        const facilitator = new HTTPFacilitatorClient({
+            url: facilitatorUrl,
+            createAuthHeaders: authToken
+                ? async () => ({
+                    verify: { Authorization: `Bearer ${authToken}` },
+                    settle: { Authorization: `Bearer ${authToken}` },
+                    supported: { Authorization: `Bearer ${authToken}` },
+                })
+                : undefined,
+        });
+        const resourceServer = new x402ResourceServer(facilitator);
+        registerExactSvmScheme(resourceServer, {
+            networks: [resolvePaymentNetwork(appConfig)],
+        });
+        const httpResourceServer = new x402HTTPResourceServer(resourceServer, buildRoutesConfig(appConfig));
+        await httpResourceServer.initialize();
+        logger.info('SAP MCP monetization gate initialized', {
+            provider: appConfig.monetization.provider,
+            network: resolvePaymentNetwork(appConfig),
+            facilitatorUrl: appConfig.monetization.facilitatorUrl,
+            payShCheckoutUrl: appConfig.monetization.payShCheckoutUrl,
+        });
+        return new McpMonetizationGate(appConfig, httpResourceServer);
+    }
+    /**
+     * @name handle
+     * @description Authorizes a request via x402 when required, then forwards it to MCP and settles on success.
+     */
+    async handle(request, response, next) {
+        if (!shouldInspectRequest(request)) {
+            await next(request, response);
+            return;
+        }
+        let rawBody;
+        let parsedBody;
+        try {
+            rawBody = await readRequestBody(request);
+            parsedBody = parseJsonBody(rawBody);
+        }
+        catch (error) {
+            logger.warn('Failed to parse monetized MCP request', { error });
+            writeJson(response, 400, { error: 'Invalid JSON-RPC request body' });
+            return;
+        }
+        const parsedMcp = parseJsonRpcBody(parsedBody);
+        const decision = resolvePaymentDecision(parsedMcp, this.monetization);
+        const replayedRequest = replayRequest(request, rawBody);
+        if (!decision.required) {
+            await next(replayedRequest, response);
+            return;
+        }
+        const requestHash = hashRequestBody(rawBody);
+        const virtualPath = buildPaidVirtualPath(decision, requestHash);
+        const metadata = buildRequestMetadata(request, requestHash, virtualPath);
+        await this.usageLedger.recordDecision(metadata, decision);
+        const context = this.buildRequestContext(request, parsedBody, virtualPath);
+        const paymentResult = await this.httpResourceServer.processHTTPRequest(context, {
+            appName: 'SAP MCP Server',
+            currentUrl: context.adapter.getUrl(),
+            testnet: resolvePaymentNetwork(this.appConfig) !== SOLANA_MAINNET_CAIP2,
+        });
+        if (paymentResult.type === 'payment-error') {
+            writePaymentInstructions(response, paymentResult.response);
+            return;
+        }
+        if (paymentResult.type === 'no-payment-required') {
+            await next(replayedRequest, response);
+            return;
+        }
+        await this.usageLedger.recordVerified(metadata, decision);
+        await this.forwardAndSettle({
+            request: replayedRequest,
+            response,
+            next,
+            context,
+            metadata,
+            decision,
+            paymentResult,
+        });
+    }
+    buildRequestContext(request, parsedBody, virtualPath) {
+        const adapter = new NativeHttpAdapter({
+            request,
+            path: virtualPath,
+            body: parsedBody,
+        });
+        return {
+            adapter,
+            path: virtualPath,
+            method: request.method ?? 'POST',
+            paymentHeader: adapter.getHeader('payment-signature') ?? adapter.getHeader('x-payment'),
+        };
+    }
+    async forwardAndSettle(options) {
+        const buffered = bufferResponse(options.response);
+        try {
+            await options.next(options.request, options.response);
+            await buffered.waitForEnd();
+        }
+        catch (error) {
+            await options.paymentResult.cancellationDispatcher.cancel({
+                reason: 'handler_threw',
+                error,
+            });
+            await this.usageLedger.recordCanceled(options.metadata, options.decision, 'handler_threw', error instanceof Error ? error.message : String(error));
+            buffered.restore();
+            throw error;
+        }
+        if (options.response.statusCode >= 400) {
+            await options.paymentResult.cancellationDispatcher.cancel({
+                reason: 'handler_failed',
+                responseStatus: options.response.statusCode,
+            });
+            await this.usageLedger.recordCanceled(options.metadata, options.decision, 'handler_failed', `MCP handler returned HTTP ${options.response.statusCode}`);
+            buffered.restoreAndReplay();
+            return;
+        }
+        await this.settleAndReplay({
+            response: options.response,
+            buffered,
+            context: options.context,
+            metadata: options.metadata,
+            decision: options.decision,
+            paymentPayload: options.paymentResult.paymentPayload,
+            paymentRequirements: options.paymentResult.paymentRequirements,
+            declaredExtensions: options.paymentResult.declaredExtensions,
+        });
+    }
+    async settleAndReplay(options) {
+        const responseBody = options.buffered.getBody();
+        const responseHeaders = getResponseHeaders(options.response);
+        const settlement = await this.httpResourceServer.processSettlement(options.paymentPayload, options.paymentRequirements, options.declaredExtensions, {
+            request: options.context,
+            responseBody,
+            responseHeaders,
+        });
+        await this.usageLedger.recordSettlement(options.metadata, options.decision, settlement);
+        if (!settlement.success) {
+            options.buffered.restore();
+            writePaymentInstructions(options.response, settlement.response);
+            return;
+        }
+        for (const [name, value] of Object.entries(settlement.headers)) {
+            options.response.setHeader(name, value);
+        }
+        options.buffered.restoreAndReplay();
+    }
+}
+/**
+ * @name resolvePaymentNetwork
+ * @description Resolves the x402 CAIP-2 Solana network from explicit config or the SAP RPC URL.
+ */
+export function resolvePaymentNetwork(config) {
+    if (config.monetization.network) {
+        return config.monetization.network;
+    }
+    if (config.rpcUrl.includes('devnet')) {
+        return SOLANA_DEVNET_CAIP2;
+    }
+    if (config.rpcUrl.includes('testnet')) {
+        return SOLANA_TESTNET_CAIP2;
+    }
+    return SOLANA_MAINNET_CAIP2;
+}
+function validateMonetizationConfig(config) {
+    if (!config.payTo) {
+        throw new Error('SAP MCP monetization requires SAP_MCP_MONETIZATION_PAY_TO');
+    }
+    if (!config.facilitatorUrl) {
+        throw new Error('SAP MCP monetization requires SAP_MCP_X402_FACILITATOR_URL. Use the OOBE facilitator URL or run sap-mcp-facilitator locally.');
+    }
+}
+function buildRoutesConfig(config) {
+    return {
+        [PAID_ROUTE_PATTERN]: {
+            accepts: {
+                scheme: 'exact',
+                network: resolvePaymentNetwork(config),
+                payTo: config.monetization.payTo ?? '',
+                price: context => resolveDynamicPrice(context, config.monetization),
+                maxTimeoutSeconds: config.monetization.maxTimeoutSeconds,
+            },
+            description: 'Paid SAP MCP remote tool execution',
+            mimeType: 'application/json',
+            serviceName: 'SAP MCP Server',
+            tags: ['sap', 'mcp', 'solana', 'x402'],
+            unpaidResponseBody: context => buildUnpaidResponseBody(context, config),
+        },
+    };
+}
+function resolveDynamicPrice(context, config) {
+    const parsed = parseJsonRpcBody(context.adapter.getBody?.());
+    const decision = resolvePaymentDecision(parsed, config);
+    return decision.required ? decision.price : formatUsdPrice(config.prices.minUsd);
+}
+function buildUnpaidResponseBody(context, config) {
+    const parsed = parseJsonRpcBody(context.adapter.getBody?.());
+    const decision = resolvePaymentDecision(parsed, config.monetization);
+    return {
+        contentType: 'application/json',
+        body: {
+            error: 'payment_required',
+            protocol: 'x402',
+            provider: config.monetization.provider,
+            payShCheckoutUrl: buildPayShCheckoutUrl(config, decision),
+            decision,
+            instructions: {
+                header: 'PAYMENT-SIGNATURE',
+                settlementHeader: 'PAYMENT-RESPONSE',
+                network: resolvePaymentNetwork(config),
+                payTo: config.monetization.payTo,
+            },
+        },
+    };
+}
+function buildPayShCheckoutUrl(config, decision) {
+    if (!config.monetization.payShCheckoutUrl || !decision.required) {
+        return undefined;
+    }
+    const url = new URL(config.monetization.payShCheckoutUrl);
+    url.searchParams.set('amount', decision.price);
+    url.searchParams.set('network', resolvePaymentNetwork(config));
+    url.searchParams.set('recipient', config.monetization.payTo ?? '');
+    url.searchParams.set('reference', decision.toolNames.join(','));
+    return url.toString();
+}
+function shouldInspectRequest(request) {
+    return request.method === 'POST' && Boolean(request.url?.startsWith('/mcp'));
+}
+/**
+ * @name buildPaidVirtualPath
+ * @description Builds the paid x402 virtual resource path, bound to the exact JSON-RPC request hash.
+ */
+export function buildPaidVirtualPath(decision, requestHash) {
+    const toolSegment = decision.toolNames.map(name => encodeURIComponent(name)).join(',');
+    return `/mcp/paid/${decision.tier}/${requestHash}/${toolSegment}`;
+}
+function buildRequestMetadata(request, requestHash, virtualPath) {
+    const paymentHeader = request.headers['payment-signature'] ?? request.headers['x-payment'];
+    return {
+        requestHash,
+        method: request.method ?? 'POST',
+        path: virtualPath,
+        paymentHeaderPresent: typeof paymentHeader === 'string' || Array.isArray(paymentHeader),
+        remoteAddress: request.socket.remoteAddress,
+        userAgent: Array.isArray(request.headers['user-agent'])
+            ? request.headers['user-agent'][0]
+            : request.headers['user-agent'],
+    };
+}
+function writePaymentInstructions(response, instructions) {
+    response.writeHead(instructions.status, {
+        'Content-Type': instructions.isHtml ? 'text/html' : 'application/json',
+        ...instructions.headers,
+    });
+    response.end(instructions.isHtml
+        ? String(instructions.body ?? '')
+        : JSON.stringify(instructions.body ?? {}));
+}
+function writeJson(response, status, body) {
+    response.writeHead(status, { 'Content-Type': 'application/json' });
+    response.end(JSON.stringify(body));
+}
+function getResponseHeaders(response) {
+    const headers = {};
+    for (const [name, value] of Object.entries(response.getHeaders())) {
+        if (Array.isArray(value)) {
+            headers[name] = value.join(',');
+        }
+        else if (value !== undefined) {
+            headers[name] = String(value);
+        }
+    }
+    return headers;
+}
+function bufferResponse(response) {
+    const originalWriteHead = response.writeHead.bind(response);
+    const originalWrite = response.write.bind(response);
+    const originalEnd = response.end.bind(response);
+    const originalFlushHeaders = response.flushHeaders.bind(response);
+    const calls = [];
+    let resolveEnd = () => undefined;
+    const endPromise = new Promise(resolve => {
+        resolveEnd = resolve;
+    });
+    response.writeHead = ((...args) => {
+        calls.push({ kind: 'writeHead', args });
+        return response;
+    });
+    response.write = ((...args) => {
+        calls.push({ kind: 'write', args });
+        return true;
+    });
+    response.end = ((...args) => {
+        calls.push({ kind: 'end', args });
+        resolveEnd();
+        return response;
+    });
+    response.flushHeaders = (() => {
+        calls.push({ kind: 'flushHeaders' });
+    });
+    return {
+        getBody: () => Buffer.concat(calls.flatMap(callToBodyChunk)),
+        waitForEnd: () => endPromise,
+        restore: () => {
+            response.writeHead = originalWriteHead;
+            response.write = originalWrite;
+            response.end = originalEnd;
+            response.flushHeaders = originalFlushHeaders;
+        },
+        restoreAndReplay: () => {
+            response.writeHead = originalWriteHead;
+            response.write = originalWrite;
+            response.end = originalEnd;
+            response.flushHeaders = originalFlushHeaders;
+            for (const call of calls) {
+                replayBufferedCall(call, originalWriteHead, originalWrite, originalEnd, originalFlushHeaders);
+            }
+        },
+    };
+}
+function callToBodyChunk(call) {
+    if (call.kind !== 'write' && call.kind !== 'end') {
+        return [];
+    }
+    const chunk = call.args[0];
+    if (typeof chunk === 'string') {
+        return [Buffer.from(chunk)];
+    }
+    if (chunk instanceof Uint8Array) {
+        return [Buffer.from(chunk)];
+    }
+    return [];
+}
+function replayBufferedCall(call, writeHead, write, end, flushHeaders) {
+    const invoke = (fn, args) => {
+        Reflect.apply(fn, undefined, args);
+    };
+    switch (call.kind) {
+        case 'writeHead':
+            invoke(writeHead, call.args);
+            return;
+        case 'write':
+            invoke(write, call.args);
+            return;
+        case 'end':
+            invoke(end, call.args);
+            return;
+        case 'flushHeaders':
+            flushHeaders();
+            return;
+    }
+}
+//# sourceMappingURL=monetization-gate.js.map

package/dist/payments/monetization-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monetization-gate.js","sourceRoot":"","sources":["../../src/payments/monetization-gate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQtG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,WAAW,EAA+B,MAAM,mBAAmB,CAAC;AA+B9F,MAAM,oBAAoB,GAAG,yCAAyC,CAAC;AACvE,MAAM,mBAAmB,GAAG,yCAAyC,CAAC;AACtE,MAAM,oBAAoB,GAAG,yCAAyC,CAAC;AACvE,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAE9C;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACb,SAAS,CAAe;IACxB,YAAY,CAA2B;IACvC,kBAAkB,CAAyB;IAC3C,WAAW,CAAc;IAE1C,YACE,SAAuB,EACvB,kBAA0C,EAC1C,WAAW,GAAG,IAAI,WAAW,EAAE;QAE/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;QAC3C,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;QAC7C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAuB;QAChD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,0BAA0B,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAEnD,MAAM,cAAc,GAAG,SAAS,CAAC,YAAY,CAAC,cAAc,CAAC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,CAAC,oBAAoB,CAAC;QAC9D,MAAM,WAAW,GAAG,IAAI,qBAAqB,CAAC;YAC5C,GAAG,EAAE,cAAc;YACnB,iBAAiB,EAAE,SAAS;gBAC1B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;oBACX,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE;oBAChD,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE;oBAChD,SAAS,EAAE,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE;iBACpD,CAAC;gBACJ,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC3D,sBAAsB,CAAC,cAAc,EAAE;YACrC,QAAQ,EAAE,CAAC,qBAAqB,CAAC,SAAS,CAAY,CAAC;SACxD,CAAC,CAAC;QAEH,MAAM,kBAAkB,GAAG,IAAI,sBAAsB,CACnD,cAAc,EACd,iBAAiB,CAAC,SAAS,CAAC,CAC7B,CAAC;QACF,MAAM,kBAAkB,CAAC,UAAU,EAAE,CAAC;QAEtC,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE;YACnD,QAAQ,EAAE,SAAS,CAAC,YAAY,CAAC,QAAQ;YACzC,OAAO,EAAE,qBAAqB,CAAC,SAAS,CAAC;YACzC,cAAc,EAAE,SAAS,CAAC,YAAY,CAAC,cAAc;YACrD,gBAAgB,EAAE,SAAS,CAAC,YAAY,CAAC,gBAAgB;SAC1D,CAAC,CAAC;QAEH,OAAO,IAAI,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,MAAM,CACjB,OAA6B,EAC7B,QAA6B,EAC7B,IAAuB;QAEvB,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,IAAI,OAAe,CAAC;QACpB,IAAI,UAAmB,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YACzC,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACtE,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACzE,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAE1D,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QAC3E,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,OAAO,EAAE;YAC9E,OAAO,EAAE,gBAAgB;YACzB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE;YACpC,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,oBAAoB;SACxE,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAC3C,wBAAwB,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,aAAa,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACjD,MAAM,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,gBAAgB,CAAC;YAC1B,OAAO,EAAE,eAAe;YACxB,QAAQ;YACR,IAAI;YACJ,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,aAAa;SACd,CAAC,CAAC;IACL,CAAC;IAEO,mBAAmB,CACzB,OAA6B,EAC7B,UAAmB,EACnB,WAAmB;QAEnB,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC;YACpC,OAAO;YACP,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO;YACP,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;YAChC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC;SACxF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAQ9B;QACC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtD,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,MAAM,CAAC;gBACxD,MAAM,EAAE,eAAe;gBACvB,KAAK;aACN,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CACnC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,QAAQ,EAChB,eAAe,EACf,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YACF,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,KAAK,CAAC;QACd,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,EAAE,CAAC;YACvC,MAAM,OAAO,CAAC,aAAa,CAAC,sBAAsB,CAAC,MAAM,CAAC;gBACxD,MAAM,EAAE,gBAAgB;gBACxB,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,UAAU;aAC5C,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CACnC,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,QAAQ,EAChB,gBAAgB,EAChB,6BAA6B,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAC3D,CAAC;YACF,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,eAAe,CAAC;YACzB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ;YACR,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,cAAc,EAAE,OAAO,CAAC,aAAa,CAAC,cAAc;YACpD,mBAAmB,EAAE,OAAO,CAAC,aAAa,CAAC,mBAAmB;YAC9D,kBAAkB,EAAE,OAAO,CAAC,aAAa,CAAC,kBAAkB;SAC7D,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,OAS7B;QACC,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAChD,MAAM,eAAe,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAChE,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,mBAAmB,EAC3B,OAAO,CAAC,kBAAkB,EAC1B;YACE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY;YACZ,eAAe;SAChB,CACF,CAAC;QAEF,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAExF,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IACtC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,IAAI,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC;IACrC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,SAAS,0BAA0B,CAAC,MAAgC;IAClE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,8HAA8H,CAAC,CAAC;IAClJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAoB;IAC7C,OAAO;QACL,CAAC,kBAAkB,CAAC,EAAE;YACpB,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAY;gBACjD,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE;gBACtC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,YAAY,CAAC;gBACnE,iBAAiB,EAAE,MAAM,CAAC,YAAY,CAAC,iBAAiB;aACzD;YACD,WAAW,EAAE,oCAAoC;YACjD,QAAQ,EAAE,kBAAkB;YAC5B,WAAW,EAAE,gBAAgB;YAC7B,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;YACtC,kBAAkB,EAAE,OAAO,CAAC,EAAE,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,CAAC;SACxE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAA2B,EAAE,MAAgC;IACxF,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAA2B,EAC3B,MAAoB;IAEpB,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAErE,OAAO;QACL,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,KAAK,EAAE,kBAAkB;YACzB,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,MAAM,CAAC,YAAY,CAAC,QAAQ;YACtC,gBAAgB,EAAE,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;YACzD,QAAQ;YACR,YAAY,EAAE;gBACZ,MAAM,EAAE,mBAAmB;gBAC3B,gBAAgB,EAAE,kBAAkB;gBACpC,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC;gBACtC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK;aACjC;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAoB,EAAE,QAAyB;IAC5E,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAC1D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACnE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA6B;IACzD,OAAO,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsD,EAAE,WAAmB;IAC9G,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvF,OAAO,aAAa,QAAQ,CAAC,IAAI,IAAI,WAAW,IAAI,WAAW,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAA6B,EAC7B,WAAmB,EACnB,WAAmB;IAEnB,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3F,OAAO;QACL,WAAW;QACX,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;QAChC,IAAI,EAAE,WAAW;QACjB,oBAAoB,EAAE,OAAO,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC;QACvF,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa;QAC3C,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACrD,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,QAA6B,EAC7B,YAAsC;IAEtC,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE;QACtC,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,kBAAkB;QACtE,GAAG,YAAY,CAAC,OAAO;KACxB,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CACV,YAAY,CAAC,MAAM;QACjB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,QAA6B,EAAE,MAAc,EAAE,IAAa;IAC7E,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA6B;IACvD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAA6B;IACnD,MAAM,iBAAiB,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAqC,CAAC;IAChG,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAiC,CAAC;IACpF,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAA+B,CAAC;IAC9E,MAAM,oBAAoB,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAwC,CAAC;IACzG,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,IAAI,UAAU,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;QAC7C,UAAU,GAAG,OAAO,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,IAAmB,EAAuB,EAAE;QACpE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAqC,CAAC;IAEvC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAe,EAAW,EAAE;QAChD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC,CAAiC,CAAC;IAEnC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAa,EAAuB,EAAE;QACxD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClC,UAAU,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC,CAA+B,CAAC;IAEjC,QAAQ,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IACvC,CAAC,CAAwC,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QAC5D,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU;QAC5B,OAAO,EAAE,GAAG,EAAE;YACZ,QAAQ,CAAC,SAAS,GAAG,iBAAiB,CAAC;YACvC,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;YAC/B,QAAQ,CAAC,GAAG,GAAG,WAAW,CAAC;YAC3B,QAAQ,CAAC,YAAY,GAAG,oBAAoB,CAAC;QAC/C,CAAC;QACD,gBAAgB,EAAE,GAAG,EAAE;YACrB,QAAQ,CAAC,SAAS,GAAG,iBAAiB,CAAC;YACvC,QAAQ,CAAC,KAAK,GAAG,aAAa,CAAC;YAC/B,QAAQ,CAAC,GAAG,GAAG,WAAW,CAAC;YAC3B,QAAQ,CAAC,YAAY,GAAG,oBAAoB,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AASD,SAAS,eAAe,CAAC,IAA0B;IACjD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CACzB,IAA0B,EAC1B,SAA2C,EAC3C,KAAmC,EACnC,GAA+B,EAC/B,YAAiD;IAEjD,MAAM,MAAM,GAAG,CAAC,EAAmC,EAAE,IAAwB,EAAQ,EAAE;QACrF,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC;IAEF,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW;YACd,MAAM,CAAC,SAA4C,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,OAAO;QACT,KAAK,OAAO;YACV,MAAM,CAAC,KAAwC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5D,OAAO;QACT,KAAK,KAAK;YACR,MAAM,CAAC,GAAsC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,OAAO;QACT,KAAK,cAAc;YACjB,YAAY,EAAE,CAAC;YACf,OAAO;IACX,CAAC;AACH,CAAC"}

package/dist/payments/oobe-facilitator-server.d.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * @name OobeX402FacilitatorServer
+ * @description Self-hosted OOBE x402 SVM facilitator compatible with @x402/core HTTPFacilitatorClient.
+ */
+import type { Network } from '@x402/core/types';
+/**
+ * @name OobeFacilitatorConfig
+ * @description Runtime configuration for the self-hosted OOBE x402 facilitator.
+ */
+export interface OobeFacilitatorConfig {
+    host: string;
+    port: number;
+    pathPrefix: string;
+    networks: Network[];
+    signerPath: string;
+    rpcUrl?: string;
+    authToken?: string;
+}
+/**
+ * @name OobeX402FacilitatorServer
+ * @description HTTP server exposing `/supported`, `/verify`, and `/settle` for x402 facilitator clients.
+ */
+export declare class OobeX402FacilitatorServer {
+    private readonly config;
+    private readonly facilitator;
+    private httpServer?;
+    private constructor();
+    /**
+     * @name create
+     * @description Creates a facilitator server with an SVM exact scheme registered for configured Solana networks.
+     */
+    static create(config?: OobeFacilitatorConfig): Promise<OobeX402FacilitatorServer>;
+    /**
+     * @name start
+     * @description Starts the OOBE x402 facilitator HTTP server.
+     */
+    start(): Promise<void>;
+    /**
+     * @name stop
+     * @description Stops the facilitator HTTP listener.
+     */
+    stop(): Promise<void>;
+    private handleRequest;
+    private isAuthorized;
+}
+/**
+ * @name loadOobeFacilitatorConfig
+ * @description Loads OOBE facilitator config from process environment.
+ */
+export declare function loadOobeFacilitatorConfig(): OobeFacilitatorConfig;
+/**
+ * @name createFacilitatorSigner
+ * @description Creates a dedicated 64-byte Solana keypair JSON for the x402 facilitator fee-payer role.
+ */
+export declare function createFacilitatorSigner(path?: string): {
+    path: string;
+    publicKey: string;
+    created: boolean;
+};
+/**
+ * @name getFacilitatorSignerPublicKey
+ * @description Reads the facilitator signer file only to derive the public key and never returns secret bytes.
+ */
+export declare function getFacilitatorSignerPublicKey(path?: string): string;
+/**
+ * @name validateFacilitatorConfig
+ * @description Fails fast on unsafe public facilitator configuration before loading signer material.
+ */
+export declare function validateFacilitatorConfig(config: OobeFacilitatorConfig): void;
+//# sourceMappingURL=oobe-facilitator-server.d.ts.map

package/dist/payments/oobe-facilitator-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oobe-facilitator-server.d.ts","sourceRoot":"","sources":["../../src/payments/oobe-facilitator-server.ts"],"names":[],"mappings":";AACA;;;GAGG;AAQH,OAAO,KAAK,EACV,OAAO,EAKR,MAAM,kBAAkB,CAAC;AAe1B;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,UAAU,CAAC,CAAc;IAEjC,OAAO;IAKP;;;OAGG;WACiB,MAAM,CAAC,MAAM,wBAA8B,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAmCpG;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBnC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUpB,aAAa;IA2C3B,OAAO,CAAC,YAAY;CAYrB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,qBAAqB,CAajE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,SAAyC,GAAG;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,CAuBA;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,SAAyC,GAAG,MAAM,CAGnG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CA2B7E"}