@bsv/wallet-toolbox 2.1.24 → 2.1.25

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

@@ -0,0 +1,45 @@
+import * as sdk from '../../sdk';
+import { TableChainTip, TableOutput, TableTransactionV7 } from './tables';
+/**
+ * Per-output inputs for the V7 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','proven'))
+ *           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: TableTransactionV7 | undefined, tip: TableChainTip | undefined): boolean;
+//# sourceMappingURL=v7Spendability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v7Spendability.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7Spendability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAGzE;;;;;;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,kBAAkB,GAAG,SAAS,EAClC,GAAG,EAAE,aAAa,GAAG,SAAS,GAC7B,OAAO,CAYT"}

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isOutputSpendable = isOutputSpendable;
+exports.isTableOutputSpendable = isTableOutputSpendable;
+const v7Fsm_1 = require("./v7Fsm");
+/**
+ * Pure implementation of the §4 spendability rule:
+ *
+ * ```
+ * spendable = (transactions.processing IN ('sent','seen','seen_multi','unconfirmed','proven'))
+ *           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, v7Fsm_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=v7Spendability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v7Spendability.js","sourceRoot":"","sources":["../../../../src/storage/schema/v7Spendability.ts"],"names":[],"mappings":";;AAwCA,8CAcC;AAMD,wDAgBC;AA1ED,mCAA+C;AAwB/C;;;;;;;;;;;;;GAaG;AACH,SAAgB,iBAAiB,CAC/B,GAA4B,EAC5B,EAAuB,EACvB,GAAqC;IAErC,IAAI,CAAC,IAAA,6BAAqB,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,EAAkC,EAClC,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/v7TxAudit.d.ts

@@ -0,0 +1,33 @@
+import { Knex } from 'knex';
+import * as sdk from '../../sdk';
+import { TableTxAudit } from './tables';
+/**
+ * V7 append-only audit log writer.
+ *
+ * Each call inserts one `tx_audit` row. Events should be small, stable
+ * identifiers (e.g. `processing.changed`, `proof.acquired`, `lease.claimed`).
+ * Payload is stored as a JSON-encoded string so downstream consumers may add
+ * shape over time without a migration.
+ */
+export interface AuditEvent {
+    transactionId?: number;
+    actionId?: number;
+    event: string;
+    fromState?: sdk.ProcessingStatus;
+    toState?: sdk.ProcessingStatus;
+    details?: Record<string, unknown>;
+}
+export declare function appendTxAudit(knex: Knex, ev: AuditEvent, now?: Date): Promise<number>;
+/**
+ * Convenience helper for processing transitions. Validates the move first;
+ * on rejection it still records the attempt with `event = 'processing.rejected'`
+ * so the audit trail captures impossible transitions for later diagnosis.
+ *
+ * Returns `true` when the transition is legal (audit row written with
+ * `processing.changed`) and `false` when rejected (audit row written with
+ * `processing.rejected`).
+ */
+export declare function auditProcessingTransition(knex: Knex, transactionId: number, from: sdk.ProcessingStatus, to: sdk.ProcessingStatus, details?: Record<string, unknown>, now?: Date): Promise<boolean>;
+/** Read all audit rows for a transaction, oldest first. Useful for tests. */
+export declare function listAuditForTransaction(knex: Knex, transactionId: number): Promise<TableTxAudit[]>;
+//# sourceMappingURL=v7TxAudit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v7TxAudit.d.ts","sourceRoot":"","sources":["../../../../src/storage/schema/v7TxAudit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAA;IAChC,OAAO,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,EAAE,EAAE,UAAU,EACd,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,GAAG,CAAC,gBAAgB,EAC1B,EAAE,EAAE,GAAG,CAAC,gBAAgB,EACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,6EAA6E;AAC7E,wBAAsB,uBAAuB,CAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzG"}

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendTxAudit = appendTxAudit;
+exports.auditProcessingTransition = auditProcessingTransition;
+exports.listAuditForTransaction = listAuditForTransaction;
+const v7Fsm_1 = require("./v7Fsm");
+async function appendTxAudit(knex, ev, now = new Date()) {
+    var _a, _b, _c, _d;
+    const detailsJson = ev.details != null ? JSON.stringify(ev.details) : null;
+    const [id] = await knex('tx_audit').insert({
+        transactionId: (_a = ev.transactionId) !== null && _a !== void 0 ? _a : null,
+        actionId: (_b = ev.actionId) !== null && _b !== void 0 ? _b : null,
+        event: ev.event,
+        from_state: (_c = ev.fromState) !== null && _c !== void 0 ? _c : null,
+        to_state: (_d = ev.toState) !== null && _d !== void 0 ? _d : null,
+        details_json: detailsJson,
+        created_at: now,
+        updated_at: now
+    });
+    if (typeof id === 'number')
+        return id;
+    const row = await knex('tx_audit').orderBy('auditId', 'desc').first('auditId');
+    return row.auditId;
+}
+/**
+ * Convenience helper for processing transitions. Validates the move first;
+ * on rejection it still records the attempt with `event = 'processing.rejected'`
+ * so the audit trail captures impossible transitions for later diagnosis.
+ *
+ * Returns `true` when the transition is legal (audit row written with
+ * `processing.changed`) and `false` when rejected (audit row written with
+ * `processing.rejected`).
+ */
+async function auditProcessingTransition(knex, transactionId, from, to, details, now = new Date()) {
+    const v = (0, v7Fsm_1.validateProcessingTransition)(from, to);
+    await appendTxAudit(knex, {
+        transactionId,
+        event: v.ok ? 'processing.changed' : 'processing.rejected',
+        fromState: from,
+        toState: to,
+        details: v.ok ? details : { ...(details !== null && details !== void 0 ? details : {}), reason: v.reason }
+    }, now);
+    return v.ok;
+}
+/** Read all audit rows for a transaction, oldest first. Useful for tests. */
+async function listAuditForTransaction(knex, transactionId) {
+    const rows = await knex('tx_audit').where({ transactionId }).orderBy('auditId');
+    return rows.map(mapRow);
+}
+function mapRow(row) {
+    var _a, _b, _c, _d, _e;
+    return {
+        created_at: new Date(row.created_at),
+        updated_at: new Date(row.updated_at),
+        auditId: row.auditId,
+        transactionId: (_a = row.transactionId) !== null && _a !== void 0 ? _a : undefined,
+        actionId: (_b = row.actionId) !== null && _b !== void 0 ? _b : undefined,
+        event: row.event,
+        fromState: (_c = row.from_state) !== null && _c !== void 0 ? _c : undefined,
+        toState: (_d = row.to_state) !== null && _d !== void 0 ? _d : undefined,
+        detailsJson: (_e = row.details_json) !== null && _e !== void 0 ? _e : undefined
+    };
+}
+//# sourceMappingURL=v7TxAudit.js.map

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

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

