@bsv/wallet-toolbox 2.1.25 → 3.0.0-alpha.0

package/out/src/storage/schema/schemaCutoverIdb.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runIdbSchemaCutover = runIdbSchemaCutover;
+const idb_1 = require("idb");
+/**
+ * IDB-side schema cutover.
+ *
+ * IndexedDB has no `RENAME STORE` primitive, and store creation/deletion is
+ * only permitted during a version-upgrade transaction. The cutover therefore:
+ *
+ *   1. Re-opens the database at a higher version, supplying an `upgrade`
+ *      callback that does the rename via copy-and-delete on the upgrade trx.
+ *   2. For each table that needs renaming:
+ *        a. Read every row from the source store.
+ *        b. Create the destination store with the same indexes.
+ *        c. Write rows into the destination store.
+ *        d. Delete the source store.
+ *   3. Returns the upgraded database handle (caller is responsible for
+ *      closing it).
+ *
+ * Safe to call twice — the second call sees the post-cutover layout, skips
+ * the rename block, and returns without error.
+ *
+ * `targetVersion` defaults to 2; bump it if the caller already operates on a
+ * higher schema version.
+ */
+async function runIdbSchemaCutover(dbName, targetVersion = 2) {
+    return await (0, idb_1.openDB)(dbName, targetVersion, {
+        async upgrade(db, oldVersion, _newVersion, trx) {
+            if (oldVersion >= 2)
+                return;
+            if (!db.objectStoreNames.contains('transactions_new'))
+                return;
+            await renameStore(db, trx, 'transactions', 'transactions_legacy', store => {
+                store.createIndex('userId', 'userId');
+                store.createIndex('status', 'status');
+                store.createIndex('status_userId', ['status', 'userId']);
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('reference', 'reference', { unique: true });
+            });
+            await renameStore(db, trx, 'proven_tx_reqs', 'proven_tx_reqs_legacy', store => {
+                store.createIndex('provenTxId', 'provenTxId');
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('status', 'status');
+                store.createIndex('batch', 'batch');
+            });
+            await renameStore(db, trx, 'proven_txs', 'proven_txs_legacy', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+            });
+            await renameStore(db, trx, 'transactions_new', 'transactions', store => {
+                store.createIndex('txid', 'txid', { unique: true });
+                store.createIndex('processing', 'processing');
+                store.createIndex('batch', 'batch');
+                store.createIndex('idempotencyKey', 'idempotencyKey', { unique: true });
+            });
+        }
+    });
+}
+async function renameStore(db, trx, fromName, toName, applyIndexes) {
+    if (!db.objectStoreNames.contains(fromName))
+        return;
+    if (db.objectStoreNames.contains(toName)) {
+        // Target already exists — assume a prior partial cutover. Drop the source
+        // and continue rather than fail; the application is expected to verify
+        // post-cutover state via its own smoke tests before resuming traffic.
+        db.deleteObjectStore(fromName);
+        return;
+    }
+    const sourceStore = trx.objectStore(fromName);
+    const sourceKeyPath = sourceStore.keyPath;
+    const sourceAutoIncrement = sourceStore.autoIncrement;
+    const rows = await sourceStore.getAll();
+    const keys = await sourceStore.getAllKeys();
+    db.deleteObjectStore(fromName);
+    const dest = db.createObjectStore(toName, {
+        keyPath: sourceKeyPath !== null && sourceKeyPath !== void 0 ? sourceKeyPath : undefined,
+        autoIncrement: sourceAutoIncrement
+    });
+    applyIndexes(dest);
+    const destStore = trx.objectStore(toName);
+    for (let i = 0; i < rows.length; i++) {
+        if (sourceAutoIncrement || sourceKeyPath != null) {
+            await destStore.put(rows[i]);
+        }
+        else {
+            await destStore.put(rows[i], keys[i]);
+        }
+    }
+}
+//# sourceMappingURL=schemaCutoverIdb.js.map

