@bsv/wallet-toolbox-client 1.7.15 → 1.7.17

package/out/src/monitor/Monitor.js

@@ -0,0 +1,317 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Monitor = void 0;
+const utilityHelpers_1 = require("../utility/utilityHelpers");
+const TaskPurge_1 = require("./tasks/TaskPurge");
+const TaskReviewStatus_1 = require("./tasks/TaskReviewStatus");
+const TaskSyncWhenIdle_1 = require("./tasks/TaskSyncWhenIdle");
+const TaskFailAbandoned_1 = require("./tasks/TaskFailAbandoned");
+const TaskCheckForProofs_1 = require("./tasks/TaskCheckForProofs");
+const TaskClock_1 = require("./tasks/TaskClock");
+const TaskNewHeader_1 = require("./tasks/TaskNewHeader");
+const TaskMonitorCallHistory_1 = require("./tasks/TaskMonitorCallHistory");
+const TaskReorg_1 = require("./tasks/TaskReorg");
+const TaskSendWaiting_1 = require("./tasks/TaskSendWaiting");
+const TaskCheckNoSends_1 = require("./tasks/TaskCheckNoSends");
+const TaskUnFail_1 = require("./tasks/TaskUnFail");
+const WERR_errors_1 = require("../sdk/WERR_errors");
+const WalletError_1 = require("../sdk/WalletError");
+const Services_1 = require("../services/Services");
+/**
+ * Background task to make sure transactions are processed, transaction proofs are received and propagated,
+ * and potentially that reorgs update proofs that were already received.
+ */
+class Monitor {
+    static createDefaultWalletMonitorOptions(chain, storage, services, chaintracks) {
+        services || (services = new Services_1.Services(chain));
+        if (!services.options.chaintracks)
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('services.options.chaintracks', 'valid');
+        const o = {
+            chain,
+            services,
+            storage,
+            msecsWaitPerMerkleProofServiceReq: 500,
+            taskRunWaitMsecs: 5000,
+            abandonedMsecs: 1000 * 60 * 5,
+            unprovenAttemptsLimitTest: 10,
+            unprovenAttemptsLimitMain: 144,
+            chaintracks: services.options.chaintracks,
+            chaintracksWithEvents: chaintracks
+        };
+        return o;
+    }
+    constructor(options) {
+        /**
+         * _tasks are typically run by the scheduler but may also be run by runTask.
+         */
+        this._tasks = [];
+        /**
+         * _otherTasks can be run by runTask but not by scheduler.
+         */
+        this._otherTasks = [];
+        this._tasksRunning = false;
+        this.defaultPurgeParams = {
+            purgeSpent: false,
+            purgeCompleted: false,
+            purgeFailed: true,
+            purgeSpentAge: 2 * Monitor.oneWeek,
+            purgeCompletedAge: 2 * Monitor.oneWeek,
+            purgeFailedAge: 5 * Monitor.oneDay
+        };
+        this._runAsyncSetup = true;
+        this.resolveCompletion = undefined;
+        this.deactivatedHeaders = [];
+        this.options = { ...options };
+        this.services = options.services;
+        this.chain = this.services.chain;
+        this.storage = options.storage;
+        this.chaintracks = options.chaintracks;
+        this.chaintracksWithEvents = options.chaintracksWithEvents;
+        this.onTransactionProven = options.onTransactionProven;
+        this.onTransactionBroadcasted = options.onTransactionBroadcasted;
+        if (this.chaintracksWithEvents) {
+            const c = this.chaintracksWithEvents;
+            this.reorgSubscriptionPromise = c.subscribeReorgs(this.processReorg.bind(this));
+            this.headersSubscriptionPromise = c.subscribeHeaders(this.processHeader.bind(this));
+        }
+    }
+    async destroy() {
+        if (this.chaintracksWithEvents) {
+            const c = this.chaintracksWithEvents;
+            if (this.reorgSubscriptionPromise)
+                await c.unsubscribe(await this.reorgSubscriptionPromise);
+            if (this.headersSubscriptionPromise)
+                await c.unsubscribe(await this.headersSubscriptionPromise);
+        }
+    }
+    addAllTasksToOther() {
+        this._otherTasks.push(new TaskClock_1.TaskClock(this));
+        this._otherTasks.push(new TaskNewHeader_1.TaskNewHeader(this));
+        this._otherTasks.push(new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this));
+        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams));
+        this._otherTasks.push(new TaskReviewStatus_1.TaskReviewStatus(this));
+        this._otherTasks.push(new TaskSendWaiting_1.TaskSendWaiting(this));
+        this._otherTasks.push(new TaskCheckForProofs_1.TaskCheckForProofs(this));
+        this._otherTasks.push(new TaskCheckNoSends_1.TaskCheckNoSends(this));
+        this._otherTasks.push(new TaskUnFail_1.TaskUnFail(this));
+        this._otherTasks.push(new TaskReorg_1.TaskReorg(this));
+        this._otherTasks.push(new TaskFailAbandoned_1.TaskFailAbandoned(this));
+        this._otherTasks.push(new TaskSyncWhenIdle_1.TaskSyncWhenIdle(this));
+    }
+    /**
+     * Default tasks with settings appropriate for a single user storage
+     * possibly with sync'ing enabled
+     */
+    addDefaultTasks() {
+        this._tasks.push(new TaskClock_1.TaskClock(this));
+        this._tasks.push(new TaskNewHeader_1.TaskNewHeader(this));
+        this._tasks.push(new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this));
+        this._tasks.push(new TaskSendWaiting_1.TaskSendWaiting(this, 8 * Monitor.oneSecond, 7 * Monitor.oneSecond)); // Check every 8 seconds but must be 7 seconds old
+        this._tasks.push(new TaskCheckForProofs_1.TaskCheckForProofs(this, 2 * Monitor.oneHour)); // Every two hours if no block found
+        this._tasks.push(new TaskCheckNoSends_1.TaskCheckNoSends(this));
+        this._tasks.push(new TaskFailAbandoned_1.TaskFailAbandoned(this, 8 * Monitor.oneMinute));
+        this._tasks.push(new TaskUnFail_1.TaskUnFail(this));
+        //this._tasks.push(new TaskPurge(this, this.defaultPurgeParams, 6 * Monitor.oneHour))
+        this._tasks.push(new TaskReviewStatus_1.TaskReviewStatus(this));
+        this._tasks.push(new TaskReorg_1.TaskReorg(this));
+    }
+    /**
+     * Tasks appropriate for multi-user storage
+     * without sync'ing enabled.
+     */
+    addMultiUserTasks() {
+        this._tasks.push(new TaskClock_1.TaskClock(this));
+        this._tasks.push(new TaskNewHeader_1.TaskNewHeader(this));
+        this._tasks.push(new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this));
+        this._tasks.push(new TaskSendWaiting_1.TaskSendWaiting(this, 8 * Monitor.oneSecond, 7 * Monitor.oneSecond)); // Check every 8 seconds but must be 7 seconds old
+        this._tasks.push(new TaskCheckForProofs_1.TaskCheckForProofs(this, 2 * Monitor.oneHour)); // Every two hours if no block found
+        this._tasks.push(new TaskCheckNoSends_1.TaskCheckNoSends(this));
+        this._tasks.push(new TaskFailAbandoned_1.TaskFailAbandoned(this, 8 * Monitor.oneMinute));
+        this._tasks.push(new TaskUnFail_1.TaskUnFail(this));
+        //this._tasks.push(new TaskPurge(this, this.defaultPurgeParams, 6 * Monitor.oneHour))
+        this._tasks.push(new TaskReviewStatus_1.TaskReviewStatus(this));
+        this._tasks.push(new TaskReorg_1.TaskReorg(this));
+    }
+    addTask(task) {
+        if (this._tasks.some(t => t.name === task.name))
+            throw new WERR_errors_1.WERR_BAD_REQUEST(`task ${task.name} has already been added.`);
+        this._tasks.push(task);
+    }
+    removeTask(name) {
+        this._tasks = this._tasks.filter(t => t.name !== name);
+    }
+    async runTask(name) {
+        let task = this._tasks.find(t => t.name === name);
+        let log = '';
+        if (!task)
+            task = this._otherTasks.find(t => t.name === name);
+        if (task) {
+            await task.asyncSetup();
+            log = await task.runTask();
+        }
+        return log;
+    }
+    async runOnce() {
+        if (this._runAsyncSetup) {
+            for (const t of this._tasks) {
+                try {
+                    await t.asyncSetup();
+                }
+                catch (eu) {
+                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                    const details = `monitor task ${t.name} asyncSetup error ${e.code} ${e.description}`;
+                    console.log(details);
+                    await this.logEvent('error0', details);
+                }
+                if (!this._tasksRunning)
+                    break;
+            }
+            this._runAsyncSetup = false;
+        }
+        if (this.storage.getActive().isStorageProvider()) {
+            const tasksToRun = [];
+            const now = new Date().getTime();
+            for (const t of this._tasks) {
+                try {
+                    if (t.trigger(now).run)
+                        tasksToRun.push(t);
+                }
+                catch (eu) {
+                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                    const details = `monitor task ${t.name} trigger error ${e.code} ${e.description}`;
+                    console.log(details);
+                    await this.logEvent('error0', details);
+                }
+            }
+            for (const ttr of tasksToRun) {
+                try {
+                    if (this.storage.getActive().isStorageProvider()) {
+                        const log = await ttr.runTask();
+                        if (log && log.length > 0) {
+                            console.log(`Task${ttr.name} ${log.slice(0, 256)}`);
+                            await this.logEvent(ttr.name, log);
+                        }
+                    }
+                }
+                catch (eu) {
+                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                    const details = `monitor task ${ttr.name} runTask error ${e.code} ${e.description}\n${e.stack}`;
+                    console.log(details);
+                    await this.logEvent('error1', details);
+                }
+                finally {
+                    ttr.lastRunMsecsSinceEpoch = new Date().getTime();
+                }
+            }
+        }
+    }
+    async startTasks() {
+        if (this._tasksRunning)
+            throw new WERR_errors_1.WERR_BAD_REQUEST('monitor tasks are already runnining.');
+        this._tasksRunning = true;
+        this._tasksRunningPromise = new Promise(resolve => {
+            this.resolveCompletion = resolve;
+        });
+        for (; this._tasksRunning;) {
+            await this.runOnce();
+            // console.log(`${new Date().toISOString()} tasks run, waiting...`)
+            await (0, utilityHelpers_1.wait)(this.options.taskRunWaitMsecs);
+        }
+        if (this.resolveCompletion) {
+            this.resolveCompletion();
+            this.resolveCompletion = undefined;
+        }
+    }
+    async logEvent(event, details) {
+        await this.storage.runAsStorageProvider(async (sp) => {
+            await sp.insertMonitorEvent({
+                created_at: new Date(),
+                updated_at: new Date(),
+                id: 0,
+                event,
+                details
+            });
+        });
+    }
+    stopTasks() {
+        this._tasksRunning = false;
+    }
+    /**
+     * Process new chain header event received from Chaintracks
+     *
+     * Kicks processing 'unconfirmed' and 'unmined' request processing.
+     *
+     * @param reqs
+     */
+    processNewBlockHeader(header) {
+        const h = header;
+        this.lastNewHeader = h;
+        this.lastNewHeaderWhen = new Date();
+        // console.log(`WalletMonitor notified of new block header ${h.height}`)
+        // Nudge the proof checker to try again.
+        TaskCheckForProofs_1.TaskCheckForProofs.checkNow = true;
+    }
+    /**
+     * This is a function run from a TaskSendWaiting Monitor task.
+     *
+     * This allows the user of wallet-toolbox to 'subscribe' for transaction broadcast updates.
+     *
+     * @param broadcastResult
+     */
+    callOnBroadcastedTransaction(broadcastResult) {
+        if (this.onTransactionBroadcasted) {
+            this.onTransactionBroadcasted(broadcastResult);
+        }
+    }
+    /**
+     * This is a function run from a TaskCheckForProofs Monitor task.
+     *
+     * This allows the user of wallet-toolbox to 'subscribe' for transaction updates.
+     *
+     * @param txStatus
+     */
+    callOnProvenTransaction(txStatus) {
+        if (this.onTransactionProven) {
+            this.onTransactionProven(txStatus);
+        }
+    }
+    /**
+     * Process reorg event received from Chaintracks
+     *
+     * Reorgs can move recent transactions to new blocks at new index positions.
+     * Affected transaction proofs become invalid and must be updated.
+     *
+     * It is possible for a transaction to become invalid.
+     *
+     * Coinbase transactions always become invalid.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    processReorg(depth, oldTip, newTip, deactivatedHeaders) {
+        if (deactivatedHeaders) {
+            for (const header of deactivatedHeaders) {
+                this.deactivatedHeaders.push({
+                    whenMsecs: Date.now(),
+                    tries: 0,
+                    header
+                });
+            }
+        }
+    }
+    /**
+     * Handler for new header events from Chaintracks.
+     *
+     * To minimize reorg processing, new headers are aged before processing via TaskNewHeader.
+     * Therefore this handler is intentionally a no-op.
+     *
+     * @param header
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    processHeader(header) { }
+}
+exports.Monitor = Monitor;
+Monitor.oneSecond = 1000;
+Monitor.oneMinute = 60 * Monitor.oneSecond;
+Monitor.oneHour = 60 * Monitor.oneMinute;
+Monitor.oneDay = 24 * Monitor.oneHour;
+Monitor.oneWeek = 7 * Monitor.oneDay;
+//# sourceMappingURL=Monitor.js.map

package/out/src/monitor/Monitor.js.map

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

package/out/src/monitor/tasks/TaskCheckForProofs.d.ts

@@ -0,0 +1,53 @@
+import { TableProvenTxReq } from '../../storage/schema/tables';
+import { Monitor } from '../Monitor';
+import { WalletMonitorTask } from './WalletMonitorTask';
+/**
+ * `TaskCheckForProofs` is a WalletMonitor task that retreives merkle proofs for
+ * transactions.
+ *
+ * It is normally triggered by the Chaintracks new block header event.
+ *
+ * When a new block is found, cwi-external-services are used to obtain proofs for
+ * any transactions that are currently in the 'unmined' or 'unknown' state.
+ *
+ * If a proof is obtained and validated, a new ProvenTx record is created and
+ * the original ProvenTxReq status is advanced to 'notifying'.
+ */
+export declare class TaskCheckForProofs extends WalletMonitorTask {
+    triggerMsecs: number;
+    static taskName: string;
+    /**
+     * An external service such as the chaintracks new block header
+     * listener can set this true to cause
+     */
+    static checkNow: boolean;
+    constructor(monitor: Monitor, triggerMsecs?: number);
+    /**
+     * Normally triggered by checkNow getting set by new block header found event from chaintracks
+     */
+    trigger(nowMsecsSinceEpoch: number): {
+        run: boolean;
+    };
+    runTask(): Promise<string>;
+}
+/**
+ * Process an array of table.ProvenTxReq (typically with status 'unmined' or 'unknown')
+ *
+ * If req is invalid, set status 'invalid'
+ *
+ * Verify the requests are valid, lookup proofs or updated transaction status using the array of getProofServices,
+ *
+ * When proofs are found, create new ProvenTxApi records and transition the requests' status to 'unconfirmed' or 'notifying',
+ * depending on chaintracks succeeding on proof verification.
+ *
+ * Increments attempts if proofs where requested.
+ *
+ * @param reqs
+ * @returns reqs partitioned by status
+ */
+export declare function getProofs(task: WalletMonitorTask, reqs: TableProvenTxReq[], indent: number | undefined, countsAsAttempt: boolean | undefined, ignoreStatus: boolean | undefined, maxAcceptableHeight: number): Promise<{
+    proven: TableProvenTxReq[];
+    invalid: TableProvenTxReq[];
+    log: string;
+}>;
+//# sourceMappingURL=TaskCheckForProofs.d.ts.map

