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

package/out/src/mockchain/merkleTree.js

@@ -15,20 +15,27 @@ function computeMerkleRoot(txids) {
         throw new Error('Cannot compute merkle root of empty txid list');
     }
     // Convert txids to byte arrays (reverse to little-endian for hashing)
-    let level = txids.map(txid => (0, utilityHelpers_noBuffer_1.asArray)(txid).reverse());
+    let level = txids.map(txid => {
+        const txidBytes = (0, utilityHelpers_noBuffer_1.asArray)(txid);
+        txidBytes.reverse();
+        return txidBytes;
+    });
     while (level.length > 1) {
         const next = [];
         for (let i = 0; i < level.length; i += 2) {
             const left = level[i];
             const right = i + 1 < level.length ? level[i + 1] : level[i]; // duplicate last if odd
             const combined = [...left, ...right];
-            const hash = (0, utilityHelpers_1.doubleSha256BE)(combined).reverse(); // doubleSha256BE returns BE, reverse to LE for next level
+            const hash = (0, utilityHelpers_1.doubleSha256BE)(combined); // doubleSha256BE returns BE, reverse to LE for next level
+            hash.reverse();
             next.push(hash);
         }
         level = next;
     }
     // Final root in LE, reverse to BE for return
-    return (0, utilityHelpers_noBuffer_1.asString)(level[0].reverse());
+    const root = [...level[0]];
+    root.reverse();
+    return (0, utilityHelpers_noBuffer_1.asString)(root);
 }
 /**
  * Compute the MerklePath for a target transaction at `targetIndex` within a block at `blockHeight`.
@@ -53,7 +60,7 @@ function computeMerklePath(txids, targetIndex, blockHeight) {
         treeHeight++;
         n = Math.ceil(n / 2);
     }
-    const path = Array(treeHeight)
+    const path = new Array(treeHeight)
         .fill(0)
         .map(() => []);
     let index = targetIndex;
@@ -87,20 +94,22 @@ function computeMerklePath(txids, targetIndex, blockHeight) {
                 }
             }
         }
+        else if (siblingIndex >= levelTxids.length) {
+            // Higher levels: duplicate sibling when odd
+            path[level].push({ offset: siblingIndex, duplicate: true });
+        }
         else {
             // Higher levels: we only need the sibling hash
-            if (siblingIndex >= levelTxids.length) {
-                path[level].push({ offset: siblingIndex, duplicate: true });
-            }
-            else {
-                path[level].push({ offset: siblingIndex, hash: levelTxids[siblingIndex] });
-            }
+            path[level].push({ offset: siblingIndex, hash: levelTxids[siblingIndex] });
         }
         // Compute next level hashes
         const nextLevel = [];
         for (let i = 0; i < levelTxids.length; i += 2) {
-            const left = (0, utilityHelpers_noBuffer_1.asArray)(levelTxids[i]).reverse();
-            const right = i + 1 < levelTxids.length ? (0, utilityHelpers_noBuffer_1.asArray)(levelTxids[i + 1]).reverse() : left;
+            const left = (0, utilityHelpers_noBuffer_1.asArray)(levelTxids[i]);
+            left.reverse();
+            const right = i + 1 < levelTxids.length ? (0, utilityHelpers_noBuffer_1.asArray)(levelTxids[i + 1]) : left;
+            if (right !== left)
+                right.reverse();
             const combined = [...left, ...right];
             const hash = (0, utilityHelpers_1.doubleSha256BE)(combined); // returns BE
             nextLevel.push((0, utilityHelpers_noBuffer_1.asString)(hash));

package/out/src/mockchain/merkleTree.js.map

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

package/out/src/monitor/LeasedMonitorTask.d.ts

@@ -0,0 +1,43 @@
+import { TransactionService } from '../storage/schema/transactionService';
+/**
+ * Helper that wraps a long-running monitor task body in `monitor_lease`
+ * acquire / renew / release semantics.
+ *
+ * Usage:
+ * ```typescript
+ * const helper = new LeasedMonitorTask(txSvc)
+ * const { ran } = await helper.run('proof-acquisition', ownerId, 30_000, async () => {
+ *   // task body runs only when lease is acquired
+ * })
+ * if (!ran) {
+ *   console.log('lease held by another instance – skipping')
+ * }
+ * ```
+ *
+ * Lease renewal is driven by a `setInterval` firing at `ttlMs * 0.4` so the
+ * lease is always refreshed well before it would expire (40 % window). The
+ * interval is cleared in the `finally` block before `releaseLease` is called.
+ *
+ * Logging writes to `console.log` so that lease activity is visible in the
+ * same stream as other Monitor diagnostics.
+ */
+export declare class LeasedMonitorTask {
+    private readonly svc;
+    constructor(svc: TransactionService);
+    /**
+     * Attempt to claim the named lease and, if successful, execute `body`.
+     *
+     * @param taskName  Logical task identifier stored in `monitor_lease.task_name`.
+     * @param ownerId   Stable identifier for this Monitor instance.
+     * @param ttlMs     Lease TTL in milliseconds.  Renewal fires at `ttlMs * 0.4`.
+     * @param body      Async work to perform while holding the lease.
+     *
+     * @returns `{ ran: true }` when the lease was acquired and `body` completed
+     *          (even if `body` threw — the error is re-thrown after cleanup).
+     *          `{ ran: false }` when another owner holds a live lease.
+     */
+    run(taskName: string, ownerId: string, ttlMs: number, body: () => Promise<void>): Promise<{
+        ran: boolean;
+    }>;
+}
+//# sourceMappingURL=LeasedMonitorTask.d.ts.map

