@lightninglabs/wavelength-core 0.1.1-rc3 → 0.1.1

package/dist/engine/activity.d.ts

@@ -17,8 +17,15 @@ export declare class ActivityStream {
     });
     start(): void;
     stop(): void;
+    /**
+     * Returns the preimage seen for a payment hash, or undefined. It is the only
+     * route to a settled send's proof of payment; see #preimages.
+     */
+    preimageFor(paymentHash: string): string | undefined;
+    /** Every preimage seen so far, for merging into a refreshed snapshot. */
+    preimages(): ReadonlyMap<string, string>;
     /** Forwarded 'activity' client events; debounced into one onActivity call. */
-    noteActivity(entry: Pick<Entry, 'cursor'>): void;
+    noteActivity(entry: Pick<Entry, 'cursor'> & Partial<Entry>): void;
     /** Forwarded 'activityStream' client events: the stream was lost; reopen. */
     noteStreamLost(): void;
 }

package/dist/engine/activity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/engine/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQ3C;;;;;;GAMG;AACH,qBAAa,cAAc;;gBAmBb,IAAI,EAAE;QAChB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;QACjE,UAAU,EAAE,MAAM,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAChC;IAID,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAaZ,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAI;IAWhD,6EAA6E;IAC7E,cAAc,IAAI,IAAI;CAoEvB"}
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../src/engine/activity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAQ3C;;;;;;GAMG;AACH,qBAAa,cAAc;;gBAmCb,IAAI,EAAE;QAChB,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC;QACjE,UAAU,EAAE,MAAM,IAAI,CAAC;QACvB,WAAW,EAAE,MAAM,IAAI,CAAC;QACxB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAChC;IAID,KAAK,IAAI,IAAI;IAYb,IAAI,IAAI,IAAI;IAcZ;;;OAGG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,yEAAyE;IACzE,SAAS,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;IAIxC,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI;IAkBjE,6EAA6E;IAC7E,cAAc,IAAI,IAAI;CAoEvB"}

package/dist/engine/activity.js