package/out/src/monitor/tasks/TaskCheckForProofs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskCheckForProofs.d.ts","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskCheckForProofs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAG9D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB;IAW9C,YAAY;IAVrB,MAAM,CAAC,QAAQ,SAAmB;IAElC;;;OAGG;IACH,MAAM,CAAC,QAAQ,UAAQ;gBAGrB,OAAO,EAAE,OAAO,EACT,YAAY,SAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,kBAAkB,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE;IAQ/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CA4BjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,gBAAgB,EAAE,EACxB,MAAM,oBAAI,EACV,eAAe,qBAAQ,EACvB,YAAY,qBAAQ,EACpB,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC;IACT,MAAM,EAAE,gBAAgB,EAAE,CAAA;IAC1B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAC,CA2ID"}

package/out/src/monitor/tasks/TaskCheckForProofs.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskCheckForProofs = void 0;
+exports.getProofs = getProofs;
+const entities_1 = require("../../storage/schema/entities");
+const utilityHelpers_1 = require("../../utility/utilityHelpers");
+const utilityHelpers_noBuffer_1 = require("../../utility/utilityHelpers.noBuffer");
+const WalletMonitorTask_1 = require("./WalletMonitorTask");
+/**
+ * `TaskCheckForProofs` is a WalletMonitor task that retreives merkle proofs for
+ * transactions.
+ *
+ * It is normally triggered by the Chaintracks new block header event.
+ *
+ * When a new block is found, cwi-external-services are used to obtain proofs for
+ * any transactions that are currently in the 'unmined' or 'unknown' state.
+ *
+ * If a proof is obtained and validated, a new ProvenTx record is created and
+ * the original ProvenTxReq status is advanced to 'notifying'.
+ */
+class TaskCheckForProofs extends WalletMonitorTask_1.WalletMonitorTask {
+    constructor(monitor, triggerMsecs = 0) {
+        super(monitor, TaskCheckForProofs.taskName);
+        this.triggerMsecs = triggerMsecs;
+    }
+    /**
+     * Normally triggered by checkNow getting set by new block header found event from chaintracks
+     */
+    trigger(nowMsecsSinceEpoch) {
+        return {
+            run: TaskCheckForProofs.checkNow
+            // Check only when checkNow flag is set.
+            // || (this.triggerMsecs > 0 && nowMsecsSinceEpoch - this.lastRunMsecsSinceEpoch > this.triggerMsecs)
+        };
+    }
+    async runTask() {
+        var _a;
+        let log = '';
+        const countsAsAttempt = TaskCheckForProofs.checkNow;
+        TaskCheckForProofs.checkNow = false;
+        const maxAcceptableHeight = (_a = this.monitor.lastNewHeader) === null || _a === void 0 ? void 0 : _a.height;
+        if (maxAcceptableHeight === undefined) {
+            return log;
+        }
+        const limit = 100;
+        let offset = 0;
+        for (;;) {
+            const reqs = await this.storage.findProvenTxReqs({
+                partial: {},
+                status: ['callback', 'unmined', 'sending', 'unknown', 'unconfirmed'],
+                paged: { limit, offset }
+            });
+            if (reqs.length === 0)
+                break;
+            log += `${reqs.length} reqs with status 'callback', 'unmined', 'sending', 'unknown', or 'unconfirmed'\n`;
+            const r = await getProofs(this, reqs, 2, countsAsAttempt, false, maxAcceptableHeight);
+            log += `${r.log}\n`;
+            //console.log(log);
+            if (reqs.length < limit)
+                break;
+            offset += limit;
+        }
+        return log;
+    }
+}
+exports.TaskCheckForProofs = TaskCheckForProofs;
+TaskCheckForProofs.taskName = 'CheckForProofs';
+/**
+ * An external service such as the chaintracks new block header
+ * listener can set this true to cause
+ */
+TaskCheckForProofs.checkNow = false;
+/**
+ * Process an array of table.ProvenTxReq (typically with status 'unmined' or 'unknown')
+ *
+ * If req is invalid, set status 'invalid'
+ *
+ * Verify the requests are valid, lookup proofs or updated transaction status using the array of getProofServices,
+ *
+ * When proofs are found, create new ProvenTxApi records and transition the requests' status to 'unconfirmed' or 'notifying',
+ * depending on chaintracks succeeding on proof verification.
+ *
+ * Increments attempts if proofs where requested.
+ *
+ * @param reqs
+ * @returns reqs partitioned by status
+ */
+async function getProofs(task, reqs, indent = 0, countsAsAttempt = false, ignoreStatus = false, maxAcceptableHeight) {
+    const proven = [];
+    const invalid = [];
+    let log = '';
+    for (const reqApi of reqs) {
+        log += ' '.repeat(indent);
+        log += `reqId ${reqApi.provenTxReqId} txid ${reqApi.txid}: `;
+        if (!ignoreStatus &&
+            reqApi.status !== 'callback' &&
+            reqApi.status !== 'unmined' &&
+            reqApi.status !== 'unknown' &&
+            reqApi.status !== 'unconfirmed' &&
+            reqApi.status !== 'nosend' &&
+            reqApi.status !== 'sending') {
+            log += `status of '${reqApi.status}' is not ready to be proven.\n`;
+            continue;
+        }
+        const req = new entities_1.EntityProvenTxReq(reqApi);
+        if (Number.isInteger(req.provenTxId)) {
+            log += `Already linked to provenTxId ${req.provenTxId}.\n`;
+            req.notified = false;
+            req.status = 'completed';
+            await req.updateStorageDynamicProperties(task.storage);
+            proven.push(reqApi);
+            continue;
+        }
+        log += '\n';
+        let reqIsValid = false;
+        if (req.rawTx) {
+            const txid = (0, utilityHelpers_noBuffer_1.asString)((0, utilityHelpers_1.doubleSha256BE)(req.rawTx));
+            if (txid === req.txid)
+                reqIsValid = true;
+        }
+        if (!reqIsValid) {
+            log += ` rawTx doesn't hash to txid. status => invalid.\n`;
+            req.notified = false;
+            req.status = 'invalid';
+            await req.updateStorageDynamicProperties(task.storage);
+            invalid.push(reqApi);
+            continue;
+        }
+        const limit = task.monitor.chain === 'main'
+            ? task.monitor.options.unprovenAttemptsLimitMain
+            : task.monitor.options.unprovenAttemptsLimitTest;
+        if (!ignoreStatus && req.attempts > limit) {
+            log += ` too many failed attempts ${req.attempts}\n`;
+            req.notified = false;
+            req.status = 'invalid';
+            await req.updateStorageDynamicProperties(task.storage);
+            invalid.push(reqApi);
+            continue;
+        }
+        const since = new Date();
+        let r;
+        let ptx;
+        // External services will try multiple providers until one returns a proof,
+        // or they all fail.
+        // There may also be an array of proofs to consider when a transaction
+        // is recently mined and appears in orphan blocks in addition to active chain blocks.
+        // Since orphan blocks can end up on chain again, multiple proofs has value.
+        //
+        // On failure, there may be a mapi response, or an error.
+        //
+        // The proofs returned are considered sequentially, validating and chaintracks confirming.
+        //
+        // If a good proof is found, proceed to using it.
+        //
+        // When all received proofs fail, force a bump to the next service provider and try
+        // one more time.
+        //
+        r = await task.monitor.services.getMerklePath(req.txid);
+        if (r.header && r.header.height > maxAcceptableHeight) {
+            // Ignore proofs from bleeding edge of new blocks as these are the most often re-orged.
+            log += ` ignoring possible proof from very new block at height ${r.header.height} ${r.header.hash}\n`;
+            continue;
+        }
+        ptx = await entities_1.EntityProvenTx.fromReq(req, r, countsAsAttempt && req.status !== 'nosend');
+        if (ptx) {
+            // We have a merklePath proof for the request (and a block header)
+            await req.updateStorageDynamicProperties(task.storage);
+            await req.refreshFromStorage(task.storage);
+            const { provenTxReqId, status, txid, attempts, history } = req.toApi();
+            const { index, height, blockHash, merklePath, merkleRoot } = ptx.toApi();
+            const r = await task.storage.runAsStorageProvider(async (sp) => {
+                return await sp.updateProvenTxReqWithNewProvenTx({
+                    provenTxReqId,
+                    status,
+                    txid,
+                    attempts,
+                    history,
+                    index,
+                    height,
+                    blockHash,
+                    merklePath,
+                    merkleRoot
+                });
+            });
+            req.status = r.status;
+            req.apiHistory = r.history;
+            req.provenTxId = r.provenTxId;
+            req.notified = true;
+            task.monitor.callOnProvenTransaction({
+                txid,
+                txIndex: index,
+                blockHeight: height,
+                blockHash,
+                merklePath,
+                merkleRoot
+            });
+        }
+        else {
+            if (countsAsAttempt && req.status !== 'nosend') {
+                req.attempts++;
+            }
+        }
+        await req.updateStorageDynamicProperties(task.storage);
+        await req.refreshFromStorage(task.storage);
+        log += req.historyPretty(since, indent + 2) + '\n';
+        if (req.status === 'completed')
+            proven.push(req.api);
+        if (req.status === 'invalid')
+            invalid.push(req.api);
+    }
+    return { proven, invalid, log };
+}
+//# sourceMappingURL=TaskCheckForProofs.js.map