package/out/src/monitor/LeasedMonitorTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeasedMonitorTask.d.ts","sourceRoot":"","sources":["../../../../src/monitor/LeasedMonitorTask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAiB;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,kBAAkB;IAErD;;;;;;;;;;;OAWG;IACG,GAAG,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GACxB,OAAO,CAAC;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;CA2C7B"}

package/out/src/monitor/LeasedMonitorTask.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeasedMonitorTask = void 0;
+/**
+ * Helper that wraps a long-running monitor task body in `monitor_lease`
+ * acquire / renew / release semantics.
+ *
+ * Usage:
+ * ```typescript
+ * const helper = new LeasedMonitorTask(txSvc)
+ * const { ran } = await helper.run('proof-acquisition', ownerId, 30_000, async () => {
+ *   // task body runs only when lease is acquired
+ * })
+ * if (!ran) {
+ *   console.log('lease held by another instance – skipping')
+ * }
+ * ```
+ *
+ * Lease renewal is driven by a `setInterval` firing at `ttlMs * 0.4` so the
+ * lease is always refreshed well before it would expire (40 % window). The
+ * interval is cleared in the `finally` block before `releaseLease` is called.
+ *
+ * Logging writes to `console.log` so that lease activity is visible in the
+ * same stream as other Monitor diagnostics.
+ */
+class LeasedMonitorTask {
+    constructor(svc) {
+        this.svc = svc;
+    }
+    /**
+     * Attempt to claim the named lease and, if successful, execute `body`.
+     *
+     * @param taskName  Logical task identifier stored in `monitor_lease.task_name`.
+     * @param ownerId   Stable identifier for this Monitor instance.
+     * @param ttlMs     Lease TTL in milliseconds.  Renewal fires at `ttlMs * 0.4`.
+     * @param body      Async work to perform while holding the lease.
+     *
+     * @returns `{ ran: true }` when the lease was acquired and `body` completed
+     *          (even if `body` threw — the error is re-thrown after cleanup).
+     *          `{ ran: false }` when another owner holds a live lease.
+     */
+    async run(taskName, ownerId, ttlMs, body) {
+        const claim = await this.svc.tryClaimLease({ taskName, ownerId, ttlMs });
+        if (!claim.acquired) {
+            console.log(`[LeasedMonitorTask] ${taskName}: lease held by another owner — skipping`);
+            return { ran: false };
+        }
+        console.log(`[LeasedMonitorTask] ${taskName}: lease acquired by ${ownerId} (ttl=${ttlMs}ms)`);
+        // Renew at 40 % of TTL so there is always a healthy margin before expiry.
+        const renewIntervalMs = Math.max(1000, Math.floor(ttlMs * 0.4));
+        let renewFailures = 0;
+        const renewTimer = setInterval(async () => {
+            var _a, _b;
+            try {
+                const result = await this.svc.renewLease({ taskName, ownerId, ttlMs });
+                if (result.acquired) {
+                    renewFailures = 0;
+                    console.log(`[LeasedMonitorTask] ${taskName}: lease renewed (renewCount=${(_b = (_a = result.lease) === null || _a === void 0 ? void 0 : _a.renewCount) !== null && _b !== void 0 ? _b : '?'})`);
+                }
+                else {
+                    renewFailures++;
+                    console.log(`[LeasedMonitorTask] ${taskName}: lease renew failed (attempt ${renewFailures}) — may have been taken over`);
+                }
+            }
+            catch (err) {
+                renewFailures++;
+                const msg = err instanceof Error ? err.message : String(err);
+                console.log(`[LeasedMonitorTask] ${taskName}: lease renew error (attempt ${renewFailures}): ${msg}`);
+            }
+        }, renewIntervalMs);
+        try {
+            await body();
+            return { ran: true };
+        }
+        finally {
+            clearInterval(renewTimer);
+            try {
+                const released = await this.svc.releaseLease({ taskName, ownerId });
+                console.log(`[LeasedMonitorTask] ${taskName}: lease released by ${ownerId} (deleted=${released})`);
+            }
+            catch (releaseErr) {
+                const msg = releaseErr instanceof Error ? releaseErr.message : String(releaseErr);
+                console.log(`[LeasedMonitorTask] ${taskName}: lease release error: ${msg}`);
+            }
+        }
+    }
+}
+exports.LeasedMonitorTask = LeasedMonitorTask;
+//# sourceMappingURL=LeasedMonitorTask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LeasedMonitorTask.js","sourceRoot":"","sources":["../../../../src/monitor/LeasedMonitorTask.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,iBAAiB;IAC5B,YAA8B,GAAuB;QAAvB,QAAG,GAAH,GAAG,CAAoB;IAAG,CAAC;IAEzD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CACP,QAAgB,EAChB,OAAe,EACf,KAAa,EACb,IAAyB;QAEzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACxE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,0CAA0C,CAAC,CAAA;YACtF,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;QACvB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,uBAAuB,OAAO,SAAS,KAAK,KAAK,CAAC,CAAA;QAE7F,0EAA0E;QAC1E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAA;QAC/D,IAAI,aAAa,GAAG,CAAC,CAAA;QACrB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;gBACtE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,aAAa,GAAG,CAAC,CAAA;oBACjB,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,+BAA+B,MAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,UAAU,mCAAI,GAAG,GAAG,CAAC,CAAA;gBAC/G,CAAC;qBAAM,CAAC;oBACN,aAAa,EAAE,CAAA;oBACf,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,iCAAiC,aAAa,8BAA8B,CAAC,CAAA;gBAC1H,CAAC;YACH,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,aAAa,EAAE,CAAA;gBACf,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,gCAAgC,aAAa,MAAM,GAAG,EAAE,CAAC,CAAA;YACtG,CAAC;QACH,CAAC,EAAE,eAAe,CAAC,CAAA;QAEnB,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAA;YACZ,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;QACtB,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,UAAU,CAAC,CAAA;YACzB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;gBACnE,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,uBAAuB,OAAO,aAAa,QAAQ,GAAG,CAAC,CAAA;YACpG,CAAC;YAAC,OAAO,UAAmB,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;gBACjF,OAAO,CAAC,GAAG,CAAC,uBAAuB,QAAQ,0BAA0B,GAAG,EAAE,CAAC,CAAA;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA/DD,8CA+DC"}

