@bsv/wallet-toolbox-client 2.4.4 → 2.4.20

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

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.selectCanonicalChange = selectCanonicalChange;
-exports.repeatableRandom = repeatableRandom;
-exports.randomizeOutputVouts = randomizeOutputVouts;
-const sdk_1 = require("@bsv/sdk");
-/** Pure exact / least-over / largest-under change selection policy. */
-function selectCanonicalChange(outputs, targetSatoshis, exactSatoshis) {
-    if (exactSatoshis !== undefined) {
-        const exact = outputs
-            .filter(output => output.satoshis === exactSatoshis)
-            .sort((a, b) => a.outputId - b.outputId)[0];
-        if (exact != null)
-            return exact;
-    }
-    const over = outputs
-        .filter(output => output.satoshis >= targetSatoshis)
-        .sort((a, b) => a.satoshis - b.satoshis || a.outputId - b.outputId)[0];
-    if (over != null)
-        return over;
-    return outputs
-        .filter(output => output.satoshis < targetSatoshis)
-        .sort((a, b) => b.satoshis - a.satoshis || b.outputId - a.outputId)[0];
-}
-function repeatableRandom(randomVals) {
-    const values = [...(randomVals ?? [])];
-    return () => {
-        if (values.length > 0) {
-            const value = values.shift() ?? 0;
-            values.push(value);
-            return value;
-        }
-        const bytes = (0, sdk_1.Random)(4);
-        return (((bytes[0] << 24) | (bytes[1] << 16) | (bytes[2] << 8) | bytes[3]) >>> 0) / 0x100000000;
-    };
-}
-/** Pure Fisher-Yates vout assignment shared by legacy and batch planning. */
-function randomizeOutputVouts(outputs, randomVals) {
-    const nextRandom = repeatableRandom(randomVals);
-    const vouts = Array.from({ length: outputs.length }, (_, index) => index);
-    for (let current = vouts.length; current > 0; current--) {
-        const randomIndex = Math.floor(nextRandom() * current);
-        [vouts[current - 1], vouts[randomIndex]] = [vouts[randomIndex], vouts[current - 1]];
-    }
-    for (let index = 0; index < outputs.length; index++)
-        outputs[index].vout = vouts[index];
-}
-//# sourceMappingURL=actionPlanning.js.map

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

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

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

