@contextvm/sdk 0.3.1 → 0.4.0

package/dist/esm/payments/processors/ln-bolt11-lnbits-payment-processor.js

@@ -0,0 +1,133 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+import { createLogger } from '../../core/utils/logger.js';
+import { sleep } from '../../core/utils/utils.js';
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by LNbits REST API.
+ *
+ * Creates BOLT11 invoices via the LNbits `/api/v1/payments` endpoint and polls
+ * for settlement using the same API.
+ */
+export class LnBolt11LnbitsPaymentProcessor {
+    constructor(options) {
+        var _a, _b, _c;
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        this.lnbitsUrl = options.lnbitsUrl.replace(/\/+$/, '');
+        this.lnbitsApiKey = options.lnbitsApiKey;
+        this.lnbitsBasicAuth = options.lnbitsBasicAuth;
+        this.ttlSeconds = (_a = options.ttlSeconds) !== null && _a !== void 0 ? _a : 300;
+        this.invoiceExpirySeconds = (_b = options.invoiceExpirySeconds) !== null && _b !== void 0 ? _b : this.ttlSeconds;
+        this.pollIntervalMs = (_c = options.pollIntervalMs) !== null && _c !== void 0 ? _c : 1500;
+        this.logger = createLogger('payments/lnbits-processor');
+    }
+    buildHeaders() {
+        const headers = {
+            'Content-Type': 'application/json',
+            'X-Api-Key': this.lnbitsApiKey,
+        };
+        if (this.lnbitsBasicAuth) {
+            const encoded = Buffer.from(this.lnbitsBasicAuth).toString('base64');
+            headers['Authorization'] = `Basic ${encoded}`;
+        }
+        return headers;
+    }
+    async createPaymentRequired(params) {
+        var _a;
+        const body = JSON.stringify({
+            out: false,
+            amount: params.amount,
+            memo: (_a = params.description) !== null && _a !== void 0 ? _a : `CVM payment: ${params.requestEventId.slice(0, 8)}`,
+            expiry: this.invoiceExpirySeconds,
+        });
+        const response = await fetch(`${this.lnbitsUrl}/api/v1/payments`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`LNbits create invoice failed: ${response.status} ${text}`);
+        }
+        const result = (await response.json());
+        if (!result.payment_request) {
+            throw new Error('LNbits returned no payment_request');
+        }
+        this.logger.debug('Invoice created', {
+            requestEventId: params.requestEventId,
+            paymentHash: result.payment_hash,
+            amount: params.amount,
+        });
+        return {
+            amount: params.amount,
+            pay_req: result.payment_request,
+            description: params.description,
+            pmi: this.pmi,
+            ttl: this.ttlSeconds,
+        };
+    }
+    async verifyPayment(params) {
+        var _a;
+        // We need the payment hash to check status. Derive it from the invoice
+        // by first looking it up via the decoded invoice endpoint, or by checking
+        // all recent payments. The simplest approach: decode the bolt11 to get the hash.
+        const paymentHash = await this.getPaymentHashFromInvoice(params.pay_req);
+        while (true) {
+            if ((_a = params.abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                throw new Error('verifyPayment aborted');
+            }
+            const response = await fetch(`${this.lnbitsUrl}/api/v1/payments/${paymentHash}`, {
+                method: 'GET',
+                headers: this.buildHeaders(),
+            });
+            if (response.ok) {
+                const result = (await response.json());
+                this.logger.debug('Payment check', {
+                    requestEventId: params.requestEventId,
+                    paymentHash,
+                    paid: result.paid,
+                });
+                if (result.paid) {
+                    return { _meta: { payment_hash: paymentHash } };
+                }
+            }
+            else {
+                this.logger.debug('Payment check request failed', {
+                    status: response.status,
+                    paymentHash,
+                });
+            }
+            await sleep(this.pollIntervalMs);
+        }
+    }
+    /**
+     * Extract payment hash from a BOLT11 invoice by checking it against LNbits.
+     * LNbits returns the payment_hash when creating an invoice, but verifyPayment
+     * only receives pay_req. We decode it via LNbits decode endpoint.
+     */
+    async getPaymentHashFromInvoice(bolt11) {
+        const response = await fetch(`${this.lnbitsUrl}/api/v1/payments/decode`, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+            body: JSON.stringify({ data: bolt11 }),
+        });
+        if (response.ok) {
+            const decoded = (await response.json());
+            if (decoded.payment_hash) {
+                return decoded.payment_hash;
+            }
+        }
+        // Fallback: search recent payments for matching bolt11
+        const paymentsResponse = await fetch(`${this.lnbitsUrl}/api/v1/payments?limit=50`, {
+            method: 'GET',
+            headers: this.buildHeaders(),
+        });
+        if (paymentsResponse.ok) {
+            const payments = (await paymentsResponse.json());
+            const match = payments.find((p) => p.bolt11 === bolt11);
+            if (match) {
+                return match.payment_hash;
+            }
+        }
+        throw new Error('Could not resolve payment hash from invoice');
+    }
+}
+//# sourceMappingURL=ln-bolt11-lnbits-payment-processor.js.map