package/out/src/monitor/Monitor.d.ts

@@ -24,6 +24,15 @@ export interface MonitorOptions {
     abandonedMsecs: number;
     unprovenAttemptsLimitTest: number;
     unprovenAttemptsLimitMain: number;
+    /**
+     * Maximum number of times a broadcast transaction may be reset to 'unsent' for
+     * rebroadcast after proof check timeout (circuit breaker).
+     *
+     * Default 0 means unlimited — the tx is rebroadcast indefinitely until a proof
+     * is found. Set to a positive integer to cap rebroadcast cycles; once the limit
+     * is reached the req is marked 'invalid'.
+     */
+    maxRebroadcastAttempts: number;
     /**
      * Stable callback token for ARC SSE event streaming.
      * When set, TaskArcadeSSE will open an SSE connection to Arcade's
@@ -50,6 +59,13 @@ export interface MonitorOptions {
  */
 export declare class Monitor {
     static createDefaultWalletMonitorOptions(chain: Chain, storage: MonitorStorage, services?: Services, chaintracks?: Chaintracks, startupTaskMode?: MonitorStartupTaskMode): MonitorOptions;
+    /**
+     * Stable identifier for this Monitor instance, used as the `ownerId` when
+     * acquiring monitor_lease rows. Generated once at construction time via
+     * 8 cryptographically random bytes (16 hex chars). Callers may override this
+     * after construction if a deterministic / persisted id is preferred.
+     */
+    instanceId: string;
     options: MonitorOptions;
     services: Services | WalletServices;
     chain: Chain;
@@ -61,7 +77,15 @@ export declare class Monitor {
     onTransactionBroadcasted?: (broadcastResult: ReviewActionResult) => Promise<void>;
     onTransactionProven?: (txStatus: ProvenTransactionStatus) => Promise<void>;
     onTransactionStatusChanged?: (txid: string, newStatus: string) => Promise<void>;
+    /**
+     * Resolves once the optional Chaintracks subscriptions have been registered.
+     * Await this before calling `startTasks()` if `chaintracksWithEvents` is provided
+     * and you need subscriptions to be active before the first task loop runs.
+     */
+    get ready(): Promise<void>;
+    private _readyInit?;
     constructor(options: MonitorOptions);
+    private _init;
     private applyStartupTaskMode;
     destroy(): Promise<void>;
     static readonly oneSecond = 1000;

package/out/src/monitor/Monitor.d.ts.map

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

package/out/src/monitor/Monitor.js

@@ -27,8 +27,8 @@ const Services_1 = require("../services/Services");
  */
 class Monitor {
     static createDefaultWalletMonitorOptions(chain, storage, services, chaintracks, startupTaskMode = 'none') {
-        services || (services = new Services_1.Services(chain));
-        if (!services.options.chaintracks)
+        services !== null && services !== void 0 ? services : (services = new Services_1.Services(chain));
+        if (services.options.chaintracks == null)
             throw new WERR_errors_1.WERR_INVALID_PARAMETER('services.options.chaintracks', 'valid');
         const o = {
             chain,
@@ -37,15 +37,34 @@ class Monitor {
             msecsWaitPerMerkleProofServiceReq: 500,
             taskRunWaitMsecs: 5000,
             abandonedMsecs: 1000 * 60 * 5,
-            unprovenAttemptsLimitTest: 10,
+            unprovenAttemptsLimitTest: 100,
             unprovenAttemptsLimitMain: 144,
+            maxRebroadcastAttempts: 0,
             chaintracks: services.options.chaintracks,
             chaintracksWithEvents: chaintracks,
             startupTaskMode
         };
         return o;
     }
+    /**
+     * Resolves once the optional Chaintracks subscriptions have been registered.
+     * Await this before calling `startTasks()` if `chaintracksWithEvents` is provided
+     * and you need subscriptions to be active before the first task loop runs.
+     */
+    get ready() {
+        if (this._readyInit === undefined) {
+            this._readyInit = this._init();
+        }
+        return this._readyInit;
+    }
     constructor(options) {
+        /**
+         * Stable identifier for this Monitor instance, used as the `ownerId` when
+         * acquiring monitor_lease rows. Generated once at construction time via
+         * 8 cryptographically random bytes (16 hex chars). Callers may override this
+         * after construction if a deterministic / persisted id is preferred.
+         */
+        this.instanceId = (0, utilityHelpers_1.randomBytesHex)(8);
         /**
          * _tasks are typically run by the scheduler but may also be run by runTask.
          */
@@ -75,13 +94,15 @@ class Monitor {
         this.onTransactionProven = options.onTransactionProven;
         this.onTransactionBroadcasted = options.onTransactionBroadcasted;
         this.onTransactionStatusChanged = options.onTransactionStatusChanged;
-        if (this.chaintracksWithEvents) {
-            const c = this.chaintracksWithEvents;
-            this.reorgSubscriptionPromise = c.subscribeReorgs(this.processReorg.bind(this));
-            this.headersSubscriptionPromise = c.subscribeHeaders(this.processHeader.bind(this));
-        }
         this.applyStartupTaskMode(options.startupTaskMode || 'none');
     }
+    async _init() {
+        if (this.chaintracksWithEvents != null) {
+            this.reorgSubscriptionPromise = this.chaintracksWithEvents.subscribeReorgs(this.processReorg.bind(this));
+            this.headersSubscriptionPromise = this.chaintracksWithEvents.subscribeHeaders(this.processHeader.bind(this));
+            await Promise.all([this.reorgSubscriptionPromise, this.headersSubscriptionPromise]);
+        }
+    }
     applyStartupTaskMode(mode) {
         switch (mode) {
             case 'default':
@@ -96,34 +117,20 @@ class Monitor {
             case 'none':
                 break;
             default:
-                throw new WERR_errors_1.WERR_INVALID_PARAMETER('startupTaskMode', `'none', 'default', 'multiuser', or 'alltoother'`);
+                throw new WERR_errors_1.WERR_INVALID_PARAMETER('startupTaskMode', '\'none\', \'default\', \'multiuser\', or \'alltoother\'');
         }
     }
     async destroy() {
-        if (this.chaintracksWithEvents) {
+        if (this.chaintracksWithEvents != null) {
             const c = this.chaintracksWithEvents;
-            if (this.reorgSubscriptionPromise)
+            if (this.reorgSubscriptionPromise != null)
                 await c.unsubscribe(await this.reorgSubscriptionPromise);
-            if (this.headersSubscriptionPromise)
+            if (this.headersSubscriptionPromise != null)
                 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 TaskSendWaiting_1.TaskSendWaiting(this));
-        this._otherTasks.push(new TaskCheckForProofs_1.TaskCheckForProofs(this));
-        this._otherTasks.push(new TaskCheckNoSends_1.TaskCheckNoSends(this));
-        this._otherTasks.push(new TaskFailAbandoned_1.TaskFailAbandoned(this));
-        this._otherTasks.push(new TaskUnFail_1.TaskUnFail(this));
-        this._otherTasks.push(new TaskReviewStatus_1.TaskReviewStatus(this));
-        this._otherTasks.push(new TaskReorg_1.TaskReorg(this));
-        this._otherTasks.push(new TaskReviewUtxos_1.TaskReviewUtxos(this));
-        this._otherTasks.push(new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this));
-        this._otherTasks.push(new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this));
-        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams));
-        //this._otherTasks.push(new TaskSyncWhenIdle(this))
+        this._otherTasks.push(new TaskClock_1.TaskClock(this), new TaskNewHeader_1.TaskNewHeader(this), new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this), new TaskSendWaiting_1.TaskSendWaiting(this), new TaskCheckForProofs_1.TaskCheckForProofs(this), new TaskCheckNoSends_1.TaskCheckNoSends(this), new TaskFailAbandoned_1.TaskFailAbandoned(this), new TaskUnFail_1.TaskUnFail(this), new TaskReviewStatus_1.TaskReviewStatus(this), new TaskReorg_1.TaskReorg(this), new TaskReviewUtxos_1.TaskReviewUtxos(this), new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this), new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this), new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams));
         if (this.chain === 'mock') {
             this._otherTasks.push(new TaskMineBlock_1.TaskMineBlock(this));
         }
@@ -132,21 +139,10 @@ class Monitor {
      * Default tasks with settings appropriate for a single user storage
      */
     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 TaskReviewStatus_1.TaskReviewStatus(this));
-        this._tasks.push(new TaskReorg_1.TaskReorg(this));
-        this._tasks.push(new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this));
-        this._tasks.push(new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this));
-        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams, 6 * Monitor.oneHour));
-        this._otherTasks.push(new TaskReviewUtxos_1.TaskReviewUtxos(this));
-        this._tasks.push(new TaskArcSSE_1.TaskArcadeSSE(this));
+        this._tasks.push(new TaskClock_1.TaskClock(this), new TaskNewHeader_1.TaskNewHeader(this), new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this), new TaskSendWaiting_1.TaskSendWaiting(this, 8 * Monitor.oneSecond, 7 * Monitor.oneSecond), // Check every 8 seconds but must be 7 seconds old
+        new TaskCheckForProofs_1.TaskCheckForProofs(this, 2 * Monitor.oneHour), // Every two hours if no block found
+        new TaskCheckNoSends_1.TaskCheckNoSends(this), new TaskFailAbandoned_1.TaskFailAbandoned(this, 8 * Monitor.oneMinute), new TaskUnFail_1.TaskUnFail(this), new TaskReviewStatus_1.TaskReviewStatus(this), new TaskReorg_1.TaskReorg(this), new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this), new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this), new TaskArcSSE_1.TaskArcadeSSE(this));
+        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams, 6 * Monitor.oneHour), new TaskReviewUtxos_1.TaskReviewUtxos(this));
         if (this.chain === 'mock') {
             this._tasks.push(new TaskMineBlock_1.TaskMineBlock(this));
         }
