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

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

@@ -0,0 +1,26 @@
+import * as sdk from '../../../sdk';
+/**
+ * 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.
+ */
+export interface TableTxAudit extends sdk.EntityTimeStamp {
+    created_at: Date;
+    updated_at: Date;
+    /** PK */
+    auditId: number;
+    /** FK -> transactions.transactionId, optional for action-only events */
+    transactionId?: number;
+    /** FK -> actions.actionId, optional for tx-only events */
+    actionId?: number;
+    /** Stable event identifier, e.g. 'processing.changed', 'proof.acquired' */
+    event: string;
+    /** Optional FSM source state for transitions */
+    fromState?: string;
+    /** Optional FSM target state for transitions */
+    toState?: string;
+    /** JSON-encoded event payload */
+    detailsJson?: string;
+}
+//# sourceMappingURL=TableTxAudit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TableTxAudit.d.ts","sourceRoot":"","sources":["../../../../../../src/storage/schema/tables/TableTxAudit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,cAAc,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,GAAG,CAAC,eAAe;IACvD,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,IAAI,CAAA;IAChB,SAAS;IACT,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB"}

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

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

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

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

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"}

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

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTransactionNewByTxid = findTransactionNewByTxid;
+exports.findTransactionNew = findTransactionNew;
+exports.insertTransactionNew = insertTransactionNew;
+exports.transitionProcessing = transitionProcessing;
+exports.findAction = findAction;
+exports.insertAction = insertAction;
+exports.getChainTip = getChainTip;
+exports.setChainTip = setChainTip;
+exports.mapTransactionRow = mapTransactionRow;
+exports.mapActionRow = mapActionRow;
+const txAudit_1 = require("./txAudit");
+/** Read a single `transactions` (new canonical) row by txid, returning `undefined` if absent. */
+async function findTransactionNewByTxid(knex, txid) {
+    const row = await knex('transactions').where({ txid }).first();
+    return row != null ? mapTransactionRow(row) : undefined;
+}
+/** Read a single `transactions` (new canonical) row by PK. */
+async function findTransactionNew(knex, transactionId) {
+    const row = await knex('transactions').where({ transactionId }).first();
+    return row != null ? mapTransactionRow(row) : undefined;
+}
+/** Insert a new `transactions` (new canonical) row. Caller supplies the full body. */
+async function insertTransactionNew(knex, row, now = new Date()) {
+    const [id] = await knex('transactions').insert(unmapTransactionRow(row, now));
+    if (typeof id === 'number' && id > 0)
+        return id;
+    const r = await knex('transactions').where({ txid: row.txid }).first('transactionId');
+    return r.transactionId;
+}
+/**
+ * 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.
+ */
+async function transitionProcessing(knex, args, now = new Date()) {
+    var _a, _b;
+    const ok = await (0, txAudit_1.auditProcessingTransition)(knex, args.transactionId, args.expectedFromState, args.toState, args.details, now);
+    if (!ok)
+        return undefined;
+    const updated = await knex('transactions')
+        .where({ transactionId: args.transactionId, processing: args.expectedFromState })
+        .update({
+        processing: args.toState,
+        processing_changed_at: now,
+        last_provider: (_a = args.provider) !== null && _a !== void 0 ? _a : null,
+        last_provider_status: (_b = args.providerStatus) !== null && _b !== void 0 ? _b : null,
+        updated_at: now
+    });
+    if (updated === 0)
+        return undefined;
+    const row = await knex('transactions').where({ transactionId: args.transactionId }).first();
+    return mapTransactionRow(row);
+}
+/** Find an action row by `(userId, transactionId)`. */
+async function findAction(knex, userId, transactionId) {
+    const row = await knex('actions').where({ userId, transactionId }).first();
+    return row != null ? mapActionRow(row) : undefined;
+}
+async function insertAction(knex, row, now = new Date()) {
+    var _a;
+    const [id] = await knex('actions').insert({
+        userId: row.userId,
+        transactionId: row.transactionId,
+        reference: row.reference,
+        description: row.description,
+        isOutgoing: row.isOutgoing,
+        satoshis_delta: row.satoshisDelta,
+        user_nosend: row.userNosend,
+        hidden: row.hidden,
+        user_aborted: row.userAborted,
+        notify_json: (_a = row.notifyJson) !== null && _a !== void 0 ? _a : null,
+        row_version: row.rowVersion,
+        created_at: now,
+        updated_at: now
+    });
+    if (typeof id === 'number' && id > 0)
+        return id;
+    const r = await knex('actions').where({ userId: row.userId, transactionId: row.transactionId }).first('actionId');
+    return r.actionId;
+}
+/** Get the singleton chain tip row (`id = 1`). */
+async function getChainTip(knex) {
+    const row = await knex('chain_tip').where({ id: 1 }).first();
+    return row != null ? mapChainTipRow(row) : undefined;
+}
+/** Upsert the singleton chain tip. Always uses `id = 1`. */
+async function setChainTip(knex, args, now = new Date()) {
+    var _a, _b;
+    const existing = await knex('chain_tip').where({ id: 1 }).first('id');
+    if (existing == null) {
+        await knex('chain_tip').insert({
+            id: 1,
+            height: args.height,
+            block_hash: args.blockHash,
+            merkle_root: (_a = args.merkleRoot) !== null && _a !== void 0 ? _a : null,
+            observed_at: now,
+            created_at: now,
+            updated_at: now
+        });
+        return;
+    }
+    await knex('chain_tip').where({ id: 1 }).update({
+        height: args.height,
+        block_hash: args.blockHash,
+        merkle_root: (_b = args.merkleRoot) !== null && _b !== void 0 ? _b : null,
+        observed_at: now,
+        updated_at: now
+    });
+}
+function mapTransactionRow(row) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        transactionId: row.transactionId,
+        txid: row.txid,
+        processing: row.processing,
+        processingChangedAt: new Date(row.processing_changed_at),
+        nextActionAt: row.next_action_at != null ? new Date(row.next_action_at) : undefined,
+        attempts: row.attempts,
+        rebroadcastCycles: row.rebroadcast_cycles,
+        wasBroadcast: !!row.was_broadcast,
+        idempotencyKey: (_a = row.idempotency_key) !== null && _a !== void 0 ? _a : undefined,
+        batch: (_b = row.batch) !== null && _b !== void 0 ? _b : undefined,
+        rawTx: row.raw_tx != null ? Array.from(row.raw_tx.values()) : undefined,
+        inputBeef: row.input_beef != null ? Array.from(row.input_beef.values()) : undefined,
+        height: (_c = row.height) !== null && _c !== void 0 ? _c : undefined,
+        merkleIndex: (_d = row.merkle_index) !== null && _d !== void 0 ? _d : undefined,
+        merklePath: row.merkle_path != null ? Array.from(row.merkle_path.values()) : undefined,
+        merkleRoot: (_e = row.merkle_root) !== null && _e !== void 0 ? _e : undefined,
+        blockHash: (_f = row.block_hash) !== null && _f !== void 0 ? _f : undefined,
+        isCoinbase: !!row.is_coinbase,
+        lastProvider: (_g = row.last_provider) !== null && _g !== void 0 ? _g : undefined,
+        lastProviderStatus: (_h = row.last_provider_status) !== null && _h !== void 0 ? _h : undefined,
+        frozenReason: (_j = row.frozen_reason) !== null && _j !== void 0 ? _j : undefined,
+        rowVersion: row.row_version
+    };
+}
+function unmapTransactionRow(row, now) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    return {
+        txid: row.txid,
+        processing: row.processing,
+        processing_changed_at: row.processingChangedAt,
+        next_action_at: (_a = row.nextActionAt) !== null && _a !== void 0 ? _a : null,
+        attempts: row.attempts,
+        rebroadcast_cycles: row.rebroadcastCycles,
+        was_broadcast: row.wasBroadcast,
+        idempotency_key: (_b = row.idempotencyKey) !== null && _b !== void 0 ? _b : null,
+        batch: (_c = row.batch) !== null && _c !== void 0 ? _c : null,
+        raw_tx: row.rawTx != null ? Buffer.from(row.rawTx) : null,
+        input_beef: row.inputBeef != null ? Buffer.from(row.inputBeef) : null,
+        height: (_d = row.height) !== null && _d !== void 0 ? _d : null,
+        merkle_index: (_e = row.merkleIndex) !== null && _e !== void 0 ? _e : null,
+        merkle_path: row.merklePath != null ? Buffer.from(row.merklePath) : null,
+        merkle_root: (_f = row.merkleRoot) !== null && _f !== void 0 ? _f : null,
+        block_hash: (_g = row.blockHash) !== null && _g !== void 0 ? _g : null,
+        is_coinbase: row.isCoinbase,
+        last_provider: (_h = row.lastProvider) !== null && _h !== void 0 ? _h : null,
+        last_provider_status: (_j = row.lastProviderStatus) !== null && _j !== void 0 ? _j : null,
+        frozen_reason: (_k = row.frozenReason) !== null && _k !== void 0 ? _k : null,
+        row_version: row.rowVersion,
+        created_at: now,
+        updated_at: now
+    };
+}
+function mapActionRow(row) {
+    var _a;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        actionId: row.actionId,
+        userId: row.userId,
+        transactionId: row.transactionId,
+        reference: row.reference,
+        description: row.description,
+        isOutgoing: !!row.isOutgoing,
+        satoshisDelta: row.satoshis_delta,
+        userNosend: !!row.user_nosend,
+        hidden: !!row.hidden,
+        userAborted: !!row.user_aborted,
+        notifyJson: (_a = row.notify_json) !== null && _a !== void 0 ? _a : undefined,
+        rowVersion: row.row_version
+    };
+}
+function mapChainTipRow(row) {
+    var _a;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        id: row.id,
+        height: row.height,
+        blockHash: row.block_hash,
+        merkleRoot: (_a = row.merkle_root) !== null && _a !== void 0 ? _a : undefined,
+        observedAt: new Date(row.observed_at)
+    };
+}
+//# sourceMappingURL=transactionCrud.js.map

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

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

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

