@garydevenay/emporion 0.0.2 → 0.0.3

package/dist/src/wallet/nwc-adapter.js

@@ -0,0 +1,233 @@
+import { randomUUID } from "node:crypto";
+import { InvoiceCreationError, PaymentFailedError, WalletAuthError, WalletUnavailableError } from "../errors.js";
+const DEFAULT_REQUEST_TIMEOUT_MS = 15_000;
+function parseInteger(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return Math.trunc(value);
+    }
+    if (typeof value === "string" && /^\d+$/.test(value)) {
+        return Number.parseInt(value, 10);
+    }
+    return undefined;
+}
+function pickString(record, fields) {
+    for (const field of fields) {
+        const value = record[field];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function toRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return {};
+    }
+    return value;
+}
+function normalizeInvoiceStatus(value) {
+    if (value === "paid" || value === "settled" || value === "complete") {
+        return "paid";
+    }
+    if (value === "expired") {
+        return "expired";
+    }
+    if (value === "canceled" || value === "cancelled") {
+        return "canceled";
+    }
+    return "created";
+}
+function normalizePaymentStatus(value) {
+    if (value === "succeeded" || value === "paid" || value === "settled" || value === "complete") {
+        return "succeeded";
+    }
+    if (value === "failed" || value === "error") {
+        return "failed";
+    }
+    return "pending";
+}
+function normalizeExpiresAt(value) {
+    if (typeof value === "string" && value.trim().length > 0) {
+        return value;
+    }
+    const seconds = parseInteger(value);
+    if (seconds !== undefined && seconds > 0) {
+        return new Date(seconds * 1_000).toISOString();
+    }
+    return undefined;
+}
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function parseNwcConnectionUri(connectionUri) {
+    if (!connectionUri.startsWith("nwc+http://") && !connectionUri.startsWith("nwc+https://")) {
+        throw new WalletUnavailableError("NWC connection URI must start with nwc+http:// or nwc+https://");
+    }
+    const normalized = connectionUri.replace(/^nwc\+/, "");
+    let endpoint;
+    try {
+        endpoint = new URL(normalized);
+    }
+    catch (error) {
+        throw new WalletUnavailableError(`Invalid NWC connection URI: ${toErrorMessage(error)}`);
+    }
+    if (endpoint.protocol !== "http:" && endpoint.protocol !== "https:") {
+        throw new WalletUnavailableError("NWC endpoint protocol must be http or https");
+    }
+    const token = endpoint.searchParams.get("token") ?? undefined;
+    const endpointDisplay = `${endpoint.origin}${endpoint.pathname}`;
+    return {
+        endpoint,
+        endpointDisplay,
+        ...(token ? { token } : {})
+    };
+}
+export function parseNwcConnectionMetadata(connectionUri) {
+    const parsed = parseNwcConnectionUri(connectionUri);
+    return {
+        endpoint: parsed.endpointDisplay
+    };
+}
+export class NwcWalletAdapter {
+    timeoutMs;
+    endpoint;
+    token;
+    constructor(connectionUri, timeoutMs = DEFAULT_REQUEST_TIMEOUT_MS) {
+        this.timeoutMs = timeoutMs;
+        const parsed = parseNwcConnectionUri(connectionUri);
+        this.endpoint = parsed.endpoint;
+        if (parsed.token) {
+            this.token = parsed.token;
+        }
+    }
+    async createInvoice(input) {
+        const response = await this.callRpc("create_invoice", {
+            amount: input.amountSats,
+            memo: input.memo,
+            expires_at: input.expiresAt
+        }, "createInvoice");
+        const record = toRecord(response);
+        const bolt11 = pickString(record, ["bolt11", "invoice", "payment_request"]);
+        const externalRef = pickString(record, ["external_ref", "payment_hash", "id"]);
+        if (!bolt11 || !externalRef) {
+            throw new InvoiceCreationError("NWC response did not include invoice and external reference");
+        }
+        const expiresAt = normalizeExpiresAt(record.expires_at ?? record.expiresAt);
+        return {
+            bolt11,
+            externalRef,
+            status: normalizeInvoiceStatus(record.status),
+            ...(expiresAt ? { expiresAt } : {})
+        };
+    }
+    async payInvoice(input) {
+        const response = await this.callRpc("pay_invoice", {
+            invoice: input.invoice
+        }, "payInvoice");
+        const record = toRecord(response);
+        const externalRef = pickString(record, ["external_ref", "payment_hash", "id"]);
+        if (!externalRef) {
+            throw new PaymentFailedError("NWC response did not include payment external reference");
+        }
+        const status = normalizePaymentStatus(record.status ?? (record.preimage ? "succeeded" : "pending"));
+        const amountSats = parseInteger(record.amount_sats ?? record.amount) ?? 0;
+        const feeSats = parseInteger(record.fee_sats ?? record.fee_paid ?? record.fee) ?? 0;
+        const failureReason = pickString(record, ["failure_reason", "error", "message"]);
+        if (status === "failed") {
+            throw new PaymentFailedError(failureReason ?? "Payment failed via NWC");
+        }
+        return {
+            externalRef,
+            amountSats,
+            feeSats,
+            status,
+            ...(failureReason ? { failureReason } : {})
+        };
+    }
+    async getInvoiceStatus(externalRef) {
+        const response = await this.callRpc("get_invoice", {
+            external_ref: externalRef
+        }, "getInvoiceStatus");
+        return normalizeInvoiceStatus(toRecord(response).status);
+    }
+    async getPaymentStatus(externalRef) {
+        const response = await this.callRpc("get_payment", {
+            external_ref: externalRef
+        }, "getPaymentStatus");
+        const record = toRecord(response);
+        const status = normalizePaymentStatus(record.status);
+        const feeSats = parseInteger(record.fee_sats ?? record.fee_paid ?? record.fee);
+        const failureReason = pickString(record, ["failure_reason", "error", "message"]);
+        return {
+            status,
+            ...(feeSats !== undefined ? { feeSats } : {}),
+            ...(failureReason ? { failureReason } : {})
+        };
+    }
+    async disconnect() {
+        // HTTP-based adapter has no persistent session to close.
+    }
+    async callRpc(method, params, operation) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const response = await fetch(this.endpoint, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    ...(this.token ? { authorization: `Bearer ${this.token}` } : {})
+                },
+                body: JSON.stringify({
+                    jsonrpc: "2.0",
+                    id: randomUUID(),
+                    method,
+                    params
+                }),
+                signal: controller.signal
+            });
+            if (response.status === 401 || response.status === 403) {
+                throw new WalletAuthError(`Wallet authentication failed during ${operation}`);
+            }
+            if (!response.ok) {
+                throw new WalletUnavailableError(`Wallet provider returned HTTP ${response.status} during ${operation}`);
+            }
+            let payload;
+            try {
+                payload = (await response.json());
+            }
+            catch (error) {
+                throw new WalletUnavailableError(`Wallet provider returned invalid JSON during ${operation}`, {
+                    cause: error
+                });
+            }
+            if (payload && typeof payload === "object" && "error" in payload && payload.error) {
+                const code = payload.error.code;
+                const message = payload.error.message ?? `Wallet provider error during ${operation}`;
+                if (code === 401 || code === 403) {
+                    throw new WalletAuthError(message);
+                }
+                if (operation === "createInvoice") {
+                    throw new InvoiceCreationError(message);
+                }
+                if (operation === "payInvoice") {
+                    throw new PaymentFailedError(message);
+                }
+                throw new WalletUnavailableError(message);
+            }
+            return payload.result;
+        }
+        catch (error) {
+            if (error instanceof WalletAuthError || error instanceof WalletUnavailableError || error instanceof InvoiceCreationError || error instanceof PaymentFailedError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new WalletUnavailableError(`Wallet provider timed out during ${operation}`);
+            }
+            throw new WalletUnavailableError(`Wallet provider request failed during ${operation}: ${toErrorMessage(error)}`);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=nwc-adapter.js.map

package/dist/src/wallet/nwc-adapter.js.map

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

package/dist/src/wallet/service.d.ts

@@ -0,0 +1,42 @@
+import { type Logger } from "../logger.js";
+import type { AutoSettleCandidate, AutoSettleResult, CreateInvoiceInput, CreateInvoiceResult, DaemonWalletStatus, PayInvoiceInput, PayInvoiceResult, PollUpdatesResult, WalletAdapter, WalletLedgerListFilters, WalletStatus } from "./types.js";
+interface WalletServiceOptions {
+    dataDir: string;
+    env?: NodeJS.ProcessEnv;
+    logger?: Logger;
+    requireUnlockOnStart?: boolean;
+    now?: () => string;
+    adapterFactory?: (connectionUri: string) => WalletAdapter;
+}
+export declare class WalletService {
+    private readonly configStore;
+    private readonly env;
+    private readonly logger;
+    private readonly adapterFactory;
+    private readonly now;
+    private runtimeWalletKey;
+    private readonly ledger;
+    private adapterCache;
+    private constructor();
+    static create(options: WalletServiceOptions): Promise<WalletService>;
+    close(): Promise<void>;
+    connect(connectionUri: string): Promise<{
+        status: WalletStatus;
+        endpoint: string;
+    }>;
+    disconnect(): Promise<WalletStatus>;
+    rotateKey(newKeyMaterial: string): Promise<void>;
+    status(): Promise<WalletStatus>;
+    daemonStatus(): Promise<DaemonWalletStatus>;
+    createInvoice(input: CreateInvoiceInput): Promise<CreateInvoiceResult>;
+    payInvoice(input: PayInvoiceInput): Promise<PayInvoiceResult>;
+    listLedger(filters: WalletLedgerListFilters): Promise<unknown[]>;
+    pollUpdates(): Promise<PollUpdatesResult>;
+    attemptAutoSettle(candidate: AutoSettleCandidate): Promise<AutoSettleResult>;
+    setRuntimeKey(keyMaterial: string | null): void;
+    private assertUnlockIfConfigured;
+    private canUnlockConfig;
+    private getUnlockedAdapter;
+    private getWalletKey;
+}
+export {};

package/dist/src/wallet/service.js

@@ -0,0 +1,390 @@
+import { createLogger } from "../logger.js";
+import { InvoiceCreationError, PaymentFailedError, WalletAuthError, WalletUnavailableError } from "../errors.js";
+import { WalletConfigStore, getWalletKeyFromEnv } from "./config-store.js";
+import { WalletLedger } from "./ledger.js";
+import { NwcWalletAdapter, parseNwcConnectionMetadata } from "./nwc-adapter.js";
+import { NostrWalletConnectAdapter, isNostrWalletConnectUri, parseNostrWalletConnectMetadata } from "./nostr-nwc-adapter.js";
+function normalizeUnknownError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function assertPositiveInteger(value, fieldName) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${fieldName} must be a positive integer`);
+    }
+}
+function lightningReferenceDedupeKey(ref) {
+    return `${ref.type}:${ref.network}:${ref.reference}`;
+}
+function parseWalletConnectionMetadata(connectionUri) {
+    if (isNostrWalletConnectUri(connectionUri)) {
+        return parseNostrWalletConnectMetadata(connectionUri);
+    }
+    return parseNwcConnectionMetadata(connectionUri);
+}
+function createWalletAdapterForConnection(connectionUri) {
+    if (isNostrWalletConnectUri(connectionUri)) {
+        return new NostrWalletConnectAdapter(connectionUri);
+    }
+    return new NwcWalletAdapter(connectionUri);
+}
+export class WalletService {
+    configStore;
+    env;
+    logger;
+    adapterFactory;
+    now;
+    runtimeWalletKey = null;
+    ledger;
+    adapterCache = null;
+    constructor(options, ledger) {
+        this.configStore = new WalletConfigStore(options.dataDir);
+        this.ledger = ledger;
+        this.env = options.env ?? process.env;
+        this.logger = options.logger ?? createLogger("error");
+        this.adapterFactory = options.adapterFactory ?? createWalletAdapterForConnection;
+        this.now = options.now ?? (() => new Date().toISOString());
+    }
+    static async create(options) {
+        const ledger = await WalletLedger.create(options.dataDir);
+        const service = new WalletService(options, ledger);
+        if (options.requireUnlockOnStart) {
+            await service.assertUnlockIfConfigured();
+        }
+        return service;
+    }
+    async close() {
+        if (this.adapterCache) {
+            await this.adapterCache.adapter.disconnect();
+            this.adapterCache = null;
+        }
+    }
+    async connect(connectionUri) {
+        const keyMaterial = this.getWalletKey();
+        const metadata = parseWalletConnectionMetadata(connectionUri);
+        await this.configStore.writeConnection({
+            backend: "nwc",
+            network: "bitcoin",
+            connectionUri,
+            endpoint: metadata.endpoint,
+            connectedAt: this.now()
+        }, keyMaterial);
+        if (this.adapterCache) {
+            await this.adapterCache.adapter.disconnect();
+            this.adapterCache = null;
+        }
+        return {
+            status: await this.status(),
+            endpoint: metadata.endpoint
+        };
+    }
+    async disconnect() {
+        if (this.adapterCache) {
+            await this.adapterCache.adapter.disconnect();
+            this.adapterCache = null;
+        }
+        await this.configStore.clearConnection();
+        return this.status();
+    }
+    async rotateKey(newKeyMaterial) {
+        const currentKey = this.getWalletKey();
+        if (newKeyMaterial.trim().length === 0) {
+            throw new WalletAuthError("New wallet key must not be blank");
+        }
+        await this.configStore.rotateKey(currentKey, newKeyMaterial);
+    }
+    async status() {
+        const metadata = await this.configStore.readMetadata();
+        const { pendingInvoices, pendingPayments } = this.ledger.getPendingCounts();
+        if (!metadata) {
+            return {
+                connected: false,
+                backend: "nwc",
+                network: "bitcoin",
+                autoSettleEnabled: false,
+                pendingInvoices,
+                pendingPayments,
+                locked: false
+            };
+        }
+        const locked = !(await this.canUnlockConfig());
+        return {
+            connected: true,
+            backend: "nwc",
+            network: "bitcoin",
+            autoSettleEnabled: !locked,
+            pendingInvoices,
+            pendingPayments,
+            locked
+        };
+    }
+    async daemonStatus() {
+        const status = await this.status();
+        return {
+            connected: status.connected,
+            backend: status.backend,
+            network: status.network,
+            autoSettleEnabled: status.autoSettleEnabled,
+            pendingInvoices: status.pendingInvoices,
+            pendingPayments: status.pendingPayments
+        };
+    }
+    async createInvoice(input) {
+        assertPositiveInteger(input.amountSats, "--amount-sats");
+        const adapter = await this.getUnlockedAdapter();
+        let adapterResult;
+        try {
+            adapterResult = await adapter.createInvoice(input);
+        }
+        catch (error) {
+            if (error instanceof InvoiceCreationError || error instanceof WalletAuthError || error instanceof WalletUnavailableError) {
+                throw error;
+            }
+            throw new InvoiceCreationError(normalizeUnknownError(error).message, { cause: error });
+        }
+        const invoice = await this.ledger.addInvoice({
+            amount: input.amountSats,
+            network: "bitcoin",
+            externalRef: adapterResult.externalRef,
+            bolt11: adapterResult.bolt11,
+            status: adapterResult.status,
+            now: this.now(),
+            ...(input.memo ? { memo: input.memo } : {}),
+            ...(adapterResult.expiresAt ? { expiresAt: adapterResult.expiresAt } : {})
+        });
+        return {
+            invoice,
+            bolt11: adapterResult.bolt11
+        };
+    }
+    async payInvoice(input) {
+        const adapter = await this.getUnlockedAdapter();
+        let adapterResult;
+        try {
+            adapterResult = await adapter.payInvoice(input);
+        }
+        catch (error) {
+            if (error instanceof PaymentFailedError || error instanceof WalletAuthError || error instanceof WalletUnavailableError) {
+                throw error;
+            }
+            throw new PaymentFailedError(normalizeUnknownError(error).message, { cause: error });
+        }
+        const now = this.now();
+        const payment = await this.ledger.addPayment({
+            sourceRef: input.sourceRef ?? input.invoice,
+            amount: adapterResult.amountSats,
+            fee: adapterResult.feeSats,
+            externalRef: adapterResult.externalRef,
+            status: adapterResult.status,
+            now,
+            ...(adapterResult.failureReason ? { failureReason: adapterResult.failureReason } : {})
+        });
+        return {
+            payment
+        };
+    }
+    async listLedger(filters) {
+        return this.ledger.list(filters);
+    }
+    async pollUpdates() {
+        const currentStatus = await this.status();
+        if (!currentStatus.connected || currentStatus.locked) {
+            return { updatedInvoices: 0, updatedPayments: 0 };
+        }
+        const adapter = await this.getUnlockedAdapter();
+        let updatedInvoices = 0;
+        let updatedPayments = 0;
+        for (const invoice of this.ledger.listPendingInvoices()) {
+            try {
+                const nextStatus = await adapter.getInvoiceStatus(invoice.externalRef);
+                if (nextStatus !== invoice.status) {
+                    await this.ledger.transitionInvoice(invoice.id, nextStatus, this.now());
+                    updatedInvoices += 1;
+                }
+            }
+            catch (error) {
+                this.logger.warn("Wallet poll invoice update failed", {
+                    invoiceId: invoice.id,
+                    error: normalizeUnknownError(error).message
+                });
+            }
+        }
+        for (const payment of this.ledger.listPendingPayments()) {
+            try {
+                const next = await adapter.getPaymentStatus(payment.externalRef);
+                if (next.status !== payment.status || next.feeSats !== undefined || next.failureReason !== undefined) {
+                    const transitionOptions = {
+                        ...(next.feeSats !== undefined ? { fee: next.feeSats } : {}),
+                        ...(next.failureReason ? { failureReason: next.failureReason } : {})
+                    };
+                    await this.ledger.transitionPayment(payment.id, next.status, this.now(), {
+                        ...transitionOptions
+                    });
+                    updatedPayments += 1;
+                }
+            }
+            catch (error) {
+                this.logger.warn("Wallet poll payment update failed", {
+                    paymentId: payment.id,
+                    error: normalizeUnknownError(error).message
+                });
+            }
+        }
+        return {
+            updatedInvoices,
+            updatedPayments
+        };
+    }
+    async attemptAutoSettle(candidate) {
+        const status = await this.status();
+        if (!status.connected || status.locked) {
+            return {
+                executed: false,
+                deduped: false,
+                reason: "wallet-unavailable"
+            };
+        }
+        const lightningReference = lightningReferenceDedupeKey(candidate.lightningRef);
+        if (this.ledger.hasAutoSettle(candidate.eventId, lightningReference)) {
+            return {
+                executed: false,
+                deduped: true,
+                reason: "already-settled"
+            };
+        }
+        if (candidate.lightningRef.network !== "bitcoin") {
+            await this.ledger.addAutoSettle({
+                triggerObjectKind: candidate.triggerObjectKind,
+                triggerObjectId: candidate.triggerObjectId,
+                eventId: candidate.eventId,
+                lightningReference,
+                action: "pay-bolt11",
+                result: "skipped",
+                detail: "unsupported-network",
+                createdAt: this.now()
+            });
+            return {
+                executed: true,
+                deduped: false,
+                state: "skipped",
+                reason: "unsupported-network"
+            };
+        }
+        if (candidate.lightningRef.type !== "bolt11") {
+            await this.ledger.addAutoSettle({
+                triggerObjectKind: candidate.triggerObjectKind,
+                triggerObjectId: candidate.triggerObjectId,
+                eventId: candidate.eventId,
+                lightningReference,
+                action: "pay-bolt11",
+                result: "skipped",
+                detail: "unsupported-reference-type",
+                createdAt: this.now()
+            });
+            return {
+                executed: true,
+                deduped: false,
+                state: "skipped",
+                reason: "unsupported-reference-type"
+            };
+        }
+        try {
+            const result = await this.payInvoice({
+                invoice: candidate.lightningRef.reference,
+                sourceRef: `${candidate.triggerObjectKind}:${candidate.triggerObjectId}:${candidate.eventId}`
+            });
+            await this.ledger.addAutoSettle({
+                triggerObjectKind: candidate.triggerObjectKind,
+                triggerObjectId: candidate.triggerObjectId,
+                eventId: candidate.eventId,
+                lightningReference,
+                action: "pay-bolt11",
+                result: "succeeded",
+                paymentId: result.payment.id,
+                createdAt: this.now()
+            });
+            return {
+                executed: true,
+                deduped: false,
+                state: "succeeded",
+                paymentId: result.payment.id
+            };
+        }
+        catch (error) {
+            const message = normalizeUnknownError(error).message;
+            await this.ledger.addAutoSettle({
+                triggerObjectKind: candidate.triggerObjectKind,
+                triggerObjectId: candidate.triggerObjectId,
+                eventId: candidate.eventId,
+                lightningReference,
+                action: "pay-bolt11",
+                result: "failed",
+                detail: message,
+                createdAt: this.now()
+            });
+            return {
+                executed: true,
+                deduped: false,
+                state: "failed",
+                reason: message
+            };
+        }
+    }
+    setRuntimeKey(keyMaterial) {
+        if (keyMaterial === null) {
+            this.runtimeWalletKey = null;
+            return;
+        }
+        const trimmed = keyMaterial.trim();
+        this.runtimeWalletKey = trimmed.length > 0 ? trimmed : null;
+    }
+    async assertUnlockIfConfigured() {
+        const configured = await this.configStore.hasEncryptedConfig();
+        if (!configured) {
+            return;
+        }
+        const key = this.getWalletKey();
+        const config = await this.configStore.readConnection(key);
+        if (!config) {
+            throw new WalletUnavailableError("Wallet config is incomplete");
+        }
+    }
+    async canUnlockConfig() {
+        try {
+            const key = this.getWalletKey();
+            const config = await this.configStore.readConnection(key);
+            return !!config;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getUnlockedAdapter() {
+        const key = this.getWalletKey();
+        const config = await this.configStore.readConnection(key);
+        if (!config) {
+            throw new WalletUnavailableError("No wallet connection is configured");
+        }
+        if (config.backend !== "nwc") {
+            throw new WalletUnavailableError(`Unsupported wallet backend: ${config.backend}`);
+        }
+        if (this.adapterCache && this.adapterCache.connectionUri === config.connectionUri) {
+            return this.adapterCache.adapter;
+        }
+        if (this.adapterCache) {
+            await this.adapterCache.adapter.disconnect();
+        }
+        const adapter = this.adapterFactory(config.connectionUri);
+        this.adapterCache = {
+            connectionUri: config.connectionUri,
+            adapter
+        };
+        return adapter;
+    }
+    getWalletKey() {
+        if (this.runtimeWalletKey) {
+            return this.runtimeWalletKey;
+        }
+        return getWalletKeyFromEnv(this.env);
+    }
+}
+//# sourceMappingURL=service.js.map