package/out/src/storage/schema/schemaCutoverIdb.js.map

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

package/out/src/storage/schema/spendabilityRefresh.d.ts

@@ -0,0 +1,49 @@
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+/**
+ * Recompute and persist `outputs.spendable` for every output whose current
+ * cached value disagrees with the §4 rule.
+ *
+ * The §4 rule depends on three inputs:
+ *   - The owning transaction's `processing` state.
+ *   - Whether the output has been spent.
+ *   - For coinbase outputs, whether maturity height has been reached on the
+ *     current chain tip.
+ *
+ * Strategy: stream outputs joined with their owning transaction's processing
+ * state in batches, evaluate the rule per row in JS, and update only rows
+ * whose persisted `spendable` flag differs from the freshly-computed value.
+ *
+ * Returns counts so callers can detect drift and emit metrics.
+ */
+export interface RefreshSpendabilityStats {
+    examined: number;
+    flipped: number;
+}
+export interface RefreshSpendabilityArgs {
+    /** Limit to outputs owned by this user. Default: refresh all users. */
+    userId?: number;
+    /** Reuse a chain tip already fetched by the caller. */
+    chainTip?: {
+        height: number;
+    };
+}
+export declare function refreshOutputsSpendable(knex: Knex, args?: RefreshSpendabilityArgs): Promise<RefreshSpendabilityStats>;
+/**
+ * Fast-path counter used by the new-schema hot query in §2.3:
+ *
+ *   SELECT * FROM outputs
+ *   WHERE user_id = ? AND spendable = true AND basketId = default
+ *   ORDER BY satoshis DESC LIMIT 100
+ *
+ * Returns the count of spendable outputs visible to the user in a basket
+ * without joining transactions. Used by tests to assert that the cached
+ * `outputs.spendable` column stays in sync with processing state.
+ */
+export declare function countCachedSpendable(knex: Knex, args: {
+    userId: number;
+    basketId?: number;
+}): Promise<number>;
+/** Snapshot of every spendable processing state. Mostly informational. */
+export declare function spendableProcessingStates(): readonly sdk.ProcessingStatus[];
+//# sourceMappingURL=spendabilityRefresh.d.ts.map

package/out/src/storage/schema/spendabilityRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spendabilityRefresh.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/spendabilityRefresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAOhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAkEnC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,IAAK,SAAS,GAAG,CAAC,gBAAgB,EAAE,CAE5E"}

