@bsv/wallet-toolbox-mobile 2.1.24 → 2.1.25

package/out/src/storage/StorageIdb.js

@@ -1,2389 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StorageIdb = void 0;
-const idb_1 = require("idb");
-const utilityHelpers_1 = require("../utility/utilityHelpers");
-const StorageProvider_1 = require("./StorageProvider");
-const listActionsIdb_1 = require("./methods/listActionsIdb");
-const listOutputsIdb_1 = require("./methods/listOutputsIdb");
-const reviewStatusIdb_1 = require("./methods/reviewStatusIdb");
-const purgeDataIdb_1 = require("./methods/purgeDataIdb");
-const WERR_errors_1 = require("../sdk/WERR_errors");
-/**
- * This class implements the `StorageProvider` interface using IndexedDB,
- * via the promises wrapper package `idb`.
- */
-class StorageIdb extends StorageProvider_1.StorageProvider {
-    constructor(options) {
-        super(options);
-        this.allStores = [
-            'certificates',
-            'certificate_fields',
-            'commissions',
-            'monitor_events',
-            'outputs',
-            'output_baskets',
-            'output_tags',
-            'output_tags_map',
-            'proven_txs',
-            'proven_tx_reqs',
-            'sync_states',
-            'transactions',
-            'tx_labels',
-            'tx_labels_map',
-            'users'
-        ];
-        this.dbName = `wallet-toolbox-${this.chain}net`;
-    }
-    /**
-     * This method must be called at least once before any other method accesses the database,
-     * and each time the schema may have updated.
-     *
-     * If the database has already been created in this context, `storageName` and `storageIdentityKey`
-     * are ignored.
-     *
-     * @param storageName
-     * @param storageIdentityKey
-     * @returns
-     */
-    async migrate(storageName, storageIdentityKey) {
-        const db = await this.verifyDB(storageName, storageIdentityKey);
-        return db.version.toString();
-    }
-    /**
-     * Following initial database initialization, this method verfies that db is ready for use.
-     *
-     * @throws `WERR_INVALID_OPERATION` if the database has not been initialized by a call to `migrate`.
-     *
-     * @param storageName
-     * @param storageIdentityKey
-     *
-     * @returns
-     */
-    async verifyDB(storageName, storageIdentityKey) {
-        if (this.db)
-            return this.db;
-        this.db = await this.initDB(storageName, storageIdentityKey);
-        this._settings = (await this.db.getAll('settings'))[0];
-        this.whenLastAccess = new Date();
-        return this.db;
-    }
-    /**
-     * Convert the standard optional `TrxToken` parameter into either a direct knex database instance,
-     * or a Knex.Transaction as appropriate.
-     */
-    toDbTrx(stores, mode, trx) {
-        if (trx) {
-            const t = trx;
-            return t;
-        }
-        else {
-            if (!this.db)
-                throw new Error('not initialized');
-            const db = this.db;
-            const trx = db.transaction(stores || this.allStores, mode || 'readwrite');
-            this.whenLastAccess = new Date();
-            return trx;
-        }
-    }
-    /**
-     * Called by `makeAvailable` to return storage `TableSettings`.
-     * Since this is the first async method that must be called by all clients,
-     * it is where async initialization occurs.
-     *
-     * After initialization, cached settings are returned.
-     *
-     * @param trx
-     */
-    async readSettings(trx) {
-        await this.verifyDB();
-        return this._settings;
-    }
-    async initDB(storageName, storageIdentityKey) {
-        const chain = this.chain;
-        const maxOutputScript = 1024;
-        const db = await (0, idb_1.openDB)(this.dbName, 1, {
-            upgrade(db, oldVersion, newVersion, transaction) {
-                if (!db.objectStoreNames.contains('proven_txs')) {
-                    // proven_txs object store
-                    const provenTxsStore = db.createObjectStore('proven_txs', {
-                        keyPath: 'provenTxId',
-                        autoIncrement: true
-                    });
-                    provenTxsStore.createIndex('txid', 'txid', { unique: true });
-                }
-                if (!db.objectStoreNames.contains('proven_tx_reqs')) {
-                    // proven_tx_reqs object store
-                    const provenTxReqsStore = db.createObjectStore('proven_tx_reqs', {
-                        keyPath: 'provenTxReqId',
-                        autoIncrement: true
-                    });
-                    provenTxReqsStore.createIndex('provenTxId', 'provenTxId');
-                    provenTxReqsStore.createIndex('txid', 'txid', { unique: true });
-                    provenTxReqsStore.createIndex('status', 'status');
-                    provenTxReqsStore.createIndex('batch', 'batch');
-                }
-                if (!db.objectStoreNames.contains('users')) {
-                    const users = db.createObjectStore('users', {
-                        keyPath: 'userId',
-                        autoIncrement: true
-                    });
-                    users.createIndex('identityKey', 'identityKey', { unique: true });
-                }
-                if (!db.objectStoreNames.contains('certificates')) {
-                    // certificates object store
-                    const certificatesStore = db.createObjectStore('certificates', {
-                        keyPath: 'certificateId',
-                        autoIncrement: true
-                    });
-                    certificatesStore.createIndex('userId', 'userId');
-                    certificatesStore.createIndex('userId_type_certifier_serialNumber', ['userId', 'type', 'certifier', 'serialNumber'], { unique: true });
-                }
-                if (!db.objectStoreNames.contains('certificate_fields')) {
-                    // certificate_fields object store
-                    const certificateFieldsStore = db.createObjectStore('certificate_fields', {
-                        keyPath: ['certificateId', 'fieldName'] // Composite key
-                    });
-                    certificateFieldsStore.createIndex('userId', 'userId');
-                    certificateFieldsStore.createIndex('certificateId', 'certificateId');
-                }
-                if (!db.objectStoreNames.contains('output_baskets')) {
-                    // output_baskets object store
-                    const outputBasketsStore = db.createObjectStore('output_baskets', {
-                        keyPath: 'basketId',
-                        autoIncrement: true
-                    });
-                    outputBasketsStore.createIndex('userId', 'userId');
-                    outputBasketsStore.createIndex('name_userId', ['name', 'userId'], { unique: true });
-                }
-                if (!db.objectStoreNames.contains('transactions')) {
-                    // transactions object store
-                    const transactionsStore = db.createObjectStore('transactions', {
-                        keyPath: 'transactionId',
-                        autoIncrement: true
-                    });
-                    transactionsStore.createIndex('userId', 'userId');
-                    transactionsStore.createIndex('status', 'status');
-                    transactionsStore.createIndex('status_userId', ['status', 'userId']);
-                    transactionsStore.createIndex('provenTxId', 'provenTxId');
-                    transactionsStore.createIndex('reference', 'reference', { unique: true });
-                }
-                if (!db.objectStoreNames.contains('commissions')) {
-                    // commissions object store
-                    const commissionsStore = db.createObjectStore('commissions', {
-                        keyPath: 'commissionId',
-                        autoIncrement: true
-                    });
-                    commissionsStore.createIndex('userId', 'userId');
-                    commissionsStore.createIndex('transactionId', 'transactionId', { unique: true });
-                }
-                if (!db.objectStoreNames.contains('outputs')) {
-                    // outputs object store
-                    const outputsStore = db.createObjectStore('outputs', {
-                        keyPath: 'outputId',
-                        autoIncrement: true
-                    });
-                    outputsStore.createIndex('userId', 'userId');
-                    outputsStore.createIndex('transactionId', 'transactionId');
-                    outputsStore.createIndex('basketId', 'basketId');
-                    outputsStore.createIndex('spentBy', 'spentBy');
-                    outputsStore.createIndex('transactionId_vout_userId', ['transactionId', 'vout', 'userId'], { unique: true });
-                }
-                if (!db.objectStoreNames.contains('output_tags')) {
-                    // output_tags object store
-                    const outputTagsStore = db.createObjectStore('output_tags', {
-                        keyPath: 'outputTagId',
-                        autoIncrement: true
-                    });
-                    outputTagsStore.createIndex('userId', 'userId');
-                    outputTagsStore.createIndex('tag_userId', ['tag', 'userId'], { unique: true });
-                }
-                if (!db.objectStoreNames.contains('output_tags_map')) {
-                    // output_tags_map object store
-                    const outputTagsMapStore = db.createObjectStore('output_tags_map', {
-                        keyPath: ['outputTagId', 'outputId']
-                    });
-                    outputTagsMapStore.createIndex('outputTagId', 'outputTagId');
-                    outputTagsMapStore.createIndex('outputId', 'outputId');
-                }
-                if (!db.objectStoreNames.contains('tx_labels')) {
-                    // tx_labels object store
-                    const txLabelsStore = db.createObjectStore('tx_labels', {
-                        keyPath: 'txLabelId',
-                        autoIncrement: true
-                    });
-                    txLabelsStore.createIndex('userId', 'userId');
-                    txLabelsStore.createIndex('label_userId', ['label', 'userId'], { unique: true });
-                }
-                if (!db.objectStoreNames.contains('tx_labels_map')) {
-                    // tx_labels_map object store
-                    const txLabelsMapStore = db.createObjectStore('tx_labels_map', {
-                        keyPath: ['txLabelId', 'transactionId']
-                    });
-                    txLabelsMapStore.createIndex('txLabelId', 'txLabelId');
-                    txLabelsMapStore.createIndex('transactionId', 'transactionId');
-                }
-                if (!db.objectStoreNames.contains('monitor_events')) {
-                    // monitor_events object store
-                    const monitorEventsStore = db.createObjectStore('monitor_events', {
-                        keyPath: 'id',
-                        autoIncrement: true
-                    });
-                }
-                if (!db.objectStoreNames.contains('sync_states')) {
-                    // sync_states object store
-                    const syncStatesStore = db.createObjectStore('sync_states', {
-                        keyPath: 'syncStateId',
-                        autoIncrement: true
-                    });
-                    syncStatesStore.createIndex('userId', 'userId');
-                    syncStatesStore.createIndex('refNum', 'refNum', { unique: true });
-                    syncStatesStore.createIndex('status', 'status');
-                }
-                if (!db.objectStoreNames.contains('settings')) {
-                    if (!storageName || !storageIdentityKey) {
-                        throw new WERR_errors_1.WERR_INVALID_OPERATION('migrate must be called before first access');
-                    }
-                    const settings = db.createObjectStore('settings', {
-                        keyPath: 'storageIdentityKey'
-                    });
-                    const s = {
-                        created_at: new Date(),
-                        updated_at: new Date(),
-                        storageIdentityKey,
-                        storageName,
-                        chain,
-                        dbtype: 'IndexedDB',
-                        maxOutputScript
-                    };
-                    settings.put(s);
-                }
-            }
-        });
-        return db;
-    }
-    //
-    // StorageProvider abstract methods
-    //
-    async reviewStatus(args) {
-        return await (0, reviewStatusIdb_1.reviewStatusIdb)(this, args);
-    }
-    async purgeData(params, trx) {
-        return await (0, purgeDataIdb_1.purgeDataIdb)(this, params, trx);
-    }
-    /**
-     * Proceeds in three stages:
-     * 1. Find an output that exactly funds the transaction (if exactSatoshis is not undefined).
-     * 2. Find an output that overfunds by the least amount (targetSatoshis).
-     * 3. Find an output that comes as close to funding as possible (targetSatoshis).
-     * 4. Return undefined if no output is found.
-     *
-     * Outputs must belong to userId and basketId and have spendable true.
-     * Their corresponding transaction must have status of 'completed', 'unproven', or 'sending' (if excludeSending is false).
-     *
-     * @param userId
-     * @param basketId
-     * @param targetSatoshis
-     * @param exactSatoshis
-     * @param excludeSending
-     * @param transactionId
-     * @returns next funding output to add to transaction or undefined if there are none.
-     */
-    async allocateChangeInput(userId, basketId, targetSatoshis, exactSatoshis, excludeSending, transactionId) {
-        const dbTrx = this.toDbTrx(['outputs', 'transactions', 'proven_txs', 'proven_tx_reqs'], 'readwrite');
-        try {
-            const txStatus = ['completed', 'unproven'];
-            if (!excludeSending)
-                txStatus.push('sending');
-            const args = {
-                partial: { userId, basketId, spendable: true },
-                txStatus,
-                // Skip per-output script hydration during the candidate scan — we only need
-                // the locking script for the one we actually pick below. Matches Knex's
-                // pattern: SELECT candidates cheaply, hydrate the chosen output explicitly.
-                noScript: true,
-                trx: dbTrx
-            };
-            const outputs = await this.findOutputs(args);
-            let output;
-            let scores = [];
-            for (const o of outputs) {
-                if (exactSatoshis && o.satoshis === exactSatoshis) {
-                    output = o;
-                    break;
-                }
-                const score = o.satoshis - targetSatoshis;
-                scores.push({ output: o, score });
-            }
-            if (!output) {
-                // sort scores increasing by score property
-                scores = scores.sort((a, b) => a.score - b.score);
-                // find the first score that is greater than or equal to 0
-                const o = scores.find(s => s.score >= 0);
-                if (o) {
-                    // stage 2 satisfied (minimally funded)
-                    output = o.output;
-                }
-                else if (scores.length > 0) {
-                    // stage 3 satisfied (minimally under-funded)
-                    output = scores.slice(-1)[0].output;
-                }
-                else {
-                    // no available funding outputs
-                    output = undefined;
-                }
-            }
-            if (output) {
-                // mark output as spent by transactionId
-                await this.updateOutput(output.outputId, { spendable: false, spentBy: transactionId }, dbTrx);
-                // Hydrate the locking script for the chosen output. Identical to Knex canon at
-                // StorageKnex.allocateChangeInput: required when the script was offloaded into
-                // rawTx storage due to exceeding maxOutputScript.
-                await this.validateOutputScript(output, dbTrx);
-            }
-            return output;
-        }
-        finally {
-            await dbTrx.done;
-        }
-    }
-    async getProvenOrRawTx(txid, trx) {
-        const r = {
-            proven: undefined,
-            rawTx: undefined,
-            inputBEEF: undefined
-        };
-        r.proven = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxs({ partial: { txid: txid }, trx }));
-        if (!r.proven) {
-            const req = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxReqs({ partial: { txid: txid }, trx }));
-            if (req && ['unsent', 'unmined', 'unconfirmed', 'sending', 'nosend', 'completed'].includes(req.status)) {
-                r.rawTx = req.rawTx;
-                r.inputBEEF = req.inputBEEF;
-            }
-        }
-        return r;
-    }
-    async getRawTxOfKnownValidTransaction(txid, offset, length, trx) {
-        if (!txid)
-            return undefined;
-        if (!this.isAvailable())
-            await this.makeAvailable();
-        let rawTx = undefined;
-        const sliceRequested = offset !== undefined && length !== undefined && Number.isInteger(offset) && Number.isInteger(length);
-        // Slice path uses an extended status set that includes 'unfail' — matches Knex
-        // canon at StorageKnex.ts:131. The non-slice path continues to delegate to
-        // getProvenOrRawTx which uses the narrower set.
-        if (sliceRequested) {
-            const proven = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxs({ partial: { txid }, trx }));
-            if (proven) {
-                rawTx = proven.rawTx;
-            }
-            else {
-                const req = (0, utilityHelpers_1.verifyOneOrNone)(await this.findProvenTxReqs({ partial: { txid }, trx }));
-                if (req && ['unsent', 'nosend', 'sending', 'unmined', 'completed', 'unfail'].includes(req.status)) {
-                    rawTx = req.rawTx;
-                }
-            }
-        }
-        else {
-            const r = await this.getProvenOrRawTx(txid, trx);
-            if (r.proven)
-                rawTx = r.proven.rawTx;
-            else
-                rawTx = r.rawTx;
-        }
-        if (rawTx && sliceRequested) {
-            rawTx = rawTx.slice(offset, offset + length);
-        }
-        return rawTx;
-    }
-    async getLabelsForTransactionId(transactionId, trx) {
-        const maps = await this.findTxLabelMaps({ partial: { transactionId, isDeleted: false }, trx });
-        const labelIds = maps.map(m => m.txLabelId);
-        const labels = [];
-        for (const txLabelId of labelIds) {
-            // verifyOneOrNone: a map row may reference a label that was later soft-deleted.
-            // Knex/Bun drop it via JOIN; we must do the same silently or we'd break the whole
-            // listActions response. Skip + log so persistent orphans still produce a signal.
-            const label = (0, utilityHelpers_1.verifyOneOrNone)(await this.findTxLabels({ partial: { txLabelId, isDeleted: false }, trx }));
-            if (label)
-                labels.push(label);
-            else
-                console.debug(`[StorageIdb] orphan tx_labels_map row skipped: transactionId=${transactionId} txLabelId=${txLabelId}`);
-        }
-        return labels;
-    }
-    async getTagsForOutputId(outputId, trx) {
-        const maps = await this.findOutputTagMaps({ partial: { outputId, isDeleted: false }, trx });
-        const tagIds = maps.map(m => m.outputTagId);
-        const tags = [];
-        for (const outputTagId of tagIds) {
-            const tag = (0, utilityHelpers_1.verifyOneOrNone)(await this.findOutputTags({ partial: { outputTagId, isDeleted: false }, trx }));
-            if (tag)
-                tags.push(tag);
-            else
-                console.debug(`[StorageIdb] orphan output_tags_map row skipped: outputId=${outputId} outputTagId=${outputTagId}`);
-        }
-        return tags;
-    }
-    async listActions(auth, vargs) {
-        if (!auth.userId)
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        return await (0, listActionsIdb_1.listActionsIdb)(this, auth, vargs);
-    }
-    async listOutputs(auth, vargs) {
-        if (!auth.userId)
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        return await (0, listOutputsIdb_1.listOutputsIdb)(this, auth, vargs);
-    }
-    async countChangeInputs(userId, basketId, excludeSending) {
-        const txStatus = ['completed', 'unproven'];
-        if (!excludeSending)
-            txStatus.push('sending');
-        const args = { partial: { userId, basketId }, txStatus };
-        let count = 0;
-        await this.filterOutputs(args, r => {
-            count++;
-        });
-        return count;
-    }
-    async findCertificatesAuth(auth, args) {
-        if (!auth.userId || (args.partial.userId && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findCertificates(args);
-    }
-    async findOutputBasketsAuth(auth, args) {
-        if (!auth.userId || (args.partial.userId && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findOutputBaskets(args);
-    }
-    async findOutputsAuth(auth, args) {
-        if (!auth.userId || (args.partial.userId && args.partial.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        args.partial.userId = auth.userId;
-        return await this.findOutputs(args);
-    }
-    async insertCertificateAuth(auth, certificate) {
-        if (!auth.userId || (certificate.userId && certificate.userId !== auth.userId))
-            throw new WERR_errors_1.WERR_UNAUTHORIZED();
-        certificate.userId = auth.userId;
-        return await this.insertCertificate(certificate);
-    }
-    //
-    // StorageReaderWriter abstract methods
-    //
-    async dropAllData() {
-        await (0, idb_1.deleteDB)(this.dbName);
-    }
-    /**
-     * Reject undefined values in a `partial` filter argument. Matches
-     * Knex behavior (which throws `Undefined binding(s) detected`) so that
-     * callers can't pass an unmapped idMap lookup through as a silent
-     * match-anything. Omit the key to skip filtering on it; pass null if
-     * you need IS NULL semantics (only meaningful for nullable columns).
-     */
-    assertNoUndefinedInPartial(partial) {
-        if (!partial)
-            return;
-        for (const k of Object.keys(partial)) {
-            if (partial[k] === undefined) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`args.partial.${k}`, `not undefined. Passing undefined as a filter value is not supported — omit the key to skip filtering. Matches Knex semantics.`);
-            }
-        }
-    }
-    async filterOutputTagMaps(args, filtered, userId) {
-        var _a, _b, _c, _d;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['output_tags_map', 'output_tags'], 'readonly', args.trx);
-        let cursor;
-        if (((_b = args.partial) === null || _b === void 0 ? void 0 : _b.outputTagId) !== undefined) {
-            cursor = await dbTrx.objectStore('output_tags_map').index('outputTagId').openCursor(args.partial.outputTagId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.outputId) !== undefined) {
-            cursor = await dbTrx.objectStore('output_tags_map').index('outputId').openCursor(args.partial.outputId);
-        }
-        else {
-            cursor = await dbTrx.objectStore('output_tags_map').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.tagIds && !args.tagIds.includes(r.outputTagId))
-                continue;
-            if (args.partial) {
-                if (args.partial.outputTagId !== undefined && r.outputTagId !== args.partial.outputTagId)
-                    continue;
-                if (args.partial.outputId !== undefined && r.outputId !== args.partial.outputId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (userId !== undefined) {
-                const tagsForUser = await this.countOutputTags({ partial: { userId, outputTagId: r.outputTagId }, trx: dbTrx });
-                if (tagsForUser === 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_d = args.paged) === null || _d === void 0 ? void 0 : _d.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findOutputTagMaps(args) {
-        const results = [];
-        await this.filterOutputTagMaps(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async filterProvenTxReqs(args, filtered, userId) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.rawTx)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', `undefined. ProvenTxReqs may not be found by rawTx value.`);
-        if (args.partial.inputBEEF)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.inputBEEF', `undefined. ProvenTxReqs may not be found by inputBEEF value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['proven_tx_reqs', 'transactions'], 'readonly', args.trx);
-        const direction = args.orderDescending ? 'prev' : 'next';
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.provenTxReqId) {
-            cursor = await dbTrx.objectStore('proven_tx_reqs').openCursor(args.partial.provenTxReqId, direction);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.provenTxId) !== undefined) {
-            cursor = await dbTrx
-                .objectStore('proven_tx_reqs')
-                .index('provenTxId')
-                .openCursor(args.partial.provenTxId, direction);
-        }
-        else if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.txid) !== undefined) {
-            cursor = await dbTrx.objectStore('proven_tx_reqs').index('txid').openCursor(args.partial.txid, direction);
-        }
-        else if (((_e = args.partial) === null || _e === void 0 ? void 0 : _e.status) !== undefined) {
-            cursor = await dbTrx.objectStore('proven_tx_reqs').index('status').openCursor(args.partial.status, direction);
-        }
-        else if (((_f = args.partial) === null || _f === void 0 ? void 0 : _f.batch) !== undefined) {
-            cursor = await dbTrx.objectStore('proven_tx_reqs').index('batch').openCursor(args.partial.batch, direction);
-        }
-        else {
-            cursor = await dbTrx.objectStore('proven_tx_reqs').openCursor(null, direction);
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.provenTxReqId !== undefined && r.provenTxReqId !== args.partial.provenTxReqId)
-                    continue;
-                if (args.partial.provenTxId !== undefined && r.provenTxId !== args.partial.provenTxId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.status !== undefined && r.status !== args.partial.status)
-                    continue;
-                if (args.partial.attempts !== undefined && r.attempts !== args.partial.attempts)
-                    continue;
-                if (args.partial.notified !== undefined && r.notified !== args.partial.notified)
-                    continue;
-                if (args.partial.txid !== undefined && r.txid !== args.partial.txid)
-                    continue;
-                if (args.partial.batch !== undefined && r.batch !== args.partial.batch)
-                    continue;
-                if (args.partial.history !== undefined && r.history !== args.partial.history)
-                    continue;
-                if (args.partial.notify !== undefined && r.notify !== args.partial.notify)
-                    continue;
-            }
-            if (args.status && args.status.length > 0 && !args.status.includes(r.status))
-                continue;
-            if (args.txids && args.txids.length > 0 && !args.txids.includes(r.txid))
-                continue;
-            if (userId !== undefined) {
-                const txsForUser = await this.countTransactions({ partial: { userId, txid: r.txid }, trx: dbTrx });
-                if (txsForUser === 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_g = args.paged) === null || _g === void 0 ? void 0 : _g.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findProvenTxReqs(args) {
-        const results = [];
-        await this.filterProvenTxReqs(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async filterProvenTxs(args, filtered, userId) {
-        var _a, _b, _c, _d;
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.rawTx)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', `undefined. ProvenTxs may not be found by rawTx value.`);
-        if (args.partial.merklePath)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.merklePath', `undefined. ProvenTxs may not be found by merklePath value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['proven_txs', 'transactions'], 'readonly', args.trx);
-        const direction = args.orderDescending ? 'prev' : 'next';
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.provenTxId) {
-            cursor = await dbTrx.objectStore('proven_txs').openCursor(args.partial.provenTxId, direction);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.txid) !== undefined) {
-            cursor = await dbTrx.objectStore('proven_txs').index('txid').openCursor(args.partial.txid, direction);
-        }
-        else {
-            cursor = await dbTrx.objectStore('proven_txs').openCursor(null, direction);
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.provenTxId !== undefined && r.provenTxId !== args.partial.provenTxId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.txid !== undefined && r.txid !== args.partial.txid)
-                    continue;
-                if (args.partial.height !== undefined && r.height !== args.partial.height)
-                    continue;
-                if (args.partial.index !== undefined && r.index !== args.partial.index)
-                    continue;
-                if (args.partial.blockHash !== undefined && r.blockHash !== args.partial.blockHash)
-                    continue;
-                if (args.partial.merkleRoot !== undefined && r.merkleRoot !== args.partial.merkleRoot)
-                    continue;
-            }
-            if (userId !== undefined) {
-                const count = await this.countTransactions({ partial: { userId, provenTxId: r.provenTxId }, trx: dbTrx });
-                if (count === 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_d = args.paged) === null || _d === void 0 ? void 0 : _d.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findProvenTxs(args) {
-        const results = [];
-        await this.filterProvenTxs(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async filterTxLabelMaps(args, filtered, userId) {
-        var _a, _b, _c, _d;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['tx_labels_map', 'tx_labels'], 'readonly', args.trx);
-        let cursor;
-        if (((_b = args.partial) === null || _b === void 0 ? void 0 : _b.transactionId) !== undefined) {
-            cursor = await dbTrx.objectStore('tx_labels_map').index('transactionId').openCursor(args.partial.transactionId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.txLabelId) !== undefined) {
-            cursor = await dbTrx.objectStore('tx_labels_map').index('txLabelId').openCursor(args.partial.txLabelId);
-        }
-        else {
-            cursor = await dbTrx.objectStore('tx_labels_map').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.txLabelId !== undefined && r.txLabelId !== args.partial.txLabelId)
-                    continue;
-                if (args.partial.transactionId !== undefined && r.transactionId !== args.partial.transactionId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (userId !== undefined) {
-                const count = await this.countTxLabels({ partial: { userId, txLabelId: r.txLabelId }, trx: dbTrx });
-                if (count === 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_d = args.paged) === null || _d === void 0 ? void 0 : _d.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findTxLabelMaps(args) {
-        const results = [];
-        await this.filterTxLabelMaps(args, r => {
-            results.push(this.validateEntity(r));
-        });
-        return results;
-    }
-    async countOutputTagMaps(args) {
-        let count = 0;
-        await this.filterOutputTagMaps(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countProvenTxReqs(args) {
-        let count = 0;
-        await this.filterProvenTxReqs(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countProvenTxs(args) {
-        let count = 0;
-        await this.filterProvenTxs(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countTxLabelMaps(args) {
-        let count = 0;
-        await this.filterTxLabelMaps(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async insertCertificate(certificate, trx) {
-        const e = await this.validateEntityForInsert(certificate, trx, undefined, ['isDeleted']);
-        // Strip non-schema runtime fields before insert. Matches Knex canon.
-        if (e.logger)
-            delete e.logger;
-        const fields = e.fields;
-        if (e.fields)
-            delete e.fields;
-        if (e.certificateId === 0)
-            delete e.certificateId;
-        const dbTrx = this.toDbTrx(['certificates', 'certificate_fields'], 'readwrite', trx);
-        const store = dbTrx.objectStore('certificates');
-        try {
-            const id = Number(await store.add(e));
-            certificate.certificateId = id;
-            if (fields) {
-                for (const field of fields) {
-                    field.certificateId = certificate.certificateId;
-                    field.userId = certificate.userId;
-                    await this.insertCertificateField(field, dbTrx);
-                }
-            }
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return certificate.certificateId;
-    }
-    async insertCertificateField(certificateField, trx) {
-        const e = await this.validateEntityForInsert(certificateField, trx);
-        const dbTrx = this.toDbTrx(['certificate_fields'], 'readwrite', trx);
-        const store = dbTrx.objectStore('certificate_fields');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-    }
-    async insertCommission(commission, trx) {
-        const e = await this.validateEntityForInsert(commission, trx);
-        if (e.commissionId === 0)
-            delete e.commissionId;
-        const dbTrx = this.toDbTrx(['commissions'], 'readwrite', trx);
-        const store = dbTrx.objectStore('commissions');
-        try {
-            const id = Number(await store.add(e));
-            commission.commissionId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return commission.commissionId;
-    }
-    async insertMonitorEvent(event, trx) {
-        const e = await this.validateEntityForInsert(event, trx);
-        if (e.id === 0)
-            delete e.id;
-        const dbTrx = this.toDbTrx(['monitor_events'], 'readwrite', trx);
-        const store = dbTrx.objectStore('monitor_events');
-        try {
-            const id = Number(await store.add(e));
-            event.id = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return event.id;
-    }
-    async insertOutput(output, trx) {
-        const e = await this.validateEntityForInsert(output, trx);
-        if (e.outputId === 0)
-            delete e.outputId;
-        const dbTrx = this.toDbTrx(['outputs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('outputs');
-        try {
-            const id = Number(await store.add(e));
-            output.outputId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return output.outputId;
-    }
-    async insertOutputBasket(basket, trx) {
-        const e = await this.validateEntityForInsert(basket, trx, undefined, ['isDeleted']);
-        if (e.basketId === 0)
-            delete e.basketId;
-        const dbTrx = this.toDbTrx(['output_baskets'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_baskets');
-        try {
-            const id = Number(await store.add(e));
-            basket.basketId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return basket.basketId;
-    }
-    async insertOutputTag(tag, trx) {
-        const e = await this.validateEntityForInsert(tag, trx, undefined, ['isDeleted']);
-        if (e.outputTagId === 0)
-            delete e.outputTagId;
-        const dbTrx = this.toDbTrx(['output_tags'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_tags');
-        try {
-            const id = Number(await store.add(e));
-            tag.outputTagId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return tag.outputTagId;
-    }
-    async insertOutputTagMap(tagMap, trx) {
-        const e = await this.validateEntityForInsert(tagMap, trx, undefined, ['isDeleted']);
-        const dbTrx = this.toDbTrx(['output_tags_map'], 'readwrite', trx);
-        const store = dbTrx.objectStore('output_tags_map');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-    }
-    async insertProvenTx(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.provenTxId === 0)
-            delete e.provenTxId;
-        const dbTrx = this.toDbTrx(['proven_txs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('proven_txs');
-        try {
-            const id = Number(await store.add(e));
-            tx.provenTxId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return tx.provenTxId;
-    }
-    async insertProvenTxReq(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.provenTxReqId === 0)
-            delete e.provenTxReqId;
-        const dbTrx = this.toDbTrx(['proven_tx_reqs'], 'readwrite', trx);
-        const store = dbTrx.objectStore('proven_tx_reqs');
-        try {
-            const id = Number(await store.add(e));
-            tx.provenTxReqId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return tx.provenTxReqId;
-    }
-    async insertSyncState(syncState, trx) {
-        const e = await this.validateEntityForInsert(syncState, trx, ['when'], ['init']);
-        if (e.syncStateId === 0)
-            delete e.syncStateId;
-        const dbTrx = this.toDbTrx(['sync_states'], 'readwrite', trx);
-        const store = dbTrx.objectStore('sync_states');
-        try {
-            const id = Number(await store.add(e));
-            syncState.syncStateId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return syncState.syncStateId;
-    }
-    async insertTransaction(tx, trx) {
-        const e = await this.validateEntityForInsert(tx, trx);
-        if (e.transactionId === 0)
-            delete e.transactionId;
-        const dbTrx = this.toDbTrx(['transactions'], 'readwrite', trx);
-        const store = dbTrx.objectStore('transactions');
-        try {
-            const id = Number(await store.add(e));
-            tx.transactionId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return tx.transactionId;
-    }
-    async insertTxLabel(label, trx) {
-        const e = await this.validateEntityForInsert(label, trx, undefined, ['isDeleted']);
-        if (e.txLabelId === 0)
-            delete e.txLabelId;
-        const dbTrx = this.toDbTrx(['tx_labels'], 'readwrite', trx);
-        const store = dbTrx.objectStore('tx_labels');
-        try {
-            const id = Number(await store.add(e));
-            label.txLabelId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return label.txLabelId;
-    }
-    async insertTxLabelMap(labelMap, trx) {
-        const e = await this.validateEntityForInsert(labelMap, trx, undefined, ['isDeleted']);
-        const dbTrx = this.toDbTrx(['tx_labels_map'], 'readwrite', trx);
-        const store = dbTrx.objectStore('tx_labels_map');
-        try {
-            await store.add(e);
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-    }
-    async insertUser(user, trx) {
-        const e = await this.validateEntityForInsert(user, trx);
-        if (e.userId === 0)
-            delete e.userId;
-        const dbTrx = this.toDbTrx(['users'], 'readwrite', trx);
-        const store = dbTrx.objectStore('users');
-        try {
-            const id = Number(await store.add(e));
-            user.userId = id;
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return user.userId;
-    }
-    async updateIdb(id, update, keyProp, storeName, trx) {
-        if (update[keyProp] !== undefined && (Array.isArray(id) || update[keyProp] !== id)) {
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`update.${keyProp}`, `undefined`);
-        }
-        const u = this.validatePartialForUpdate(update);
-        const dbTrx = this.toDbTrx([storeName], 'readwrite', trx);
-        const store = dbTrx.objectStore(storeName);
-        const ids = Array.isArray(id) ? id : [id];
-        let updated = 0;
-        try {
-            for (const i of ids) {
-                const e = await store.get(i);
-                // Match Knex/Bun semantics: missing rows produce a 0-row result, not an error.
-                // Caller receives the true updated count and can decide how to react.
-                if (!e)
-                    continue;
-                const v = {
-                    ...e,
-                    ...u
-                };
-                const uid = await store.put(v);
-                if (uid !== i)
-                    throw new WERR_errors_1.WERR_INTERNAL(`updated id ${uid} does not match original ${id}`);
-                updated++;
-            }
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return updated;
-    }
-    async updateIdbKey(key, update, keyProps, storeName, trx) {
-        if (key.length !== keyProps.length)
-            throw new WERR_errors_1.WERR_INTERNAL(`key.length ${key.length} !== keyProps.length ${keyProps.length}`);
-        for (let i = 0; i < key.length; i++) {
-            if (update[keyProps[i]] !== undefined && update[keyProps[i]] !== key[i]) {
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER(`update.${keyProps[i]}`, `undefined`);
-            }
-        }
-        const u = this.validatePartialForUpdate(update);
-        const dbTrx = this.toDbTrx([storeName], 'readwrite', trx);
-        const store = dbTrx.objectStore(storeName);
-        try {
-            const e = await store.get(key);
-            if (!e)
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('key', `an existing record to update ${keyProps.join(',')} ${key.join(',')} not found`);
-            const v = {
-                ...e,
-                ...u
-            };
-            const uid = await store.put(v);
-            for (let i = 0; i < key.length; i++) {
-                if (uid[i] !== key[i])
-                    throw new WERR_errors_1.WERR_INTERNAL(`updated key ${uid[i]} does not match original ${key[i]}`);
-            }
-        }
-        finally {
-            if (!trx)
-                await dbTrx.done;
-        }
-        return 1;
-    }
-    async updateCertificate(id, update, trx) {
-        return this.updateIdb(id, update, 'certificateId', 'certificates', trx);
-    }
-    async updateCertificateField(certificateId, fieldName, update, trx) {
-        return this.updateIdbKey([certificateId, fieldName], update, ['certificateId', 'fieldName'], 'certificate_fields', trx);
-    }
-    async updateCommission(id, update, trx) {
-        return this.updateIdb(id, update, 'commissionId', 'commissions', trx);
-    }
-    async updateMonitorEvent(id, update, trx) {
-        return this.updateIdb(id, update, 'id', 'monitor_events', trx);
-    }
-    async updateOutput(id, update, trx) {
-        return this.updateIdb(id, update, 'outputId', 'outputs', trx);
-    }
-    async updateOutputBasket(id, update, trx) {
-        return this.updateIdb(id, update, 'basketId', 'output_baskets', trx);
-    }
-    async updateOutputTag(id, update, trx) {
-        return this.updateIdb(id, update, 'outputTagId', 'output_tags', trx);
-    }
-    async updateProvenTx(id, update, trx) {
-        return this.updateIdb(id, update, 'provenTxId', 'proven_txs', trx);
-    }
-    async updateProvenTxReq(id, update, trx) {
-        return this.updateIdb(id, update, 'provenTxReqId', 'proven_tx_reqs', trx);
-    }
-    async updateSyncState(id, update, trx) {
-        return this.updateIdb(id, update, 'syncStateId', 'sync_states', trx);
-    }
-    async updateTransaction(id, update, trx) {
-        return this.updateIdb(id, update, 'transactionId', 'transactions', trx);
-    }
-    async updateTxLabel(id, update, trx) {
-        return this.updateIdb(id, update, 'txLabelId', 'tx_labels', trx);
-    }
-    async updateUser(id, update, trx) {
-        return this.updateIdb(id, update, 'userId', 'users', trx);
-    }
-    async updateOutputTagMap(outputId, tagId, update, trx) {
-        return this.updateIdbKey([tagId, outputId], update, ['outputTagId', 'outputId'], 'output_tags_map', trx);
-    }
-    async updateTxLabelMap(transactionId, txLabelId, update, trx) {
-        return this.updateIdbKey([txLabelId, transactionId], update, ['txLabelId', 'transactionId'], 'tx_labels_map', trx);
-    }
-    //
-    // StorageReader abstract methods
-    //
-    async destroy() {
-        if (this.db) {
-            this.db.close();
-        }
-        this.db = undefined;
-        this._settings = undefined;
-    }
-    /**
-     * @param scope
-     * @param trx
-     * @returns
-     */
-    async transaction(scope, trx) {
-        if (trx)
-            return await scope(trx);
-        const stores = this.allStores;
-        const db = await this.verifyDB();
-        const tx = db.transaction(stores, 'readwrite');
-        try {
-            const r = await scope(tx);
-            await tx.done;
-            return r;
-        }
-        catch (err) {
-            tx.abort();
-            await tx.done;
-            throw err;
-        }
-    }
-    async filterCertificateFields(args, filtered) {
-        var _a, _b, _c, _d;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['certificate_fields'], 'readonly', args.trx);
-        let cursor;
-        if (((_b = args.partial) === null || _b === void 0 ? void 0 : _b.certificateId) !== undefined) {
-            cursor = await dbTrx
-                .objectStore('certificate_fields')
-                .index('certificateId')
-                .openCursor(args.partial.certificateId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            cursor = await dbTrx.objectStore('certificate_fields').index('userId').openCursor(args.partial.userId);
-        }
-        else {
-            cursor = await dbTrx.objectStore('certificate_fields').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.certificateId !== undefined && r.certificateId !== args.partial.certificateId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.fieldName !== undefined && r.fieldName !== args.partial.fieldName)
-                    continue;
-                if (args.partial.fieldValue !== undefined && r.fieldValue !== args.partial.fieldValue)
-                    continue;
-                if (args.partial.masterKey !== undefined && r.masterKey !== args.partial.masterKey)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_d = args.paged) === null || _d === void 0 ? void 0 : _d.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findCertificateFields(args) {
-        const result = [];
-        await this.filterCertificateFields(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterCertificates(args, filtered) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['certificates'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.certificateId) {
-            cursor = await dbTrx.objectStore('certificates').openCursor(args.partial.certificateId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.type) && ((_e = args.partial) === null || _e === void 0 ? void 0 : _e.certifier) && ((_f = args.partial) === null || _f === void 0 ? void 0 : _f.serialNumber)) {
-                cursor = await dbTrx
-                    .objectStore('certificates')
-                    .index('userId_type_certifier_serialNumber')
-                    .openCursor([args.partial.userId, args.partial.type, args.partial.certifier, args.partial.serialNumber]);
-            }
-            else {
-                cursor = await dbTrx.objectStore('certificates').index('userId').openCursor(args.partial.userId);
-            }
-        }
-        else {
-            cursor = await dbTrx.objectStore('certificates').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.certifiers && !args.certifiers.includes(r.certifier))
-                continue;
-            if (args.types && !args.types.includes(r.type))
-                continue;
-            if (args.partial) {
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.certificateId !== undefined && r.certificateId !== args.partial.certificateId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.type !== undefined && r.type !== args.partial.type)
-                    continue;
-                if (args.partial.serialNumber !== undefined && r.serialNumber !== args.partial.serialNumber)
-                    continue;
-                if (args.partial.certifier !== undefined && r.certifier !== args.partial.certifier)
-                    continue;
-                if (args.partial.subject !== undefined && r.subject !== args.partial.subject)
-                    continue;
-                if (args.partial.verifier !== undefined && r.verifier !== args.partial.verifier)
-                    continue;
-                if (args.partial.revocationOutpoint !== undefined && r.revocationOutpoint !== args.partial.revocationOutpoint)
-                    continue;
-                if (args.partial.signature !== undefined && r.signature !== args.partial.signature)
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_g = args.paged) === null || _g === void 0 ? void 0 : _g.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findCertificates(args) {
-        const result = [];
-        await this.filterCertificates(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        if (args.includeFields) {
-            for (const c of result) {
-                const fields = await this.findCertificateFields({ partial: { certificateId: c.certificateId }, trx: args.trx });
-                c.fields = fields;
-            }
-        }
-        return result;
-    }
-    async filterCommissions(args, filtered) {
-        var _a, _b, _c, _d, _e;
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.lockingScript)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('partial.lockingScript', `undefined. Commissions may not be found by lockingScript value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['commissions'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.commissionId) {
-            cursor = await dbTrx.objectStore('commissions').openCursor(args.partial.commissionId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            cursor = await dbTrx.objectStore('commissions').index('userId').openCursor(args.partial.userId);
-        }
-        else if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.transactionId) !== undefined) {
-            cursor = await dbTrx.objectStore('commissions').index('transactionId').openCursor(args.partial.transactionId);
-        }
-        else {
-            cursor = await dbTrx.objectStore('commissions').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.commissionId !== undefined && r.commissionId !== args.partial.commissionId)
-                    continue;
-                if (args.partial.transactionId !== undefined && r.transactionId !== args.partial.transactionId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.satoshis !== undefined && r.satoshis !== args.partial.satoshis)
-                    continue;
-                if (args.partial.keyOffset !== undefined && r.keyOffset !== args.partial.keyOffset)
-                    continue;
-                if (args.partial.isRedeemed !== undefined && r.isRedeemed !== args.partial.isRedeemed)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_e = args.paged) === null || _e === void 0 ? void 0 : _e.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findCommissions(args) {
-        const result = [];
-        await this.filterCommissions(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterMonitorEvents(args, filtered) {
-        var _a, _b, _c;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['monitor_events'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.id) {
-            cursor = await dbTrx.objectStore('monitor_events').openCursor(args.partial.id);
-        }
-        else {
-            cursor = await dbTrx.objectStore('monitor_events').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.id !== undefined && r.id !== args.partial.id)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.event !== undefined && r.event !== args.partial.event)
-                    continue;
-                if (args.partial.details !== undefined && r.details !== args.partial.details)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_c = args.paged) === null || _c === void 0 ? void 0 : _c.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findMonitorEvents(args) {
-        const result = [];
-        await this.filterMonitorEvents(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterOutputBaskets(args, filtered) {
-        var _a, _b, _c, _d, _e;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['output_baskets'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.basketId) {
-            cursor = await dbTrx.objectStore('output_baskets').openCursor(args.partial.basketId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.name) !== undefined) {
-                cursor = await dbTrx
-                    .objectStore('output_baskets')
-                    .index('name_userId')
-                    .openCursor([args.partial.name, args.partial.userId]);
-            }
-            else {
-                cursor = await dbTrx.objectStore('output_baskets').index('userId').openCursor(args.partial.userId);
-            }
-        }
-        else {
-            cursor = await dbTrx.objectStore('output_baskets').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.basketId !== undefined && r.basketId !== args.partial.basketId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.name !== undefined && r.name !== args.partial.name)
-                    continue;
-                if (args.partial.numberOfDesiredUTXOs !== undefined &&
-                    r.numberOfDesiredUTXOs !== args.partial.numberOfDesiredUTXOs)
-                    continue;
-                if (args.partial.minimumDesiredUTXOValue !== undefined &&
-                    r.numberOfDesiredSatoshis !== args.partial.minimumDesiredUTXOValue)
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_e = args.paged) === null || _e === void 0 ? void 0 : _e.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findOutputBaskets(args) {
-        const result = [];
-        await this.filterOutputBaskets(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterOutputs(args, filtered, tagIds, isQueryModeAll) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-        this.assertNoUndefinedInPartial(args.partial);
-        // args.txStatus
-        // args.noScript
-        if (args.partial.lockingScript)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', `undefined. Outputs may not be found by lockingScript value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const stores = ['outputs'];
-        if (tagIds && tagIds.length > 0) {
-            stores.push('output_tags_map');
-        }
-        if (args.txStatus) {
-            stores.push('transactions');
-        }
-        const dbTrx = this.toDbTrx(stores, 'readonly', args.trx);
-        const direction = args.orderDescending ? 'prev' : 'next';
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.outputId) {
-            cursor = await dbTrx.objectStore('outputs').openCursor(args.partial.outputId, direction);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.transactionId) && ((_e = args.partial) === null || _e === void 0 ? void 0 : _e.vout) !== undefined) {
-                cursor = await dbTrx
-                    .objectStore('outputs')
-                    .index('transactionId_vout_userId')
-                    .openCursor([args.partial.transactionId, args.partial.vout, args.partial.userId], direction);
-            }
-            else {
-                cursor = await dbTrx.objectStore('outputs').index('userId').openCursor(args.partial.userId, direction);
-            }
-        }
-        else if (((_f = args.partial) === null || _f === void 0 ? void 0 : _f.transactionId) !== undefined) {
-            cursor = await dbTrx
-                .objectStore('outputs')
-                .index('transactionId')
-                .openCursor(args.partial.transactionId, direction);
-        }
-        else if (((_g = args.partial) === null || _g === void 0 ? void 0 : _g.basketId) !== undefined) {
-            cursor = await dbTrx.objectStore('outputs').index('basketId').openCursor(args.partial.basketId, direction);
-        }
-        else if (((_h = args.partial) === null || _h === void 0 ? void 0 : _h.spentBy) !== undefined) {
-            cursor = await dbTrx.objectStore('outputs').index('spentBy').openCursor(args.partial.spentBy, direction);
-        }
-        else {
-            cursor = await dbTrx.objectStore('outputs').openCursor(null, direction);
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.outputId !== undefined && r.outputId !== args.partial.outputId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.transactionId !== undefined && r.transactionId !== args.partial.transactionId)
-                    continue;
-                if (args.partial.basketId !== undefined && r.basketId !== args.partial.basketId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.spendable !== undefined && r.spendable !== args.partial.spendable)
-                    continue;
-                if (args.partial.change !== undefined && r.change !== args.partial.change)
-                    continue;
-                if (args.partial.outputDescription !== undefined && r.outputDescription !== args.partial.outputDescription)
-                    continue;
-                if (args.partial.vout !== undefined && r.vout !== args.partial.vout)
-                    continue;
-                if (args.partial.satoshis !== undefined && r.satoshis !== args.partial.satoshis)
-                    continue;
-                if (args.partial.providedBy !== undefined && r.providedBy !== args.partial.providedBy)
-                    continue;
-                if (args.partial.purpose !== undefined && r.purpose !== args.partial.purpose)
-                    continue;
-                if (args.partial.type !== undefined && r.type !== args.partial.type)
-                    continue;
-                if (args.partial.txid !== undefined && r.txid !== args.partial.txid)
-                    continue;
-                if (args.partial.senderIdentityKey !== undefined && r.senderIdentityKey !== args.partial.senderIdentityKey)
-                    continue;
-                if (args.partial.derivationPrefix !== undefined && r.derivationPrefix !== args.partial.derivationPrefix)
-                    continue;
-                if (args.partial.derivationSuffix !== undefined && r.derivationSuffix !== args.partial.derivationSuffix)
-                    continue;
-                if (args.partial.customInstructions !== undefined && r.customInstructions !== args.partial.customInstructions)
-                    continue;
-                if (args.partial.spentBy !== undefined && r.spentBy !== args.partial.spentBy)
-                    continue;
-                if (args.partial.sequenceNumber !== undefined && r.sequenceNumber !== args.partial.sequenceNumber)
-                    continue;
-                if (args.partial.scriptLength !== undefined && r.scriptLength !== args.partial.scriptLength)
-                    continue;
-                if (args.partial.scriptOffset !== undefined && r.scriptOffset !== args.partial.scriptOffset)
-                    continue;
-            }
-            if (args.txStatus !== undefined && args.txStatus.length > 0) {
-                const count = await this.countTransactions({
-                    partial: { transactionId: r.transactionId },
-                    status: args.txStatus,
-                    trx: dbTrx
-                });
-                if (count === 0)
-                    continue;
-            }
-            if (tagIds && tagIds.length > 0) {
-                let ids = [...tagIds];
-                await this.filterOutputTagMaps({ partial: { outputId: r.outputId }, trx: dbTrx }, tm => {
-                    if (ids.length > 0) {
-                        const i = ids.indexOf(tm.outputTagId);
-                        if (i >= 0) {
-                            if (isQueryModeAll) {
-                                ids.splice(i, 1);
-                            }
-                            else {
-                                ids = [];
-                            }
-                        }
-                    }
-                });
-                if (ids.length > 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            if (args.noScript === true) {
-                r.script = undefined;
-            }
-            filtered(r);
-            count++;
-            if (((_j = args.paged) === null || _j === void 0 ? void 0 : _j.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findOutputs(args, tagIds, isQueryModeAll) {
-        const results = [];
-        await this.filterOutputs(args, r => {
-            results.push(this.validateEntity(r));
-        }, tagIds, isQueryModeAll);
-        for (const o of results) {
-            // noScript skips the rawTx-slice re-hydration but does not wipe script already
-            // on the row — parity with Knex/Bun, which simply don't SELECT the column.
-            if (!args.noScript)
-                await this.validateOutputScript(o, args.trx);
-        }
-        return results;
-    }
-    async filterOutputTags(args, filtered) {
-        var _a, _b, _c, _d, _e;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['output_tags'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.outputTagId) {
-            cursor = await dbTrx.objectStore('output_tags').openCursor(args.partial.outputTagId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.tag) !== undefined) {
-                cursor = await dbTrx
-                    .objectStore('output_tags')
-                    .index('tag_userId')
-                    .openCursor([args.partial.tag, args.partial.userId]);
-            }
-            else {
-                cursor = await dbTrx.objectStore('output_tags').index('userId').openCursor(args.partial.userId);
-            }
-        }
-        else {
-            cursor = await dbTrx.objectStore('output_tags').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.outputTagId !== undefined && r.outputTagId !== args.partial.outputTagId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.tag !== undefined && r.tag !== args.partial.tag)
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_e = args.paged) === null || _e === void 0 ? void 0 : _e.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findOutputTags(args) {
-        const result = [];
-        await this.filterOutputTags(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterSyncStates(args, filtered) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.syncMap)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.syncMap', `undefined. SyncStates may not be found by syncMap value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['sync_states'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.syncStateId) {
-            cursor = await dbTrx.objectStore('sync_states').openCursor(args.partial.syncStateId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            cursor = await dbTrx.objectStore('sync_states').index('userId').openCursor(args.partial.userId);
-        }
-        else if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.refNum) !== undefined) {
-            cursor = await dbTrx.objectStore('sync_states').index('refNum').openCursor(args.partial.refNum);
-        }
-        else if (((_e = args.partial) === null || _e === void 0 ? void 0 : _e.status) !== undefined) {
-            cursor = await dbTrx.objectStore('sync_states').index('status').openCursor(args.partial.status);
-        }
-        else {
-            cursor = await dbTrx.objectStore('sync_states').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.syncStateId !== undefined && r.syncStateId !== args.partial.syncStateId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.storageIdentityKey !== undefined && r.storageIdentityKey !== args.partial.storageIdentityKey)
-                    continue;
-                if (args.partial.storageName !== undefined && r.storageName !== args.partial.storageName)
-                    continue;
-                if (args.partial.status !== undefined && r.status !== args.partial.status)
-                    continue;
-                if (args.partial.init !== undefined && r.init !== args.partial.init)
-                    continue;
-                if (args.partial.refNum !== undefined && r.refNum !== args.partial.refNum)
-                    continue;
-                if (args.partial.when !== undefined && ((_f = r.when) === null || _f === void 0 ? void 0 : _f.getTime()) !== args.partial.when.getTime())
-                    continue;
-                if (args.partial.satoshis !== undefined && r.satoshis !== args.partial.satoshis)
-                    continue;
-                if (args.partial.errorLocal !== undefined && r.errorLocale !== args.partial.errorLocal)
-                    continue;
-                if (args.partial.errorOther !== undefined && r.errorOther !== args.partial.errorOther)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_g = args.paged) === null || _g === void 0 ? void 0 : _g.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findSyncStates(args) {
-        const result = [];
-        await this.filterSyncStates(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterTransactions(args, filtered, labelIds, isQueryModeAll) {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        this.assertNoUndefinedInPartial(args.partial);
-        if (args.partial.rawTx)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', `undefined. Transactions may not be found by rawTx value.`);
-        if (args.partial.inputBEEF)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.inputBEEF', `undefined. Transactions may not be found by inputBEEF value.`);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const stores = ['transactions'];
-        if (labelIds && labelIds.length > 0) {
-            stores.push('tx_labels_map');
-        }
-        const dbTrx = this.toDbTrx(stores, 'readonly', args.trx);
-        const direction = args.orderDescending ? 'prev' : 'next';
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.transactionId) {
-            cursor = await dbTrx.objectStore('transactions').openCursor(args.partial.transactionId, direction);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.status) !== undefined) {
-                cursor = await dbTrx
-                    .objectStore('transactions')
-                    .index('status_userId')
-                    .openCursor([args.partial.status, args.partial.userId], direction);
-            }
-            else {
-                cursor = await dbTrx.objectStore('transactions').index('userId').openCursor(args.partial.userId, direction);
-            }
-        }
-        else if (((_e = args.partial) === null || _e === void 0 ? void 0 : _e.status) !== undefined) {
-            cursor = await dbTrx.objectStore('transactions').index('status').openCursor(args.partial.status, direction);
-        }
-        else if (((_f = args.partial) === null || _f === void 0 ? void 0 : _f.provenTxId) !== undefined) {
-            cursor = await dbTrx
-                .objectStore('transactions')
-                .index('provenTxId')
-                .openCursor(args.partial.provenTxId, direction);
-        }
-        else if (((_g = args.partial) === null || _g === void 0 ? void 0 : _g.reference) !== undefined) {
-            cursor = await dbTrx.objectStore('transactions').index('reference').openCursor(args.partial.reference, direction);
-        }
-        else {
-            cursor = await dbTrx.objectStore('transactions').openCursor(null, direction);
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.from && r.created_at.getTime() < args.from.getTime())
-                continue;
-            if (args.to && r.created_at.getTime() >= args.to.getTime())
-                continue;
-            if (args.status && args.status.length > 0 && !args.status.includes(r.status))
-                continue;
-            if (args.partial) {
-                if (args.partial.transactionId !== undefined && r.transactionId !== args.partial.transactionId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.provenTxId !== undefined && r.provenTxId !== args.partial.provenTxId)
-                    continue;
-                if (args.partial.status !== undefined && r.status !== args.partial.status)
-                    continue;
-                if (args.partial.reference !== undefined && r.reference !== args.partial.reference)
-                    continue;
-                if (args.partial.isOutgoing !== undefined && r.isOutgoing !== args.partial.isOutgoing)
-                    continue;
-                if (args.partial.satoshis !== undefined && r.satoshis !== args.partial.satoshis)
-                    continue;
-                if (args.partial.description !== undefined && r.description !== args.partial.description)
-                    continue;
-                if (args.partial.version !== undefined && r.version !== args.partial.version)
-                    continue;
-                if (args.partial.lockTime !== undefined && r.lockTime !== args.partial.lockTime)
-                    continue;
-                if (args.partial.txid !== undefined && r.txid !== args.partial.txid)
-                    continue;
-            }
-            if (labelIds && labelIds.length > 0) {
-                let ids = [...labelIds];
-                await this.filterTxLabelMaps({ partial: { transactionId: r.transactionId }, trx: dbTrx }, lm => {
-                    if (ids.length > 0) {
-                        const i = ids.indexOf(lm.txLabelId);
-                        if (i >= 0) {
-                            if (isQueryModeAll) {
-                                ids.splice(i, 1);
-                            }
-                            else {
-                                ids = [];
-                            }
-                        }
-                    }
-                });
-                if (ids.length > 0)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_h = args.paged) === null || _h === void 0 ? void 0 : _h.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findTransactions(args, labelIds, isQueryModeAll) {
-        const results = [];
-        await this.filterTransactions(args, r => {
-            results.push(this.validateEntity(r));
-        }, labelIds, isQueryModeAll);
-        for (const t of results) {
-            // noRawTx skips rawTx re-hydration but does not wipe inputBEEF — Knex's
-            // transactionColumnsWithoutRawTx only strips rawTx, and callers such as
-            // getReqsAndBeefToShareWithWorld legitimately need inputBEEF when noRawTx is set.
-            if (!args.noRawTx)
-                await this.validateRawTransaction(t, args.trx);
-            else
-                t.rawTx = undefined;
-        }
-        return results;
-    }
-    async filterTxLabels(args, filtered) {
-        var _a, _b, _c, _d, _e;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['tx_labels'], 'readonly', args.trx);
-        let cursor;
-        if ((_b = args.partial) === null || _b === void 0 ? void 0 : _b.txLabelId) {
-            cursor = await dbTrx.objectStore('tx_labels').openCursor(args.partial.txLabelId);
-        }
-        else if (((_c = args.partial) === null || _c === void 0 ? void 0 : _c.userId) !== undefined) {
-            if (((_d = args.partial) === null || _d === void 0 ? void 0 : _d.label) !== undefined) {
-                cursor = await dbTrx
-                    .objectStore('tx_labels')
-                    .index('label_userId')
-                    .openCursor([args.partial.label, args.partial.userId]);
-            }
-            else {
-                cursor = await dbTrx.objectStore('tx_labels').index('userId').openCursor(args.partial.userId);
-            }
-        }
-        else {
-            cursor = await dbTrx.objectStore('tx_labels').openCursor();
-        }
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.txLabelId !== undefined && r.txLabelId !== args.partial.txLabelId)
-                    continue;
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.label !== undefined && r.label !== args.partial.label)
-                    continue;
-                if (args.partial.isDeleted !== undefined && r.isDeleted !== args.partial.isDeleted)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_e = args.paged) === null || _e === void 0 ? void 0 : _e.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findTxLabels(args) {
-        const result = [];
-        await this.filterTxLabels(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async filterUsers(args, filtered) {
-        var _a, _b;
-        this.assertNoUndefinedInPartial(args.partial);
-        const offset = ((_a = args.paged) === null || _a === void 0 ? void 0 : _a.offset) || 0;
-        let skipped = 0;
-        let count = 0;
-        const dbTrx = this.toDbTrx(['users'], 'readonly', args.trx);
-        let cursor = await dbTrx.objectStore('users').openCursor();
-        let firstTime = true;
-        while (cursor) {
-            if (!firstTime)
-                cursor = await cursor.continue();
-            if (!cursor)
-                break;
-            firstTime = false;
-            const r = cursor.value;
-            if (args.since && args.since > r.updated_at)
-                continue;
-            if (args.partial) {
-                if (args.partial.userId !== undefined && r.userId !== args.partial.userId)
-                    continue;
-                if (args.partial.created_at !== undefined && r.created_at.getTime() !== args.partial.created_at.getTime())
-                    continue;
-                if (args.partial.updated_at !== undefined && r.updated_at.getTime() !== args.partial.updated_at.getTime())
-                    continue;
-                if (args.partial.identityKey !== undefined && r.identityKey !== args.partial.identityKey)
-                    continue;
-                if (args.partial.activeStorage !== undefined && r.activeStorage !== args.partial.activeStorage)
-                    continue;
-            }
-            if (skipped < offset) {
-                skipped++;
-                continue;
-            }
-            filtered(r);
-            count++;
-            if (((_b = args.paged) === null || _b === void 0 ? void 0 : _b.limit) && count >= args.paged.limit)
-                break;
-        }
-        if (!args.trx)
-            await dbTrx.done;
-    }
-    async findUsers(args) {
-        const result = [];
-        await this.filterUsers(args, r => {
-            result.push(this.validateEntity(r));
-        });
-        return result;
-    }
-    async countCertificateFields(args) {
-        let count = 0;
-        await this.filterCertificateFields(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countCertificates(args) {
-        let count = 0;
-        await this.filterCertificates(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countCommissions(args) {
-        let count = 0;
-        await this.filterCommissions(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countMonitorEvents(args) {
-        let count = 0;
-        await this.filterMonitorEvents(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countOutputBaskets(args) {
-        let count = 0;
-        await this.filterOutputBaskets(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countOutputs(args, tagIds, isQueryModeAll) {
-        let count = 0;
-        await this.filterOutputs({ ...args, noScript: true }, () => {
-            count++;
-        }, tagIds, isQueryModeAll);
-        return count;
-    }
-    async countOutputTags(args) {
-        let count = 0;
-        await this.filterOutputTags(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countSyncStates(args) {
-        let count = 0;
-        await this.filterSyncStates(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countTransactions(args, labelIds, isQueryModeAll) {
-        let count = 0;
-        await this.filterTransactions({ ...args, noRawTx: true }, () => {
-            count++;
-        }, labelIds, isQueryModeAll);
-        return count;
-    }
-    async countTxLabels(args) {
-        let count = 0;
-        await this.filterTxLabels(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async countUsers(args) {
-        let count = 0;
-        await this.filterUsers(args, () => {
-            count++;
-        });
-        return count;
-    }
-    async getProvenTxsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterProvenTxs(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getProvenTxReqsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterProvenTxReqs(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getTxLabelMapsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterTxLabelMaps(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async getOutputTagMapsForUser(args) {
-        const results = [];
-        const fargs = {
-            partial: {},
-            since: args.since,
-            paged: args.paged,
-            trx: args.trx
-        };
-        await this.filterOutputTagMaps(fargs, r => {
-            results.push(this.validateEntity(r));
-        }, args.userId);
-        return results;
-    }
-    async verifyReadyForDatabaseAccess(trx) {
-        if (!this._settings) {
-            this._settings = await this.readSettings();
-        }
-        return this._settings.dbtype;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all individual records with time stamps or number[] retreived from database.
-     */
-    validateEntity(entity, dateFields, booleanFields) {
-        entity.created_at = this.validateDate(entity.created_at);
-        entity.updated_at = this.validateDate(entity.updated_at);
-        if (dateFields) {
-            for (const df of dateFields) {
-                if (entity[df])
-                    entity[df] = this.validateDate(entity[df]);
-            }
-        }
-        if (booleanFields) {
-            for (const df of booleanFields) {
-                if (entity[df] !== undefined)
-                    entity[df] = !!entity[df];
-            }
-        }
-        for (const key of Object.keys(entity)) {
-            const val = entity[key];
-            if (val === null) {
-                entity[key] = undefined;
-            }
-            else if (val instanceof Uint8Array) {
-                entity[key] = Array.from(val);
-            }
-        }
-        return entity;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process all arrays of records with time stamps retreived from database.
-     * @returns input `entities` array with contained values validated.
-     */
-    validateEntities(entities, dateFields, booleanFields) {
-        for (let i = 0; i < entities.length; i++) {
-            entities[i] = this.validateEntity(entities[i], dateFields, booleanFields);
-        }
-        return entities;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process the update template for entities being updated.
-     */
-    validatePartialForUpdate(update, dateFields, booleanFields) {
-        if (!this.dbtype)
-            throw new WERR_errors_1.WERR_INTERNAL('must call verifyReadyForDatabaseAccess first');
-        const v = { ...update };
-        if (v.created_at)
-            v.created_at = this.validateEntityDate(v.created_at);
-        if (v.updated_at)
-            v.updated_at = this.validateEntityDate(v.updated_at);
-        if (!v.created_at)
-            delete v.created_at;
-        if (!v.updated_at)
-            v.updated_at = this.validateEntityDate(new Date());
-        if (dateFields) {
-            for (const df of dateFields) {
-                if (v[df])
-                    v[df] = this.validateOptionalEntityDate(v[df]);
-            }
-        }
-        if (booleanFields) {
-            for (const df of booleanFields) {
-                if (update[df] !== undefined)
-                    update[df] = !!update[df] ? 1 : 0;
-            }
-        }
-        for (const key of Object.keys(v)) {
-            const val = v[key];
-            if (Array.isArray(val) && (val.length === 0 || Number.isInteger(val[0]))) {
-                v[key] = Uint8Array.from(val);
-            }
-            else if (val === null) {
-                v[key] = undefined;
-            }
-        }
-        this.isDirty = true;
-        return v;
-    }
-    /**
-     * Helper to force uniform behavior across database engines.
-     * Use to process new entities being inserted into the database.
-     */
-    async validateEntityForInsert(entity, trx, dateFields, booleanFields) {
-        await this.verifyReadyForDatabaseAccess(trx);
-        const v = { ...entity };
-        v.created_at = this.validateOptionalEntityDate(v.created_at, true);
-        v.updated_at = this.validateOptionalEntityDate(v.updated_at, true);
-        if (!v.created_at)
-            delete v.created_at;
-        if (!v.updated_at)
-            delete v.updated_at;
-        if (dateFields) {
-            for (const df of dateFields) {
-                if (v[df])
-                    v[df] = this.validateOptionalEntityDate(v[df]);
-            }
-        }
-        if (booleanFields) {
-            for (const df of booleanFields) {
-                if (entity[df] !== undefined)
-                    entity[df] = !!entity[df] ? 1 : 0;
-            }
-        }
-        for (const key of Object.keys(v)) {
-            const val = v[key];
-            if (Array.isArray(val) && (val.length === 0 || Number.isInteger(val[0]))) {
-                v[key] = Uint8Array.from(val);
-            }
-            else if (val === null) {
-                v[key] = undefined;
-            }
-        }
-        this.isDirty = true;
-        return v;
-    }
-    async validateRawTransaction(t, trx) {
-        // if there is no txid or there is a rawTransaction return what we have.
-        if (t.rawTx || !t.txid)
-            return;
-        // rawTransaction is missing, see if we moved it ...
-        const rawTx = await this.getRawTxOfKnownValidTransaction(t.txid, undefined, undefined, trx);
-        if (!rawTx)
-            return;
-        t.rawTx = rawTx;
-    }
-    async adminStats(adminIdentityKey) {
-        throw new Error('Method intentionally not implemented for personal storage.');
-    }
-}
-exports.StorageIdb = StorageIdb;
-//# sourceMappingURL=StorageIdb.js.map