package/out/src/storage/storageProviderHelpers.d.ts

@@ -0,0 +1,34 @@
+import { Beef } from '@bsv/sdk';
+import { TableProvenTxReq } from './schema/tables/TableProvenTxReq';
+import { TrxToken } from '../sdk/WalletStorage.interfaces';
+import { GetReqsAndBeefDetail } from './methods/processAction';
+import { ReqHistoryNote } from '../sdk/types';
+/**
+ * Classify a ProvenTxReq status into beef-sharing lifecycle status.
+ * Mutates `d` in place.
+ */
+export declare function classifyReqStatus(d: GetReqsAndBeefDetail, req: TableProvenTxReq): void;
+/**
+ * For each input of `rawTx`, ensure the source txid is represented in `beef`.
+ *
+ * When `requiredLevels` is undefined/0 and `knownTxids` contains the source txid,
+ * a txid-only stub is merged rather than recursing into storage.
+ */
+export declare function mergeInputBeefs(rawTx: number[], beef: Beef, trustSelf: 'known' | undefined, knownTxids: string[] | undefined, trx: TrxToken | undefined, requiredLevels: number | undefined, getValidBeef: (txid: string, beef: Beef, trustSelf: 'known' | undefined, knownTxids: string[] | undefined, trx: TrxToken | undefined, requiredLevels: number | undefined) => Promise<unknown>): Promise<void>;
+/**
+ * Convenience wrapper for the external-sharing path where `trustSelf` and
+ * `requiredLevels` are always absent.
+ */
+export declare function mergeInputsIntoBeef(rawTx: number[], beef: Beef, knownTxids: string[], trx: TrxToken | undefined, getValidBeef: (txid: string, beef: Beef, trustSelf: undefined, knownTxids: string[], trx: TrxToken | undefined) => Promise<unknown>): Promise<void>;
+/**
+ * Notify each transaction that a proof has been found.
+ * Mutates `req` history notes in place.
+ *
+ * The `addNote` and `flushNotes` callbacks avoid coupling this helper to a
+ * specific entity type.
+ */
+export declare function notifyTransactionsOfProof(ids: number[], provenTxId: number, addNote: (note: ReqHistoryNote) => void, flushNotes: () => Promise<void>, updateTransaction: (id: number, update: {
+    provenTxId: number;
+    status: 'completed';
+}) => Promise<unknown>): Promise<void>;
+//# sourceMappingURL=storageProviderHelpers.d.ts.map