@@ -0,0 +1,315 @@
+import { Beef } from '@bsv/sdk';
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+import { TableAction, TableOutput, TableTransactionNew } from './tables';
+import { MonitorLeaseClaim, MonitorLeaseRelease, MonitorLeaseRenew, MonitorLeaseResult } from './monitorLease';
+/**
+ * High-level service over the new-schema storage primitives.
+ *
+ * Storage methods and the Monitor call into this surface rather than the
+ * lower-level CRUD/FSM/audit/lease modules so that:
+ *  - Every processing transition is audited.
+ *  - Optimistic concurrency is uniformly enforced.
+ *  - Chain tip + monitor lease access have one canonical entry point.
+ *
+ * Construction takes a Knex handle; instances are stateless and cheap to
+ * create — typically one per request or per Monitor task tick.
+ */
+/**
+ * Extract the merkle leaf index for `txid` from a BUMP-encoded merkle path.
+ *
+ * The BUMP format encodes level 0 leaves with `txid: true` and an `offset`
+ * equal to the position of the transaction in its block. For a single-tx
+ * proof exactly one leaf is flagged; for trimmed compound proofs the leaf
+ * matching `txid` is selected.
+ */
+export declare function indexFromMerklePath(merklePath: number[], txid: string): number;
+export declare class TransactionService {
+    private readonly knex;
+    constructor(knex: Knex);
+    findByTxid(txid: string): Promise<TableTransactionNew | undefined>;
+    findById(transactionId: number): Promise<TableTransactionNew | undefined>;
+    /**
+     * Insert a new new transaction row. The row is created in `queued` state
+     * unless the caller overrides `processing`.
+     */
+    create(args: {
+        txid: string;
+        processing?: sdk.ProcessingStatus;
+        rawTx?: number[];
+        inputBeef?: number[];
+        batch?: string;
+        idempotencyKey?: string;
+        isCoinbase?: boolean;
+        now?: Date;
+    }): Promise<TableTransactionNew>;
+    /**
+     * Transition processing state with optimistic concurrency. Returns
+     * `undefined` when the FSM rejects the move OR the row's current state no
+     * longer matches `expectedFrom`.
+     */
+    transition(args: {
+        transactionId: number;
+        expectedFrom: sdk.ProcessingStatus;
+        to: sdk.ProcessingStatus;
+        provider?: string;
+        providerStatus?: string;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<TableTransactionNew | undefined>;
+    /**
+     * Record acquisition of a Merkle proof for a transaction. Atomically:
+     *  - Updates proof columns (height, index, merkle_path, merkle_root, block_hash)
+     *  - Transitions processing to `confirmed` from any spendable-class state.
+     *  - Writes a `proof.acquired` audit row.
+     *
+     * The merkle leaf index is derived from `merklePath` (BUMP) using the row's
+     * `txid`; callers do not pass it.
+     */
+    recordProof(args: {
+        transactionId: number;
+        height: number;
+        merklePath: number[];
+        merkleRoot: string;
+        blockHash: string;
+        expectedFrom: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<TableTransactionNew | undefined>;
+    findActionForUser(userId: number, transactionId: number): Promise<TableAction | undefined>;
+    createAction(args: {
+        userId: number;
+        transactionId: number;
+        reference: string;
+        description: string;
+        isOutgoing: boolean;
+        satoshisDelta: number;
+        userNosend?: boolean;
+        notifyJson?: string;
+        now?: Date;
+    }): Promise<number>;
+    getChainTip(): Promise<{
+        height: number;
+        blockHash: string;
+    } | undefined>;
+    setChainTip(args: {
+        height: number;
+        blockHash: string;
+        merkleRoot?: string;
+        now?: Date;
+    }): Promise<void>;
+    tryClaimLease(claim: MonitorLeaseClaim, now?: Date): Promise<MonitorLeaseResult>;
+    renewLease(renew: MonitorLeaseRenew, now?: Date): Promise<MonitorLeaseResult>;
+    releaseLease(release: MonitorLeaseRelease): Promise<boolean>;
+    /**
+     * #1 — Look up an action + its backing transaction by (userId, reference).
+     */
+    findActionByReference(userId: number, reference: string): Promise<{
+        action: TableAction;
+        transaction: TableTransactionNew;
+    } | undefined>;
+    /**
+     * #2 — Look up an action + its backing transaction by (userId, txid).
+     */
+    findActionByUserTxid(userId: number, txid: string): Promise<{
+        action: TableAction;
+        transaction: TableTransactionNew;
+    } | undefined>;
+    /**
+     * #3 — Upsert: find existing action for (userId, txid) or create both the new
+     * transaction row and the action row.
+     */
+    findOrCreateActionForTxid(args: {
+        userId: number;
+        txid: string;
+        isOutgoing: boolean;
+        description: string;
+        satoshisDelta: number;
+        reference: string;
+        rawTx?: number[];
+        inputBeef?: number[];
+        processing?: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<{
+        action: TableAction;
+        transaction: TableTransactionNew;
+        isNew: boolean;
+    }>;
+    /**
+     * #4 — Atomically update the satoshisDelta column on an action row.
+     */
+    updateActionSatoshisDelta(actionId: number, delta: number, now?: Date): Promise<void>;
+    /**
+     * #5 — Create a new transaction row already in `confirmed` state with all proof
+     * columns populated. Useful for internalised transactions that arrive with a
+     * Merkle proof (bump) already attached.
+     */
+    createWithProof(args: {
+        txid: string;
+        rawTx?: number[];
+        inputBeef?: number[];
+        height: number;
+        merklePath: number[];
+        merkleRoot: string;
+        blockHash: string;
+        isCoinbase?: boolean;
+        now?: Date;
+    }): Promise<TableTransactionNew>;
+    /**
+     * #6 — Find an existing new transaction row for the given txid (suitable for
+     * the broadcast queue) or create a new one in `queued` state.
+     */
+    findOrCreateForBroadcast(args: {
+        txid: string;
+        rawTx: number[];
+        inputBeef?: number[];
+        batch?: string;
+        processing?: sdk.ProcessingStatus;
+        now?: Date;
+    }): Promise<{
+        transaction: TableTransactionNew;
+        isNew: boolean;
+    }>;
+    /**
+     * #7 — Bulk transition: attempt `transition` for each id; collect results.
+     * When `expectedFrom` is omitted the current state of each row is used as
+     * the expected source (lenient mode — only the FSM is checked).
+     */
+    transitionMany(args: {
+        transactionIds: number[];
+        expectedFrom?: sdk.ProcessingStatus;
+        to: sdk.ProcessingStatus;
+        provider?: string;
+        providerStatus?: string;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<{
+        updated: number[];
+        skipped: number[];
+    }>;
+    /**
+     * #8 — Bulk-set the `batch` column for a list of transaction ids.
+     * Pass `undefined` to clear the batch tag.
+     */
+    setBatch(transactionIds: number[], batch: string | undefined, now?: Date): Promise<void>;
+    /**
+     * #9 — Atomically increment the `attempts` counter for one transaction and
+     * write an `attempts.incremented` audit entry.
+     */
+    incrementAttempts(transactionId: number, now?: Date): Promise<TableTransactionNew | undefined>;
+    /**
+     * #10 — Record the outcome of a broadcast attempt. Transitions processing
+     * state, updates `wasBroadcast` and `lastProvider*` columns, and writes an
+     * audit row.
+     */
+    recordBroadcastResult(args: {
+        transactionId: number;
+        txid: string;
+        status: sdk.ProcessingStatus;
+        provider: string;
+        providerStatus?: string;
+        wasBroadcast?: boolean;
+        details?: Record<string, unknown>;
+        now?: Date;
+    }): Promise<TableTransactionNew | undefined>;
+    /**
+     * #11 — Append a free-form history note to the audit log for a transaction.
+     */
+    recordHistoryNote(transactionId: number, note: {
+        what: string;
+        [k: string]: unknown;
+    }, now?: Date): Promise<void>;
+    /**
+     * #12 — For each txid that exists in the new transactions table, merge the
+     * raw transaction bytes and (where available) the Merkle path into `beef`.
+     * Txids not present in new-schema are silently skipped.
+     */
+    mergeBeefForTxids(beef: Beef, txids: string[]): Promise<void>;
+    /**
+     * #13 — Collect broadcast-readiness info and a populated Beef for a list of
+     * txids. Each entry is classified as:
+     *  - `readyToSend`  — queued/sending → still needs broadcast
+     *  - `alreadySent`  — sent/seen/seen_multi/unconfirmed/confirmed → already on network
+     *  - `error`        — invalid/doubleSpend → terminal failure
+     *  - `unknown`      — not found in new-schema
+     */
+    collectReqsAndBeef(txids: string[], extraTxids?: string[]): Promise<{
+        beef: Beef;
+        details: Array<{
+            txid: string;
+            status: 'readyToSend' | 'alreadySent' | 'error' | 'unknown';
+            reason?: string;
+        }>;
+    }>;
+    /**
+     * #14 — Paginated list of actions (per-user transaction views) with optional
+     * status and label filters.
+     *
+     * After the the schema cutover `tx_labels_map.transactionId` references `actions.actionId`
+     * (not `transactions.transactionId`).
+     */
+    listActionsForUser(args: {
+        userId: number;
+        statusFilter?: sdk.ProcessingStatus[];
+        labelIds?: number[];
+        labelQueryMode?: 'all' | 'any';
+        createdAtFrom?: Date;
+        createdAtTo?: Date;
+        limit: number;
+        offset: number;
+    }): Promise<{
+        rows: Array<TableAction & {
+            txid: string;
+            processing: sdk.ProcessingStatus;
+            height?: number;
+        }>;
+        total?: number;
+    }>;
+    /**
+     * #15 — Paginated list of outputs with their backing transaction processing
+     * state. Optional filters: basket, tag set, processing state, spent flag.
+     */
+    listOutputsForUser(args: {
+        userId: number;
+        basketId?: number;
+        tagIds?: number[];
+        tagQueryMode?: 'all' | 'any';
+        processingFilter: sdk.ProcessingStatus[];
+        includeSpent: boolean;
+        limit: number;
+        offset: number;
+        includeLockingScripts?: boolean;
+    }): Promise<{
+        rows: Array<TableOutput & {
+            processing: sdk.ProcessingStatus;
+        }>;
+        total?: number;
+    }>;
+    /**
+     * Post-cutover helper: rewrite `tx_labels_map.transactionId` rows that were
+     * written with the legacy transactionId (before the real txid + actionId were
+     * known) so that they now point at the new-schema `actions.actionId`.
+     *
+     * Call this once per new outgoing transaction immediately after
+     * `findOrCreateActionForTxid` resolves the actionId.
+     *
+     * This is a no-op when:
+     *  - `legacyTransactionId` has no rows in `tx_labels_map` (no labels on the tx)
+     *  - `legacyTransactionId === actionId` (should not happen in practice but
+     *    is safe to call anyway)
+     */
+    repointLabelsToActionId(legacyTransactionId: number, actionId: number, now?: Date): Promise<void>;
+    /**
+     * After `processAction` creates the new `transactions` row, remap
+     * `outputs.transactionId` and `outputs.spentBy` from the bridge-period
+     * `transactions_legacy.transactionId` to the real `transactions.transactionId`.
+     *
+     * During `createAction`, new outputs are inserted with `transactionId =
+     * legacyTransactionId` (bypassing FK constraints). `listActionsKnex` queries
+     * outputs by new transactionId, so without this remap the outputs would be
+     * invisible to `listActions`.
+     *
+     * This is a no-op when `legacyTransactionId === newTransactionId`.
+     */
+    repointOutputsToNewTransactionId(legacyTransactionId: number, newTransactionId: number, now?: Date): Promise<void>;
+}
+//# sourceMappingURL=transactionService.d.ts.map