@bsv/wallet-toolbox 2.6.5 → 2.7.1

package/out/src/storage/methods/managedChangePolicy.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MANAGED_CHANGE_PENDING_COMPARISON_INPUTS = exports.DEFAULT_MANAGED_CHANGE_MIGRATION_INPUTS_PER_ACTION = exports.DEFAULT_MANAGED_CHANGE_MAX_OUTPUTS_PER_ACTION = exports.DEFAULT_MANAGED_CHANGE_MINIMUM_SATOSHIS = exports.DEFAULT_MANAGED_CHANGE_TARGET_UTXOS = exports.LEGACY_MANAGED_CHANGE_MINIMUM_SATOSHIS = void 0;
+exports.isLegacyManagedChangeBasketDefault = isLegacyManagedChangeBasketDefault;
+exports.upgradeLegacyManagedChangeBasketDefault = upgradeLegacyManagedChangeBasketDefault;
+exports.defaultManagedChangePolicy = defaultManagedChangePolicy;
+exports.validateManagedChangePolicy = validateManagedChangePolicy;
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+/** Historical default retained only to identify untouched wallet baskets. */
+exports.LEGACY_MANAGED_CHANGE_MINIMUM_SATOSHIS = 32;
+/**
+ * Default liquidity policy for wallet-managed change.
+ *
+ * The preferred minimum is deliberately much larger than the dust threshold.
+ * Dust answers "can this output ever be spent economically?"; this value
+ * answers "is this output useful as an independently selectable liquidity
+ * unit at contemporary fee rates?".
+ */
+exports.DEFAULT_MANAGED_CHANGE_TARGET_UTXOS = 144;
+exports.DEFAULT_MANAGED_CHANGE_MINIMUM_SATOSHIS = 5_000;
+exports.DEFAULT_MANAGED_CHANGE_MAX_OUTPUTS_PER_ACTION = 8;
+exports.DEFAULT_MANAGED_CHANGE_MIGRATION_INPUTS_PER_ACTION = 4;
+exports.DEFAULT_MANAGED_CHANGE_PENDING_COMPARISON_INPUTS = 16;
+/** True only for the exact historical default that is safe to auto-upgrade. */
+function isLegacyManagedChangeBasketDefault(basket) {
+    return basket.name === 'default' &&
+        basket.numberOfDesiredUTXOs === exports.DEFAULT_MANAGED_CHANGE_TARGET_UTXOS &&
+        basket.minimumDesiredUTXOValue === exports.LEGACY_MANAGED_CHANGE_MINIMUM_SATOSHIS;
+}
+/**
+ * Normalize a legacy default while retaining every other field and every
+ * operator-selected non-default value. Used by migrations, sync, and restore.
+ */
+function upgradeLegacyManagedChangeBasketDefault(basket) {
+    if (!isLegacyManagedChangeBasketDefault(basket))
+        return basket;
+    return { ...basket, minimumDesiredUTXOValue: exports.DEFAULT_MANAGED_CHANGE_MINIMUM_SATOSHIS };
+}
+function defaultManagedChangePolicy() {
+    return {
+        maxOutputsPerAction: exports.DEFAULT_MANAGED_CHANGE_MAX_OUTPUTS_PER_ACTION,
+        migrationInputsPerAction: exports.DEFAULT_MANAGED_CHANGE_MIGRATION_INPUTS_PER_ACTION,
+        pendingComparisonInputs: exports.DEFAULT_MANAGED_CHANGE_PENDING_COMPARISON_INPUTS
+    };
+}
+function validateManagedChangePolicy(options) {
+    const policy = { ...defaultManagedChangePolicy(), ...options };
+    const validateLimit = (value, name, minimum) => {
+        if (value !== -1 && (!Number.isSafeInteger(value) || value < minimum)) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER(`managedChangePolicy.${name}`, `${minimum === 0 ? 'a non-negative' : 'a positive'} safe integer or -1 for unlimited`);
+        }
+    };
+    validateLimit(policy.maxOutputsPerAction, 'maxOutputsPerAction', 1);
+    validateLimit(policy.migrationInputsPerAction, 'migrationInputsPerAction', 0);
+    validateLimit(policy.pendingComparisonInputs, 'pendingComparisonInputs', 1);
+    return policy;
+}
+//# sourceMappingURL=managedChangePolicy.js.map

