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

package/dist/payments/pay-sh-spec.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+/**
+ * @name PayShProviderSpec
+ * @description Generates a pay.sh provider YAML for hosted SAP MCP monetization.
+ */
+import { writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { loadConfig } from '../config/env.js';
+import { initLogger, logger } from '../core/logger.js';
+const SOLANA_MAINNET_CAIP2 = 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp';
+const SOLANA_DEVNET_CAIP2 = 'solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1';
+const SOLANA_TESTNET_CAIP2 = 'solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z';
+/**
+ * @name DEFAULT_PAY_SH_SPEC_OPTIONS
+ * @description Production defaults for OOBE Protocol's hosted SAP MCP pay.sh provider spec.
+ */
+export const DEFAULT_PAY_SH_SPEC_OPTIONS = {
+    name: 'oobe-sap-mcp',
+    subdomain: 'oobe-sap-mcp',
+    title: 'OOBE SAP MCP Server',
+    description: 'Paid hosted MCP access for Synapse Agent Protocol tools, discovery, SNS, and Solana agent workflows.',
+    version: 'v1',
+    upstreamUrl: 'http://127.0.0.1:8787',
+    operatorNetwork: 'devnet',
+    feePayer: true,
+};
+/**
+ * @name generatePayShProviderYaml
+ * @description Builds a pay.sh provider YAML that proxies paid MCP requests to the SAP MCP HTTP server.
+ */
+export function generatePayShProviderYaml(config, options = {}) {
+    const resolved = resolvePayShOptions(config, options);
+    const readPremiumUsd = formatYamlNumber(config.monetization.prices.readPremiumUsd);
+    const builderUsd = formatYamlNumber(config.monetization.prices.builderUsd);
+    const maxUsd = formatYamlNumber(config.monetization.prices.maxUsd);
+    const minUsd = formatYamlNumber(config.monetization.prices.minUsd);
+    const yaml = [
+        `name: ${quoteYaml(resolved.name)}`,
+        `subdomain: ${quoteYaml(resolved.subdomain)}`,
+        `title: ${quoteYaml(resolved.title)}`,
+        `description: ${quoteYaml(resolved.description)}`,
+        'category: devtools',
+        `version: ${quoteYaml(resolved.version)}`,
+        '',
+        'routing:',
+        '  type: proxy',
+        `  url: ${quoteYaml(withTrailingSlash(resolved.upstreamUrl))}`,
+        '',
+        'operator:',
+        "  currencies:",
+        "    usd: ['USDC']",
+        `  network: ${resolved.operatorNetwork}`,
+        `  fee_payer: ${String(resolved.feePayer)}`,
+        ...(resolved.recipient ? [`  recipient: ${quoteYaml(resolved.recipient)}`] : []),
+        ...(resolved.rpcUrl ? [`  rpc_url: ${quoteYaml(resolved.rpcUrl)}`] : []),
+        ...(resolved.signerPath ? [`  signer: { type: file, path: ${quoteYaml(resolved.signerPath)} }`] : []),
+        '',
+        'endpoints:',
+        '  - method: GET',
+        "    path: 'health'",
+        "    description: 'Health check forwarded to the hosted SAP MCP server.'",
+        '',
+        '  - method: POST',
+        "    path: 'mcp'",
+        "    description: 'SAP MCP JSON-RPC endpoint. Server-side x402 pricing remains authoritative per tool call.'",
+        '    metering:',
+        '      dimensions:',
+        '        - direction: usage',
+        '          unit: requests',
+        '          scale: 1',
+        '          tiers:',
+        `            - price_usd: ${readPremiumUsd}`,
+        '',
+        'notes: |',
+        '  The pay.sh gateway protects the outer HTTP MCP endpoint and forwards verified calls to SAP MCP.',
+        `  SAP MCP still performs native x402 per-tool pricing internally: free tools stay free, premium reads start at $${readPremiumUsd}, builders at $${builderUsd}, and value actions are capped between $${minUsd} and $${maxUsd}.`,
+        '  Validate with: pay --sandbox server start sap-mcp-pay-sh.yml --bind 127.0.0.1:1402',
+        '',
+    ];
+    return `${yaml.join('\n')}`;
+}
+/**
+ * @name resolvePayShOptions
+ * @description Resolves pay.sh YAML options from explicit overrides and the SAP MCP runtime config.
+ */
+export function resolvePayShOptions(config, options = {}) {
+    return {
+        ...DEFAULT_PAY_SH_SPEC_OPTIONS,
+        operatorNetwork: resolvePayShNetwork(config),
+        recipient: config.monetization.payTo,
+        rpcUrl: config.rpcUrl,
+        ...options,
+    };
+}
+/**
+ * @name resolvePayShNetwork
+ * @description Maps SAP MCP RPC/network config to pay.sh operator network aliases.
+ */
+export function resolvePayShNetwork(config) {
+    const network = config.monetization.network ?? config.rpcUrl;
+    if (network === SOLANA_MAINNET_CAIP2 || network.includes('mainnet')) {
+        return 'mainnet';
+    }
+    if (network === SOLANA_DEVNET_CAIP2
+        || network === SOLANA_TESTNET_CAIP2
+        || network.includes('devnet')
+        || network.includes('testnet')) {
+        return 'devnet';
+    }
+    if (network.includes('local')) {
+        return 'localnet';
+    }
+    return 'devnet';
+}
+function quoteYaml(value) {
+    return `'${value.replaceAll("'", "''")}'`;
+}
+function withTrailingSlash(value) {
+    return value.endsWith('/') ? value : `${value}/`;
+}
+function formatYamlNumber(value) {
+    return value.toFixed(6).replace(/0+$/, '').replace(/\.$/, '');
+}
+function parseCliOptions(argv) {
+    const parsed = { options: {} };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        const value = argv[index + 1];
+        if (arg === '--config' && value) {
+            parsed.configPath = value;
+            index += 1;
+        }
+        else if (arg === '--out' && value) {
+            parsed.outputPath = value;
+            index += 1;
+        }
+        else if (arg === '--upstream-url' && value) {
+            parsed.options.upstreamUrl = value;
+            index += 1;
+        }
+        else if (arg === '--network' && isPayShNetwork(value)) {
+            parsed.options.operatorNetwork = value;
+            index += 1;
+        }
+        else if (arg === '--recipient' && value) {
+            parsed.options.recipient = value;
+            index += 1;
+        }
+        else if (arg === '--rpc-url' && value) {
+            parsed.options.rpcUrl = value;
+            index += 1;
+        }
+        else if (arg === '--signer-path' && value) {
+            parsed.options.signerPath = value;
+            index += 1;
+        }
+        else if (arg === '--title' && value) {
+            parsed.options.title = value;
+            index += 1;
+        }
+        else if (arg === '--subdomain' && value) {
+            parsed.options.subdomain = value;
+            parsed.options.name = value;
+            index += 1;
+        }
+        else if (arg === '--no-fee-payer') {
+            parsed.options.feePayer = false;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printUsage();
+            process.exit(0);
+        }
+    }
+    return parsed;
+}
+function isPayShNetwork(value) {
+    return value === 'mainnet' || value === 'devnet' || value === 'localnet';
+}
+function printUsage() {
+    process.stdout.write([
+        'sap-mcp-pay-sh-spec',
+        '',
+        'Generate a pay.sh provider YAML for hosted SAP MCP monetization.',
+        '',
+        'Usage:',
+        '  npx sap-mcp-pay-sh-spec --out sap-mcp-pay-sh.yml --upstream-url https://sap.mcp.oobeprotocol.ai',
+        '',
+        'Options:',
+        '  --config <path>        SAP MCP profile/config JSON path',
+        '  --out <path>           Write YAML to file instead of stdout',
+        '  --upstream-url <url>   Hosted SAP MCP base URL',
+        '  --network <name>       mainnet, devnet, or localnet',
+        '  --recipient <pubkey>   Revenue wallet override',
+        '  --rpc-url <url>        pay.sh operator RPC URL',
+        '  --signer-path <path>   pay.sh operator signer file',
+        '  --subdomain <slug>     pay.sh provider slug',
+        '  --title <text>         pay.sh provider title',
+        '  --no-fee-payer         Disable operator fee payer sponsorship',
+        '',
+    ].join('\n'));
+}
+if (process.argv[1]?.endsWith('pay-sh-spec.js') || process.argv[1]?.endsWith('pay-sh-spec.ts')) {
+    initLogger({
+        level: process.env.SAP_MCP_LOG_LEVEL === 'debug' ? 'debug' : 'info',
+        format: process.env.SAP_MCP_LOG_FORMAT === 'json' ? 'json' : 'pretty',
+    });
+    const { configPath, outputPath, options } = parseCliOptions(process.argv.slice(2));
+    const yaml = generatePayShProviderYaml(loadConfig(configPath), options);
+    if (outputPath) {
+        const target = resolve(outputPath);
+        writeFileSync(target, yaml, 'utf-8');
+        logger.info('pay.sh provider YAML generated', { path: target });
+    }
+    else {
+        process.stdout.write(yaml);
+    }
+}
+//# sourceMappingURL=pay-sh-spec.js.map