package/out/src/storage/schema/spendabilityRefresh.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.refreshOutputsSpendable = refreshOutputsSpendable;
+exports.countCachedSpendable = countCachedSpendable;
+exports.spendableProcessingStates = spendableProcessingStates;
+const sdk = __importStar(require("../../sdk"));
+const spendabilityRule_1 = require("./spendabilityRule");
+const REFRESH_BATCH = 500;
+const SPENDABLE_STATES = sdk.ProcessingSpendableStatus.slice();
+async function refreshOutputsSpendable(knex, args = {}) {
+    var _a, _b, _c, _d, _e;
+    const stats = { examined: 0, flipped: 0 };
+    const tip = (_a = args.chainTip) !== null && _a !== void 0 ? _a : (await knex('chain_tip').where({ id: 1 }).first('height'));
+    const tipHeight = tip === null || tip === void 0 ? void 0 : tip.height;
+    let lastId = 0;
+    /* eslint-disable-next-line no-constant-condition */
+    while (true) {
+        const baseQuery = knex('outputs as o')
+            .leftJoin('transactions as t', 't.transactionId', 'o.transactionId')
+            .where('o.outputId', '>', lastId)
+            .orderBy('o.outputId')
+            .limit(REFRESH_BATCH)
+            .select(knex.ref('o.outputId').as('outputId'), knex.ref('o.spendable').as('spendable'), knex.ref('o.spentBy').as('spentBy'), knex.ref('o.lockingScript').as('lockingScript'), knex.raw('o.scriptLength as scriptLength'), knex.raw('o.matures_at_height as maturesAtHeight'), knex.ref('t.processing').as('processing'), knex.ref('t.is_coinbase').as('isCoinbase'));
+        const rows = args.userId != null
+            ? await baseQuery.andWhere('o.userId', args.userId)
+            : await baseQuery;
+        if (rows.length === 0)
+            return stats;
+        for (const row of rows) {
+            lastId = row.outputId;
+            stats.examined += 1;
+            // Reorg rule (bsv_wallet_transaction_requirements v1.0 §6):
+            // "Reorg: Revert transaction status; preserve the current spendable
+            // value of outputs (do not flip to false)."
+            // We honor this by skipping refresh while the owning transaction is
+            // in the `reorging` state. Whatever spendable value was cached at
+            // entry into reorg is preserved until the reorg resolves and the
+            // transaction transitions back to a normal state.
+            if (row.processing === 'reorging')
+                continue;
+            const desired = (0, spendabilityRule_1.isOutputSpendable)({
+                spentBy: (_b = row.spentBy) !== null && _b !== void 0 ? _b : null,
+                // Treat presence of scriptLength as equivalent to presence of
+                // locking script — the §4 rule only requires that some locking
+                // script exists, not that it has been fetched into memory.
+                lockingScript: (_d = ((_c = row.lockingScript) !== null && _c !== void 0 ? _c : null)) !== null && _d !== void 0 ? _d : (row.scriptLength != null ? [0] : null),
+                isCoinbase: row.isCoinbase === 1 || row.isCoinbase === true,
+                // Read the persisted maturity height from the new outputs column.
+                // A null value for a coinbase row means maturity has not been
+                // computed yet; the §4 rule treats that as not-yet-mature and
+                // refuses spendability until backfill populates the column.
+                maturesAtHeight: (_e = row.maturesAtHeight) !== null && _e !== void 0 ? _e : null
+            }, { processing: row.processing }, tipHeight != null ? { height: tipHeight } : undefined);
+            const current = row.spendable === 1 || row.spendable === true;
+            if (current !== desired) {
+                await knex('outputs')
+                    .where({ outputId: row.outputId })
+                    .update({ spendable: desired });
+                stats.flipped += 1;
+            }
+        }
+    }
+}
+/**
+ * Fast-path counter used by the new-schema hot query in §2.3:
+ *
+ *   SELECT * FROM outputs
+ *   WHERE user_id = ? AND spendable = true AND basketId = default
+ *   ORDER BY satoshis DESC LIMIT 100
+ *
+ * Returns the count of spendable outputs visible to the user in a basket
+ * without joining transactions. Used by tests to assert that the cached
+ * `outputs.spendable` column stays in sync with processing state.
+ */
+async function countCachedSpendable(knex, args) {
+    var _a;
+    const q = knex('outputs').where({ userId: args.userId, spendable: true });
+    if (args.basketId != null)
+        q.andWhere({ basketId: args.basketId });
+    const row = await q.count({ c: '*' }).first();
+    return (_a = row === null || row === void 0 ? void 0 : row.c) !== null && _a !== void 0 ? _a : 0;
+}
+/** Snapshot of every spendable processing state. Mostly informational. */
+function spendableProcessingStates() {
+    return SPENDABLE_STATES;
+}
+//# sourceMappingURL=spendabilityRefresh.js.map

package/out/src/storage/schema/spendabilityRefresh.js.map

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

package/out/src/storage/schema/spendabilityRule.d.ts