@@ -1,124 +0,0 @@
-import { Beef, WalletLoggerInterface } from '@bsv/sdk';
-import { StorageProvider } from '../StorageProvider';
-import { EntityProvenTxReq } from '../schema/entities';
-import * as sdk from '../../sdk';
-/**
- * Attempt to post one or more `ProvenTxReq` with status 'unsent'
- * to the bitcoin network.
- *
- * @param reqs
- */
-export declare function attemptToPostReqsToNetwork(storage: StorageProvider, reqs: EntityProvenTxReq[], trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<PostReqsToNetworkResult>;
-/**
- * For each txid in submitted `txids`:
- *
- *   Based on its aggregate status, and whether broadcast happening in background (isDelayed) or immediately (!isDelayed),
- *   and iff current req.status is not 'unproven' or 'completed':
- *
- *     'success':
- *       req.status => 'unmined', tx.status => 'unproven'
- *     'doubleSpend':
- *       req.status => 'doubleSpend', tx.status => 'failed'
- *     'invalidTx':
- *       req.status => 'invalid', tx.status => 'failed'
- *     'serviceError':
- *       increment req.attempts
- *
- * @param txids
- * @param apbrs
- * @param storage
- * @param services if valid, doubleSpend results will be verified (but only if not within a trx. e.g. trx must be undefined)
- * @param trx
- */
-export declare function updateReqsFromAggregateResults(txids: string[], r: PostReqsToNetworkResult, apbrs: Record<string, AggregatePostBeefTxResult>, storage: StorageProvider, services?: sdk.WalletServices, trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<void>;
-/**
- * After any failed broadcast (doubleSpend, invalidTx, etc.), query each
- * consumed-input outpoint of the failed transaction against on-chain
- * UTXO state. For inputs the chain authoritatively confirms are spent
- * (i.e. NOT a UTXO), update the corresponding wallet basket entry to
- * spendable=false.
- *
- * Background: `updateTransactionStatus(failed)` optimistically restores
- * all consumed-input outputs to spendable=true so the user can retry
- * with the same inputs. For some failures (genuine doubleSpend, or any
- * 'missing-inputs' outcome where the input has been spent on chain by
- * a different transaction), restoration is incorrect — the input is
- * gone and restoring it produces an infinite missing-inputs loop on
- * the next createAction → broadcast cycle. Apps cannot evict from the
- * default basket on app-isolated wallets (admin-only policy), so this
- * self-heal must run inside the wallet.
- *
- * Different broadcasters classify the same on-chain reality differently
- * (ARC → doubleSpend, WhatsOnChain/Bitails → invalidTx via
- * 'missing-inputs'); this helper is broadcaster-agnostic because its
- * decision is based on services.isUtxo, not the aggregate failure
- * classification.
- *
- * Pre-broadcast races where concurrent createActions reach the same
- * UTXO across separate app processes are out of scope; see PR
- * description.
- *
- * Conservatively scoped:
- *   - Only inputs found in the failing user's basket are touched.
- *   - Inputs whose on-chain UTXO status cannot be determined (service
- *     error / inconclusive) are left spendable=true. Eviction is opt-in
- *     based on positive evidence of stale state.
- *   - Inputs the chain confirms are still UTXOs (e.g. a competing tx
- *     itself failed, or a malformed/fee failure where inputs are intact)
- *     are left spendable=true — preserving the existing transient-retry
- *     semantics callers depend on.
- *
- * Returns counts for instrumentation and the set of stale outpoints
- * that were actually evicted (added to history note for diagnostics).
- */
-export declare function markStaleInputsAsSpent(ar: AggregatePostBeefTxResult, storage: StorageProvider, services: sdk.WalletServices, trx?: sdk.TrxToken, logger?: WalletLoggerInterface): Promise<{
-    checked: number;
-    staleConfirmed: number;
-    staleOutpoints: string[];
-}>;
-type AggregateStatus = 'success' | 'doubleSpend' | 'invalidTx' | 'serviceError';
-export interface AggregatePostBeefTxResult {
-    txid: string;
-    txidResults: sdk.PostTxResultForTxid[];
-    status: AggregateStatus;
-    vreq: PostReqsToNetworkDetails;
-    successCount: number;
-    doubleSpendCount: number;
-    statusErrorCount: number;
-    serviceErrorCount: number;
-    /**
-     * Any competing double spend txids reported for this txid
-     */
-    competingTxs: string[];
-}
-/**
- * Indicates status of a new Action following a `createAction` or `signAction` in immediate mode:
- * When `acceptDelayedBroadcast` is falses.
- *
- * 'success': The action has been broadcast and accepted by the bitcoin processing network.
- * 'doubleSpend': The action has been confirmed to double spend one or more inputs, and by the "first-seen-rule" is the losing transaction.
- * 'invalidTx': The action was rejected by the processing network as an invalid bitcoin transaction.
- * 'serviceError': The broadcast services are currently unable to reach the bitcoin network. The action is now queued for delayed retries.
- *
- * 'invalid': The action was in an invalid state for processing, this status should never be seen by user code.
- * 'unknown': An internal processing error has occured, this status should never be seen by user code.
- *
- */
-export type PostReqsToNetworkDetailsStatus = 'success' | 'doubleSpend' | 'unknown' | 'invalid' | 'serviceError' | 'invalidTx';
-export interface PostReqsToNetworkDetails {
-    txid: string;
-    req: EntityProvenTxReq;
-    status: PostReqsToNetworkDetailsStatus;
-    /**
-     * Any competing double spend txids reported for this txid
-     */
-    competingTxs?: string[];
-}
-export interface PostReqsToNetworkResult {
-    status: 'success' | 'error';
-    beef: Beef;
-    details: PostReqsToNetworkDetails[];
-    log: string;
-}
-export {};
-//# sourceMappingURL=attemptToPostReqsToNetwork.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"attemptToPostReqsToNetwork.d.ts","sourceRoot":"","sources":["../../../../../src/storage/methods/attemptToPostReqsToNetwork.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,GAAG,MAAM,WAAW,CAAA;AAIhC;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,iBAAiB,EAAE,EACzB,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CAoBlC;AA2ID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,MAAM,EAAE,EACf,CAAC,EAAE,uBAAuB,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAChD,OAAO,EAAE,eAAe,EACxB,QAAQ,CAAC,EAAE,GAAG,CAAC,cAAc,EAC7B,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsHf;AAgFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,yBAAyB,EAC7B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,GAAG,CAAC,cAAc,EAC5B,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,EAClB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAsGhF;AAED,KAAK,eAAe,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,CAAA;AAE/E,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,GAAG,CAAC,mBAAmB,EAAE,CAAA;IACtC,MAAM,EAAE,eAAe,CAAA;IACvB,IAAI,EAAE,wBAAwB,CAAA;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,CAAA;IACzB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,8BAA8B,GACtC,SAAS,GACT,aAAa,GACb,SAAS,GACT,SAAS,GACT,cAAc,GACd,WAAW,CAAA;AAEf,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,iBAAiB,CAAA;IACtB,MAAM,EAAE,8BAA8B,CAAA;IACtC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IAC3B,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,wBAAwB,EAAE,CAAA;IACnC,GAAG,EAAE,MAAM,CAAA;CACZ"}

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

@@ -1,490 +0,0 @@
-"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.attemptToPostReqsToNetwork = attemptToPostReqsToNetwork;
-exports.updateReqsFromAggregateResults = updateReqsFromAggregateResults;
-exports.markStaleInputsAsSpent = markStaleInputsAsSpent;
-const sdk_1 = require("@bsv/sdk");
-const sdk = __importStar(require("../../sdk"));
-const utilityHelpers_1 = require("../../utility/utilityHelpers");
-/**
- * Attempt to post one or more `ProvenTxReq` with status 'unsent'
- * to the bitcoin network.
- *
- * @param reqs
- */
-async function attemptToPostReqsToNetwork(storage, reqs, trx, logger) {
-    // initialize results, validate reqs ready to post, txids are of the transactions in the beef that we care about.
-    const { r, vreqs, txids } = await validateReqsAndMergeBeefs(storage, reqs, trx);
-    logger?.log('validated request and merged beefs');
-    const services = storage.getServices();
-    const pbrs = await services.postBeef(r.beef, txids, logger);
-    // post beef results (pbrs) is an array by service provider
-    // for each service provider, there's an aggregate result and individual results by txid.
-    await transferNotesToReqHistories(txids, vreqs, pbrs, storage, trx);
-    const apbrs = aggregatePostBeefResultsByTxid(txids, vreqs, pbrs);
-    await updateReqsFromAggregateResults(txids, r, apbrs, storage, services, trx, logger);
-    return r;
-}
-async function validateReqsAndMergeBeefs(storage, reqs, trx) {
-    const r = {
-        status: 'success',
-        beef: new sdk_1.Beef(),
-        details: [],
-        log: ''
-    };
-    const vreqs = [];
-    for (const req of reqs) {
-        try {
-            const noRawTx = !req.rawTx;
-            const noTxIds = (req.notify.transactionIds == null) || req.notify.transactionIds.length < 1;
-            const noInputBEEF = req.inputBEEF == null;
-            if (noRawTx || noTxIds || noInputBEEF) {
-                // This should have happened earlier...
-                req.addHistoryNote({ when: new Date().toISOString(), what: 'validateReqFailed', noRawTx, noTxIds, noInputBEEF });
-                req.status = 'invalid';
-                await req.updateStorageDynamicProperties(storage, trx);
-                r.details.push({ txid: req.txid, req, status: 'invalid' });
-            }
-            else {
-                const vreq = { txid: req.txid, req, status: 'unknown' };
-                await storage.mergeReqToBeefToShareExternally(req.api, r.beef, [], trx);
-                vreqs.push(vreq);
-                r.details.push(vreq);
-            }
-        }
-        catch (error_) {
-            const { code, message } = sdk.WalletError.fromUnknown(error_);
-            req.addHistoryNote({ when: new Date().toISOString(), what: 'validateReqError', txid: req.txid, code, message });
-            req.attempts++;
-            if (req.attempts > 6 || message.startsWith('The txid parameter must be known to storage')) {
-                req.status = 'invalid';
-                r.details.push({ txid: req.txid, req, status: 'invalid' });
-            }
-            await req.updateStorageDynamicProperties(storage, trx);
-        }
-    }
-    return { r, vreqs, txids: vreqs.map(r => r.txid) };
-}
-async function transferNotesToReqHistories(txids, vreqs, pbrs, storage, trx) {
-    for (const txid of txids) {
-        const vreq = vreqs.find(r => r.txid === txid);
-        if (vreq == null)
-            throw new sdk.WERR_INTERNAL();
-        const notes = [];
-        for (const pbr of pbrs) {
-            notes.push(...(pbr.notes || []));
-            const r = pbr.txidResults.find(tr => tr.txid === txid);
-            if (r != null)
-                notes.push(...(r.notes || []));
-        }
-        for (const n of notes) {
-            vreq.req.addHistoryNote(n);
-        }
-        await vreq.req.updateStorageDynamicProperties(storage, trx);
-    }
-}
-function tallyTxidResults(ar, pbrs) {
-    for (const pbr of pbrs) {
-        const tr = pbr.txidResults.find(tr => tr.txid === ar.txid);
-        if (tr == null)
-            continue;
-        ar.txidResults.push(tr);
-        if (tr.status === 'success') {
-            ar.successCount++;
-        }
-        else if (tr.doubleSpend) {
-            ar.doubleSpendCount++;
-            if (tr.competingTxs != null)
-                ar.competingTxs = [...tr.competingTxs];
-        }
-        else if (tr.serviceError) {
-            ar.serviceErrorCount++;
-        }
-        else {
-            ar.statusErrorCount++;
-        }
-    }
-    if (ar.competingTxs.length > 1)
-        ar.competingTxs = [...new Set(ar.competingTxs)];
-}
-/**
- * For each txid, decide on the aggregate success or failure of attempting to broadcast it to the bitcoin processing network.
- *
- * Possible results:
- * 1. Success: At least one success, no double spends.
- * 2. DoubleSpend: One or more double spends.
- * 3. InvalidTransaction: No success, no double spend, one or more non-exception errors.
- * 4. Service Failure: No results or all results are exception errors.
- *
- * @param txids
- * @param reqs
- * @param pbrs
- * @param storage
- * @returns
- */
-function aggregatePostBeefResultsByTxid(txids, vreqs, pbrs) {
-    const r = {};
-    for (const txid of txids) {
-        const vreq = vreqs.find(r => r.txid === txid);
-        const ar = {
-            txid,
-            vreq,
-            txidResults: [],
-            status: 'success',
-            successCount: 0,
-            doubleSpendCount: 0,
-            statusErrorCount: 0,
-            serviceErrorCount: 0,
-            competingTxs: []
-        };
-        r[txid] = ar;
-        tallyTxidResults(ar, pbrs);
-        if (ar.successCount > 0 && ar.doubleSpendCount === 0)
-            ar.status = 'success';
-        else if (ar.doubleSpendCount > 0)
-            ar.status = 'doubleSpend';
-        else if (ar.statusErrorCount > 0)
-            ar.status = 'invalidTx';
-        else
-            ar.status = 'serviceError';
-    }
-    return r;
-}
-/**
- * For each txid in submitted `txids`:
- *
- *   Based on its aggregate status, and whether broadcast happening in background (isDelayed) or immediately (!isDelayed),
- *   and iff current req.status is not 'unproven' or 'completed':
- *
- *     'success':
- *       req.status => 'unmined', tx.status => 'unproven'
- *     'doubleSpend':
- *       req.status => 'doubleSpend', tx.status => 'failed'
- *     'invalidTx':
- *       req.status => 'invalid', tx.status => 'failed'
- *     'serviceError':
- *       increment req.attempts
- *
- * @param txids
- * @param apbrs
- * @param storage
- * @param services if valid, doubleSpend results will be verified (but only if not within a trx. e.g. trx must be undefined)
- * @param trx
- */
-async function updateReqsFromAggregateResults(txids, r, apbrs, storage, services, trx, logger) {
-    logger?.group('update storage from aggregate results');
-    for (const txid of txids) {
-        const ar = apbrs[txid];
-        const req = ar.vreq.req;
-        await req.refreshFromStorage(storage, trx);
-        const { successCount, doubleSpendCount, statusErrorCount, serviceErrorCount } = ar;
-        const note = {
-            when: new Date().toISOString(),
-            what: 'aggregateResults',
-            reqStatus: req.status,
-            aggStatus: ar.status,
-            attempts: req.attempts,
-            successCount,
-            doubleSpendCount,
-            statusErrorCount,
-            serviceErrorCount
-        };
-        if (['completed', 'unmined'].includes(req.status)) 
-        // However it happened, don't degrade status if it is somehow already beyond broadcast stage
-        {
-            continue;
-        }
-        if (ar.status === 'doubleSpend' && (services != null) && (trx == null))
-            await confirmDoubleSpend(ar, r.beef, storage, services, logger);
-        let newReqStatus;
-        let newTxStatus;
-        switch (ar.status) {
-            case 'success':
-                newReqStatus = 'unmined';
-                newTxStatus = 'unproven';
-                // Mark as broadcast so proof-timeout resets to rebroadcast rather than invalid
-                req.wasBroadcast = true;
-                break;
-            case 'doubleSpend':
-                newReqStatus = 'doubleSpend';
-                newTxStatus = 'failed';
-                break;
-            case 'invalidTx':
-                newReqStatus = 'invalid';
-                newTxStatus = 'failed';
-                break;
-            case 'serviceError':
-                newReqStatus = 'sending';
-                newTxStatus = 'sending';
-                req.attempts++;
-                break;
-            default:
-                throw new sdk.WERR_INTERNAL(`unimplemented AggregateStatus ${ar.status}`);
-        }
-        note.newReqStatus = newReqStatus;
-        note.newTxStatus = newTxStatus;
-        note.newAttempts = req.attempts;
-        if (newReqStatus)
-            req.status = newReqStatus;
-        req.addHistoryNote(note);
-        await req.updateStorageDynamicProperties(storage, trx);
-        if (newTxStatus) {
-            const ids = req.notify.transactionIds;
-            if (ids != null) {
-                // Also set generated outputs to spendable false and consumed input outputs to spendable true (and clears their spentBy).
-                await storage.updateTransactionsStatus(ids, newTxStatus, trx);
-            }
-        }
-        // For ANY failed-broadcast result (doubleSpend, invalidTx,
-        // serviceError-resolved-to-failure), override the optimistic
-        // "restore inputs spendable" behavior of updateTransactionStatus
-        // for inputs that on-chain state confirms are actually spent.
-        // Without this, the wallet picks the same stale UTXO on the next
-        // createAction — an infinite missing-inputs loop. Apps cannot
-        // self-heal because the default basket is admin-only on
-        // app-isolated wallets (e.g. metanet-desktop).
-        //
-        // Why broaden beyond doubleSpend (Codex review 51331f6e035a7ed0):
-        // different broadcasters classify the same on-chain reality
-        // differently. ARC reports SEEN_IN_ORPHAN_MEMPOOL → doubleSpend.
-        // WoC + Bitails report 'Missing inputs' / 'missing-inputs' →
-        // invalidTx. Both mean the same root cause (referenced UTXO is
-        // gone). The helper is conservatively opt-in on positive
-        // isUtxo===false evidence: malformed/fee/script failures whose
-        // inputs are still UTXOs are LEFT spendable=true, preserving
-        // the existing transient-retry semantics. So broadening is safe.
-        //
-        // Gate: services available + not in a nested transaction (chain
-        // queries are async I/O — same gate as confirmDoubleSpend).
-        if (newTxStatus === 'failed' &&
-            services != null &&
-            trx == null) {
-            const stale = await markStaleInputsAsSpent(ar, storage, services, trx, logger);
-            if (stale.checked > 0) {
-                req.addHistoryNote({
-                    when: new Date().toISOString(),
-                    what: 'markStaleInputsAsSpent',
-                    aggStatus: ar.status,
-                    checked: stale.checked,
-                    confirmed: stale.staleConfirmed,
-                    ...(stale.staleOutpoints.length > 0
-                        ? { outpoints: stale.staleOutpoints.join(',') }
-                        : {})
-                });
-                await req.updateStorageDynamicProperties(storage, trx);
-            }
-        }
-        // Transfer critical results to details going back to the user
-        const details = r.details.find(d => d.txid === txid);
-        details.status = ar.status;
-        details.competingTxs = ar.competingTxs;
-        logger?.log(`updated ${txid}`);
-    }
-    logger?.group('update storage from aggregate results');
-}
-async function gatherCompetingTxids(ar, beef, services, note, logger) {
-    const req = ar.vreq.req;
-    const tx = sdk_1.Transaction.fromBinary(req.rawTx);
-    const competingTxids = new Set(ar.competingTxs);
-    for (const input of tx.inputs) {
-        const sourceTx = beef.findTxid(input.sourceTXID)?.tx;
-        if (sourceTx == null) {
-            let s = note.missingSourceTx || '';
-            s += input.sourceTXID + ' ';
-            note.missingSourceTx = s;
-            continue;
-        }
-        const lockingScript = sourceTx.outputs[input.sourceOutputIndex].lockingScript.toHex();
-        const hash = services.hashOutputScript(lockingScript);
-        const shhrs = await services.getScriptHashHistory(hash, undefined, logger);
-        if (shhrs.status === 'success') {
-            for (const h of shhrs.history) {
-                // Neither the source of the input nor the current transaction are competition.
-                if (h.txid !== input.sourceTXID && h.txid !== ar.txid)
-                    competingTxids.add(h.txid);
-            }
-        }
-    }
-    ar.competingTxs = [...competingTxids].slice(-24); // keep at most 24, if they were sorted by time, keep newest
-    note.competingTxs = ar.competingTxs.join(',');
-}
-/**
- * Requires ar.status === 'doubleSpend'
- *
- * Parse the rawTx and review each input as a possible double spend.
- *
- * If all inputs appear to be unspent, update aggregate status to 'success' if successCount > 0, otherwise 'serviceError'.
- *
- * @param ar
- * @param storage
- * @param services
- */
-async function confirmDoubleSpend(ar, beef, storage, services, logger) {
-    const req = ar.vreq.req;
-    const note = { when: new Date().toISOString(), what: 'confirmDoubleSpend' };
-    let known = false;
-    for (let retry = 0; retry < 3; retry++) {
-        const gsr = await services.getStatusForTxids([req.txid]);
-        const errCode = gsr.error != null ? gsr.error.code : '';
-        note[`getStatus${retry}`] = `${gsr.status}${errCode},${gsr.results[0]?.status}`;
-        if (gsr.status !== 'success' || gsr.results[0].status === 'unknown') {
-            await (0, utilityHelpers_1.wait)(1000);
-        }
-        else {
-            known = true;
-            break;
-        }
-    }
-    if (known) {
-        // doubleSpend -> success
-        ar.status = 'success';
-        note.newStatus = ar.status;
-    }
-    else {
-        // Confirmed double spend, get txids of possible competing transactions.
-        await gatherCompetingTxids(ar, beef, services, note, logger);
-    }
-    req.addHistoryNote(note);
-}
-/**
- * After any failed broadcast (doubleSpend, invalidTx, etc.), query each
- * consumed-input outpoint of the failed transaction against on-chain
- * UTXO state. For inputs the chain authoritatively confirms are spent
- * (i.e. NOT a UTXO), update the corresponding wallet basket entry to
- * spendable=false.
- *
- * Background: `updateTransactionStatus(failed)` optimistically restores
- * all consumed-input outputs to spendable=true so the user can retry
- * with the same inputs. For some failures (genuine doubleSpend, or any
- * 'missing-inputs' outcome where the input has been spent on chain by
- * a different transaction), restoration is incorrect — the input is
- * gone and restoring it produces an infinite missing-inputs loop on
- * the next createAction → broadcast cycle. Apps cannot evict from the
- * default basket on app-isolated wallets (admin-only policy), so this
- * self-heal must run inside the wallet.
- *
- * Different broadcasters classify the same on-chain reality differently
- * (ARC → doubleSpend, WhatsOnChain/Bitails → invalidTx via
- * 'missing-inputs'); this helper is broadcaster-agnostic because its
- * decision is based on services.isUtxo, not the aggregate failure
- * classification.
- *
- * Pre-broadcast races where concurrent createActions reach the same
- * UTXO across separate app processes are out of scope; see PR
- * description.
- *
- * Conservatively scoped:
- *   - Only inputs found in the failing user's basket are touched.
- *   - Inputs whose on-chain UTXO status cannot be determined (service
- *     error / inconclusive) are left spendable=true. Eviction is opt-in
- *     based on positive evidence of stale state.
- *   - Inputs the chain confirms are still UTXOs (e.g. a competing tx
- *     itself failed, or a malformed/fee failure where inputs are intact)
- *     are left spendable=true — preserving the existing transient-retry
- *     semantics callers depend on.
- *
- * Returns counts for instrumentation and the set of stale outpoints
- * that were actually evicted (added to history note for diagnostics).
- */
-async function markStaleInputsAsSpent(ar, storage, services, trx, logger) {
-    const result = { checked: 0, staleConfirmed: 0, staleOutpoints: [] };
-    const req = ar.vreq.req;
-    // Resolve the user owning the failing tx so we only touch THIS user's
-    // basket entries. Multiple txids share a userId; first is sufficient.
-    const txIds = req.notify.transactionIds;
-    if (txIds == null || txIds.length === 0)
-        return result;
-    const txRecord = (await storage.findTransactions({
-        partial: { transactionId: txIds[0] },
-        noRawTx: true,
-        trx
-    }))[0];
-    if (txRecord == null)
-        return result;
-    const userId = txRecord.userId;
-    // Walk the failed tx's inputs to find which user-owned UTXOs were
-    // consumed and need on-chain verification.
-    const tx = sdk_1.Transaction.fromBinary(req.rawTx);
-    const outpoints = tx.inputs
-        .map(i => ({ txid: i.sourceTXID ?? '', vout: i.sourceOutputIndex ?? 0 }))
-        .filter(o => o.txid !== '');
-    if (outpoints.length === 0)
-        return result;
-    const byOutpoint = await storage.findOutputsByOutpoints(userId, outpoints, trx);
-    const checks = await Promise.all(outpoints.map(async (outpoint) => {
-        const localOutput = byOutpoint[`${outpoint.txid}.${outpoint.vout}`];
-        if (localOutput == null)
-            return { kind: 'skipped' };
-        // services.isUtxo requires the lockingScript; load it lazily.
-        if (localOutput.lockingScript == null) {
-            try {
-                await storage.validateOutputScript(localOutput, trx);
-            }
-            catch {
-                return { kind: 'skipped' };
-            }
-        }
-        let isStillUtxo;
-        try {
-            isStillUtxo = await services.isUtxo(localOutput);
-        }
-        catch {
-            // Service error — preserve current behavior (keep spendable=true).
-            // Eviction requires positive evidence of stale state.
-            return { kind: 'service-error', localOutput };
-        }
-        return isStillUtxo
-            ? { kind: 'still-utxo', localOutput }
-            : { kind: 'stale', localOutput, outpoint };
-    }));
-    for (const c of checks) {
-        if (c.kind === 'skipped')
-            continue;
-        result.checked++;
-        if (c.kind === 'stale') {
-            // Authoritative on-chain evidence the input is spent. Override
-            // the optimistic restore from updateTransactionStatus(failed).
-            await storage.updateOutput(c.localOutput.outputId, { spendable: false }, trx);
-            result.staleConfirmed++;
-            result.staleOutpoints.push(`${c.outpoint.txid}.${c.outpoint.vout}`);
-        }
-    }
-    if (result.staleConfirmed > 0) {
-        logger?.log(`markStaleInputsAsSpent: ${result.staleConfirmed} of ${result.checked} input(s) confirmed-spent on chain for txid=${req.txid}`);
-    }
-    return result;
-}
-//# sourceMappingURL=attemptToPostReqsToNetwork.js.map