package/out/src/storage/storageProviderHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageProviderHelpers.d.ts","sourceRoot":"","sources":["../../../src/storage/storageProviderHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAU7C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAE,CAAC,EAAE,oBAAoB,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAiBvF;AAMD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,YAAY,EAAE,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,cAAc,EAAE,MAAM,GAAG,SAAS,KAC/B,OAAO,CAAC,OAAO,CAAC,GACpB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAAE,EACpB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,GAClI,OAAO,CAAC,IAAI,CAAC,CAWf;AAMD;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EAAE,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,EACvC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC/B,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GACvG,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/out/src/storage/storageProviderHelpers.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyReqStatus = classifyReqStatus;
+exports.mergeInputBeefs = mergeInputBeefs;
+exports.mergeInputsIntoBeef = mergeInputsIntoBeef;
+exports.notifyTransactionsOfProof = notifyTransactionsOfProof;
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../sdk/WERR_errors");
+const WalletError_1 = require("../sdk/WalletError");
+// ---------------------------------------------------------------------------
+// getReqsAndBeefToShareWithWorld helpers
+// ---------------------------------------------------------------------------
+const alreadySentStatuses = new Set(['unmined', 'callback', 'unconfirmed', 'completed']);
+const readyToSendStatuses = new Set(['sending', 'unsent', 'nosend', 'unprocessed']);
+const errorStatuses = new Set(['unknown', 'nonfinal', 'invalid', 'doubleSpend']);
+/**
+ * Classify a ProvenTxReq status into beef-sharing lifecycle status.
+ * Mutates `d` in place.
+ */
+function classifyReqStatus(d, req) {
+    if (errorStatuses.has(req.status)) {
+        d.status = 'error';
+        d.error = `ERR_INVALID_PARAMETER: ${d.txid} is not ready to send.`;
+    }
+    else if (alreadySentStatuses.has(req.status)) {
+        d.status = 'alreadySent';
+    }
+    else if (readyToSendStatuses.has(req.status)) {
+        if ((req.rawTx == null) || req.inputBEEF == null) {
+            d.status = 'error';
+            d.error = `ERR_INTERNAL: ${d.txid} req is missing rawTx or beef.`;
+        }
+        else {
+            d.status = 'readyToSend';
+        }
+    }
+    else {
+        d.status = 'error';
+        d.error = `ERR_INTERNAL: ${d.txid} has unexpected req status ${req.status}`;
+    }
+}
+// ---------------------------------------------------------------------------
+// Beef input-merge helpers (used by mergeReqToBeefToShareExternally and getValidBeefForTxid)
+// ---------------------------------------------------------------------------
+/**
+ * For each input of `rawTx`, ensure the source txid is represented in `beef`.
+ *
+ * When `requiredLevels` is undefined/0 and `knownTxids` contains the source txid,
+ * a txid-only stub is merged rather than recursing into storage.
+ */
+async function mergeInputBeefs(rawTx, beef, trustSelf, knownTxids, trx, requiredLevels, getValidBeef) {
+    var _a;
+    const tx = sdk_1.Transaction.fromBinary(rawTx);
+    for (const input of tx.inputs) {
+        const sourceTXID = (_a = input.sourceTXID) !== null && _a !== void 0 ? _a : '';
+        if (sourceTXID === '')
+            throw new WERR_errors_1.WERR_INTERNAL('req all transaction inputs must have valid sourceTXID');
+        if (beef.findTxid(sourceTXID) != null)
+            continue;
+        if ((requiredLevels == null || requiredLevels === 0) && (knownTxids === null || knownTxids === void 0 ? void 0 : knownTxids.includes(sourceTXID))) {
+            beef.mergeTxidOnly(sourceTXID);
+        }
+        else {
+            await getValidBeef(sourceTXID, beef, trustSelf, knownTxids, trx, requiredLevels);
+        }
+    }
+}
+/**
+ * Convenience wrapper for the external-sharing path where `trustSelf` and
+ * `requiredLevels` are always absent.
+ */
+async function mergeInputsIntoBeef(rawTx, beef, knownTxids, trx, getValidBeef) {
+    await mergeInputBeefs(rawTx, beef, undefined, knownTxids, trx, undefined, async (txid, beef, _trustSelf, knownTxids, trx) => getValidBeef(txid, beef, undefined, knownTxids, trx));
+}
+// ---------------------------------------------------------------------------
+// updateProvenTxReqWithNewProvenTx helpers
+// ---------------------------------------------------------------------------
+/**
+ * Notify each transaction that a proof has been found.
+ * Mutates `req` history notes in place.
+ *
+ * The `addNote` and `flushNotes` callbacks avoid coupling this helper to a
+ * specific entity type.
+ */
+async function notifyTransactionsOfProof(ids, provenTxId, addNote, flushNotes, updateTransaction) {
+    if (ids.length === 0)
+        return;
+    for (const id of ids) {
+        try {
+            await updateTransaction(id, { provenTxId, status: 'completed' });
+            addNote({ what: 'notifyTxOfProof', transactionId: id });
+        }
+        catch (error_) {
+            const { code, description } = WalletError_1.WalletError.fromUnknown(error_);
+            addNote({ what: 'notifyTxOfProofError', id, provenTxId, code, description });
+        }
+    }
+    await flushNotes();
+}
+//# sourceMappingURL=storageProviderHelpers.js.map