package/dist/payments/pay-sh-spec.js.map

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

package/dist/payments/pricing.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @name SapMcpPricing
+ * @description Pricing registry for hosted SAP MCP tool monetization.
+ */
+import type { SapMcpMonetizationConfig } from '../config/env.js';
+import type { McpToolCall, ParsedMcpRequest } from './json-rpc.js';
+/**
+ * @name PaymentTier
+ * @description Commercial pricing tier for an MCP request.
+ */
+export type PaymentTier = 'free' | 'read-premium' | 'builder' | 'value-action' | 'batch';
+/**
+ * @name ToolPricing
+ * @description Resolved price classification for one tool call.
+ */
+export interface ToolPricing {
+    toolName: string;
+    tier: PaymentTier;
+    priceUsd: number;
+    reason: string;
+}
+/**
+ * @name PaymentDecision
+ * @description Aggregated payment requirement for a JSON-RPC MCP request.
+ */
+export type PaymentDecision = {
+    required: false;
+    tier: 'free';
+    reason: string;
+    toolPricings: ToolPricing[];
+} | {
+    required: true;
+    tier: Exclude<PaymentTier, 'free'>;
+    priceUsd: number;
+    price: string;
+    description: string;
+    toolPricings: ToolPricing[];
+    toolNames: string[];
+};
+/**
+ * @name resolvePaymentDecision
+ * @description Calculates whether a parsed MCP request requires payment and the exact USD price.
+ */
+export declare function resolvePaymentDecision(parsedRequest: ParsedMcpRequest, config: SapMcpMonetizationConfig): PaymentDecision;
+/**
+ * @name priceToolCall
+ * @description Classifies and prices a single MCP tool invocation.
+ */
+export declare function priceToolCall(toolCall: McpToolCall, config: SapMcpMonetizationConfig): ToolPricing;
+/**
+ * @name classifyTool
+ * @description Maps a tool name to the default hosted monetization tier.
+ */
+export declare function classifyTool(toolName: string): PaymentTier;
+/**
+ * @name formatUsdPrice
+ * @description Formats a decimal USD price for x402 money parsing while preserving small prices.
+ */
+export declare function formatUsdPrice(priceUsd: number): string;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/payments/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/payments/pricing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGnE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAEzF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B,GACD;IACE,QAAQ,EAAE,IAAI,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAgHN;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,gBAAgB,EAC/B,MAAM,EAAE,wBAAwB,GAC/B,eAAe,CAqCjB;AASD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,MAAM,EAAE,wBAAwB,GAC/B,WAAW,CAyCb;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CA+B1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/payments/pricing.js