@@ -0,0 +1,45 @@
+import * as sdk from '../../sdk';
+import { TableChainTip, TableOutput, TableTransactionNew } from './tables';
+/**
+ * Per-output inputs for the new-schema spendability check.
+ *
+ * Only the fields needed by §4 of PROD_REQ_V7_TS.md are required; callers are
+ * free to pass full rows. `spentBy` is the legacy `outputs.spentBy` column;
+ * coinbase fields use the names introduced in §2.3.
+ */
+export interface SpendabilityOutputInput {
+    spentBy?: number | null;
+    lockingScript?: number[] | null;
+    isCoinbase?: boolean;
+    maturesAtHeight?: number | null;
+}
+export interface SpendabilityTxInput {
+    processing: sdk.ProcessingStatus;
+}
+export interface SpendabilityTipInput {
+    height: number;
+}
+/**
+ * Pure implementation of the §4 spendability rule:
+ *
+ * ```
+ * spendable = (transactions.processing IN ('sent','seen','seen_multi','unconfirmed','confirmed'))
+ *           AND outputs.spent_by IS NULL
+ *           AND outputs.locking_script IS NOT NULL
+ *           AND (NOT outputs.is_coinbase OR outputs.matures_at_height <= chain_tip.height)
+ * ```
+ *
+ * The function never reads from storage — call sites are responsible for
+ * loading the matching transaction row and chain tip. This keeps the rule
+ * testable in isolation and lets the refresh helpers batch loads efficiently.
+ */
+export declare function isOutputSpendable(out: SpendabilityOutputInput, tx: SpendabilityTxInput, tip: SpendabilityTipInput | undefined): boolean;
+/**
+ * Convenience wrapper that takes whole table rows and forwards to the pure
+ * predicate. Returns `false` when the matching transaction row is missing.
+ */
+export declare function isTableOutputSpendable(out: TableOutput & {
+    isCoinbase?: boolean;
+    maturesAtHeight?: number | null;
+}, tx: TableTransactionNew | undefined, tip: TableChainTip | undefined): boolean;
+//# sourceMappingURL=spendabilityRule.d.ts.map

package/out/src/storage/schema/spendabilityRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spendabilityRule.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/spendabilityRule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAG1E;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAA;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,uBAAuB,EAC5B,EAAE,EAAE,mBAAmB,EACvB,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACpC,OAAO,CAUT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAC5E,EAAE,EAAE,mBAAmB,GAAG,SAAS,EACnC,GAAG,EAAE,aAAa,GAAG,SAAS,GAC7B,OAAO,CAYT"}

package/out/src/storage/schema/spendabilityRule.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOutputSpendable = isOutputSpendable;
+exports.isTableOutputSpendable = isTableOutputSpendable;
+const processingFsm_1 = require("./processingFsm");
+/**
+ * Pure implementation of the §4 spendability rule:
+ *
+ * ```
+ * spendable = (transactions.processing IN ('sent','seen','seen_multi','unconfirmed','confirmed'))
+ *           AND outputs.spent_by IS NULL
+ *           AND outputs.locking_script IS NOT NULL
+ *           AND (NOT outputs.is_coinbase OR outputs.matures_at_height <= chain_tip.height)
+ * ```
+ *
+ * The function never reads from storage — call sites are responsible for
+ * loading the matching transaction row and chain tip. This keeps the rule
+ * testable in isolation and lets the refresh helpers batch loads efficiently.
+ */
+function isOutputSpendable(out, tx, tip) {
+    if (!(0, processingFsm_1.isProcessingSpendable)(tx.processing))
+        return false;
+    if (out.spentBy != null)
+        return false;
+    if (out.lockingScript == null)
+        return false;
+    if (out.isCoinbase === true) {
+        if (tip == null)
+            return false;
+        if (out.maturesAtHeight == null)
+            return false;
+        if (out.maturesAtHeight > tip.height)
+            return false;
+    }
+    return true;
+}
+/**
+ * Convenience wrapper that takes whole table rows and forwards to the pure
+ * predicate. Returns `false` when the matching transaction row is missing.
+ */
+function isTableOutputSpendable(out, tx, tip) {
+    var _a, _b, _c;
+    if (tx === undefined)
+        return false;
+    return isOutputSpendable({
+        spentBy: (_a = out.spentBy) !== null && _a !== void 0 ? _a : null,
+        lockingScript: (_b = out.lockingScript) !== null && _b !== void 0 ? _b : null,
+        isCoinbase: out.isCoinbase === true,
+        maturesAtHeight: (_c = out.maturesAtHeight) !== null && _c !== void 0 ? _c : null
+    }, { processing: tx.processing }, tip != null ? { height: tip.height } : undefined);
+}
+//# sourceMappingURL=spendabilityRule.js.map