package/out/src/storage/storageProviderHelpers.js.map

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

package/out/src/storage/sync/StorageMySQLDojoReader.d.ts

@@ -8,8 +8,7 @@ import { TableOutputBasket } from '../schema/tables/TableOutputBasket';
 import { TableOutput } from '../schema/tables/TableOutput';
 import { TableProvenTxReq } from '../schema/tables/TableProvenTxReq';
 import { Chain, EntityTimeStamp } from '../../sdk/types';
-import { FindCertificateFieldsArgs, FindCommissionsArgs, FindForUserSincePagedArgs, FindMonitorEventsArgs, FindOutputTagsArgs, FindPartialSincePagedArgs, FindSyncStatesArgs, FindTransactionsArgs, FindTxLabelsArgs, FindUsersArgs, TrxToken, WalletStorageSyncReader } from '../../sdk/WalletStorage.interfaces';
-import { FindCertificatesArgs, FindOutputBasketsArgs, FindOutputsArgs } from '../../sdk/WalletStorage.interfaces';
+import { FindCertificateFieldsArgs, FindCommissionsArgs, FindForUserSincePagedArgs, FindMonitorEventsArgs, FindOutputTagsArgs, FindPartialSincePagedArgs, FindSyncStatesArgs, FindTransactionsArgs, FindTxLabelsArgs, FindUsersArgs, TrxToken, WalletStorageSyncReader, FindCertificatesArgs, FindOutputBasketsArgs, FindOutputsArgs } from '../../sdk/WalletStorage.interfaces';
 import { TableTxLabel } from '../schema/tables/TableTxLabel';
 import { TableOutputTag } from '../schema/tables/TableOutputTag';
 import { TableTransaction } from '../schema/tables/TableTransaction';