@@ -0,0 +1,272 @@
+/**
+ * @name SapMcpPricing
+ * @description Pricing registry for hosted SAP MCP tool monetization.
+ */
+import { isRecord } from './json-rpc.js';
+const FREE_MCP_METHODS = new Set([
+    'initialize',
+    'notifications/initialized',
+    'ping',
+    'tools/list',
+    'prompts/list',
+    'prompts/get',
+    'resources/list',
+    'resources/templates/list',
+    'resources/read',
+]);
+const FREE_TOOLS = new Set([
+    'sap_profile_current',
+    'sap_profile_list',
+    'sap_profile_public_key',
+    'sap_skills_list',
+    'sap_skills_bundle',
+    'sap_get_network_overview',
+]);
+const READ_PREMIUM_TOOLS = new Set([
+    'sap_list_all_agents',
+    'sap_discover_agents',
+    'sap_list_agents',
+    'sap_network_stats',
+    'sap_find_tools_by_category',
+    'sap_get_tool_category_summary',
+    'sap_fetch_capability_index',
+    'sap_fetch_protocol_index',
+    'sap_fetch_tool_category_index',
+    'sap_fetch_tool',
+    'sap_sns_check_domain',
+    'sap_sns_resolve_domain',
+    'sap_sns_resolve_wallet',
+    'sap_sns_get_domain_records',
+    'sap_sns_get_record',
+    'sap_sns_check_ownership',
+    'sap_sns_get_domain_pda',
+    'sap_sns_get_record_pda',
+    'sap_x402_estimate_cost',
+    'sap_x402_calculate_cost',
+    'sap_x402_has_escrow',
+    'sap_x402_fetch_escrow',
+    'sap_x402_get_balance',
+    'coingecko_getTokenPrice',
+]);
+const BUILDER_TOOLS = new Set([
+    'sap_sns_batch_check_domains',
+    'sap_sns_validate_records',
+    'sap_sns_build_manage_record_transaction',
+    'sap_sns_build_set_primary_domain_transaction',
+    'sap_decode_transaction',
+    'sap_preview_transaction',
+    'sap_x402_build_payment_headers',
+    'sap_x402_build_headers_from_escrow',
+]);
+const VALUE_ACTION_TOOLS = new Set([
+    'sap_x402_prepare_payment',
+    'sap_x402_settle',
+    'sap_x402_settle_batch',
+]);
+const VALUE_ACTION_PREFIXES = [
+    'sap_register',
+    'sap_update',
+    'sap_deactivate',
+    'sap_reactivate',
+    'sap_close',
+    'sap_publish',
+    'sap_create',
+    'sap_fund',
+    'sap_cancel',
+    'sap_deposit',
+    'sap_withdraw',
+    'sap_settle',
+    'sap_finalize',
+    'sap_file',
+    'sap_submit',
+    'sap_sign',
+    'sap_sns_register',
+];
+const BUILDER_KEYWORDS = [
+    'analytics',
+    'batch',
+    'build',
+    'builder',
+    'domain',
+    'enriched',
+    'insight',
+    'quote',
+    'route',
+    'sns',
+    'swap',
+];
+const READ_PREMIUM_KEYWORDS = [
+    'discover',
+    'index',
+    'market',
+    'network',
+    'overview',
+    'price',
+    'protocol',
+    'stats',
+];
+/**
+ * @name resolvePaymentDecision
+ * @description Calculates whether a parsed MCP request requires payment and the exact USD price.
+ */
+export function resolvePaymentDecision(parsedRequest, config) {
+    if (parsedRequest.toolCalls.length === 0) {
+        const allFreeMethods = parsedRequest.methods.every(method => FREE_MCP_METHODS.has(method));
+        return {
+            required: false,
+            tier: 'free',
+            reason: allFreeMethods ? 'free MCP protocol method' : 'non-tool MCP request',
+            toolPricings: [],
+        };
+    }
+    const toolPricings = parsedRequest.toolCalls.map(toolCall => priceToolCall(toolCall, config));
+    const paidPricings = toolPricings.filter(pricing => pricing.tier !== 'free');
+    if (paidPricings.length === 0) {
+        return {
+            required: false,
+            tier: 'free',
+            reason: 'all tool calls are in the free tier',
+            toolPricings,
+        };
+    }
+    const priceUsd = clampPrice(paidPricings.reduce((sum, pricing) => sum + pricing.priceUsd, 0), config);
+    return {
+        required: true,
+        tier: parsedRequest.isBatch || paidPricings.length > 1 ? 'batch' : toPaidTier(paidPricings[0].tier),
+        priceUsd,
+        price: formatUsdPrice(priceUsd),
+        description: buildPaymentDescription(paidPricings),
+        toolPricings,
+        toolNames: paidPricings.map(pricing => pricing.toolName),
+    };
+}
+function toPaidTier(tier) {
+    if (tier === 'free') {
+        return 'read-premium';
+    }
+    return tier;
+}
+/**
+ * @name priceToolCall
+ * @description Classifies and prices a single MCP tool invocation.
+ */
+export function priceToolCall(toolCall, config) {
+    const tier = classifyTool(toolCall.toolName);
+    if (tier === 'free') {
+        return {
+            toolName: toolCall.toolName,
+            tier,
+            priceUsd: 0,
+            reason: 'free tool',
+        };
+    }
+    if (tier === 'read-premium') {
+        return {
+            toolName: toolCall.toolName,
+            tier,
+            priceUsd: clampPrice(config.prices.readPremiumUsd, config),
+            reason: 'premium read/discovery tool',
+        };
+    }
+    if (tier === 'builder') {
+        return {
+            toolName: toolCall.toolName,
+            tier,
+            priceUsd: clampPrice(config.prices.builderUsd, config),
+            reason: 'complex builder, batch, SNS, analytics, or routing tool',
+        };
+    }
+    const notionalUsd = extractUsdNotional(toolCall.arguments);
+    const variableUsd = notionalUsd === undefined ? 0 : notionalUsd * (config.prices.valueBps / 10_000);
+    return {
+        toolName: toolCall.toolName,
+        tier,
+        priceUsd: clampPrice(config.prices.valueFixedUsd + variableUsd, config),
+        reason: notionalUsd === undefined
+            ? 'value-changing action fixed fee'
+            : 'value-changing action fixed fee plus configured basis-points fee',
+    };
+}
+/**
+ * @name classifyTool
+ * @description Maps a tool name to the default hosted monetization tier.
+ */
+export function classifyTool(toolName) {
+    if (FREE_TOOLS.has(toolName)) {
+        return 'free';
+    }
+    if (READ_PREMIUM_TOOLS.has(toolName)) {
+        return 'read-premium';
+    }
+    if (BUILDER_TOOLS.has(toolName)) {
+        return 'builder';
+    }
+    if (VALUE_ACTION_TOOLS.has(toolName)) {
+        return 'value-action';
+    }
+    if (VALUE_ACTION_PREFIXES.some(prefix => toolName.startsWith(prefix))) {
+        return 'value-action';
+    }
+    const normalized = toolName.toLowerCase();
+    if (BUILDER_KEYWORDS.some(keyword => normalized.includes(keyword))) {
+        return 'builder';
+    }
+    if (READ_PREMIUM_KEYWORDS.some(keyword => normalized.includes(keyword))) {
+        return 'read-premium';
+    }
+    return 'read-premium';
+}
+/**
+ * @name formatUsdPrice
+ * @description Formats a decimal USD price for x402 money parsing while preserving small prices.
+ */
+export function formatUsdPrice(priceUsd) {
+    const fixed = priceUsd.toFixed(6).replace(/0+$/, '').replace(/\.$/, '');
+    return `$${fixed}`;
+}
+function clampPrice(priceUsd, config) {
+    const minimum = Math.max(config.prices.minUsd, 0);
+    const maximum = Math.max(config.prices.maxUsd, minimum);
+    return Math.min(maximum, Math.max(minimum, priceUsd));
+}
+function buildPaymentDescription(toolPricings) {
+    if (toolPricings.length === 1) {
+        const [pricing] = toolPricings;
+        return `SAP MCP paid tool call: ${pricing.toolName} (${pricing.tier})`;
+    }
+    return `SAP MCP paid batch: ${toolPricings.length} tool calls`;
+}
+function extractUsdNotional(value, depth = 0) {
+    if (depth > 4 || !isRecord(value)) {
+        return undefined;
+    }
+    const candidateKeys = [
+        'amountUsd',
+        'usdAmount',
+        'valueUsd',
+        'usdValue',
+        'notionalUsd',
+        'settlementUsd',
+        'paymentUsd',
+    ];
+    for (const key of candidateKeys) {
+        const candidate = value[key];
+        if (typeof candidate === 'number' && Number.isFinite(candidate) && candidate > 0) {
+            return candidate;
+        }
+        if (typeof candidate === 'string') {
+            const parsed = Number.parseFloat(candidate);
+            if (Number.isFinite(parsed) && parsed > 0) {
+                return parsed;
+            }
+        }
+    }
+    for (const nested of Object.values(value)) {
+        const nestedValue = extractUsdNotional(nested, depth + 1);
+        if (nestedValue !== undefined) {
+            return nestedValue;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/payments/pricing.js.map

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

package/dist/payments/usage-ledger.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @name PaymentUsageLedger
+ * @description Append-only JSONL audit ledger for remote MCP payment decisions and settlements.
+ */
+import type { SettleResponse } from '@x402/core/types';
+import type { PaymentDecision } from './pricing.js';
+/**
+ * @name PaymentLedgerEventType
+ * @description Supported audit event types emitted by the monetization gate.
+ */
+export type PaymentLedgerEventType = 'payment_required' | 'payment_verified' | 'payment_settled' | 'payment_failed' | 'payment_canceled';
+/**
+ * @name PaymentLedgerEvent
+ * @description Durable audit record for a monetized MCP request without storing private key material or payment payloads.
+ */
+export interface PaymentLedgerEvent {
+    event: PaymentLedgerEventType;
+    timestamp: string;
+    requestHash: string;
+    method: string;
+    path: string;
+    toolNames: string[];
+    priceUsd?: number;
+    paymentHeaderPresent: boolean;
+    remoteAddress?: string;
+    userAgent?: string;
+    transaction?: string;
+    network?: string;
+    amount?: string;
+    payer?: string;
+    errorReason?: string;
+    errorMessage?: string;
+}
+/**
+ * @name PaymentRequestMetadata
+ * @description Public request metadata that is safe to persist for payment auditability.
+ */
+export interface PaymentRequestMetadata {
+    requestHash: string;
+    method: string;
+    path: string;
+    remoteAddress?: string;
+    userAgent?: string;
+    paymentHeaderPresent: boolean;
+}
+/**
+ * @name UsageLedger
+ * @description Writes MCP payment events to an append-only local JSONL ledger.
+ */
+export declare class UsageLedger {
+    private readonly ledgerPath;
+    constructor(ledgerPath?: string);
+    /**
+     * @name append
+     * @description Appends one payment audit event to the JSONL ledger.
+     */
+    append(event: PaymentLedgerEvent): Promise<void>;
+    /**
+     * @name recordDecision
+     * @description Records that a request requires payment.
+     */
+    recordDecision(metadata: PaymentRequestMetadata, decision: PaymentDecision): Promise<void>;
+    /**
+     * @name recordVerified
+     * @description Records that an x402 payment was accepted before handler execution.
+     */
+    recordVerified(metadata: PaymentRequestMetadata, decision: PaymentDecision): Promise<void>;
+    /**
+     * @name recordCanceled
+     * @description Records that a verified payment was canceled because MCP execution did not complete successfully.
+     */
+    recordCanceled(metadata: PaymentRequestMetadata, decision: PaymentDecision, reason: string, errorMessage?: string): Promise<void>;
+    /**
+     * @name recordSettlement
+     * @description Records successful or failed x402 settlement without storing payment payload bytes.
+     */
+    recordSettlement(metadata: PaymentRequestMetadata, decision: PaymentDecision, settlement: SettleResponse): Promise<void>;
+}
+/**
+ * @name hashRequestBody
+ * @description Computes a deterministic SHA-256 hash for request correlation without persisting raw arguments.
+ */
+export declare function hashRequestBody(body: Buffer): string;
+//# sourceMappingURL=usage-ledger.d.ts.map

package/dist/payments/usage-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-ledger.d.ts","sourceRoot":"","sources":["../../src/payments/usage-ledger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAC9B,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,CAAC;AAEvB;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEjB,UAAU,SAAuD;IAIpF;;;OAGG;IACU,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvG;;;OAGG;IACU,cAAc,CAAC,QAAQ,EAAE,sBAAsB,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvG;;;OAGG;IACU,cAAc,CACzB,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;OAGG;IACU,gBAAgB,CAC3B,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,cAAc,GACzB,OAAO,CAAC,IAAI,CAAC;CAwBjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}