@shroud-fi/scanning 0.1.0

package/dist/cjs/detector.js

@@ -0,0 +1,425 @@
+"use strict";
+// Stealth-payment detector — orchestrates view-tag prefilter, ECDH recovery,
+// finality gating, dedup, and reconciliation backfill.
+//
+// Privacy contract (binding — enforced by tests):
+//   - No console.* anywhere in this file.
+//   - No error message embeds key material, ephemeral pubkey bytes, or stealth
+//     private key. Short structured tags only ("verify failed", "backend
+//     unreachable").
+//   - No JSON.stringify of keys, raw announcements, or RawAnnouncement.metadata.
+//   - The recovered stealth private key only surfaces via the explicit return
+//     value DetectedPayment.stealthPrivateKey — never logged.
+//   - Backpressure note: the live watch() queue is unbounded by design for v1.
+//     A consumer that ignores yields will see memory grow; document if surfaces.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScanner = createScanner;
+const viem_1 = require("viem");
+const accounts_1 = require("viem/accounts");
+const core_1 = require("@shroud-fi/core");
+const transport_1 = require("@shroud-fi/transport");
+const constants_js_1 = require("./constants.js");
+const cursor_js_1 = require("./cursor.js");
+const dedup_js_1 = require("./dedup.js");
+const errors_js_1 = require("./errors.js");
+const viem_backend_js_1 = require("./viem-backend.js");
+/**
+ * Build a Scanner instance.
+ *
+ * Construction validates config + resolves defaults. The Scanner is inert until
+ * the caller starts iterating watch() or scanRange(). close() is idempotent.
+ */
+function createScanner(config) {
+    if (config.transport === undefined || config.transport.publicClient === undefined) {
+        throw new errors_js_1.MissingPublicClientError();
+    }
+    if (config.startBlock < 0n) {
+        throw new errors_js_1.ScanningError('startBlock must be non-negative');
+    }
+    const schemeId = config.schemeId ?? constants_js_1.DEFAULT_SCHEME_ID;
+    const finality = config.finality ?? constants_js_1.DEFAULT_FINALITY;
+    const reconcileIntervalMs = config.reconcileIntervalMs ?? constants_js_1.DEFAULT_RECONCILE_INTERVAL_MS;
+    const dedupCapacity = config.dedupCapacity ?? constants_js_1.DEFAULT_DEDUP_CAPACITY;
+    const getLogsChunkSize = config.getLogsChunkSize ?? constants_js_1.DEFAULT_GETLOGS_CHUNK_SIZE;
+    const contractAddress = config.contractAddress ?? transport_1.ERC5564_ANNOUNCER;
+    const backend = config.backend ??
+        new viem_backend_js_1.ViemScannerBackend(config.transport.publicClient, {
+            getLogsChunkSize,
+        });
+    const dedup = new dedup_js_1.LRUDeduper(dedupCapacity);
+    const cursor = new cursor_js_1.Cursor(config.startBlock);
+    const pendingFinality = new Map();
+    let reconcileTimer;
+    let unsubscribe;
+    let closed = false;
+    // Reject concurrent watch() calls. The closure singletons above can hold at
+    // most one live subscription + timer; a second watch() would silently leak
+    // the first iterator's resources. Caller must close() before re-watching.
+    let watchActive = false;
+    // Cap pending events so a stuck backend can't grow memory unboundedly.
+    const pendingCap = Math.max(dedupCapacity, 100);
+    // ---- Verification pipeline ----------------------------------------------
+    /**
+     * Run view-tag prefilter + ECDH derivation + address-match check against
+     * a raw announcement. Returns recovered stealth private key bytes on match,
+     * or null when the announcement is not for this recipient (or is malformed).
+     * Never throws — returning null is the privacy-preserving signal.
+     */
+    function verifyAnnouncement(raw) {
+        // Defence: metadata too short to even contain a view tag.
+        if (raw.metadata.length < constants_js_1.MIN_METADATA_LENGTH)
+            return null;
+        const viewTag = raw.metadata[0];
+        // Fast-path filter — drops ~99.6% of non-matching announcements.
+        let viewTagMatch;
+        try {
+            viewTagMatch = (0, core_1.checkViewTag)(config.scanningKey, raw.ephemeralPubKey, viewTag);
+        }
+        catch {
+            // Garbage ephemeral pubkey — drop silently.
+            return null;
+        }
+        if (!viewTagMatch)
+            return null;
+        // ECDH derivation of stealth private key.
+        let stealthPriv;
+        try {
+            stealthPriv = (0, core_1.computeStealthKey)(config.scanningKey, config.spendingKey, raw.ephemeralPubKey);
+        }
+        catch (err) {
+            if (err instanceof core_1.InvalidKeyError || err instanceof core_1.StealthAddressError) {
+                return null;
+            }
+            // Re-wrap unknown failure with a privacy-safe message.
+            throw new errors_js_1.ScanningError('verify failed');
+        }
+        // Address-match check — guards against view-tag false positives and any
+        // log unrelated to this recipient.
+        let derivedAddress;
+        try {
+            const stealthPrivHex = (0, viem_1.bytesToHex)(stealthPriv);
+            derivedAddress = (0, accounts_1.privateKeyToAccount)(stealthPrivHex).address;
+        }
+        catch {
+            return null;
+        }
+        if (derivedAddress.toLowerCase() !== raw.stealthAddress.toLowerCase()) {
+            return null;
+        }
+        return stealthPriv;
+    }
+    function dedupKey(raw) {
+        return `${raw.txHash}:${raw.logIndex}`;
+    }
+    function toDetected(raw, stealthPriv, payloadFinality) {
+        return {
+            stealthAddress: raw.stealthAddress,
+            ephemeralPubKey: (0, viem_1.bytesToHex)(raw.ephemeralPubKey),
+            stealthPrivateKey: (0, viem_1.bytesToHex)(stealthPriv),
+            blockNumber: raw.blockNumber,
+            blockHash: raw.blockHash,
+            txHash: raw.txHash,
+            logIndex: raw.logIndex,
+            finality: payloadFinality,
+        };
+    }
+    // The configured `finality` is 'unsafe' | 'safe' | 'finalized', but the
+    // emitted DetectedPayment.finality is only 'safe' | 'finalized'. Treat
+    // 'unsafe' as 'safe' on the emit path (caller asked for no gating; we still
+    // tag what we yield as the safer label).
+    const emitFinality = finality === 'finalized' ? 'finalized' : 'safe';
+    // ---- watch() ------------------------------------------------------------
+    function watch(signal) {
+        return {
+            [Symbol.asyncIterator]: () => {
+                if (watchActive) {
+                    // Surface as a rejecting first next() so callers learn via the
+                    // async-iterator protocol instead of a sync throw from `for await`.
+                    return {
+                        next: () => Promise.reject(new errors_js_1.ScanningError('watch already active — close() first')),
+                        return: () => Promise.resolve({ value: undefined, done: true }),
+                    };
+                }
+                watchActive = true;
+                const queue = [];
+                let waiter;
+                let finished = false;
+                let abortListener;
+                function finish() {
+                    if (finished)
+                        return;
+                    finished = true;
+                    if (waiter !== undefined) {
+                        const w = waiter;
+                        waiter = undefined;
+                        w.resolve({ value: undefined, done: true });
+                    }
+                }
+                function emit(payment) {
+                    if (finished)
+                        return;
+                    if (waiter !== undefined) {
+                        const w = waiter;
+                        waiter = undefined;
+                        w.resolve({ value: payment, done: false });
+                        return;
+                    }
+                    queue.push(payment);
+                }
+                async function tryEmitOrDefer(raw) {
+                    const key = dedupKey(raw);
+                    // Two-tier dedup: emitted (LRU) + in-flight pending. Skip duplicates
+                    // arriving while the first delivery is still mid-pipeline.
+                    if (dedup.has(key) || pendingFinality.has(key))
+                        return;
+                    const stealthPriv = verifyAnnouncement(raw);
+                    if (stealthPriv === null)
+                        return;
+                    let tip;
+                    try {
+                        tip = await backend.getLatestBlock(finality);
+                    }
+                    catch {
+                        // Backend transient failure — keep the candidate around for the
+                        // next reconciliation tick. Do not throw into the consumer stream.
+                        pendingFinality.set(key, raw);
+                        return;
+                    }
+                    if (raw.blockNumber > tip) {
+                        // Cap pending map to prevent unbounded growth on stuck finality.
+                        if (pendingFinality.size >= pendingCap) {
+                            const oldest = pendingFinality.keys().next().value;
+                            if (oldest !== undefined)
+                                pendingFinality.delete(oldest);
+                        }
+                        pendingFinality.set(key, raw);
+                        return;
+                    }
+                    // Race guard: if a concurrent path already added this key (e.g. the
+                    // same announcement was delivered twice and both passed the initial
+                    // has() check before either reached this point), drop the dup.
+                    if (!dedup.add(key))
+                        return;
+                    pendingFinality.delete(key);
+                    emit(toDetected(raw, stealthPriv, emitFinality));
+                }
+                // Already-aborted: bail before touching the backend.
+                if (signal?.aborted === true) {
+                    finished = true;
+                    return {
+                        next: () => Promise.resolve({ value: undefined, done: true }),
+                        return: () => Promise.resolve({ value: undefined, done: true }),
+                    };
+                }
+                // Subscribe to live announcements.
+                try {
+                    unsubscribe = backend.watchAnnouncements((raw) => {
+                        if (finished || closed)
+                            return;
+                        // Fire-and-forget per backend contract.
+                        void tryEmitOrDefer(raw).catch(() => {
+                            // Swallow — never let pipeline errors crash the watcher.
+                        });
+                    }, { contractAddress, schemeId });
+                }
+                catch {
+                    // If subscription fails outright, surface a privacy-safe error on
+                    // the first next() and shut down.
+                    finished = true;
+                    return {
+                        next: () => Promise.reject(new errors_js_1.BackendUnreachableError('watch subscribe failed')),
+                        return: () => Promise.resolve({ value: undefined, done: true }),
+                    };
+                }
+                // Reconciliation tick — backfill missed blocks + re-check pending.
+                const timer = setInterval(() => {
+                    void reconcileOnce().catch(() => {
+                        // Never throw out of the interval.
+                    });
+                }, reconcileIntervalMs);
+                // Don't keep the Node event loop alive solely on this timer.
+                if (typeof timer.unref === 'function') {
+                    timer.unref();
+                }
+                reconcileTimer = timer;
+                async function reconcileOnce() {
+                    if (finished || closed)
+                        return;
+                    // Phase 1: backfill any blocks between cursor and current tip.
+                    let tip;
+                    try {
+                        tip = await backend.getLatestBlock(finality);
+                    }
+                    catch {
+                        return; // Skip this tick — try again later.
+                    }
+                    const from = cursor.last + 1n;
+                    if (tip >= from) {
+                        let logs = [];
+                        try {
+                            logs = await backend.getAnnouncementsInRange(from, tip, {
+                                contractAddress,
+                                schemeId,
+                            });
+                        }
+                        catch {
+                            // Leave cursor alone — try again next tick.
+                            return;
+                        }
+                        for (const raw of logs) {
+                            if (finished || closed)
+                                return;
+                            const key = dedupKey(raw);
+                            if (dedup.has(key))
+                                continue;
+                            const stealthPriv = verifyAnnouncement(raw);
+                            if (stealthPriv === null)
+                                continue;
+                            if (!dedup.add(key))
+                                continue;
+                            pendingFinality.delete(key);
+                            emit(toDetected(raw, stealthPriv, emitFinality));
+                        }
+                        // Re-check after the loop: close() may have run mid-iteration.
+                        if (finished || closed)
+                            return;
+                        cursor.advanceTo(tip);
+                    }
+                    // Phase 2: re-check pending announcements that had not finalized.
+                    if (pendingFinality.size > 0) {
+                        for (const [key, raw] of Array.from(pendingFinality.entries())) {
+                            if (finished || closed)
+                                return;
+                            if (raw.blockNumber <= tip) {
+                                pendingFinality.delete(key);
+                                if (dedup.has(key))
+                                    continue;
+                                const stealthPriv = verifyAnnouncement(raw);
+                                if (stealthPriv === null)
+                                    continue;
+                                if (!dedup.add(key))
+                                    continue;
+                                emit(toDetected(raw, stealthPriv, emitFinality));
+                            }
+                        }
+                    }
+                }
+                // Wire abort. Listener handle retained so we can remove it on return().
+                if (signal !== undefined) {
+                    abortListener = () => {
+                        finish();
+                        close();
+                    };
+                    signal.addEventListener('abort', abortListener, { once: true });
+                }
+                function teardown() {
+                    if (signal !== undefined && abortListener !== undefined) {
+                        try {
+                            signal.removeEventListener('abort', abortListener);
+                        }
+                        catch {
+                            // Some environments swallow this; safe to ignore.
+                        }
+                        abortListener = undefined;
+                    }
+                    watchActive = false;
+                }
+                return {
+                    next() {
+                        // queue.length and waiter assignment are both synchronous within
+                        // this tick — no interleaving window exists between the empty
+                        // check and the executor body. emit() will see `waiter` set by
+                        // the time it can fire (next microtask).
+                        if (queue.length > 0) {
+                            const value = queue.shift();
+                            return Promise.resolve({ value, done: false });
+                        }
+                        if (finished) {
+                            return Promise.resolve({ value: undefined, done: true });
+                        }
+                        return new Promise((resolve) => {
+                            waiter = { resolve };
+                        });
+                    },
+                    return() {
+                        finish();
+                        teardown();
+                        close();
+                        return Promise.resolve({ value: undefined, done: true });
+                    },
+                    throw() {
+                        finish();
+                        teardown();
+                        close();
+                        return Promise.resolve({ value: undefined, done: true });
+                    },
+                };
+            },
+        };
+    }
+    // ---- scanRange() --------------------------------------------------------
+    function scanRange(fromBlock, toBlock, signal) {
+        return {
+            [Symbol.asyncIterator]: async function* () {
+                if (signal !== undefined && signal.aborted)
+                    return;
+                if (toBlock < fromBlock)
+                    return;
+                let logs;
+                try {
+                    logs = await backend.getAnnouncementsInRange(fromBlock, toBlock, {
+                        contractAddress,
+                        schemeId,
+                    });
+                }
+                catch {
+                    throw new errors_js_1.BackendUnreachableError('getLogs failed');
+                }
+                // Sort deterministically by (blockNumber, logIndex).
+                const sorted = [...logs].sort((a, b) => {
+                    if (a.blockNumber === b.blockNumber) {
+                        return a.logIndex - b.logIndex;
+                    }
+                    return a.blockNumber < b.blockNumber ? -1 : 1;
+                });
+                for (const raw of sorted) {
+                    if (signal !== undefined && signal.aborted)
+                        return;
+                    const key = dedupKey(raw);
+                    if (dedup.has(key))
+                        continue;
+                    const stealthPriv = verifyAnnouncement(raw);
+                    if (stealthPriv === null)
+                        continue;
+                    if (!dedup.add(key))
+                        continue;
+                    // Caller invoked a historical range — finality is achieved.
+                    yield toDetected(raw, stealthPriv, 'safe');
+                }
+            },
+        };
+    }
+    // ---- close() ------------------------------------------------------------
+    function close() {
+        if (closed)
+            return;
+        closed = true;
+        if (unsubscribe !== undefined) {
+            try {
+                unsubscribe();
+            }
+            catch {
+                // Swallow — close must not throw.
+            }
+            unsubscribe = undefined;
+        }
+        if (reconcileTimer !== undefined) {
+            clearInterval(reconcileTimer);
+            reconcileTimer = undefined;
+        }
+        // Reset re-entry guard so close() + new watch() works.
+        watchActive = false;
+    }
+    return { watch, scanRange, close };
+}
+//# sourceMappingURL=detector.js.map