package/out/src/storage/sync/StorageMySQLDojoReader.d.ts.map

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

package/out/src/storage/sync/StorageMySQLDojoReader.js

@@ -13,7 +13,7 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
     constructor(options) {
         super(options);
         if (!options.knex)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('options.knex', `valid`);
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('options.knex', 'valid');
         this.knex = options.knex;
     }
     async destroy() {
@@ -21,7 +21,7 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
         await ((_a = this.knex) === null || _a === void 0 ? void 0 : _a.destroy());
     }
     async transaction(scope, trx) {
-        if (trx)
+        if (trx != null)
             return await scope(trx);
         return await this.knex.transaction(async (knextrx) => {
             const trx = knextrx;
@@ -30,7 +30,7 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
     }
     toDb(trx) {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const db = !trx ? this.knex : trx;
+        const db = (trx == null) ? this.knex : trx;
         this.whenLastAccess = new Date();
         return db;
     }
@@ -45,18 +45,19 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
             dbtype: 'MySQL',
             maxOutputScript: 256
         };
-        if (r.storageName.startsWith('staging') && this.chain !== 'test')
+        if (r.storageName.startsWith('staging') && this.chain !== 'test') {
             throw new WERR_errors_1.WERR_INVALID_PARAMETER('chain', `in aggreement with storage chain ${r.storageName}`);
+        }
         this._settings = r;
         return r;
     }
     setupQuery(table, args) {
-        let q = this.toDb(args.trx)(table);
+        const q = this.toDb(args.trx)(table);
         if (args.partial && Object.keys(args.partial).length > 0)
             q.where(args.partial);
-        if (args.since)
+        if (args.since != null)
             q.where('updated_at', '>=', this.validateDateForWhere(args.since));
-        if (args.paged) {
+        if (args.paged != null) {
             q.limit(args.paged.limit);
             q.offset(args.paged.offset || 0);
         }
@@ -125,16 +126,18 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
         return this.validateEntities(rs, undefined, ['isDeleted']);
     }
     findTransactionsQuery(args, count) {
-        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.`);
+        if (args.partial.rawTx != null) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.rawTx', 'undefined. Transactions may not be found by rawTx value.');
+        }
+        if (args.partial.inputBEEF != null) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.inputBEEF', 'undefined. Transactions may not be found by inputBEEF value.');
+        }
         const q = this.setupQuery('transactions', args);
-        if (args.status && args.status.length > 0)
+        if ((args.status != null) && args.status.length > 0)
             q.whereIn('status', args.status);
-        if (args.from)
+        if (args.from != null)
             q.where('created_at', '>=', this.validateDateForWhere(args.from));
-        if (args.to)
+        if (args.to != null)
             q.where('created_at', '<', this.validateDateForWhere(args.to));
         if (args.noRawTx && !count) {
             const columns = TableTransaction_1.transactionColumnsWithoutRawTx.map(c => `transactions.${c}`);
@@ -169,8 +172,9 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
         return this.validateEntities(rs, undefined, ['isOutgoing']);
     }
     findCommissionsQuery(args) {
-        if (args.partial.lockingScript)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', `undefined. Commissions may not be found by lockingScript value.`);
+        if (args.partial.lockingScript != null) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', 'undefined. Commissions may not be found by lockingScript value.');
+        }
         return this.setupQuery('commissions', args);
     }
     async findCommissions(args) {
@@ -199,8 +203,9 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
         return s;
     }
     findOutputsQuery(args, count) {
-        if (args.partial.lockingScript)
-            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', `undefined. Outputs may not be found by lockingScript value.`);
+        if (args.partial.lockingScript != null) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('args.partial.lockingScript', 'undefined. Outputs may not be found by lockingScript value.');
+        }
         const q = this.setupQuery('outputs', args);
         if (args.noScript && !count) {
             const columns = TableOutput_1.outputColumnsWithoutLockingScript.map(c => `outputs.${c}`);
@@ -223,7 +228,7 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
                 spendable: !!d.spendable,
                 change: d.providedBy !== 'you' && d.purpose === 'change',
                 outputDescription: (d.description || '').trim(),
-                vout: (0, utilityHelpers_1.verifyInteger)(typeof d.vout !== 'number' ? 9999 : d.vout),
+                vout: (0, utilityHelpers_1.verifyInteger)(typeof d.vout === 'number' ? d.vout : 9999),
                 satoshis: (0, utilityHelpers_1.verifyInteger)(d.amount),
                 providedBy: (0, utilityHelpers_1.verifyTruthy)(d.providedBy || 'you')
                     .trim()
@@ -249,9 +254,9 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
     }
     findCertificatesQuery(args) {
         const q = this.setupQuery('certificates', args);
-        if (args.certifiers && args.certifiers.length > 0)
+        if ((args.certifiers != null) && args.certifiers.length > 0)
             q.whereIn('certifier', args.certifiers);
-        if (args.types && args.types.length > 0)
+        if ((args.types != null) && args.types.length > 0)
             q.whereIn('type', args.types);
         return q;
     }
@@ -350,11 +355,11 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
                 .from('transactions')
                 .whereRaw(`proven_txs.provenTxId = transactions.provenTxId and transactions.userId = ${args.userId}`));
         });
-        if (args.paged) {
+        if (args.paged != null) {
             q = q.limit(args.paged.limit);
             q = q.offset(args.paged.offset || 0);
         }
-        if (args.since)
+        if (args.since != null)
             q = q.where('updated_at', '>=', args.since);
         return q;
     }
@@ -392,11 +397,11 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
                 .from('transactions')
                 .whereRaw(`proven_tx_reqs.txid = transactions.txid and transactions.userId = ${args.userId}`));
         });
-        if (args.paged) {
+        if (args.paged != null) {
             q = q.limit(args.paged.limit);
             q = q.offset(args.paged.offset || 0);
         }
-        if (args.since)
+        if (args.since != null)
             q = q.where('updated_at', '>=', args.since);
         return q;
     }
@@ -429,9 +434,9 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
             .select('*')
             .from('tx_labels')
             .whereRaw(`tx_labels.txLabelId = tx_labels_map.txLabelId and tx_labels.userId = ${args.userId}`));
-        if (args.since)
+        if (args.since != null)
             q = q.where('updated_at', '>=', this.validateDateForWhere(args.since));
-        if (args.paged) {
+        if (args.paged != null) {
             q = q.limit(args.paged.limit);
             q = q.offset(args.paged.offset || 0);
         }
@@ -459,9 +464,9 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
             .select('*')
             .from('output_tags')
             .whereRaw(`output_tags.outputTagId = output_tags_map.outputTagId and output_tags.userId = ${args.userId}`));
-        if (args.since)
+        if (args.since != null)
             q = q.where('updated_at', '>=', this.validateDateForWhere(args.since));
-        if (args.paged) {
+        if (args.paged != null) {
             q = q.limit(args.paged.limit);
             q = q.offset(args.paged.offset || 0);
         }
@@ -526,13 +531,13 @@ class StorageMySQLDojoReader extends StorageReader_1.StorageReader {
     validateEntity(entity, dateFields, booleanFields) {
         entity.created_at = this.validateDate(entity.created_at);
         entity.updated_at = this.validateDate(entity.updated_at);
-        if (dateFields) {
+        if (dateFields != null) {
             for (const df of dateFields) {
                 if (entity[df])
                     entity[df] = this.validateDate(entity[df]);
             }
         }
-        if (booleanFields) {
+        if (booleanFields != null) {
             for (const df of booleanFields) {
                 if (entity[df] !== undefined)
                     entity[df] = !!entity[df];
@@ -584,7 +589,7 @@ function deserializeTscMerkleProofNodes(nodes) {
 function convertReqStatus(status) {
     return status;
 }
-//type TransactionStatus =
+// type TransactionStatus =
 //   'completed' | 'failed' | 'unprocessed' | 'sending' | 'unproven' | 'unsigned' | 'nosend'
 function convertTxStatus(status) {
     return status;