package/out/src/storage/methods/managedChangePolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managedChangePolicy.js","sourceRoot":"","sources":["../../../../src/storage/methods/managedChangePolicy.ts"],"names":[],"mappings":";;;;;;;AAAA,uDAA8D;AAE9D,6EAA6E;AAChE,QAAA,sCAAsC,GAAG,EAAE,CAAA;AAExD;;;;;;;GAOG;AACU,QAAA,mCAAmC,GAAG,GAAG,CAAA;AACzC,QAAA,uCAAuC,GAAG,KAAK,CAAA;AAC/C,QAAA,6CAA6C,GAAG,CAAC,CAAA;AACjD,QAAA,kDAAkD,GAAG,CAAC,CAAA;AACtD,QAAA,gDAAgD,GAAG,EAAE,CAAA;AAwBlE,+EAA+E;AAC/E,4CACE,MAAmC;IAEnC,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS;QAC9B,MAAM,CAAC,oBAAoB,KAAK,QAAA,mCAAmC;QACnE,MAAM,CAAC,uBAAuB,KAAK,QAAA,sCAAsC,CAAA;AAC7E,CAAC;AAED;;;GAGG;AACH,iDACE,MAAS;IAET,IAAI,CAAC,kCAAkC,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IAC9D,OAAO,EAAE,GAAG,MAAM,EAAE,uBAAuB,EAAE,QAAA,uCAAuC,EAAE,CAAA;AACxF,CAAC;AAED;IACE,OAAO;QACL,mBAAmB,EAAE,QAAA,6CAA6C;QAClE,wBAAwB,EAAE,QAAA,kDAAkD;QAC5E,uBAAuB,EAAE,QAAA,gDAAgD;KAC1E,CAAA;AACH,CAAC;AAED,qCACE,OAAoC;IAEpC,MAAM,MAAM,GAAG,EAAE,GAAG,0BAA0B,EAAE,EAAE,GAAG,OAAO,EAAE,CAAA;IAC9D,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,IAA+B,EAAE,OAAe,EAAQ,EAAE;QAC9F,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,oCAAsB,CAC9B,uBAAuB,IAAI,EAAE,EAC7B,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,mCAAmC,CACtF,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,aAAa,CAAC,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,CAAC,CAAC,CAAA;IACnE,aAAa,CAAC,MAAM,CAAC,wBAAwB,EAAE,0BAA0B,EAAE,CAAC,CAAC,CAAA;IAC7E,aAAa,CAAC,MAAM,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAA;IAC3E,OAAO,MAAM,CAAA;AACf,CAAC"}

package/out/src/storage/methods/reconcileFailedTransactionInputs.d.ts