package/out/src/storage/schema/spendabilityRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spendabilityRule.js","sourceRoot":"","sources":["../../../../src/storage/schema/spendabilityRule.ts"],"names":[],"mappings":";;AAwCA,8CAcC;AAMD,wDAgBC;AA1ED,mDAAuD;AAwBvD;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAC/B,GAA4B,EAC5B,EAAuB,EACvB,GAAqC;IAErC,IAAI,CAAC,IAAA,qCAAqB,EAAC,EAAE,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAA;IACvD,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IACrC,IAAI,GAAG,CAAC,aAAa,IAAI,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,IAAI;YAAE,OAAO,KAAK,CAAA;QAC7B,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI;YAAE,OAAO,KAAK,CAAA;QAC7C,IAAI,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,MAAM;YAAE,OAAO,KAAK,CAAA;IACpD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,GAA4E,EAC5E,EAAmC,EACnC,GAA8B;;IAE9B,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAClC,OAAO,iBAAiB,CACtB;QACE,OAAO,EAAE,MAAA,GAAG,CAAC,OAAO,mCAAI,IAAI;QAC5B,aAAa,EAAE,MAAA,GAAG,CAAC,aAAa,mCAAI,IAAI;QACxC,UAAU,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI;QACnC,eAAe,EAAE,MAAA,GAAG,CAAC,eAAe,mCAAI,IAAI;KAC7C,EACD,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,EAC7B,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CACjD,CAAA;AACH,CAAC"}

package/out/src/storage/schema/tables/TableAction.d.ts

@@ -1,10 +1,10 @@
 import * as sdk from '../../../sdk';
 /**
- * V7 per-user view of a transaction.
+ * per-user view of a transaction.
  *
  * Migrated from the legacy `transactions` table. Holds everything that is truly
  * per-user (description, labels via tx_labels_map -> actionId, soft-delete flags,
- * notification subscribers). All on-chain status lives in the V7 `transactions`
+ * notification subscribers). All on-chain status lives in the new `transactions`
  * table addressed by `transactionId`.
  *
  * UNIQUE(userId, transactionId).
@@ -15,7 +15,7 @@ export interface TableAction extends sdk.EntityTimeStamp {
     /** PK */
     actionId: number;
     userId: number;
-    /** FK -> V7 transactions.transactionId (per-txid record) */
+    /** FK -> new transactions.transactionId (per-txid record) */
     transactionId: number;
     /** Application reference, hex/Base64, max 64 chars */
     reference: string;