@@ -155,27 +151,18 @@ class Monitor {
      * Tasks appropriate for multi-user storage
      */
     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 TaskReviewStatus_1.TaskReviewStatus(this));
-        this._tasks.push(new TaskReorg_1.TaskReorg(this));
-        this._tasks.push(new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this));
-        this._tasks.push(new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this));
-        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams));
-        this._otherTasks.push(new TaskReviewUtxos_1.TaskReviewUtxos(this));
+        this._tasks.push(new TaskClock_1.TaskClock(this), new TaskNewHeader_1.TaskNewHeader(this), new TaskMonitorCallHistory_1.TaskMonitorCallHistory(this), new TaskSendWaiting_1.TaskSendWaiting(this, 8 * Monitor.oneSecond, 7 * Monitor.oneSecond), // Check every 8 seconds but must be 7 seconds old
+        new TaskCheckForProofs_1.TaskCheckForProofs(this, 2 * Monitor.oneHour), // Every two hours if no block found
+        new TaskCheckNoSends_1.TaskCheckNoSends(this), new TaskFailAbandoned_1.TaskFailAbandoned(this, 8 * Monitor.oneMinute), new TaskUnFail_1.TaskUnFail(this), new TaskReviewStatus_1.TaskReviewStatus(this), new TaskReorg_1.TaskReorg(this), new TaskReviewDoubleSpends_1.TaskReviewDoubleSpends(this), new TaskReviewProvenTxs_1.TaskReviewProvenTxs(this));
+        this._otherTasks.push(new TaskPurge_1.TaskPurge(this, this.defaultPurgeParams), new TaskReviewUtxos_1.TaskReviewUtxos(this));
         if (this.chain === 'mock') {
             this._tasks.push(new TaskMineBlock_1.TaskMineBlock(this));
         }
     }
     addTask(task) {
-        if (this._tasks.some(t => t.name === task.name))
+        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) {
@@ -184,9 +171,8 @@ class Monitor {
     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) {
+        task !== null && task !== void 0 ? task : (task = this._otherTasks.find(t => t.name === name));
+        if (task != null) {
             await task.asyncSetup();
             log = await task.runTask();
         }
@@ -198,8 +184,8 @@ class Monitor {
                 try {
                     await t.asyncSetup();
                 }
-                catch (eu) {
-                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                catch (error_) {
+                    const e = WalletError_1.WalletError.fromUnknown(error_);
                     const details = `monitor task ${t.name} asyncSetup error ${e.code} ${e.description}`;
                     console.log(details);
                     await this.logEvent('error0', details);
@@ -211,14 +197,14 @@ class Monitor {
         }
         if (this.storage.getActive().isStorageProvider()) {
             const tasksToRun = [];
-            const now = new Date().getTime();
+            const now = Date.now();
             for (const t of this._tasks) {
                 try {
                     if (t.trigger(now).run)
                         tasksToRun.push(t);
                 }
-                catch (eu) {
-                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                catch (error_) {
+                    const e = WalletError_1.WalletError.fromUnknown(error_);
                     const details = `monitor task ${t.name} trigger error ${e.code} ${e.description}`;
                     console.log(details);
                     await this.logEvent('error0', details);
@@ -238,14 +224,14 @@ class Monitor {
                         }
                     }
                 }
-                catch (eu) {
-                    const e = WalletError_1.WalletError.fromUnknown(eu);
+                catch (error_) {
+                    const e = WalletError_1.WalletError.fromUnknown(error_);
                     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();
+                    ttr.lastRunMsecsSinceEpoch = Date.now();
                 }
             }
         }
@@ -257,12 +243,12 @@ class Monitor {
         this._tasksRunningPromise = new Promise(resolve => {
             this.resolveCompletion = resolve;
         });
-        for (; this._tasksRunning;) {
+        while (this._tasksRunning) {
             await this.runOnce();
             // console.log(`${new Date().toISOString()} tasks run, waiting...`)
             await (0, utilityHelpers_1.wait)(this.options.taskRunWaitMsecs);
         }
-        if (this.resolveCompletion) {
+        if (this.resolveCompletion != null) {
             this.resolveCompletion();
             this.resolveCompletion = undefined;
         }
@@ -304,7 +290,7 @@ class Monitor {
      * @param broadcastResult
      */
     callOnBroadcastedTransaction(broadcastResult) {
-        if (this.onTransactionBroadcasted) {
+        if (this.onTransactionBroadcasted != null) {
             this.onTransactionBroadcasted(broadcastResult);
         }
     }
@@ -316,7 +302,7 @@ class Monitor {
      * @param txStatus
      */
     callOnProvenTransaction(txStatus) {
-        if (this.onTransactionProven) {
+        if (this.onTransactionProven != null) {
             this.onTransactionProven(txStatus);
         }
     }
@@ -324,7 +310,7 @@ class Monitor {
      * Called by TaskArcadeSSE when an SSE status event is received from Arcade.
      */
     callOnTransactionStatusChanged(txid, newStatus) {
-        if (this.onTransactionStatusChanged) {
+        if (this.onTransactionStatusChanged != null) {
             this.onTransactionStatusChanged(txid, newStatus);
         }
     }
@@ -349,7 +335,7 @@ class Monitor {
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     processReorg(depth, oldTip, newTip, deactivatedHeaders) {
-        if (deactivatedHeaders) {
+        if (deactivatedHeaders != null) {
             for (const header of deactivatedHeaders) {
                 this.deactivatedHeaders.push({
                     whenMsecs: Date.now(),
@@ -368,7 +354,9 @@ class Monitor {
      * @param header
      */
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    processHeader(header) { }
+    processHeader(header) {
+        // Intentional no-op: new headers are aged via TaskNewHeader before processing
+    }
 }
 exports.Monitor = Monitor;
 Monitor.oneSecond = 1000;