@@ -0,0 +1,32 @@
+import { WalletLoggerInterface } from '@bsv/sdk';
+import * as sdk from '../../sdk';
+import { StorageProvider } from '../StorageProvider';
+import { EntityProvenTxReq } from '../schema/entities';
+export interface FailedInputReconciliationResult {
+    checked: number;
+    staleConfirmed: number;
+    staleOutpoints: string[];
+}
+/**
+ * Conservatively quarantine every locally-owned input of a transaction after
+ * Arcade supplies explicit missing-input/conflict evidence. This path is
+ * deliberately independent of explorer or UTXO providers: a positive
+ * broadcaster verdict is enough to stop the failed transaction from feeding
+ * the same inputs into another action. A later validated mined proof remains
+ * able to repair the transaction through the ordinary proof recovery path.
+ */
+export declare function quarantineReqInputs(req: EntityProvenTxReq, storage: StorageProvider, trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<FailedInputReconciliationResult>;
+/**
+ * Keep only inputs created by a locally terminal parent unavailable after the
+ * failed-child transition releases its allocations. Other inputs may still be
+ * valid UTXOs and must remain reusable.
+ */
+export declare function quarantineReqInputsFromFailedParents(req: EntityProvenTxReq, failedParentTxids: string[], storage: StorageProvider, trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<FailedInputReconciliationResult>;
+/**
+ * Ask the configured UTXO-provider collection to classify the request's local
+ * inputs and mark only positively confirmed spent outputs unavailable.
+ * Provider errors and a collection with no providers are inconclusive and
+ * never count as spent.
+ */
+export declare function markConfirmedStaleReqInputs(req: EntityProvenTxReq, storage: StorageProvider, services: sdk.WalletServices, trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<FailedInputReconciliationResult>;
+//# sourceMappingURL=reconcileFailedTransactionInputs.d.ts.map

package/out/src/storage/methods/reconcileFailedTransactionInputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcileFailedTransactionInputs.d.ts","sourceRoot":"","sources":["../../../../src/storage/methods/reconcileFailedTransactionInputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAStD,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AA4DD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,eAAe,EACxB,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,+BAA+B,CAAC,CAS1C;AAED;;;;GAIG;AACH,wBAAsB,oCAAoC,CACxD,GAAG,EAAE,iBAAiB,EACtB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,OAAO,EAAE,eAAe,EACxB,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,+BAA+B,CAAC,CAY1C;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,GAAG,CAAC,cAAc,EAC5B,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,+BAA+B,CAAC,CAuD1C"}

package/out/src/storage/methods/reconcileFailedTransactionInputs.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quarantineReqInputs = quarantineReqInputs;
+exports.quarantineReqInputsFromFailedParents = quarantineReqInputsFromFailedParents;
+exports.markConfirmedStaleReqInputs = markConfirmedStaleReqInputs;
+const sdk_1 = require("@bsv/sdk");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const classifyOutputUtxo_1 = require("../../services/classifyOutputUtxo");
+async function quarantineLocalInputs(localInputs, storage, trx) {
+    const staleOutpoints = new Set();
+    for (const { output, outpoint } of localInputs) {
+        await storage.updateOutput((0, utilityHelpers_1.verifyId)(output.outputId), { spendable: false }, trx);
+        staleOutpoints.add(`${outpoint.txid}.${outpoint.vout}`);
+    }
+    return {
+        checked: localInputs.length,
+        staleConfirmed: localInputs.length,
+        staleOutpoints: [...staleOutpoints]
+    };
+}
+async function findLocalInputs(req, storage, trx) {
+    const tx = sdk_1.Transaction.fromBinary(req.rawTx);
+    const outpoints = tx.inputs
+        .map(input => ({ txid: input.sourceTXID ?? '', vout: input.sourceOutputIndex ?? 0 }))
+        .filter(outpoint => outpoint.txid !== '');
+    if (outpoints.length === 0)
+        return [];
+    // A transaction can be internalized by multiple users while the request's
+    // notification list is racing. Resolve every local copy by txid so no user's
+    // basket retains the same confirmed-stale outpoint.
+    const transactions = await storage.findTransactions({
+        partial: { txid: req.txid },
+        noRawTx: true,
+        trx
+    });
+    const userIds = [...new Set(transactions.map(transaction => transaction.userId))];
+    const localInputs = [];
+    const localKeys = new Set();
+    for (const userId of userIds) {
+        const byOutpoint = await storage.findOutputsByOutpoints(userId, outpoints, trx);
+        for (const outpoint of outpoints) {
+            const output = byOutpoint[`${outpoint.txid}.${outpoint.vout}`];
+            const localKey = `${userId}:${outpoint.txid}.${outpoint.vout}`;
+            if (output != null && !localKeys.has(localKey)) {
+                localKeys.add(localKey);
+                localInputs.push({ output, outpoint });
+            }
+        }
+    }
+    return localInputs;
+}
+/**
+ * Conservatively quarantine every locally-owned input of a transaction after
+ * Arcade supplies explicit missing-input/conflict evidence. This path is
+ * deliberately independent of explorer or UTXO providers: a positive
+ * broadcaster verdict is enough to stop the failed transaction from feeding
+ * the same inputs into another action. A later validated mined proof remains
+ * able to repair the transaction through the ordinary proof recovery path.
+ */
+async function quarantineReqInputs(req, storage, trx, logger) {
+    const localInputs = await findLocalInputs(req, storage, trx);
+    const result = await quarantineLocalInputs(localInputs, storage, trx);
+    if (result.staleConfirmed > 0) {
+        logger?.log(`quarantineReqInputs: ${result.staleConfirmed} local input copy/copies quarantined for txid=${req.txid}`);
+    }
+    return result;
+}
+/**
+ * Keep only inputs created by a locally terminal parent unavailable after the
+ * failed-child transition releases its allocations. Other inputs may still be
+ * valid UTXOs and must remain reusable.
+ */
+async function quarantineReqInputsFromFailedParents(req, failedParentTxids, storage, trx, logger) {
+    const failedParents = new Set(failedParentTxids);
+    const localInputs = (await findLocalInputs(req, storage, trx)).filter(({ outpoint }) => failedParents.has(outpoint.txid));
+    const result = await quarantineLocalInputs(localInputs, storage, trx);
+    if (result.staleConfirmed > 0) {
+        logger?.log(`quarantineReqInputsFromFailedParents: ${result.staleConfirmed} local parent output copy/copies quarantined for txid=${req.txid}`);
+    }
+    return result;
+}
+/**
+ * Ask the configured UTXO-provider collection to classify the request's local
+ * inputs and mark only positively confirmed spent outputs unavailable.
+ * Provider errors and a collection with no providers are inconclusive and
+ * never count as spent.
+ */
+async function markConfirmedStaleReqInputs(req, storage, services, trx, logger) {
+    const result = { checked: 0, staleConfirmed: 0, staleOutpoints: [] };
+    const localInputs = await findLocalInputs(req, storage, trx);
+    const verdicts = new Map();
+    const uniqueInputs = new Map();
+    for (const localInput of localInputs) {
+        const key = `${localInput.outpoint.txid}.${localInput.outpoint.vout}`;
+        if (!uniqueInputs.has(key))
+            uniqueInputs.set(key, localInput);
+    }
+    await (0, classifyOutputUtxo_1.mapWithConcurrency)([...uniqueInputs.values()], classifyOutputUtxo_1.UTXO_PROVIDER_MAX_CONCURRENCY, async ({ output, outpoint }) => {
+        const key = `${outpoint.txid}.${outpoint.vout}`;
+        if (output.lockingScript == null) {
+            try {
+                await storage.validateOutputScript(output, trx);
+            }
+            catch {
+                verdicts.set(key, 'inconclusive');
+                return;
+            }
+        }
+        if (output.lockingScript == null) {
+            verdicts.set(key, 'inconclusive');
+            return;
+        }
+        const classification = await (0, classifyOutputUtxo_1.classifyOutputUtxo)(services, output);
+        let verdict;
+        if (classification.verdict === 'unknown')
+            verdict = 'inconclusive';
+        else if (classification.verdict === 'unspent')
+            verdict = 'utxo';
+        else
+            verdict = 'stale';
+        verdicts.set(key, verdict);
+    });
+    const staleOutpoints = new Set();
+    for (const { output, outpoint } of localInputs) {
+        const key = `${outpoint.txid}.${outpoint.vout}`;
+        const verdict = verdicts.get(key);
+        if (verdict == null || verdict === 'inconclusive')
+            continue;
+        result.checked++;
+        if (verdict === 'stale') {
+            await storage.updateOutput((0, utilityHelpers_1.verifyId)(output.outputId), { spendable: false }, trx);
+            result.staleConfirmed++;
+            staleOutpoints.add(key);
+        }
+    }
+    result.staleOutpoints = [...staleOutpoints];
+    if (result.staleConfirmed > 0) {
+        logger?.log(`markConfirmedStaleReqInputs: ${result.staleConfirmed} of ${result.checked} local input copy/copies confirmed spent for txid=${req.txid}`);
+    }
+    return result;
+}
+//# sourceMappingURL=reconcileFailedTransactionInputs.js.map

package/out/src/storage/methods/reconcileFailedTransactionInputs.js.map

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

package/out/src/storage/methods/reviewUtxoOutputs.d.ts

@@ -0,0 +1,37 @@
+import { AuthId } from '../../sdk/WalletStorage.interfaces';
+import { type OutputUtxoClassification } from '../../services/classifyOutputUtxo';
+import { StorageProvider } from '../StorageProvider';
+import { TableOutput } from '../schema/tables/TableOutput';
+export declare const UTXO_REVIEW_PROVIDER_TIMEOUT_MSECS = 5000;
+export type UtxoReviewReleaseMode = 'none' | 'atomic' | 'conclusive';
+export interface UtxoReviewClassification {
+    output: TableOutput;
+    status: OutputUtxoClassification;
+}
+export interface UtxoReviewDiagnostics {
+    checked: number;
+    confirmedUnspent: number;
+    confirmedSpent: number;
+    unknown: number;
+    confirmedSpentSatoshis: number;
+    released: number;
+    releasedSatoshis: number;
+    providers: string[];
+    providerCount: number;
+    providersTruncated: boolean;
+}
+export interface ReviewUtxoOutputsResult {
+    classifications: UtxoReviewClassification[];
+    confirmedSpentOutputs: TableOutput[];
+    unknownOutputs: TableOutput[];
+    diagnostics: UtxoReviewDiagnostics;
+}
+/**
+ * Classify a bounded set of wallet outputs without treating provider failure as
+ * proof that an output was spent. Read-only reviews always return their
+ * conclusive and unknown partitions. Atomic release requires every verdict to
+ * be conclusive; the operator-only conclusive mode releases the positively
+ * spent subset while retaining and reporting unknowns.
+ */
+export declare function reviewUtxoOutputs(storage: StorageProvider, auth: AuthId, outputs: TableOutput[], releaseMode?: UtxoReviewReleaseMode): Promise<ReviewUtxoOutputsResult>;
+//# sourceMappingURL=reviewUtxoOutputs.d.ts.map

package/out/src/storage/methods/reviewUtxoOutputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewUtxoOutputs.d.ts","sourceRoot":"","sources":["../../../../src/storage/methods/reviewUtxoOutputs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAA;AAE3D,OAAO,EAGL,KAAK,wBAAwB,EAE9B,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAI1D,eAAO,MAAM,kCAAkC,OAAQ,CAAA;AAEvD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEpE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,wBAAwB,CAAA;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB,EAAE,MAAM,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,wBAAwB,EAAE,CAAA;IAC3C,qBAAqB,EAAE,WAAW,EAAE,CAAA;IACpC,cAAc,EAAE,WAAW,EAAE,CAAA;IAC7B,WAAW,EAAE,qBAAqB,CAAA;CACnC;AA8HD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,GAAE,qBAA8B,GAC1C,OAAO,CAAC,uBAAuB,CAAC,CAoClC"}

package/out/src/storage/methods/reviewUtxoOutputs.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UTXO_REVIEW_PROVIDER_TIMEOUT_MSECS = void 0;
+exports.reviewUtxoOutputs = reviewUtxoOutputs;
+const WERR_errors_1 = require("../../sdk/WERR_errors");
+const classifyOutputUtxo_1 = require("../../services/classifyOutputUtxo");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const MAX_AUDIT_PROVIDERS = 8;
+const MAX_PROVIDER_NAME_LENGTH = 128;
+exports.UTXO_REVIEW_PROVIDER_TIMEOUT_MSECS = 5_000;
+function diagnosticsFor(classifications, releasedOutputIds) {
+    const allProviders = [
+        ...new Set(classifications.map(result => result.status.provider.slice(0, MAX_PROVIDER_NAME_LENGTH)))
+    ];
+    const providers = allProviders.slice(0, MAX_AUDIT_PROVIDERS);
+    const confirmedSpent = classifications.filter(result => result.status.verdict === 'spent');
+    const released = confirmedSpent.filter(result => releasedOutputIds.has(result.output.outputId));
+    return {
+        checked: classifications.length,
+        confirmedUnspent: classifications.filter(result => result.status.verdict === 'unspent').length,
+        confirmedSpent: confirmedSpent.length,
+        unknown: classifications.filter(result => result.status.verdict === 'unknown').length,
+        confirmedSpentSatoshis: confirmedSpent.reduce((sum, result) => sum + result.output.satoshis, 0),
+        released: released.length,
+        releasedSatoshis: released.reduce((sum, result) => sum + result.output.satoshis, 0),
+        providers,
+        providerCount: allProviders.length,
+        providersTruncated: allProviders.length > providers.length
+    };
+}
+function auditDetails(diagnostics, userId, releaseMode, reason) {
+    return JSON.stringify({
+        operation: 'specOpInvalidChange',
+        reason,
+        releaseMode,
+        userId,
+        ...diagnostics
+    });
+}
+async function classifyCandidates(storage, outputs) {
+    const services = storage.getServices();
+    const candidates = outputs.filter(output => output.basketId != null);
+    return await (0, classifyOutputUtxo_1.mapWithConcurrency)(candidates, classifyOutputUtxo_1.UTXO_PROVIDER_MAX_CONCURRENCY, async (output) => {
+        try {
+            await storage.validateOutputScript(output);
+        }
+        catch (error) {
+            return {
+                output,
+                status: {
+                    verdict: 'unknown',
+                    provider: '<script-validation-error>',
+                    error
+                }
+            };
+        }
+        let timeout;
+        const providerCall = (0, classifyOutputUtxo_1.classifyOutputUtxo)(services, output);
+        const timedClassification = new Promise(resolve => {
+            timeout = setTimeout(() => resolve({
+                verdict: 'unknown',
+                provider: '<review-timeout>',
+                error: new Error(`UTXO classification exceeded ${exports.UTXO_REVIEW_PROVIDER_TIMEOUT_MSECS}ms`)
+            }), exports.UTXO_REVIEW_PROVIDER_TIMEOUT_MSECS);
+        });
+        try {
+            return {
+                output,
+                status: await Promise.race([providerCall, timedClassification])
+            };
+        }
+        finally {
+            if (timeout != null)
+                clearTimeout(timeout);
+            void providerCall.catch(() => undefined);
+        }
+    });
+}
+async function releaseConfirmedSpent(storage, auth, classifications, releaseMode) {
+    const confirmedSpent = classifications.filter(result => result.status.verdict === 'spent');
+    const releasedOutputIds = new Set();
+    await storage.transaction(async (trx) => {
+        for (const { output } of confirmedSpent) {
+            const current = await storage.findOutputById(output.outputId, trx, true);
+            if (current == null || current.userId !== auth.userId) {
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('outputId', `owned by user ${auth.userId}`);
+            }
+            if (current.spendable !== true || current.spentBy != null) {
+                throw new WERR_errors_1.WERR_INVALID_OPERATION(`Output ${output.outputId} changed state during UTXO review; no outputs were changed.`);
+            }
+            const updated = await storage.updateOutput((0, utilityHelpers_1.verifyId)(output.outputId), { spendable: false }, trx);
+            if (updated !== 1) {
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('outputId', `updated exactly once: ${output.outputId}`);
+            }
+            releasedOutputIds.add(output.outputId);
+        }
+        const now = new Date();
+        const diagnostics = diagnosticsFor(classifications, releasedOutputIds);
+        await storage.insertMonitorEvent({
+            created_at: now,
+            updated_at: now,
+            id: 0,
+            event: releaseMode === 'atomic' ? 'InvalidChangeRelease' : 'InvalidChangeConclusiveRelease',
+            details: auditDetails(diagnostics, auth.userId, releaseMode, 'provider-confirmed-spent')
+        }, trx);
+    });
+    return releasedOutputIds;
+}
+/**
+ * Classify a bounded set of wallet outputs without treating provider failure as
+ * proof that an output was spent. Read-only reviews always return their
+ * conclusive and unknown partitions. Atomic release requires every verdict to
+ * be conclusive; the operator-only conclusive mode releases the positively
+ * spent subset while retaining and reporting unknowns.
+ */
+async function reviewUtxoOutputs(storage, auth, outputs, releaseMode = 'none') {
+    const classifications = await classifyCandidates(storage, outputs);
+    const confirmedSpentOutputs = classifications
+        .filter(result => result.status.verdict === 'spent')
+        .map(result => result.output);
+    const unknownOutputs = classifications
+        .filter(result => result.status.verdict === 'unknown')
+        .map(result => result.output);
+    if (releaseMode === 'atomic' && unknownOutputs.length > 0) {
+        const diagnostics = diagnosticsFor(classifications, new Set());
+        const now = new Date();
+        await storage.insertMonitorEvent({
+            created_at: now,
+            updated_at: now,
+            id: 0,
+            event: 'InvalidChangeReleaseBlocked',
+            details: auditDetails(diagnostics, auth.userId, releaseMode, 'inconclusive-provider-result')
+        });
+        throw new WERR_errors_1.WERR_UTXO_REVIEW_INCONCLUSIVE(diagnostics.checked, diagnostics.confirmedSpent, diagnostics.unknown);
+    }
+    const releasedOutputIds = releaseMode === 'none'
+        ? new Set()
+        : await releaseConfirmedSpent(storage, auth, classifications, releaseMode);
+    for (const output of confirmedSpentOutputs) {
+        if (releasedOutputIds.has(output.outputId))
+            output.spendable = false;
+    }
+    return {
+        classifications,
+        confirmedSpentOutputs,
+        unknownOutputs,
+        diagnostics: diagnosticsFor(classifications, releasedOutputIds)
+    };
+}
+//# sourceMappingURL=reviewUtxoOutputs.js.map

package/out/src/storage/methods/reviewUtxoOutputs.js.map

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

package/out/src/storage/portable/index.d.ts.map

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

package/out/src/storage/portable/index.js

@@ -16,6 +16,7 @@ const AESGCM_1 = require("@bsv/sdk/primitives/AESGCM");
 const hashWasm_1 = require("../../utility/hashWasm");
 const EntityBase_1 = require("../schema/entities/EntityBase");
 const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const managedChangePolicy_1 = require("../methods/managedChangePolicy");
 const BRC38_TITLE = 'User Wallet Data Format';
 const BRC39_MAGIC = [0x57, 0x44, 0x41, 0x54]; // WDAT
 const BRC39_HEADER_LENGTH = 33;
@@ -326,8 +327,9 @@ async function restoreBRC38(storage, data) {
         await storage.insertUser({ ...data.user }, trx);
         for (const row of data.provenTxs)
             await storage.insertProvenTx({ ...row }, trx);
-        for (const row of data.outputBaskets)
-            await storage.insertOutputBasket({ ...row }, trx);
+        for (const row of data.outputBaskets) {
+            await storage.insertOutputBasket((0, managedChangePolicy_1.upgradeLegacyManagedChangeBasketDefault)({ ...row }), trx);
+        }
         for (const row of data.outputTags)
             await storage.insertOutputTag({ ...row }, trx);
         for (const row of data.txLabels)