@bsv/wallet-toolbox 1.6.14 → 1.6.16

package/docs/wallet.md

@@ -8515,10 +8515,15 @@ export class BulkFileDataManager {
     readonly maxRetained?: number;
     readonly fromKnownSourceUrl?: string;
     constructor(options: BulkFileDataManagerOptions | Chain) 
+    async deleteBulkFiles(): Promise<void> 
+    async setStorage(storage: ChaintracksStorageBulkFileApi, log: (...args: any[]) => void): Promise<void> 
+    heightRangesFromBulkFiles(files: BulkHeaderFileInfo[]): {
+        all: HeightRange;
+        cdn: HeightRange;
+        incremental: HeightRange;
+    } 
     async createReader(range?: HeightRange, maxBufferSize?: number): Promise<BulkFileDataReader> 
     async updateFromUrl(cdnUrl: string): Promise<void> 
-    async setStorage(storage: ChaintracksStorageBulkFileApi, log: (...args: any[]) => void): Promise<void> 
-    async deleteBulkFiles(): Promise<void> 
     async merge(files: BulkHeaderFileInfo[]): Promise<BulkFileDataManagerMergeResult> 
     toLogString(what?: BulkFileDataManagerMergeResult | BulkFileData[] | BulkHeaderFileInfo[]): string 
     async mergeIncrementalBlockHeaders(newBulkHeaders: BlockHeader[], incrementalChainWork?: string): Promise<void> 
@@ -8535,6 +8540,19 @@ export class BulkFileDataManager {
 
 See also: [BlockHeader](./client.md#interface-blockheader), [BulkFileDataManagerMergeResult](./services.md#interface-bulkfiledatamanagermergeresult), [BulkFileDataManagerOptions](./services.md#interface-bulkfiledatamanageroptions), [BulkFileDataReader](./services.md#class-bulkfiledatareader), [BulkHeaderFileInfo](./services.md#interface-bulkheaderfileinfo), [Chain](./client.md#type-chain), [ChaintracksFetchApi](./services.md#interface-chaintracksfetchapi), [ChaintracksFsApi](./services.md#interface-chaintracksfsapi), [ChaintracksStorageBulkFileApi](./services.md#interface-chaintracksstoragebulkfileapi), [HeightRange](./services.md#class-heightrange)
 
+###### Method setStorage
+
+If `bfds` are going to be backed by persistent storage,
+must be called before making storage available.
+
+Synchronizes bfds and storage files, after which this manager maintains sync.
+There should be no changes to bulk files by direct access to storage bulk file methods.
+
+```ts
+async setStorage(storage: ChaintracksStorageBulkFileApi, log: (...args: any[]) => void): Promise<void> 
+```
+See also: [ChaintracksStorageBulkFileApi](./services.md#interface-chaintracksstoragebulkfileapi)
+
 Links: [API](#api), [Interfaces](#interfaces), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
 ---
@@ -9403,130 +9421,142 @@ export class Chaintracks implements ChaintracksManagementApi {
         const cdnSyncRepeatMsecs = 24 * 60 * 60 * 1000;
         const syncCheckRepeatMsecs = 30 * 60 * 1000;
         while (!this.stopMainThread) {
-            const now = Date.now();
-            lastSyncCheck = now;
-            const presentHeight = await this.getPresentHeight();
-            const before = await this.storage.getAvailableHeightRanges();
-            let skipBulkSync = !before.live.isEmpty && before.live.maxHeight >= presentHeight - this.addLiveRecursionLimit / 2;
-            if (skipBulkSync && now - lastSyncCheck > cdnSyncRepeatMsecs) {
-                skipBulkSync = false;
-            }
-            this.log(`Chaintracks Update Services: Bulk Header Sync Review
+            try {
+                const now = Date.now();
+                lastSyncCheck = now;
+                const presentHeight = await this.getPresentHeight();
+                const before = await this.storage.getAvailableHeightRanges();
+                let skipBulkSync = !before.live.isEmpty && before.live.maxHeight >= presentHeight - this.addLiveRecursionLimit / 2;
+                if (skipBulkSync && now - lastSyncCheck > cdnSyncRepeatMsecs) {
+                    skipBulkSync = false;
+                }
+                this.log(`Chaintracks Update Services: Bulk Header Sync Review
   presentHeight=${presentHeight}   addLiveRecursionLimit=${this.addLiveRecursionLimit}
   Before synchronize: bulk ${before.bulk}, live ${before.live}
   ${skipBulkSync ? "Skipping" : "Starting"} syncBulkStorage.
 `);
-            if (!skipBulkSync) {
-                lastBulkSync = now;
-                if (this.available)
-                    await this.syncBulkStorage(presentHeight, before);
-                else
-                    await this.syncBulkStorageNoLock(presentHeight, before);
-            }
-            let count = 0;
-            let liveHeaderDupes = 0;
-            let needSyncCheck = false;
-            for (; !needSyncCheck && !this.stopMainThread;) {
-                let header = this.liveHeaders.shift();
-                if (header) {
-                    let recursions = this.addLiveRecursionLimit;
-                    for (; !needSyncCheck && !this.stopMainThread;) {
-                        const ihr = await this.addLiveHeader(header);
-                        if (this.invalidInsertHeaderResult(ihr)) {
-                            this.log(`Ignoring liveHeader ${header.height} ${header.hash} due to invalid insert result.`);
-                            needSyncCheck = true;
-                        }
-                        else if (ihr.noPrev) {
-                            if (recursions-- <= 0) {
-                                this.log(`Ignoring liveHeader ${header.height} ${header.hash} addLiveRecursionLimit=${this.addLiveRecursionLimit} exceeded.`);
+                if (!skipBulkSync) {
+                    lastBulkSync = now;
+                    if (this.available)
+                        await this.syncBulkStorage(presentHeight, before);
+                    else
+                        await this.syncBulkStorageNoLock(presentHeight, before);
+                }
+                let count = 0;
+                let liveHeaderDupes = 0;
+                let needSyncCheck = false;
+                for (; !needSyncCheck && !this.stopMainThread;) {
+                    let header = this.liveHeaders.shift();
+                    if (header) {
+                        let recursions = this.addLiveRecursionLimit;
+                        for (; !needSyncCheck && !this.stopMainThread;) {
+                            const ihr = await this.addLiveHeader(header);
+                            if (this.invalidInsertHeaderResult(ihr)) {
+                                this.log(`Ignoring liveHeader ${header.height} ${header.hash} due to invalid insert result.`);
                                 needSyncCheck = true;
                             }
-                            else {
-                                const hash = header.previousHash;
-                                const prevHeader = await this.getMissingBlockHeader(hash);
-                                if (!prevHeader) {
-                                    this.log(`Ignoring liveHeader ${header.height} ${header.hash} failed to find previous header by hash ${asString(hash)}`);
+                            else if (ihr.noPrev) {
+                                if (recursions-- <= 0) {
+                                    this.log(`Ignoring liveHeader ${header.height} ${header.hash} addLiveRecursionLimit=${this.addLiveRecursionLimit} exceeded.`);
                                     needSyncCheck = true;
                                 }
                                 else {
-                                    this.liveHeaders.unshift(header);
-                                    header = prevHeader;
+                                    const hash = header.previousHash;
+                                    const prevHeader = await this.getMissingBlockHeader(hash);
+                                    if (!prevHeader) {
+                                        this.log(`Ignoring liveHeader ${header.height} ${header.hash} failed to find previous header by hash ${asString(hash)}`);
+                                        needSyncCheck = true;
+                                    }
+                                    else {
+                                        this.liveHeaders.unshift(header);
+                                        header = prevHeader;
+                                    }
                                 }
                             }
-                        }
-                        else {
-                            if (this.subscriberCallbacksEnabled)
-                                this.log(`addLiveHeader ${header.height}${ihr.added ? " added" : ""}${ihr.dupe ? " dupe" : ""}${ihr.isActiveTip ? " isActiveTip" : ""}${ihr.reorgDepth ? " reorg depth " + ihr.reorgDepth : ""}${ihr.noPrev ? " noPrev" : ""}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? " error" : ""}`);
-                            if (ihr.dupe) {
-                                liveHeaderDupes++;
-                            }
-                            if (ihr.added) {
-                                count++;
-                            }
-                            break;
-                        }
-                    }
-                }
-                else {
-                    const bheader = this.baseHeaders.shift();
-                    if (bheader) {
-                        const prev = await this.storage.findLiveHeaderForBlockHash(bheader.previousHash);
-                        if (!prev) {
-                            this.log(`Ignoring header with unknown previousHash ${bheader.previousHash} in live storage.`);
-                        }
-                        else {
-                            const header: BlockHeader = {
-                                ...bheader,
-                                height: prev.height + 1,
-                                hash: blockHash(bheader)
-                            };
-                            const ihr = await this.addLiveHeader(header);
-                            if (this.invalidInsertHeaderResult(ihr)) {
-                                this.log(`Ignoring invalid baseHeader ${header.height} ${header.hash}.`);
-                            }
                             else {
                                 if (this.subscriberCallbacksEnabled)
-                                    this.log(`addBaseHeader ${header.height}${ihr.added ? " added" : ""}${ihr.dupe ? " dupe" : ""}${ihr.isActiveTip ? " isActiveTip" : ""}${ihr.reorgDepth ? " reorg depth " + ihr.reorgDepth : ""}${ihr.noPrev ? " noPrev" : ""}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? " error" : ""}`);
+                                    this.log(`addLiveHeader ${header.height}${ihr.added ? " added" : ""}${ihr.dupe ? " dupe" : ""}${ihr.isActiveTip ? " isActiveTip" : ""}${ihr.reorgDepth ? " reorg depth " + ihr.reorgDepth : ""}${ihr.noPrev ? " noPrev" : ""}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? " error" : ""}`);
+                                if (ihr.dupe) {
+                                    liveHeaderDupes++;
+                                }
                                 if (ihr.added) {
                                     count++;
                                 }
+                                break;
                             }
                         }
                     }
                     else {
-                        if (count > 0) {
-                            if (liveHeaderDupes > 0) {
-                                this.log(`${liveHeaderDupes} duplicate headers ignored.`);
-                                liveHeaderDupes = 0;
+                        const bheader = this.baseHeaders.shift();
+                        if (bheader) {
+                            const prev = await this.storage.findLiveHeaderForBlockHash(bheader.previousHash);
+                            if (!prev) {
+                                this.log(`Ignoring header with unknown previousHash ${bheader.previousHash} in live storage.`);
+                            }
+                            else {
+                                const header: BlockHeader = {
+                                    ...bheader,
+                                    height: prev.height + 1,
+                                    hash: blockHash(bheader)
+                                };
+                                const ihr = await this.addLiveHeader(header);
+                                if (this.invalidInsertHeaderResult(ihr)) {
+                                    this.log(`Ignoring invalid baseHeader ${header.height} ${header.hash}.`);
+                                }
+                                else {
+                                    if (this.subscriberCallbacksEnabled)
+                                        this.log(`addBaseHeader ${header.height}${ihr.added ? " added" : ""}${ihr.dupe ? " dupe" : ""}${ihr.isActiveTip ? " isActiveTip" : ""}${ihr.reorgDepth ? " reorg depth " + ihr.reorgDepth : ""}${ihr.noPrev ? " noPrev" : ""}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? " error" : ""}`);
+                                    if (ihr.added) {
+                                        count++;
+                                    }
+                                }
                             }
-                            const updated = await this.storage.getAvailableHeightRanges();
-                            this.log(`After adding ${count} live headers
+                        }
+                        else {
+                            if (count > 0) {
+                                if (liveHeaderDupes > 0) {
+                                    this.log(`${liveHeaderDupes} duplicate headers ignored.`);
+                                    liveHeaderDupes = 0;
+                                }
+                                const updated = await this.storage.getAvailableHeightRanges();
+                                this.log(`After adding ${count} live headers
    After live: bulk ${updated.bulk}, live ${updated.live}
 `);
-                            count = 0;
-                        }
-                        if (!this.subscriberCallbacksEnabled) {
-                            const live = await this.storage.findLiveHeightRange();
-                            if (!live.isEmpty) {
-                                this.subscriberCallbacksEnabled = true;
-                                this.log(`listening at height of ${live.maxHeight}`);
+                                count = 0;
                             }
+                            if (!this.subscriberCallbacksEnabled) {
+                                const live = await this.storage.findLiveHeightRange();
+                                if (!live.isEmpty) {
+                                    this.subscriberCallbacksEnabled = true;
+                                    this.log(`listening at height of ${live.maxHeight}`);
+                                }
+                            }
+                            if (!this.available) {
+                                this.available = true;
+                            }
+                            needSyncCheck = Date.now() - lastSyncCheck > syncCheckRepeatMsecs;
+                            if (!needSyncCheck)
+                                await wait(1000);
                         }
-                        if (!this.available) {
-                            this.available = true;
-                        }
-                        needSyncCheck = Date.now() - lastSyncCheck > syncCheckRepeatMsecs;
-                        if (!needSyncCheck)
-                            await wait(1000);
                     }
                 }
             }
+            catch (eu: unknown) {
+                const e = WalletError.fromUnknown(eu);
+                if (!this.available) {
+                    this.startupError = e;
+                    this.stopMainThread = true;
+                }
+                else {
+                    this.log(`Error occurred during chaintracks main thread processing: ${e.stack || e.message}`);
+                }
+            }
         }
     }
 }
 ```
 
-See also: [BaseBlockHeader](./client.md#interface-baseblockheader), [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [ChaintracksFsApi](./services.md#interface-chaintracksfsapi), [ChaintracksInfoApi](./services.md#interface-chaintracksinfoapi), [ChaintracksManagementApi](./services.md#interface-chaintracksmanagementapi), [ChaintracksOptions](./services.md#interface-chaintracksoptions), [HeaderListener](./services.md#type-headerlistener), [HeightRange](./services.md#class-heightrange), [HeightRanges](./services.md#interface-heightranges), [LiveBlockHeader](./services.md#interface-liveblockheader), [ReorgListener](./services.md#type-reorglistener), [Services](./services.md#class-services), [asString](./client.md#function-asstring), [blockHash](./services.md#function-blockhash), [wait](./client.md#function-wait)
+See also: [BaseBlockHeader](./client.md#interface-baseblockheader), [BlockHeader](./client.md#interface-blockheader), [Chain](./client.md#type-chain), [ChaintracksFsApi](./services.md#interface-chaintracksfsapi), [ChaintracksInfoApi](./services.md#interface-chaintracksinfoapi), [ChaintracksManagementApi](./services.md#interface-chaintracksmanagementapi), [ChaintracksOptions](./services.md#interface-chaintracksoptions), [HeaderListener](./services.md#type-headerlistener), [HeightRange](./services.md#class-heightrange), [HeightRanges](./services.md#interface-heightranges), [LiveBlockHeader](./services.md#interface-liveblockheader), [ReorgListener](./services.md#type-reorglistener), [Services](./services.md#class-services), [WalletError](./client.md#class-walleterror), [asString](./client.md#function-asstring), [blockHash](./services.md#function-blockhash), [wait](./client.md#function-wait)
 
 ###### Method addHeader
 

package/mobile/out/src/services/chaintracker/chaintracks/Chaintracks.d.ts

@@ -18,6 +18,7 @@ export declare class Chaintracks implements ChaintracksManagementApi {
     private liveHeaders;
     private addLiveRecursionLimit;
     private available;
+    private startupError;
     private subscriberCallbacksEnabled;
     private stopMainThread;
     private lastPresentHeight;

package/mobile/out/src/services/chaintracker/chaintracks/Chaintracks.d.ts.map

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

package/mobile/out/src/services/chaintracker/chaintracks/Chaintracks.js

@@ -7,6 +7,7 @@ const utilityHelpers_noBuffer_1 = require("../../../utility/utilityHelpers.noBuf
 const HeightRange_1 = require("./util/HeightRange");
 const SingleWriterMultiReaderLock_1 = require("./util/SingleWriterMultiReaderLock");
 const utilityHelpers_1 = require("../../../utility/utilityHelpers");
+const WalletError_1 = require("../../../sdk/WalletError");
 class Chaintracks {
     static createOptions(chain) {
         return {
@@ -30,6 +31,7 @@ class Chaintracks {
         this.liveHeaders = [];
         this.addLiveRecursionLimit = 11;
         this.available = false;
+        this.startupError = null;
         this.subscriberCallbacksEnabled = false;
         this.stopMainThread = true;
         this.lastPresentHeight = 0;
@@ -146,9 +148,11 @@ class Chaintracks {
             // Start mai loop to shift out liveHeaders...once sync'd, will set `available` true.
             this.promises.push(this.mainThreadShiftLiveHeaders());
             // Wait for the main thread to finish initial sync.
-            while (!this.available) {
+            while (!this.available && !this.startupError) {
                 await (0, utilityHelpers_1.wait)(100);
             }
+            if (this.startupError)
+                throw this.startupError;
         });
     }
     async startPromises() {
@@ -376,142 +380,154 @@ class Chaintracks {
         const cdnSyncRepeatMsecs = 24 * 60 * 60 * 1000; // 24 hours
         const syncCheckRepeatMsecs = 30 * 60 * 1000; // 30 minutes
         while (!this.stopMainThread) {
-            // Review the need for bulk sync...
-            const now = Date.now();
-            lastSyncCheck = now;
-            const presentHeight = await this.getPresentHeight();
-            const before = await this.storage.getAvailableHeightRanges();
-            // Skip bulk sync if within less than half the recursion limit of present height
-            let skipBulkSync = !before.live.isEmpty && before.live.maxHeight >= presentHeight - this.addLiveRecursionLimit / 2;
-            if (skipBulkSync && now - lastSyncCheck > cdnSyncRepeatMsecs) {
-                // If we haven't re-synced in a long time, do it just to check for a CDN update.
-                skipBulkSync = false;
-            }
-            this.log(`Chaintracks Update Services: Bulk Header Sync Review
+            try {
+                // Review the need for bulk sync...
+                const now = Date.now();
+                lastSyncCheck = now;
+                const presentHeight = await this.getPresentHeight();
+                const before = await this.storage.getAvailableHeightRanges();
+                // Skip bulk sync if within less than half the recursion limit of present height
+                let skipBulkSync = !before.live.isEmpty && before.live.maxHeight >= presentHeight - this.addLiveRecursionLimit / 2;
+                if (skipBulkSync && now - lastSyncCheck > cdnSyncRepeatMsecs) {
+                    // If we haven't re-synced in a long time, do it just to check for a CDN update.
+                    skipBulkSync = false;
+                }
+                this.log(`Chaintracks Update Services: Bulk Header Sync Review
   presentHeight=${presentHeight}   addLiveRecursionLimit=${this.addLiveRecursionLimit}
   Before synchronize: bulk ${before.bulk}, live ${before.live}
   ${skipBulkSync ? 'Skipping' : 'Starting'} syncBulkStorage.
 `);
-            if (!skipBulkSync) {
-                // Bring bulk storage up-to-date and (re-)initialize liveHeaders
-                lastBulkSync = now;
-                if (this.available)
-                    // Once available, initial write lock is released, take a new one to update bulk storage.
-                    await this.syncBulkStorage(presentHeight, before);
-                else
-                    // While still not available, the makeAvailable write lock is held.
-                    await this.syncBulkStorageNoLock(presentHeight, before);
-            }
-            let count = 0;
-            let liveHeaderDupes = 0;
-            let needSyncCheck = false;
-            for (; !needSyncCheck && !this.stopMainThread;) {
-                let header = this.liveHeaders.shift();
-                if (header) {
-                    // Process a "live" block header...
-                    let recursions = this.addLiveRecursionLimit;
-                    for (; !needSyncCheck && !this.stopMainThread;) {
-                        //console.log(`Processing liveHeader: height: ${header.height} hash: ${header.hash} ${new Date().toISOString()}`)
-                        const ihr = await this.addLiveHeader(header);
-                        if (this.invalidInsertHeaderResult(ihr)) {
-                            this.log(`Ignoring liveHeader ${header.height} ${header.hash} due to invalid insert result.`);
-                            needSyncCheck = true;
-                        }
-                        else if (ihr.noPrev) {
-                            // Previous header is unknown, request it by hash from the network and try adding it first...
-                            if (recursions-- <= 0) {
-                                // Ignore this header...
-                                this.log(`Ignoring liveHeader ${header.height} ${header.hash} addLiveRecursionLimit=${this.addLiveRecursionLimit} exceeded.`);
+                if (!skipBulkSync) {
+                    // Bring bulk storage up-to-date and (re-)initialize liveHeaders
+                    lastBulkSync = now;
+                    if (this.available)
+                        // Once available, initial write lock is released, take a new one to update bulk storage.
+                        await this.syncBulkStorage(presentHeight, before);
+                    else
+                        // While still not available, the makeAvailable write lock is held.
+                        await this.syncBulkStorageNoLock(presentHeight, before);
+                }
+                let count = 0;
+                let liveHeaderDupes = 0;
+                let needSyncCheck = false;
+                for (; !needSyncCheck && !this.stopMainThread;) {
+                    let header = this.liveHeaders.shift();
+                    if (header) {
+                        // Process a "live" block header...
+                        let recursions = this.addLiveRecursionLimit;
+                        for (; !needSyncCheck && !this.stopMainThread;) {
+                            //console.log(`Processing liveHeader: height: ${header.height} hash: ${header.hash} ${new Date().toISOString()}`)
+                            const ihr = await this.addLiveHeader(header);
+                            if (this.invalidInsertHeaderResult(ihr)) {
+                                this.log(`Ignoring liveHeader ${header.height} ${header.hash} due to invalid insert result.`);
                                 needSyncCheck = true;
                             }
-                            else {
-                                const hash = header.previousHash;
-                                const prevHeader = await this.getMissingBlockHeader(hash);
-                                if (!prevHeader) {
-                                    this.log(`Ignoring liveHeader ${header.height} ${header.hash} failed to find previous header by hash ${(0, utilityHelpers_noBuffer_1.asString)(hash)}`);
+                            else if (ihr.noPrev) {
+                                // Previous header is unknown, request it by hash from the network and try adding it first...
+                                if (recursions-- <= 0) {
+                                    // Ignore this header...
+                                    this.log(`Ignoring liveHeader ${header.height} ${header.hash} addLiveRecursionLimit=${this.addLiveRecursionLimit} exceeded.`);
                                     needSyncCheck = true;
                                 }
                                 else {
-                                    // Switch to trying to add prevHeader, unshifting current header to try it again after prevHeader exists.
-                                    this.liveHeaders.unshift(header);
-                                    header = prevHeader;
+                                    const hash = header.previousHash;
+                                    const prevHeader = await this.getMissingBlockHeader(hash);
+                                    if (!prevHeader) {
+                                        this.log(`Ignoring liveHeader ${header.height} ${header.hash} failed to find previous header by hash ${(0, utilityHelpers_noBuffer_1.asString)(hash)}`);
+                                        needSyncCheck = true;
+                                    }
+                                    else {
+                                        // Switch to trying to add prevHeader, unshifting current header to try it again after prevHeader exists.
+                                        this.liveHeaders.unshift(header);
+                                        header = prevHeader;
+                                    }
                                 }
                             }
-                        }
-                        else {
-                            if (this.subscriberCallbacksEnabled)
-                                this.log(`addLiveHeader ${header.height}${ihr.added ? ' added' : ''}${ihr.dupe ? ' dupe' : ''}${ihr.isActiveTip ? ' isActiveTip' : ''}${ihr.reorgDepth ? ' reorg depth ' + ihr.reorgDepth : ''}${ihr.noPrev ? ' noPrev' : ''}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? ' error' : ''}`);
-                            if (ihr.dupe) {
-                                liveHeaderDupes++;
-                            }
-                            // Header wasn't invalid and previous header is known. If it was successfully added, count it as a win.
-                            if (ihr.added) {
-                                count++;
-                            }
-                            break;
-                        }
-                    }
-                }
-                else {
-                    // There are no liveHeaders currently to process, check the out-of-band baseHeaders channel (`addHeader` method called by a client).
-                    const bheader = this.baseHeaders.shift();
-                    if (bheader) {
-                        const prev = await this.storage.findLiveHeaderForBlockHash(bheader.previousHash);
-                        if (!prev) {
-                            // Ignoring attempt to add a baseHeader with unknown previous hash, no attempt made to find previous header(s).
-                            this.log(`Ignoring header with unknown previousHash ${bheader.previousHash} in live storage.`);
-                            // Does not trigger a re-sync.
-                        }
-                        else {
-                            const header = {
-                                ...bheader,
-                                height: prev.height + 1,
-                                hash: (0, blockHeaderUtilities_1.blockHash)(bheader)
-                            };
-                            const ihr = await this.addLiveHeader(header);
-                            if (this.invalidInsertHeaderResult(ihr)) {
-                                this.log(`Ignoring invalid baseHeader ${header.height} ${header.hash}.`);
-                            }
                             else {
                                 if (this.subscriberCallbacksEnabled)
-                                    this.log(`addBaseHeader ${header.height}${ihr.added ? ' added' : ''}${ihr.dupe ? ' dupe' : ''}${ihr.isActiveTip ? ' isActiveTip' : ''}${ihr.reorgDepth ? ' reorg depth ' + ihr.reorgDepth : ''}${ihr.noPrev ? ' noPrev' : ''}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? ' error' : ''}`);
-                                // baseHeader was successfully added.
+                                    this.log(`addLiveHeader ${header.height}${ihr.added ? ' added' : ''}${ihr.dupe ? ' dupe' : ''}${ihr.isActiveTip ? ' isActiveTip' : ''}${ihr.reorgDepth ? ' reorg depth ' + ihr.reorgDepth : ''}${ihr.noPrev ? ' noPrev' : ''}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? ' error' : ''}`);
+                                if (ihr.dupe) {
+                                    liveHeaderDupes++;
+                                }
+                                // Header wasn't invalid and previous header is known. If it was successfully added, count it as a win.
                                 if (ihr.added) {
                                     count++;
                                 }
+                                break;
                             }
                         }
                     }
                     else {
-                        // There are no liveHeaders and no baseHeaders to add,
-                        if (count > 0) {
-                            if (liveHeaderDupes > 0) {
-                                this.log(`${liveHeaderDupes} duplicate headers ignored.`);
-                                liveHeaderDupes = 0;
+                        // There are no liveHeaders currently to process, check the out-of-band baseHeaders channel (`addHeader` method called by a client).
+                        const bheader = this.baseHeaders.shift();
+                        if (bheader) {
+                            const prev = await this.storage.findLiveHeaderForBlockHash(bheader.previousHash);
+                            if (!prev) {
+                                // Ignoring attempt to add a baseHeader with unknown previous hash, no attempt made to find previous header(s).
+                                this.log(`Ignoring header with unknown previousHash ${bheader.previousHash} in live storage.`);
+                                // Does not trigger a re-sync.
+                            }
+                            else {
+                                const header = {
+                                    ...bheader,
+                                    height: prev.height + 1,
+                                    hash: (0, blockHeaderUtilities_1.blockHash)(bheader)
+                                };
+                                const ihr = await this.addLiveHeader(header);
+                                if (this.invalidInsertHeaderResult(ihr)) {
+                                    this.log(`Ignoring invalid baseHeader ${header.height} ${header.hash}.`);
+                                }
+                                else {
+                                    if (this.subscriberCallbacksEnabled)
+                                        this.log(`addBaseHeader ${header.height}${ihr.added ? ' added' : ''}${ihr.dupe ? ' dupe' : ''}${ihr.isActiveTip ? ' isActiveTip' : ''}${ihr.reorgDepth ? ' reorg depth ' + ihr.reorgDepth : ''}${ihr.noPrev ? ' noPrev' : ''}${ihr.noActiveAncestor || ihr.noTip || ihr.badPrev ? ' error' : ''}`);
+                                    // baseHeader was successfully added.
+                                    if (ihr.added) {
+                                        count++;
+                                    }
+                                }
                             }
-                            const updated = await this.storage.getAvailableHeightRanges();
-                            this.log(`After adding ${count} live headers
+                        }
+                        else {
+                            // There are no liveHeaders and no baseHeaders to add,
+                            if (count > 0) {
+                                if (liveHeaderDupes > 0) {
+                                    this.log(`${liveHeaderDupes} duplicate headers ignored.`);
+                                    liveHeaderDupes = 0;
+                                }
+                                const updated = await this.storage.getAvailableHeightRanges();
+                                this.log(`After adding ${count} live headers
    After live: bulk ${updated.bulk}, live ${updated.live}
 `);
-                            count = 0;
-                        }
-                        if (!this.subscriberCallbacksEnabled) {
-                            const live = await this.storage.findLiveHeightRange();
-                            if (!live.isEmpty) {
-                                this.subscriberCallbacksEnabled = true;
-                                this.log(`listening at height of ${live.maxHeight}`);
+                                count = 0;
                             }
+                            if (!this.subscriberCallbacksEnabled) {
+                                const live = await this.storage.findLiveHeightRange();
+                                if (!live.isEmpty) {
+                                    this.subscriberCallbacksEnabled = true;
+                                    this.log(`listening at height of ${live.maxHeight}`);
+                                }
+                            }
+                            if (!this.available) {
+                                this.available = true;
+                            }
+                            needSyncCheck = Date.now() - lastSyncCheck > syncCheckRepeatMsecs;
+                            // If we aren't going to review sync, wait before checking input queues again
+                            if (!needSyncCheck)
+                                await (0, utilityHelpers_1.wait)(1000);
                         }
-                        if (!this.available) {
-                            this.available = true;
-                        }
-                        needSyncCheck = Date.now() - lastSyncCheck > syncCheckRepeatMsecs;
-                        // If we aren't going to review sync, wait before checking input queues again
-                        if (!needSyncCheck)
-                            await (0, utilityHelpers_1.wait)(1000);
                     }
                 }
             }
+            catch (eu) {
+                const e = WalletError_1.WalletError.fromUnknown(eu);
+                if (!this.available) {
+                    this.startupError = e;
+                    this.stopMainThread = true;
+                }
+                else {
+                    this.log(`Error occurred during chaintracks main thread processing: ${e.stack || e.message}`);
+                }
+            }
         }
     }
 }