package/dist/esm/payments/processors/ln-bolt11-lnbits-payment-processor.js.map

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

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.d.ts

@@ -0,0 +1,41 @@
+import type { RelayHandler } from '../../core/interfaces.js';
+import type { PaymentProcessor, PaymentProcessorCreateParams, PaymentProcessorVerifyParams } from '../types.js';
+export interface LnBolt11NwcPaymentProcessorOptions {
+    /** NIP-47 `nostr+walletconnect://...` connection string. */
+    nwcConnectionString: string;
+    /** Optional relay handler to reuse; defaults to an ApplesauceRelayPool built from the connection relays. */
+    relayHandler?: RelayHandler;
+    /** Fallback TTL in seconds if wallet does not provide expires_at. @default 300 */
+    ttlSeconds?: number;
+    /** `make_invoice.expiry` in seconds. @default ttlSeconds */
+    invoiceExpirySeconds?: number;
+    /** Poll interval for `lookup_invoice`. @default 1500 */
+    pollIntervalMs?: number;
+    /** Per-request response timeout. @default 60_000 */
+    responseTimeoutMs?: number;
+}
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export declare class LnBolt11NwcPaymentProcessor implements PaymentProcessor {
+    readonly pmi: "bitcoin-lightning-bolt11";
+    private readonly nwc;
+    private readonly ttlSeconds;
+    private readonly invoiceExpirySeconds;
+    private readonly pollIntervalMs;
+    private readonly logger;
+    constructor(options: LnBolt11NwcPaymentProcessorOptions);
+    private isSettledInvoice;
+    private getReceiptFromInvoiceResult;
+    createPaymentRequired(params: PaymentProcessorCreateParams): Promise<{
+        amount: number;
+        pay_req: string;
+        description?: string;
+        pmi: string;
+        ttl?: number;
+    }>;
+    verifyPayment(params: PaymentProcessorVerifyParams): Promise<{
+        _meta?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-processor.d.ts.map

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ln-bolt11-nwc-payment-processor.d.ts","sourceRoot":"","sources":["../../../../src/payments/processors/ln-bolt11-nwc-payment-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,gBAAgB,EAChB,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,aAAa,CAAC;AAUrB,MAAM,WAAW,kCAAkC;IACjD,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,2BAA4B,YAAW,gBAAgB;IAClE,SAAgB,GAAG,6BAAgC;IAEnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEb,OAAO,EAAE,kCAAkC;IAiB9D,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,2BAA2B;IAqBtB,qBAAqB,CAChC,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAoCW,aAAa,CACxB,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAoDhD"}

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.js

@@ -0,0 +1,129 @@
+import { PMI_BITCOIN_LIGHTNING_BOLT11 } from '../pmis.js';
+import { parseNwcConnectionString } from '../nip47/connection.js';
+import { NwcClient } from '../nip47/nwc-client.js';
+import { ApplesauceRelayPool } from '../../relay/applesauce-relay-pool.js';
+import { createLogger } from '../../core/utils/logger.js';
+import { sleep } from '../../core/utils/utils.js';
+import { satsToMsats } from '../nip47/utils.js';
+/**
+ * CEP-8 server payment processor for PMI `bitcoin-lightning-bolt11` backed by NIP-47 (NWC).
+ */
+export class LnBolt11NwcPaymentProcessor {
+    constructor(options) {
+        var _a, _b, _c, _d;
+        this.pmi = PMI_BITCOIN_LIGHTNING_BOLT11;
+        const connection = parseNwcConnectionString(options.nwcConnectionString);
+        const relayHandler = (_a = options.relayHandler) !== null && _a !== void 0 ? _a : new ApplesauceRelayPool([...connection.relays]);
+        this.nwc = new NwcClient({
+            relayHandler,
+            connection,
+            responseTimeoutMs: options.responseTimeoutMs,
+        });
+        this.ttlSeconds = (_b = options.ttlSeconds) !== null && _b !== void 0 ? _b : 300;
+        this.invoiceExpirySeconds = (_c = options.invoiceExpirySeconds) !== null && _c !== void 0 ? _c : this.ttlSeconds;
+        this.pollIntervalMs = (_d = options.pollIntervalMs) !== null && _d !== void 0 ? _d : 1500;
+        this.logger = createLogger('payments/nwc-processor');
+    }
+    isSettledInvoice(result) {
+        // Wallets vary: some set `state`, some only set `settled_at`, some include `preimage`.
+        // Treat any of these signals as settlement.
+        if (!result)
+            return false;
+        if (result.state === 'settled')
+            return true;
+        if (typeof result.settled_at === 'number')
+            return true;
+        if (typeof result.preimage === 'string' && result.preimage.length > 0)
+            return true;
+        return false;
+    }
+    getReceiptFromInvoiceResult(params) {
+        const { result, requestEventId } = params;
+        // Prefer stable identifiers; avoid leaking preimage.
+        if (typeof (result === null || result === void 0 ? void 0 : result.payment_hash) === 'string' &&
+            result.payment_hash.length > 0) {
+            return result.payment_hash;
+        }
+        // Some wallets do not provide `payment_hash` on lookup results. Still produce a stable
+        // settlement identifier string for correlation.
+        const settledAt = typeof (result === null || result === void 0 ? void 0 : result.settled_at) === 'number' ? result.settled_at : undefined;
+        return `settled:${requestEventId}${settledAt ? `:${settledAt}` : ''}`;
+    }
+    async createPaymentRequired(params) {
+        var _a;
+        const request = {
+            amount: satsToMsats(params.amount),
+            description: params.description,
+            expiry: this.invoiceExpirySeconds,
+        };
+        const response = await this.nwc.request({
+            method: 'make_invoice',
+            resultType: 'make_invoice',
+            request: { method: 'make_invoice', params: request },
+        });
+        if (response.error) {
+            throw new Error(`NWC make_invoice failed: ${response.error.code} (${response.error.message})`);
+        }
+        const invoice = (_a = response.result) === null || _a === void 0 ? void 0 : _a.invoice;
+        if (!invoice) {
+            throw new Error('NWC make_invoice returned no invoice');
+        }
+        // Keep TTL simple and predictable. Some providers return non-standard `expires_at`.
+        const ttl = this.ttlSeconds;
+        return {
+            amount: params.amount,
+            pay_req: invoice,
+            description: params.description,
+            pmi: this.pmi,
+            ttl,
+        };
+    }
+    async verifyPayment(params) {
+        var _a;
+        // Note: server-payments middleware already bounds overall time by the `ttl` it emitted.
+        // We still keep this loop tight and predictable.
+        while (true) {
+            if ((_a = params.abortSignal) === null || _a === void 0 ? void 0 : _a.aborted) {
+                throw new Error('verifyPayment aborted');
+            }
+            const response = await this.nwc.request({
+                method: 'lookup_invoice',
+                resultType: 'lookup_invoice',
+                request: {
+                    method: 'lookup_invoice',
+                    params: { invoice: params.pay_req },
+                },
+            });
+            if (response.error) {
+                // NOT_FOUND can happen if the wallet is lagging; treat as pending.
+                if (response.error.code !== 'NOT_FOUND') {
+                    throw new Error(`NWC lookup_invoice failed: ${response.error.code} (${response.error.message})`);
+                }
+            }
+            else {
+                const result = response.result;
+                this.logger.debug('lookup_invoice result', {
+                    requestEventId: params.requestEventId,
+                    state: result === null || result === void 0 ? void 0 : result.state,
+                    hasPreimage: Boolean(result === null || result === void 0 ? void 0 : result.preimage),
+                    hasSettledAt: typeof (result === null || result === void 0 ? void 0 : result.settled_at) === 'number',
+                    hasPaymentHash: Boolean(result === null || result === void 0 ? void 0 : result.payment_hash),
+                });
+                if (this.isSettledInvoice(result)) {
+                    // Prefer payment_hash as a stable identifier (avoid exposing preimages).
+                    const paymentHash = this.getReceiptFromInvoiceResult({
+                        result,
+                        requestEventId: params.requestEventId,
+                    });
+                    return { _meta: { payment_hash: paymentHash } };
+                }
+                const state = result === null || result === void 0 ? void 0 : result.state;
+                if (state === 'expired' || state === 'failed') {
+                    throw new Error(`Invoice ${state}`);
+                }
+            }
+            await sleep(this.pollIntervalMs);
+        }
+    }
+}
+//# sourceMappingURL=ln-bolt11-nwc-payment-processor.js.map

package/dist/esm/payments/processors/ln-bolt11-nwc-payment-processor.js.map

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

package/dist/esm/payments/server-payments.d.ts

@@ -0,0 +1,32 @@
+import { CorrelatedNotificationSender, PaymentProcessor, PricedCapability, ResolvePriceFn, ServerMiddlewareFn } from './types.js';
+export interface ServerPaymentsOptions {
+    processors: readonly PaymentProcessor[];
+    pricedCapabilities: readonly PricedCapability[];
+    /** Optional dynamic pricing callback used to compute a per-request quote. */
+    resolvePrice?: ResolvePriceFn;
+    /**
+     * Maximum time to keep a request in pending-payment state.
+     *
+     * Note: if the payment request includes a CEP-8 `ttl` (seconds), the effective
+     * verification timeout will be derived from that TTL. This option is primarily
+     * a memory/DoS guardrail.
+     *
+     * @default 300_000
+     */
+    paymentTtlMs?: number;
+    /**
+     * Maximum number of concurrent pending-payment request ids to track.
+     *
+     * This is a DoS/memory-safety guardrail.
+     * @default 1000
+     */
+    maxPendingPayments?: number;
+}
+/**
+ * Creates a server-side middleware that gates priced requests until payment is verified.
+ */
+export declare function createServerPaymentsMiddleware(params: {
+    sender: CorrelatedNotificationSender;
+    options: ServerPaymentsOptions;
+}): ServerMiddlewareFn;
+//# sourceMappingURL=server-payments.d.ts.map

package/dist/esm/payments/server-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-payments.d.ts","sourceRoot":"","sources":["../../../src/payments/server-payments.ts"],"names":[],"mappings":"AACA,OAAO,EACL,4BAA4B,EAE5B,gBAAgB,EAGhB,gBAAgB,EAGhB,cAAc,EACd,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAEhD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAuHD;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,MAAM,EAAE,4BAA4B,CAAC;IACrC,OAAO,EAAE,qBAAqB,CAAC;CAChC,GAAG,kBAAkB,CA6JrB"}

package/dist/esm/payments/server-payments.js

@@ -0,0 +1,199 @@
+import { isJsonRpcRequest, } from './types.js';
+import { LruCache } from '../core/utils/lru-cache.js';
+import { withTimeout } from '../core/utils/utils.js';
+function purgeExpiredPending(params) {
+    let checked = 0;
+    for (const [key, value] of params.pending.entries()) {
+        if (checked >= params.maxToCheck) {
+            break;
+        }
+        checked += 1;
+        if (value.expiresAtMs <= params.nowMs) {
+            params.pending.delete(key);
+        }
+    }
+}
+function getVerificationTimeoutMs(params) {
+    // CEP-8 TTL is in seconds. If TTL is absent, default is 5 minutes.
+    const ttlSeconds = params.ttlSeconds;
+    if (ttlSeconds === undefined) {
+        return 5 * 60 * 1000;
+    }
+    if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
+        return 5 * 60 * 1000;
+    }
+    return Math.floor(ttlSeconds * 1000);
+}
+function matchPricedCapability(message, priced) {
+    const capabilityName = getCapabilityNameForPricing(message);
+    return priced.find((p) => {
+        if (p.method !== message.method)
+            return false;
+        if (p.name === undefined)
+            return true;
+        return p.name === capabilityName;
+    });
+}
+function getCapabilityNameForPricing(message) {
+    const params = message.params;
+    switch (message.method) {
+        case 'tools/call': {
+            const name = params === null || params === void 0 ? void 0 : params.name;
+            return typeof name === 'string' ? name : undefined;
+        }
+        case 'prompts/get': {
+            const name = params === null || params === void 0 ? void 0 : params.name;
+            return typeof name === 'string' ? name : undefined;
+        }
+        case 'resources/read': {
+            const uri = params === null || params === void 0 ? void 0 : params.uri;
+            return typeof uri === 'string' ? uri : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+function createPaymentRequiredNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_required',
+        params,
+    };
+}
+function createPaymentAcceptedNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_accepted',
+        params,
+    };
+}
+function createPaymentRejectedNotification(params) {
+    return {
+        jsonrpc: '2.0',
+        method: 'notifications/payment_rejected',
+        params,
+    };
+}
+function isResolvePriceRejection(quote) {
+    return 'reject' in quote && quote.reject;
+}
+/**
+ * Creates a server-side middleware that gates priced requests until payment is verified.
+ */
+export function createServerPaymentsMiddleware(params) {
+    var _a, _b;
+    const { sender, options } = params;
+    const processorsByPmi = new Map(options.processors.map((p) => [p.pmi, p]));
+    const paymentTtlMs = (_a = options.paymentTtlMs) !== null && _a !== void 0 ? _a : 300000;
+    const pending = new LruCache((_b = options.maxPendingPayments) !== null && _b !== void 0 ? _b : 1000);
+    return async (message, ctx, forward) => {
+        // Only gate requests. Never interfere with notifications.
+        if (!isJsonRpcRequest(message)) {
+            await forward(message);
+            return;
+        }
+        const priced = matchPricedCapability(message, options.pricedCapabilities);
+        if (!priced) {
+            await forward(message);
+            return;
+        }
+        const requestEventId = String(message.id);
+        const now = Date.now();
+        // Opportunistic cleanup so one-shot spam doesn't accumulate until reuse.
+        purgeExpiredPending({ pending, nowMs: now, maxToCheck: 25 });
+        const existing = pending.get(requestEventId);
+        if (existing && existing.expiresAtMs > now) {
+            // Duplicate request event id: await the in-flight work deterministically.
+            // This avoids double-charge races and avoids black-holing duplicates.
+            await existing.inFlight;
+            return;
+        }
+        // IMPORTANT: set pending state synchronously before any await to make idempotency atomic.
+        const inFlight = (async () => {
+            var _a, _b, _c;
+            const clientPmis = ctx.clientPmis;
+            const chosenPmi = clientPmis
+                ? clientPmis.find((pmi) => processorsByPmi.has(pmi))
+                : undefined;
+            const chosenProcessor = chosenPmi
+                ? processorsByPmi.get(chosenPmi)
+                : options.processors[0];
+            if (!chosenProcessor) {
+                throw new Error('No payment processors configured');
+            }
+            const processor = (_a = processorsByPmi.get(chosenProcessor.pmi)) !== null && _a !== void 0 ? _a : chosenProcessor;
+            const quote = options.resolvePrice
+                ? await options.resolvePrice({
+                    capability: priced,
+                    request: message,
+                    clientPubkey: ctx.clientPubkey,
+                    requestEventId,
+                })
+                : { amount: priced.amount, description: priced.description };
+            // Handle rejection: emit payment_rejected and do not forward.
+            if (isResolvePriceRejection(quote)) {
+                const rejectedNotification = createPaymentRejectedNotification({
+                    pmi: processor.pmi,
+                    amount: priced.amount,
+                    message: quote.message,
+                });
+                await sender.sendNotification(ctx.clientPubkey, rejectedNotification, requestEventId);
+            }
+            else {
+                const resolvedQuote = quote;
+                const paymentRequired = await processor.createPaymentRequired({
+                    amount: resolvedQuote.amount,
+                    description: resolvedQuote.description,
+                    requestEventId,
+                    clientPubkey: ctx.clientPubkey,
+                });
+                const mergedMeta = resolvedQuote.meta === undefined &&
+                    paymentRequired._meta === undefined
+                    ? undefined
+                    : {
+                        ...((_b = paymentRequired._meta) !== null && _b !== void 0 ? _b : {}),
+                        ...((_c = resolvedQuote.meta) !== null && _c !== void 0 ? _c : {}),
+                    };
+                const requiredNotification = createPaymentRequiredNotification({
+                    amount: paymentRequired.amount,
+                    pay_req: paymentRequired.pay_req,
+                    pmi: paymentRequired.pmi,
+                    description: paymentRequired.description,
+                    ttl: paymentRequired.ttl,
+                    _meta: mergedMeta,
+                });
+                await sender.sendNotification(ctx.clientPubkey, requiredNotification, requestEventId);
+                const verifyTimeoutMs = getVerificationTimeoutMs({
+                    ttlSeconds: paymentRequired.ttl,
+                });
+                const effectiveTimeoutMs = Math.min(verifyTimeoutMs, paymentTtlMs);
+                const controller = new AbortController();
+                const verified = await withTimeout(processor.verifyPayment({
+                    pay_req: paymentRequired.pay_req,
+                    requestEventId,
+                    clientPubkey: ctx.clientPubkey,
+                    abortSignal: controller.signal,
+                }), effectiveTimeoutMs, 'verifyPayment timed out').finally(() => controller.abort());
+                const acceptedNotification = createPaymentAcceptedNotification({
+                    amount: paymentRequired.amount,
+                    pmi: paymentRequired.pmi,
+                    _meta: verified._meta,
+                });
+                await sender.sendNotification(ctx.clientPubkey, acceptedNotification, requestEventId);
+                await forward(message);
+            }
+        })();
+        const state = {
+            expiresAtMs: now + paymentTtlMs,
+            inFlight,
+        };
+        pending.set(requestEventId, state);
+        try {
+            await inFlight;
+        }
+        finally {
+            pending.delete(requestEventId);
+        }
+    };
+}
+//# sourceMappingURL=server-payments.js.map