package/out/src/storage/schema/tables/TableAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableAction.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAA;IACnB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAA;IACf,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;CACnB"}
+{"version":3,"file":"TableAction.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAA;IACnB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAA;IACrB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAA;IACnB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAA;IACf,0BAA0B;IAC1B,WAAW,EAAE,OAAO,CAAA;IACpB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableChainTip.d.ts

@@ -1,6 +1,6 @@
 import * as sdk from '../../../sdk';
 /**
- * V7 singleton row tracking the most recently observed chain tip.
+ * singleton row tracking the most recently observed chain tip.
  * Used by spendability checks and coinbase maturity calculations.
  */
 export interface TableChainTip extends sdk.EntityTimeStamp {

package/out/src/storage/schema/tables/TableMonitorLease.d.ts

@@ -1,6 +1,6 @@
 import * as sdk from '../../../sdk';
 /**
- * V7 lease record so at most one Monitor daemon owns a given task at a time.
+ * monitor_lease record so at most one Monitor daemon owns a given task at a time.
  *
  * The Monitor acquires a lease by upserting `(taskName, ownerId, expiresAt)`
  * and renews periodically. Stale leases (`expiresAt < now`) may be claimed by

package/out/src/storage/schema/tables/TableOutput.d.ts

@@ -28,6 +28,13 @@ export interface TableOutput extends sdk.EntityTimeStamp {
     scriptLength?: number;
     scriptOffset?: number;
     lockingScript?: number[];
+    /**
+     * new-schema: minimum block height at which a coinbase output becomes spendable.
+     * NULL for non-coinbase outputs and for pre-new schema rows that have not yet been
+     * backfilled. The §4 spendability rule treats a non-coinbase output as
+     * mature regardless of this column.
+     */
+    maturesAtHeight?: number;
 }
 export interface TableOutputX extends TableOutput {
     basket?: TableOutputBasket;

package/out/src/storage/schema/tables/TableOutput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutput.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,iBAAiB,EAAE,2BAA2B,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAC7B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,iCAAiC,UA0B7C,CAAA"}
+{"version":3,"file":"TableOutput.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC,MAAM,WAAW,WAAY,SAAQ,GAAG,CAAC,eAAe;IACtD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;IACf,iBAAiB,EAAE,2BAA2B,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,GAAG,CAAC,iBAAiB,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAC7B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,gBAAgB,CAAC,EAAE,YAAY,CAAA;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,iCAAiC,UA0B7C,CAAA"}

package/out/src/storage/schema/tables/TableOutput.js.map

@@ -1 +1 @@
-{"version":3,"file":"TableOutput.js","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":";;;AAsCa,QAAA,iCAAiC,GAAG;IAC/C,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,YAAY;IACZ,SAAS;IACT,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,SAAS;IACT,gBAAgB;IAChB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,mBAAmB;CACpB,CAAA"}
+{"version":3,"file":"TableOutput.js","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableOutput.ts"],"names":[],"mappings":";;;AA6Ca,QAAA,iCAAiC,GAAG;IAC/C,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,eAAe;IACf,UAAU;IACV,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,YAAY;IACZ,SAAS;IACT,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,mBAAmB;IACnB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,SAAS;IACT,gBAAgB;IAChB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,mBAAmB;CACpB,CAAA"}

package/out/src/storage/schema/tables/TableTransactionNew.d.ts

@@ -0,0 +1,50 @@
+import * as sdk from '../../../sdk';
+/**
+ * new canonical per-txid table.
+ *
+ * Single source of truth for everything about a transaction on the network.
+ * Merges the legacy `proven_tx_reqs` (broadcast queue + processing state) and
+ * `proven_txs` (final Merkle proof) tables into one row per txid.
+ *
+ * Per-user metadata (description, labels, hidden, etc.) lives in `actions`.
+ */
+export interface TableTransactionNew extends sdk.EntityTimeStamp {
+    created_at: Date;
+    updated_at: Date;
+    /** PK */
+    transactionId: number;
+    /** UNIQUE — Bitcoin txid, hex */
+    txid: string;
+    /** Granular FSM state (see ProcessingStatus) */
+    processing: sdk.ProcessingStatus;
+    /** Wall-clock of the most recent processing transition */
+    processingChangedAt: Date;
+    /** Wall-clock at which the next monitor pass should consider this row */
+    nextActionAt?: Date;
+    /** Cumulative network-service attempt count */
+    attempts: number;
+    /** Count of times this row has been reset for rebroadcast (circuit-breaker) */
+    rebroadcastCycles: number;
+    /** true once the row has reached a state implying successful broadcast */
+    wasBroadcast: boolean;
+    /** Application-supplied idempotency key (unique when present) */
+    idempotencyKey?: string;
+    /** Optional batch tag for grouped broadcast */
+    batch?: string;
+    rawTx?: number[];
+    inputBeef?: number[];
+    /** Merkle proof fields — populated on transition to `proven` */
+    height?: number;
+    merkleIndex?: number;
+    merklePath?: number[];
+    merkleRoot?: string;
+    blockHash?: string;
+    isCoinbase: boolean;
+    lastProvider?: string;
+    lastProviderStatus?: string;
+    /** Reason a row is in `frozen` state, free text */
+    frozenReason?: string;
+    /** Optimistic concurrency token */
+    rowVersion: number;
+}
+//# sourceMappingURL=TableTransactionNew.d.ts.map

package/out/src/storage/schema/tables/TableTransactionNew.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableTransactionNew.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableTransactionNew.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAoB,SAAQ,GAAG,CAAC,eAAe;IAC9D,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS;IACT,aAAa,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAA;IAChC,0DAA0D;IAC1D,mBAAmB,EAAE,IAAI,CAAA;IACzB,yEAAyE;IACzE,YAAY,CAAC,EAAE,IAAI,CAAA;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAA;IACzB,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAA;IACrB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;CACnB"}

package/out/src/storage/schema/tables/TableTransactionNew.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TableTransactionNew.js.map

package/out/src/storage/schema/tables/TableTransactionNew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableTransactionNew.js","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/TableTransactionNew.ts"],"names":[],"mappings":""}

package/out/src/storage/schema/tables/TableTxAudit.d.ts

@@ -1,6 +1,6 @@
 import * as sdk from '../../../sdk';
 /**
- * V7 per-event audit log for transactions and actions.
+ * per-event audit log for transactions and actions.
  *
  * Each row records a single observable event scoped to either a transaction
  * (per-txid) or an action (per-user) or both. Append-only.

package/out/src/storage/schema/tables/index.d.ts

@@ -14,4 +14,9 @@ export * from './TableTxLabel';
 export * from './TableTxLabelMap';
 export * from './TableMonitorEvent';
 export * from './TableSyncState';
+export * from './TableAction';
+export * from './TableTransactionNew';
+export * from './TableChainTip';
+export * from './TableTxAudit';
+export * from './TableMonitorLease';
 //# sourceMappingURL=index.d.ts.map

package/out/src/storage/schema/tables/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA"}

package/out/src/storage/schema/tables/index.js

@@ -30,4 +30,9 @@ __exportStar(require("./TableTxLabel"), exports);
 __exportStar(require("./TableTxLabelMap"), exports);
 __exportStar(require("./TableMonitorEvent"), exports);
 __exportStar(require("./TableSyncState"), exports);
+__exportStar(require("./TableAction"), exports);
+__exportStar(require("./TableTransactionNew"), exports);
+__exportStar(require("./TableChainTip"), exports);
+__exportStar(require("./TableTxAudit"), exports);
+__exportStar(require("./TableMonitorLease"), exports);
 //# sourceMappingURL=index.js.map

package/out/src/storage/schema/tables/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B;AAC/B,qDAAkC;AAClC,8CAA2B;AAC3B,qDAAkC;AAClC,0DAAuC;AACvC,sDAAmC;AACnC,qDAAkC;AAClC,oDAAiC;AACjC,gDAA6B;AAC7B,mDAAgC;AAChC,sDAAmC;AACnC,iDAA8B;AAC9B,oDAAiC;AACjC,sDAAmC;AACnC,mDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/storage/schema/tables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B;AAC/B,qDAAkC;AAClC,8CAA2B;AAC3B,qDAAkC;AAClC,0DAAuC;AACvC,sDAAmC;AACnC,qDAAkC;AAClC,oDAAiC;AACjC,gDAA6B;AAC7B,mDAAgC;AAChC,sDAAmC;AACnC,iDAA8B;AAC9B,oDAAiC;AACjC,sDAAmC;AACnC,mDAAgC;AAChC,gDAA6B;AAC7B,wDAAqC;AACrC,kDAA+B;AAC/B,iDAA8B;AAC9B,sDAAmC"}

package/out/src/storage/schema/transactionCrud.d.ts

@@ -0,0 +1,41 @@
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+import { TableAction, TableChainTip, TableTransactionNew } from './tables';
+/** Read a single `transactions` (new canonical) row by txid, returning `undefined` if absent. */
+export declare function findTransactionNewByTxid(knex: Knex, txid: string): Promise<TableTransactionNew | undefined>;
+/** Read a single `transactions` (new canonical) row by PK. */
+export declare function findTransactionNew(knex: Knex, transactionId: number): Promise<TableTransactionNew | undefined>;
+/** Insert a new `transactions` (new canonical) row. Caller supplies the full body. */
+export declare function insertTransactionNew(knex: Knex, row: Omit<TableTransactionNew, 'transactionId' | 'created_at' | 'updated_at'>, now?: Date): Promise<number>;
+/**
+ * Transition the processing column atomically and append a `tx_audit` row.
+ * Returns the new `TableTransactionNew` on success and `undefined` when the
+ * source state did not match the row (CAS failed) or the transition was
+ * rejected by the FSM.
+ *
+ * Optimistic concurrency: the caller passes the `expectedFromState` they
+ * read in the same logical operation; the update only fires when the row's
+ * current `processing` still equals that value.
+ */
+export declare function transitionProcessing(knex: Knex, args: {
+    transactionId: number;
+    expectedFromState: sdk.ProcessingStatus;
+    toState: sdk.ProcessingStatus;
+    details?: Record<string, unknown>;
+    provider?: string;
+    providerStatus?: string;
+}, now?: Date): Promise<TableTransactionNew | undefined>;
+/** Find an action row by `(userId, transactionId)`. */
+export declare function findAction(knex: Knex, userId: number, transactionId: number): Promise<TableAction | undefined>;
+export declare function insertAction(knex: Knex, row: Omit<TableAction, 'actionId' | 'created_at' | 'updated_at'>, now?: Date): Promise<number>;
+/** Get the singleton chain tip row (`id = 1`). */
+export declare function getChainTip(knex: Knex): Promise<TableChainTip | undefined>;
+/** Upsert the singleton chain tip. Always uses `id = 1`. */
+export declare function setChainTip(knex: Knex, args: {
+    height: number;
+    blockHash: string;
+    merkleRoot?: string;
+}, now?: Date): Promise<void>;
+export declare function mapTransactionRow(row: any): TableTransactionNew;
+export declare function mapActionRow(row: any): TableAction;
+//# sourceMappingURL=transactionCrud.d.ts.map

package/out/src/storage/schema/transactionCrud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionCrud.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/transactionCrud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EACL,WAAW,EACX,aAAa,EACb,mBAAmB,EACpB,MAAM,UAAU,CAAA;AAGjB,iGAAiG;AACjG,wBAAsB,wBAAwB,CAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAGlH;AAED,8DAA8D;AAC9D,wBAAsB,kBAAkB,CAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAGrH;AAED,sFAAsF;AACtF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,IAAI,CAAC,mBAAmB,EAAE,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC,EAC7E,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;IACJ,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,GAAG,CAAC,gBAAgB,CAAA;IACvC,OAAO,EAAE,GAAG,CAAC,gBAAgB,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,EACD,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAsB1C;AAED,uDAAuD;AACvD,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAGlC;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC,EAChE,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,kDAAkD;AAClD,wBAAsB,WAAW,CAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAGjF;AAED,4DAA4D;AAC5D,wBAAsB,WAAW,CAC/B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,wBAAgB,iBAAiB,CAAE,GAAG,EAAE,GAAG,GAAG,mBAAmB,CA2BhE;AAiCD,wBAAgB,YAAY,CAAE,GAAG,EAAE,GAAG,GAAG,WAAW,CAiBnD"}