@@ -9,6 +9,22 @@ import { ACTIVITY_DEBOUNCE_MS, STREAM_BACKOFF_CAP_MS, STREAM_BACKOFF_MS, STREAM_
 export class ActivityStream {
     #running = false;
     #cursor = 0;
+    /**
+     * Preimages seen on the stream, keyed by payment hash.
+     *
+     * The daemon reveals a send's preimage exactly once, on the entry it pushes
+     * when the swap settles, and omits it from the list snapshot that every
+     * later refresh reads. Without remembering it here the field is unreachable
+     * through any public API: the stream event is consumed for its cursor and
+     * the body discarded, and the refresh that follows overwrites the entry with
+     * a copy that has none.
+     *
+     * That matters because a preimage is proof of payment, and the only way a
+     * caller can demonstrate to a third party that an invoice was actually
+     * settled. Holding them in memory is enough: they are re-delivered on the
+     * includeExisting replay when a stream reopens.
+     */
+    #preimages = new Map();
     #backoff = STREAM_BACKOFF_MS;
     #failures = 0;
     #lifecycleGeneration = 0;
@@ -41,10 +57,22 @@ export class ActivityStream {
         this.#running = false;
         this.#lifecycleGeneration += 1;
         this.#cursor = 0;
+        this.#preimages.clear();
         clearTimeout(this.#retryTimer);
         clearTimeout(this.#debounce);
         this.#opts.client.stopActivity();
     }
+    /**
+     * Returns the preimage seen for a payment hash, or undefined. It is the only
+     * route to a settled send's proof of payment; see #preimages.
+     */
+    preimageFor(paymentHash) {
+        return this.#preimages.get(paymentHash);
+    }
+    /** Every preimage seen so far, for merging into a refreshed snapshot. */
+    preimages() {
+        return this.#preimages;
+    }
     /** Forwarded 'activity' client events; debounced into one onActivity call. */
     noteActivity(entry) {
         if (!this.#running) {
@@ -53,6 +81,12 @@ export class ActivityStream {
         if (Number.isSafeInteger(entry.cursor) && entry.cursor > this.#cursor) {
             this.#cursor = entry.cursor;
         }
+        // Capture the proof before the body is dropped. This is the only moment
+        // it exists anywhere the SDK can see.
+        const progress = entry.progress;
+        if (progress?.paymentHash && progress.preimage) {
+            this.#preimages.set(progress.paymentHash, progress.preimage);
+        }
         clearTimeout(this.#debounce);
         this.#debounce = setTimeout(() => this.#opts.onActivity(), ACTIVITY_DEBOUNCE_MS);
     }

package/dist/engine/engine.d.ts

@@ -1,16 +1,26 @@
 import type { WavelengthClient } from '../client.ts';
 import type { RuntimeConfig } from '../config.ts';
+import { type WavelengthPerformanceListener } from '../performance.ts';
 import { type ExitBatchEvent, type ExitBatchOptions, type ExitBatchResult } from '../exit.ts';
 import type { CreateWalletRequest, DepositRequest, ExitRequest, ExitStatusRequest, ExitSummaryRequest, GetExitPlanRequest, ListRequest, OpenWalletFromPasskeyRequest, ReceiveRequest, RestoreWalletRequest, SendRequest, SweepWalletRequest, UnlockWalletRequest } from '../requests.ts';
-import type { CreateWalletResult, DepositResult, ExitResult, ExitStatusResult, ExitSummaryResult, GetExitPlanResult, ListResult, OpenWalletFromPasskeyResult, PrepareSendResult, ReceiveResult, SendResult, SweepWalletResult, UnlockWalletResult } from '../results.ts';
+import type { CreateWalletResult, DepositResult, Entry, ExitResult, ExitStatusResult, ExitSummaryResult, GetExitPlanResult, ListResult, OpenWalletFromPasskeyResult, PrepareSendResult, ReceiveResult, SendResult, SweepWalletResult, UnlockWalletResult } from '../results.ts';
 import { type WalletInfo } from '../state.ts';
 import type { WalletSnapshot } from './snapshot.ts';
+/** The instrumentation options every arm of {@link WalletEngineOptions} shares. */
+type WalletEnginePerformanceOptions = {
+    /**
+     * Receives structured timing samples for runtime readiness, wallet
+     * create/open RPCs, post-operation info adoption, and sync polling. Omit it
+     * to keep performance instrumentation disabled.
+     */
+    onPerformance?: WavelengthPerformanceListener;
+};
 /**
  * Options for {@link createWalletEngine}. A discriminated union: the type
  * requires config when autoStart is true, so autoStart cannot be set without
  * a config to start from.
  */
-export type WalletEngineOptions = {
+export type WalletEngineOptions = WalletEnginePerformanceOptions & ({
     /** The transport client the engine drives. */
     client: WavelengthClient;
     /** Default runtime config used by autoStart and by start() with no argument. */
@@ -24,7 +34,7 @@ export type WalletEngineOptions = {
     config?: RuntimeConfig;
     /** Start the runtime automatically once it is ready. Requires config; omit or set false when config is unset. */
     autoStart?: false;
-};
+});
 /**
  * Removes a key from every arm of a union type. TypeScript's built-in Omit
  * does not distribute over unions (it flattens to the union of all keys
@@ -117,4 +127,18 @@ export interface WalletEngine {
 }
 /** Creates a {@link WalletEngine} over any transport client. */
 export declare function createWalletEngine(options: WalletEngineOptions): WalletEngine;
+/**
+ * Puts back the preimages the list snapshot drops.
+ *
+ * The daemon reveals a send's preimage once, on the stream entry it pushes at
+ * settle, and never again: every list read returns the entry with the field
+ * empty. So a refresh would otherwise erase proof of payment that the SDK had
+ * already seen, and a caller who blinked would have no way to get it back.
+ *
+ * Entries that already carry a preimage, or for which none was ever seen, are
+ * returned untouched, so this allocates nothing in the ordinary case and never
+ * invents a value it was not given.
+ */
+export declare function restorePreimages(entries: readonly Entry[], preimages: ReadonlyMap<string, string>): Entry[];
+export {};
 //# sourceMappingURL=engine.d.ts.map

package/dist/engine/engine.d.ts.map

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

package/dist/engine/engine.js

@@ -1,4 +1,5 @@
 import { toError } from "../errors.js";
+import { performanceNow, reportPerformance, } from "../performance.js";
 import { exitBatch as runExitBatch, } from "../exit.js";
 import { WalletState } from "../state.js";
 import { ActivityStream } from "./activity.js";
@@ -16,6 +17,7 @@ class WavelengthEngine {
     client;
     #store = new SnapshotStore();
     #config;
+    #onPerformance;
     #disposed = false;
     // Counts stops the host asked for, so a start that rejects afterwards can
     // tell an intentional shutdown from a runtime that died underneath it.
@@ -30,12 +32,15 @@ class WavelengthEngine {
     #reconciler;
     #syncPoller;
     #restorePoller;
+    #syncStartedAt;
+    #syncTicks = 0;
     // The pending restore promise, settled exactly once at usability (resolve)
     // or wallet-down failure (reject).
     #restore;
     constructor(options) {
         this.client = options.client;
         this.#config = options.config;
+        this.#onPerformance = options.onPerformance;
         this.#stream = new ActivityStream({
             client: this.client,
             onActivity: () => this.#reconciler.trigger(),
@@ -57,7 +62,10 @@ class WavelengthEngine {
         this.#syncPoller = new Poller({
             intervalMs: SYNC_POLL_MS,
             failureLimit: SYNC_POLL_FAILURE_LIMIT,
-            tick: () => this.refresh(),
+            tick: () => {
+                this.#syncTicks += 1;
+                return this.refresh();
+            },
             onExhausted: (err) => {
                 // A poller tick already in flight when the poller stops can resolve
                 // after the phase has left 'syncing', so only dispatch while the
@@ -73,7 +81,17 @@ class WavelengthEngine {
             immediate: true,
             tick: () => this.#restoreTick(),
         });
+        const readyStartedAt = this.#onPerformance
+            ? performanceNow()
+            : undefined;
         this.client.ready().then(() => {
+            if (readyStartedAt !== undefined) {
+                reportPerformance(this.#onPerformance, {
+                    stage: 'runtime',
+                    phase: 'clientReady',
+                    durationMs: performanceNow() - readyStartedAt,
+                });
+            }
             if (this.#disposed) {
                 return;
             }
@@ -84,6 +102,14 @@ class WavelengthEngine {
                 void this.start().catch(() => undefined);
             }
         }, (err) => {
+            if (readyStartedAt !== undefined) {
+                reportPerformance(this.#onPerformance, {
+                    stage: 'runtime',
+                    phase: 'clientReady',
+                    durationMs: performanceNow() - readyStartedAt,
+                    detail: { outcome: 'error' },
+                });
+            }
             if (!this.#disposed) {
                 this.#dispatch({ type: 'runtimeFailed' }, { error: toError(err) });
             }
@@ -184,10 +210,12 @@ class WavelengthEngine {
     }
     async createWallet(req) {
         this.#assertNotDisposed();
-        const result = await this.client.createWallet(req);
-        await this.#adoptInfo();
-        this.#kickRefresh();
-        return result;
+        return this.#measureWallet('createTotal', async () => {
+            const result = await this.#measureWallet('createRpc', () => this.client.createWallet(req));
+            await this.#adoptInfo('create');
+            this.#kickRefresh();
+            return result;
+        });
     }
     restoreWallet(req) {
         // A restore with server-assisted recovery blocks createWallet for the
@@ -281,17 +309,21 @@ class WavelengthEngine {
     }
     async unlockWallet(req) {
         this.#assertNotDisposed();
-        const result = await this.client.unlockWallet(req);
-        await this.#adoptInfo();
-        this.#kickRefresh();
-        return result;
+        return this.#measureWallet('unlockTotal', async () => {
+            const result = await this.#measureWallet('unlockRpc', () => this.client.unlockWallet(req));
+            await this.#adoptInfo('unlock');
+            this.#kickRefresh();
+            return result;
+        });
     }
     async openWalletFromPasskey(req) {
         this.#assertNotDisposed();
-        const result = await this.client.openWalletFromPasskey(req);
-        await this.#adoptInfo();
-        this.#kickRefresh();
-        return result;
+        return this.#measureWallet('passkeyOpenTotal', async () => {
+            const result = await this.#measureWallet('passkeyOpenRpc', () => this.client.openWalletFromPasskey(req));
+            await this.#adoptInfo('passkeyOpen');
+            this.#kickRefresh();
+            return result;
+        });
     }
     async deposit(req = {}) {
         this.#assertNotDisposed();
@@ -366,7 +398,17 @@ class WavelengthEngine {
     list(req) {
         this.#assertNotDisposed();
         // Listing reads state, so nothing to refresh.
-        return this.client.list(req);
+        return this.client.list(req).then((result) => {
+            if (!result.activity)
+                return result;
+            return {
+                ...result,
+                activity: {
+                    ...result.activity,
+                    entries: restorePreimages(result.activity.entries, this.#stream.preimages()),
+                },
+            };
+        });
     }
     clearLogs() {
         this.#store.update({ logs: [] });
@@ -424,10 +466,24 @@ class WavelengthEngine {
             this.#reconciler.cancel();
         }
         if (phase === 'syncing') {
+            if (this.#syncStartedAt === undefined && this.#onPerformance) {
+                this.#syncStartedAt = performanceNow();
+                this.#syncTicks = 0;
+            }
             this.#syncPoller.start();
         }
         else {
             this.#syncPoller.stop();
+            if (this.#syncStartedAt !== undefined) {
+                reportPerformance(this.#onPerformance, {
+                    stage: 'wallet',
+                    phase: 'sync',
+                    durationMs: performanceNow() - this.#syncStartedAt,
+                    detail: { ticks: this.#syncTicks, outcome: phase },
+                });
+                this.#syncStartedAt = undefined;
+                this.#syncTicks = 0;
+            }
         }
         if (phase === 'restoring') {
             this.#restorePoller.start();
@@ -454,7 +510,7 @@ class WavelengthEngine {
         if (snap.phase === 'stopping' || snap.phase === 'stopped') {
             return snap.balance;
         }
-        const entries = rows.activity?.entries || [];
+        const entries = restorePreimages(rows.activity?.entries || [], this.#stream.preimages());
         const nextInfo = stabilize(snap.info, info);
         const nextBalance = stabilize(snap.balance, balance);
         const nextActivity = stabilize(snap.activity, entries);
@@ -468,24 +524,52 @@ class WavelengthEngine {
     // every attempt fails the daemon is presumed gone: escalate via
     // walletAdoptionFailed rather than silently leaving the wallet stuck
     // without info.
-    async #adoptInfo() {
+    async #adoptInfo(operation) {
+        const startedAt = this.#onPerformance ? performanceNow() : undefined;
+        let attempts = 0;
+        let retryWaitMs = 0;
+        let adopted = false;
         for (let attempt = 0; attempt < ADOPT_INFO_RETRIES; attempt++) {
             if (this.#disposed) {
-                return null;
+                break;
             }
+            attempts += 1;
             try {
                 const info = await this.client.getInfo();
                 this.#dispatch({ type: 'infoReceived', info }, { info });
+                adopted = true;
+                if (startedAt !== undefined) {
+                    reportPerformance(this.#onPerformance, {
+                        stage: 'wallet',
+                        phase: 'adoptInfo',
+                        durationMs: performanceNow() - startedAt,
+                        detail: { operation, attempts, retryWaitMs, outcome: 'success' },
+                    });
+                }
                 return info;
             }
             catch {
                 if (attempt < ADOPT_INFO_RETRIES - 1) {
+                    retryWaitMs += ADOPT_INFO_RETRY_MS;
                     await new Promise((resolve) => {
                         setTimeout(resolve, ADOPT_INFO_RETRY_MS);
                     });
                 }
             }
         }
+        if (startedAt !== undefined && !adopted) {
+            reportPerformance(this.#onPerformance, {
+                stage: 'wallet',
+                phase: 'adoptInfo',
+                durationMs: performanceNow() - startedAt,
+                detail: {
+                    operation,
+                    attempts,
+                    retryWaitMs,
+                    outcome: this.#disposed ? 'disposed' : 'exhausted',
+                },
+            });
+        }
         if (!this.#disposed) {
             this.#dispatch({ type: 'walletAdoptionFailed' }, {
                 error: new Error('the wallet was created but the daemon stopped responding'),
@@ -493,6 +577,28 @@ class WavelengthEngine {
         }
         return null;
     }
+    async #measureWallet(phase, task) {
+        if (!this.#onPerformance) {
+            return task();
+        }
+        const startedAt = performanceNow();
+        let outcome = 'success';
+        try {
+            return await task();
+        }
+        catch (err) {
+            outcome = 'error';
+            throw err;
+        }
+        finally {
+            reportPerformance(this.#onPerformance, {
+                stage: 'wallet',
+                phase,
+                durationMs: performanceNow() - startedAt,
+                detail: { outcome },
+            });
+        }
+    }
     // Serialized background refresh with a consecutive-failure budget. Below
     // the limit failures stay engine-internal; at the limit the phase escalates
     // so a dead daemon cannot hide behind a healthy-looking ready wallet.
@@ -582,3 +688,31 @@ class WavelengthEngine {
         this.#rejectRestore(new Error('the runtime stopped during the restore'));
     }
 }
+/**
+ * Puts back the preimages the list snapshot drops.
+ *
+ * The daemon reveals a send's preimage once, on the stream entry it pushes at
+ * settle, and never again: every list read returns the entry with the field
+ * empty. So a refresh would otherwise erase proof of payment that the SDK had
+ * already seen, and a caller who blinked would have no way to get it back.
+ *
+ * Entries that already carry a preimage, or for which none was ever seen, are
+ * returned untouched, so this allocates nothing in the ordinary case and never
+ * invents a value it was not given.
+ */
+export function restorePreimages(entries, preimages) {
+    if (preimages.size === 0) {
+        return entries;
+    }
+    return entries.map((entry) => {
+        const progress = entry.progress;
+        if (!progress?.paymentHash || progress.preimage) {
+            return entry;
+        }
+        const preimage = preimages.get(progress.paymentHash);
+        if (preimage === undefined) {
+            return entry;
+        }
+        return { ...entry, progress: { ...progress, preimage } };
+    });
+}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export type { ActivityStreamPayload, ActivityStreamState, WavelengthEvent, WavelengthEventType, WavelengthListener, WavelengthLogLevel, WavelengthLogPayload, } from './events.ts';
+export type { WavelengthPerformanceEvent, WavelengthPerformanceListener, } from './performance.ts';
 export { DEBUG_LEVELS, networkDefaults, validateRuntimeConfig, } from './config.ts';
 export type { DebugLevel, Network, PresetNetwork, RuntimeConfig, } from './config.ts';
 export { WalletState, normalizeInfo, phaseFromInfo, walletStateFromProto } from './state.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC7F,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,4BAA4B,EAC5B,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,YAAY,EACV,YAAY,EACZ,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,KAAK,EACL,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,QAAQ,EACR,uBAAuB,EACvB,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,2BAA2B,EAC3B,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,kCAAkC,EAClC,qCAAqC,EACrC,mCAAmC,EACnC,wCAAwC,EACxC,yCAAyC,EACzC,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,iCAAiC,EACjC,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EACL,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC3E,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAIxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/performance.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A structured timing sample emitted by an opt-in Wavelength performance
+ * reporter. Stage identifies the broad subsystem and phase identifies the
+ * measured boundary within it.
+ */
+export type WavelengthPerformanceEvent = {
+    /** Broad subsystem being measured, such as runtime, wallet, or passkey. */
+    stage: 'runtime' | 'wallet' | 'passkey';
+    /** Stable name of the measured operation within the stage. */
+    phase: string;
+    /** Elapsed wall-clock time in milliseconds. */
+    durationMs: number;
+    /** Extra low-cardinality context for interpreting the sample. */
+    detail?: Record<string, string | number | boolean>;
+};
+/** Receives opt-in structured Wavelength performance samples. */
+export type WavelengthPerformanceListener = (event: WavelengthPerformanceEvent) => void;
+/** Returns a monotonic timestamp when available. */
+export declare function performanceNow(): number;
+/**
+ * Delivers a timing sample without allowing diagnostics to break wallet
+ * behavior when a host reporter throws.
+ */
+export declare function reportPerformance(listener: WavelengthPerformanceListener | undefined, event: WavelengthPerformanceEvent): void;
+//# sourceMappingURL=performance.d.ts.map

package/dist/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../src/performance.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC,2EAA2E;IAC3E,KAAK,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,6BAA6B,GAAG,CAC1C,KAAK,EAAE,0BAA0B,KAC9B,IAAI,CAAC;AAEV,oDAAoD;AACpD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,6BAA6B,GAAG,SAAS,EACnD,KAAK,EAAE,0BAA0B,GAChC,IAAI,CAUN"}

package/dist/performance.js

@@ -0,0 +1,19 @@
+/** Returns a monotonic timestamp when available. */
+export function performanceNow() {
+    return globalThis.performance?.now?.() ?? Date.now();
+}
+/**
+ * Delivers a timing sample without allowing diagnostics to break wallet
+ * behavior when a host reporter throws.
+ */
+export function reportPerformance(listener, event) {
+    if (!listener) {
+        return;
+    }
+    try {
+        listener(event);
+    }
+    catch {
+        // Performance reporting is diagnostic and must never break wallet work.
+    }
+}

package/dist/version.d.ts

@@ -14,5 +14,5 @@
  * scripts/runtime-version.mjs, so keep the declaration in this exact
  * single-quoted literal form.
  */
-export declare const RUNTIME_MANIFEST_VERSION = "v0.1.1-rc3";
+export declare const RUNTIME_MANIFEST_VERSION = "v0.1.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,eAAe,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,WAAW,CAAC"}

package/dist/version.js

@@ -14,4 +14,4 @@
  * scripts/runtime-version.mjs, so keep the declaration in this exact
  * single-quoted literal form.
  */
-export const RUNTIME_MANIFEST_VERSION = 'v0.1.1-rc3';
+export const RUNTIME_MANIFEST_VERSION = 'v0.1.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightninglabs/wavelength-core",
-  "version": "0.1.1-rc3",
+  "version": "0.1.1",
   "private": false,
   "description": "Transport- and framework-agnostic contract for the Wavelength self-custodial Lightning wallet SDK.",
   "license": "MIT",