package/dist/esm/payments/server-payments.js.map

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

package/dist/esm/payments/server-transport-payments.d.ts

@@ -0,0 +1,7 @@
+import type { NostrServerTransport } from '../transport/nostr-server-transport.js';
+import type { ServerPaymentsOptions } from './server-payments.js';
+/**
+ * Attaches CEP-8 payments gating to a NostrServerTransport.
+ */
+export declare function withServerPayments(transport: NostrServerTransport, options: ServerPaymentsOptions): NostrServerTransport;
+//# sourceMappingURL=server-transport-payments.d.ts.map

package/dist/esm/payments/server-transport-payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-transport-payments.d.ts","sourceRoot":"","sources":["../../../src/payments/server-transport-payments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,oBAAoB,EAC/B,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAatB"}

package/dist/esm/payments/server-transport-payments.js

@@ -0,0 +1,14 @@
+import { createCapTagsFromPricedCapabilities } from './cap-tags.js';
+import { createPmiTagsFromProcessors } from './pmi-tags.js';
+import { createServerPaymentsMiddleware } from './server-payments.js';
+/**
+ * Attaches CEP-8 payments gating to a NostrServerTransport.
+ */
+export function withServerPayments(transport, options) {
+    // CEP-8 discovery tags: advertise supported PMIs + reference pricing on announcement/list events.
+    transport.setAnnouncementExtraTags(createPmiTagsFromProcessors(options.processors));
+    transport.setAnnouncementPricingTags(createCapTagsFromPricedCapabilities(options.pricedCapabilities));
+    transport.addInboundMiddleware(createServerPaymentsMiddleware({ sender: transport, options }));
+    return transport;
+}
+//# sourceMappingURL=server-transport-payments.js.map

package/dist/esm/payments/server-transport-payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-transport-payments.js","sourceRoot":"","sources":["../../../src/payments/server-transport-payments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mCAAmC,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAEtE;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAA+B,EAC/B,OAA8B;IAE9B,kGAAkG;IAClG,SAAS,CAAC,wBAAwB,CAChC,2BAA2B,CAAC,OAAO,CAAC,UAAU,CAAC,CAChD,CAAC;IACF,SAAS,CAAC,0BAA0B,CAClC,mCAAmC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAChE,CAAC;IAEF,SAAS,CAAC,oBAAoB,CAC5B,8BAA8B,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAC/D,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC"}