package/dist/cjs/detector.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,21 @@
+export declare class ScanningError extends Error {
+    readonly name: string;
+    constructor(message: string);
+}
+export declare class BackendUnreachableError extends ScanningError {
+    readonly name: string;
+    constructor(reason: string);
+}
+export declare class MalformedAnnouncementError extends ScanningError {
+    readonly name: string;
+    constructor(reason: string);
+}
+export declare class MissingPublicClientError extends ScanningError {
+    readonly name: string;
+    constructor();
+}
+export declare class InvalidFinalityLevelError extends ScanningError {
+    readonly name: string;
+    constructor(level: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAWA,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,EAAE,MAAM,CAAmB;gBACrC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,SAAkB,IAAI,EAAE,MAAM,CAA6B;gBAC/C,MAAM,EAAE,MAAM;CAG3B;AAED,qBAAa,0BAA2B,SAAQ,aAAa;IAC3D,SAAkB,IAAI,EAAE,MAAM,CAAgC;gBAClD,MAAM,EAAE,MAAM;CAG3B;AAED,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,SAAkB,IAAI,EAAE,MAAM,CAA8B;;CAI7D;AAED,qBAAa,yBAA0B,SAAQ,aAAa;IAC1D,SAAkB,IAAI,EAAE,MAAM,CAA+B;gBACjD,KAAK,EAAE,MAAM;CAG1B"}

package/dist/cjs/errors.js

@@ -0,0 +1,49 @@
+"use strict";
+// Privacy-safe error classes for @shroud-fi/scanning.
+//
+// Invariants enforced by tests in test/privacy-invariants.test.ts:
+//   - Error messages MUST NOT embed any 32-byte hex (key material, txHash is
+//     allowed but should not be the whole error payload).
+//   - Error messages MUST NOT embed ephemeral pubkey bytes.
+//   - Error messages MUST NOT embed transfer amounts.
+//   - Constructors take only short, structured tags (chainId, block, logIndex,
+//     short reason). The thrown error gets its full stack from V8; we don't
+//     attach extra fields.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidFinalityLevelError = exports.MissingPublicClientError = exports.MalformedAnnouncementError = exports.BackendUnreachableError = exports.ScanningError = void 0;
+class ScanningError extends Error {
+    name = 'ScanningError';
+    constructor(message) {
+        super(message);
+    }
+}
+exports.ScanningError = ScanningError;
+class BackendUnreachableError extends ScanningError {
+    name = 'BackendUnreachableError';
+    constructor(reason) {
+        super(`Scanner backend unreachable: ${reason}`);
+    }
+}
+exports.BackendUnreachableError = BackendUnreachableError;
+class MalformedAnnouncementError extends ScanningError {
+    name = 'MalformedAnnouncementError';
+    constructor(reason) {
+        super(`Malformed announcement skipped: ${reason}`);
+    }
+}
+exports.MalformedAnnouncementError = MalformedAnnouncementError;
+class MissingPublicClientError extends ScanningError {
+    name = 'MissingPublicClientError';
+    constructor() {
+        super('Scanner transport has no publicClient');
+    }
+}
+exports.MissingPublicClientError = MissingPublicClientError;
+class InvalidFinalityLevelError extends ScanningError {
+    name = 'InvalidFinalityLevelError';
+    constructor(level) {
+        super(`Invalid finality level: ${level}`);
+    }
+}
+exports.InvalidFinalityLevelError = InvalidFinalityLevelError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,EAAE;AACF,mEAAmE;AACnE,6EAA6E;AAC7E,0DAA0D;AAC1D,4DAA4D;AAC5D,sDAAsD;AACtD,+EAA+E;AAC/E,4EAA4E;AAC5E,2BAA2B;;;AAE3B,MAAa,aAAc,SAAQ,KAAK;IACpB,IAAI,GAAW,eAAe,CAAC;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;CACF;AALD,sCAKC;AAED,MAAa,uBAAwB,SAAQ,aAAa;IACtC,IAAI,GAAW,yBAAyB,CAAC;IAC3D,YAAY,MAAc;QACxB,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AALD,0DAKC;AAED,MAAa,0BAA2B,SAAQ,aAAa;IACzC,IAAI,GAAW,4BAA4B,CAAC;IAC9D,YAAY,MAAc;QACxB,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AALD,gEAKC;AAED,MAAa,wBAAyB,SAAQ,aAAa;IACvC,IAAI,GAAW,0BAA0B,CAAC;IAC5D;QACE,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACjD,CAAC;CACF;AALD,4DAKC;AAED,MAAa,yBAA0B,SAAQ,aAAa;IACxC,IAAI,GAAW,2BAA2B,CAAC;IAC7D,YAAY,KAAa;QACvB,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF;AALD,8DAKC"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,9 @@
+export { createScanner } from './detector.js';
+export { ViemScannerBackend } from './viem-backend.js';
+export type { ScannerBackend, RawAnnouncement, AnnouncementHandler, UnsubscribeFn, BackendWatchOptions, FinalityLevel, } from './backend.js';
+export type { Scanner, ScannerConfig, ScannerTransportLike, DetectedPayment, } from './types.js';
+export { ScanningError, BackendUnreachableError, MalformedAnnouncementError, MissingPublicClientError, InvalidFinalityLevelError, } from './errors.js';
+export { LRUDeduper } from './dedup.js';
+export { Cursor } from './cursor.js';
+export { DEFAULT_SCHEME_ID, DEFAULT_RECONCILE_INTERVAL_MS, DEFAULT_DEDUP_CAPACITY, DEFAULT_GETLOGS_CHUNK_SIZE, DEFAULT_FINALITY, MIN_METADATA_LENGTH, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EACL,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACtB,0BAA0B,EAC1B,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,33 @@
+"use strict";
+// Public surface — @shroud-fi/scanning
+// Phase 3: detection-only stealth payment scanner. Caller drives sweep.
+// Sweep queue / log-normal delay / destination rotation are deferred phases.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIN_METADATA_LENGTH = exports.DEFAULT_FINALITY = exports.DEFAULT_GETLOGS_CHUNK_SIZE = exports.DEFAULT_DEDUP_CAPACITY = exports.DEFAULT_RECONCILE_INTERVAL_MS = exports.DEFAULT_SCHEME_ID = exports.Cursor = exports.LRUDeduper = exports.InvalidFinalityLevelError = exports.MissingPublicClientError = exports.MalformedAnnouncementError = exports.BackendUnreachableError = exports.ScanningError = exports.ViemScannerBackend = exports.createScanner = void 0;
+// Factory
+var detector_js_1 = require("./detector.js");
+Object.defineProperty(exports, "createScanner", { enumerable: true, get: function () { return detector_js_1.createScanner; } });
+// Backend interface + viem implementation
+var viem_backend_js_1 = require("./viem-backend.js");
+Object.defineProperty(exports, "ViemScannerBackend", { enumerable: true, get: function () { return viem_backend_js_1.ViemScannerBackend; } });
+// Errors
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "ScanningError", { enumerable: true, get: function () { return errors_js_1.ScanningError; } });
+Object.defineProperty(exports, "BackendUnreachableError", { enumerable: true, get: function () { return errors_js_1.BackendUnreachableError; } });
+Object.defineProperty(exports, "MalformedAnnouncementError", { enumerable: true, get: function () { return errors_js_1.MalformedAnnouncementError; } });
+Object.defineProperty(exports, "MissingPublicClientError", { enumerable: true, get: function () { return errors_js_1.MissingPublicClientError; } });
+Object.defineProperty(exports, "InvalidFinalityLevelError", { enumerable: true, get: function () { return errors_js_1.InvalidFinalityLevelError; } });
+// Utilities (advanced consumers)
+var dedup_js_1 = require("./dedup.js");
+Object.defineProperty(exports, "LRUDeduper", { enumerable: true, get: function () { return dedup_js_1.LRUDeduper; } });
+var cursor_js_1 = require("./cursor.js");
+Object.defineProperty(exports, "Cursor", { enumerable: true, get: function () { return cursor_js_1.Cursor; } });
+// Defaults
+var constants_js_1 = require("./constants.js");
+Object.defineProperty(exports, "DEFAULT_SCHEME_ID", { enumerable: true, get: function () { return constants_js_1.DEFAULT_SCHEME_ID; } });
+Object.defineProperty(exports, "DEFAULT_RECONCILE_INTERVAL_MS", { enumerable: true, get: function () { return constants_js_1.DEFAULT_RECONCILE_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_DEDUP_CAPACITY", { enumerable: true, get: function () { return constants_js_1.DEFAULT_DEDUP_CAPACITY; } });
+Object.defineProperty(exports, "DEFAULT_GETLOGS_CHUNK_SIZE", { enumerable: true, get: function () { return constants_js_1.DEFAULT_GETLOGS_CHUNK_SIZE; } });
+Object.defineProperty(exports, "DEFAULT_FINALITY", { enumerable: true, get: function () { return constants_js_1.DEFAULT_FINALITY; } });
+Object.defineProperty(exports, "MIN_METADATA_LENGTH", { enumerable: true, get: function () { return constants_js_1.MIN_METADATA_LENGTH; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,wEAAwE;AACxE,6EAA6E;;;AAE7E,UAAU;AACV,6CAA8C;AAArC,4GAAA,aAAa,OAAA;AAEtB,0CAA0C;AAC1C,qDAAuD;AAA9C,qHAAA,kBAAkB,OAAA;AAkB3B,SAAS;AACT,yCAMqB;AALnB,0GAAA,aAAa,OAAA;AACb,oHAAA,uBAAuB,OAAA;AACvB,uHAAA,0BAA0B,OAAA;AAC1B,qHAAA,wBAAwB,OAAA;AACxB,sHAAA,yBAAyB,OAAA;AAG3B,iCAAiC;AACjC,uCAAwC;AAA/B,sGAAA,UAAU,OAAA;AACnB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AAEf,WAAW;AACX,+CAOwB;AANtB,iHAAA,iBAAiB,OAAA;AACjB,6HAAA,6BAA6B,OAAA;AAC7B,sHAAA,sBAAsB,OAAA;AACtB,0HAAA,0BAA0B,OAAA;AAC1B,gHAAA,gBAAgB,OAAA;AAChB,mHAAA,mBAAmB,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}