npm - @bsv/wallet-toolbox - Versions diffs - 1.6.14 → 1.6.16 - Mend

@bsv/wallet-toolbox 1.6.14 → 1.6.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

package/docs/client.md CHANGED Viewed

@@ -8516,10 +8516,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>
@@ -8536,6 +8541,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)
 ---
@@ -9404,130 +9422,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/docs/services.md CHANGED Viewed

@@ -2835,10 +2835,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>
@@ -2855,6 +2860,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)
 ---
@@ -3481,130 +3499,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