package/out/src/monitor/tasks/TaskCheckForProofs.js.map

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

package/out/src/monitor/tasks/TaskCheckNoSends.d.ts

@@ -0,0 +1,33 @@
+import { Monitor } from '../Monitor';
+import { WalletMonitorTask } from './WalletMonitorTask';
+/**
+ * `TaskCheckNoSends` is a WalletMonitor task that retreives merkle proofs for
+ * 'nosend' transactions that MAY have been shared externally.
+ *
+ * Unlike intentionally processed transactions, 'nosend' transactions are fully valid
+ * transactions which have not been processed by the wallet.
+ *
+ * By default, this task runs once a day to check if any 'nosend' transaction has
+ * managed to get mined by some external process.
+ *
+ * If a proof is obtained and validated, a new ProvenTx record is created and
+ * the original ProvenTxReq status is advanced to 'notifying'.
+ */
+export declare class TaskCheckNoSends extends WalletMonitorTask {
+    triggerMsecs: number;
+    static taskName: string;
+    /**
+     * An external service such as the chaintracks new block header
+     * listener can set this true to cause
+     */
+    static checkNow: boolean;
+    constructor(monitor: Monitor, triggerMsecs?: number);
+    /**
+     * Normally triggered by checkNow getting set by new block header found event from chaintracks
+     */
+    trigger(nowMsecsSinceEpoch: number): {
+        run: boolean;
+    };
+    runTask(): Promise<string>;
+}
+//# sourceMappingURL=TaskCheckNoSends.d.ts.map

package/out/src/monitor/tasks/TaskCheckNoSends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaskCheckNoSends.d.ts","sourceRoot":"","sources":["../../../../../src/monitor/tasks/TaskCheckNoSends.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAiB,SAAQ,iBAAiB;IAW5C,YAAY;IAVrB,MAAM,CAAC,QAAQ,SAAiB;IAEhC;;;OAGG;IACH,MAAM,CAAC,QAAQ,UAAQ;gBAGrB,OAAO,EAAE,OAAO,EACT,YAAY,SAAqB;IAK1C;;OAEG;IACH,OAAO,CAAC,kBAAkB,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE;IAQ/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CA4BjC"}