@bsv/wallet-toolbox-mobile 1.5.21 → 1.6.1

package/out/src/services/chaintracker/chaintracks/util/BulkHeaderFile.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BulkHeaderFiles = exports.BulkHeaderFileStorage = exports.BulkHeaderFileFs = exports.BulkHeaderFile = void 0;
+const HeightRange_1 = require("./HeightRange");
+const sdk_1 = require("@bsv/sdk");
+const WERR_errors_1 = require("../../../../sdk/WERR_errors");
+const utilityHelpers_noBuffer_1 = require("../../../../utility/utilityHelpers.noBuffer");
+class BulkHeaderFile {
+    constructor(info) {
+        this.chain = info.chain;
+        this.count = info.count;
+        this.data = info.data;
+        this.fileHash = info.fileHash;
+        this.fileId = info.fileId;
+        this.fileName = info.fileName;
+        this.firstHeight = info.firstHeight;
+        this.lastChainWork = info.lastChainWork;
+        this.lastHash = info.lastHash;
+        this.prevChainWork = info.prevChainWork;
+        this.prevHash = info.prevHash;
+        this.sourceUrl = info.sourceUrl;
+        this.validated = info.validated;
+    }
+    get heightRange() {
+        return new HeightRange_1.HeightRange(this.firstHeight, this.firstHeight + this.count - 1);
+    }
+    async ensureData() {
+        if (!this.data)
+            throw new WERR_errors_1.WERR_INVALID_OPERATION(`data is undefined and no ensureData() override`);
+        return this.data;
+    }
+    /**
+     * Whenever reloading data from a backing store, validated fileHash must be re-verified
+     * @returns the sha256 hash of the file's data as base64 string.
+     */
+    async computeFileHash() {
+        if (!this.data)
+            throw new WERR_errors_1.WERR_INVALID_OPERATION(`requires defined data`);
+        return (0, utilityHelpers_noBuffer_1.asString)(sdk_1.Hash.sha256((0, utilityHelpers_noBuffer_1.asArray)(this.data)), 'base64');
+    }
+    async releaseData() {
+        this.data = undefined;
+    }
+    toCdnInfo() {
+        return {
+            count: this.count,
+            fileHash: this.fileHash,
+            fileName: this.fileName,
+            firstHeight: this.firstHeight,
+            lastChainWork: this.lastChainWork,
+            lastHash: this.lastHash,
+            prevChainWork: this.prevChainWork,
+            prevHash: this.prevHash
+        };
+    }
+    toStorageInfo() {
+        return {
+            count: this.count,
+            fileHash: this.fileHash,
+            fileName: this.fileName,
+            firstHeight: this.firstHeight,
+            lastChainWork: this.lastChainWork,
+            lastHash: this.lastHash,
+            prevChainWork: this.prevChainWork,
+            prevHash: this.prevHash,
+            chain: this.chain,
+            validated: this.validated,
+            sourceUrl: this.sourceUrl,
+            fileId: this.fileId
+        };
+    }
+}
+exports.BulkHeaderFile = BulkHeaderFile;
+class BulkHeaderFileFs extends BulkHeaderFile {
+    constructor(info, fs, rootFolder) {
+        super(info);
+        this.fs = fs;
+        this.rootFolder = rootFolder;
+    }
+    async readDataFromFile(length, offset) {
+        if (this.data) {
+            return this.data.slice(offset, offset + length);
+        }
+        const f = await this.fs.openReadableFile(this.fs.pathJoin(this.rootFolder, this.fileName));
+        try {
+            const buffer = await f.read(length, offset);
+            return buffer;
+        }
+        finally {
+            await f.close();
+        }
+    }
+    async ensureData() {
+        if (this.data)
+            return this.data;
+        this.data = await this.readDataFromFile(this.count * 80, 0);
+        if (!this.data)
+            throw new WERR_errors_1.WERR_INVALID_OPERATION(`failed to read data for ${this.fileName}`);
+        if (this.validated) {
+            const hash = await this.computeFileHash();
+            if (hash !== this.fileHash)
+                throw new WERR_errors_1.WERR_INVALID_OPERATION(`BACKING FILE DATA CORRUPTION: invalid fileHash for ${this.fileName}`);
+        }
+        return this.data;
+    }
+}
+exports.BulkHeaderFileFs = BulkHeaderFileFs;
+class BulkHeaderFileStorage extends BulkHeaderFile {
+    constructor(info, storage, fetch) {
+        super(info);
+        this.storage = storage;
+        this.fetch = fetch;
+    }
+    async readDataFromFile(length, offset) {
+        return (await this.ensureData()).slice(offset, offset + length);
+    }
+    async ensureData() {
+        if (this.data)
+            return this.data;
+        if (!this.sourceUrl) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('sourceUrl', 'defined. Or data must be defined.');
+        }
+        const url = this.fetch.pathJoin(this.sourceUrl, this.fileName);
+        this.data = await this.fetch.download(url);
+        if (!this.data)
+            throw new WERR_errors_1.WERR_INVALID_OPERATION(`failed to download data from ${url}`);
+        if (this.validated) {
+            const hash = await this.computeFileHash();
+            if (hash !== this.fileHash)
+                throw new WERR_errors_1.WERR_INVALID_OPERATION(`BACKING DOWNLOAD DATA CORRUPTION: invalid fileHash for ${this.fileName}`);
+        }
+        return this.data;
+    }
+}
+exports.BulkHeaderFileStorage = BulkHeaderFileStorage;
+class BulkHeaderFiles {
+    constructor(rootFolder, jsonFilename, files, headersPerFile) {
+        this.rootFolder = rootFolder;
+        this.jsonFilename = jsonFilename;
+        this.files = files;
+        this.headersPerFile = headersPerFile;
+    }
+}
+exports.BulkHeaderFiles = BulkHeaderFiles;
+//# sourceMappingURL=BulkHeaderFile.js.map

package/out/src/services/chaintracker/chaintracks/util/BulkHeaderFile.js.map

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

package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.d.ts

@@ -0,0 +1,10 @@
+import { HttpClient } from '@bsv/sdk';
+import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
+export declare class ChaintracksFetch implements ChaintracksFetchApi {
+    httpClient: HttpClient;
+    constructor();
+    download(url: string): Promise<Uint8Array>;
+    fetchJson<R>(url: string): Promise<R>;
+    pathJoin(baseUrl: string, subpath: string): string;
+}
+//# sourceMappingURL=ChaintracksFetch.d.ts.map

package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChaintracksFetch.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/util/ChaintracksFetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAE,MAAM,UAAU,CAAA;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,UAAU,EAAE,UAAU,CAAsB;;IAItC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiB1C,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAe3C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAQnD"}

package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChaintracksFetch = void 0;
+const sdk_1 = require("@bsv/sdk");
+class ChaintracksFetch {
+    constructor() {
+        this.httpClient = (0, sdk_1.defaultHttpClient)();
+    }
+    async download(url) {
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/octet-stream'
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to download from ${url}: ${response.statusText}`);
+        }
+        const data = await response.arrayBuffer();
+        return new Uint8Array(data);
+    }
+    async fetchJson(url) {
+        const requestJsonOptions = {
+            method: 'GET',
+            headers: {
+                Accept: 'application/json'
+            }
+        };
+        const response = await fetch(url, requestJsonOptions);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch JSON from ${url}: ${response.statusText}`);
+        }
+        const json = (await response.json());
+        return json;
+    }
+    pathJoin(baseUrl, subpath) {
+        // Ensure the subpath doesn't start with a slash to avoid issues
+        const cleanSubpath = subpath.replace(/^\/+/, '');
+        if (!baseUrl.endsWith('/'))
+            baseUrl += '/';
+        // Create a new URL object and append the subpath
+        const url = new URL(cleanSubpath, baseUrl);
+        return url.toString();
+    }
+}
+exports.ChaintracksFetch = ChaintracksFetch;
+//# sourceMappingURL=ChaintracksFetch.js.map

package/out/src/services/chaintracker/chaintracks/util/ChaintracksFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChaintracksFetch.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/util/ChaintracksFetch.ts"],"names":[],"mappings":";;;AAAA,kCAAwD;AAGxD,MAAa,gBAAgB;IAG3B;QAFA,eAAU,GAAe,IAAA,uBAAiB,GAAE,CAAA;IAE7B,CAAC;IAEhB,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,cAAc,EAAE,0BAA0B;aAC3C;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;QAEzC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,SAAS,CAAI,GAAW;QAC5B,MAAM,kBAAkB,GAAG;YACzB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;aAC3B;SACF,CAAA;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;QACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;QACzC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,OAAe;QACvC,gEAAgE;QAChE,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,GAAG,CAAA;QAC1C,iDAAiD;QACjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAC1C,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;IACvB,CAAC;CACF;AA7CD,4CA6CC"}

package/out/src/services/chaintracker/chaintracks/util/HeightRange.d.ts

@@ -0,0 +1,72 @@
+import { BlockHeader } from '../../../../sdk/WalletServices.interfaces';
+export interface HeightRangeApi {
+    minHeight: number;
+    maxHeight: number;
+}
+export interface HeightRanges {
+    bulk: HeightRange;
+    live: HeightRange;
+}
+export declare class HeightRange implements HeightRangeApi {
+    minHeight: number;
+    maxHeight: number;
+    constructor(minHeight: number, maxHeight: number);
+    static readonly empty: HeightRange;
+    /**
+     * @param headers
+     * @returns range of height values from the given headers, or the empty range if there are no headers.
+     */
+    static from(headers: BlockHeader[]): HeightRange;
+    get length(): number;
+    get isEmpty(): boolean;
+    toString(): string;
+    /**
+     * @param range HeightRange or single height value.
+     * @returns true if `range` is entirely within this range.
+     */
+    contains(range: HeightRange | number): boolean;
+    /**
+     * Return the intersection with another height range.
+     *
+     * Intersection with an empty range is always empty.
+     *
+     * The result is always a single, possibly empty, range.
+     * @param range
+     * @returns
+     */
+    intersect(range: HeightRange): HeightRange;
+    /**
+     * Return the union with another height range.
+     *
+     * Only valid if the two ranges overlap or touch, or one is empty.
+     *
+     * Throws an error if the union would create two disjoint ranges.
+     *
+     * @param range
+     * @returns
+     */
+    union(range: HeightRange): HeightRange;
+    /**
+     * Returns `range` subtracted from this range.
+     *
+     * Throws an error if the subtraction would create two disjoint ranges.
+     *
+     * @param range
+     * @returns
+     */
+    subtract(range: HeightRange): HeightRange;
+    /**
+     * If `range` is not empty and this is not empty, returns a new range minHeight
+     * replaced by to range.maxHeight + 1.
+     *
+     * Otherwise returns a copy of this range.
+     *
+     * This returns the portion of this range that is strictly above `range`.
+     */
+    above(range: HeightRange): HeightRange;
+    /**
+     * Return a copy of this range.
+     */
+    copy(): HeightRange;
+}
+//# sourceMappingURL=HeightRange.d.ts.map

package/out/src/services/chaintracker/chaintracks/util/HeightRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeightRange.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/util/HeightRange.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAEvE,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,qBAAa,WAAY,YAAW,cAAc;IAEvC,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;gBADjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;IAG1B,MAAM,CAAC,QAAQ,CAAC,KAAK,cAAyB;IAE9C;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW;IAOhD,IAAI,MAAM,WAET;IAED,IAAI,OAAO,YAEV;IAED,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAOpC;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW;IAI5B;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW;IAQxB;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW;IAmB3B;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW;IAKxB;;OAEG;IACH,IAAI,IAAI,WAAW;CAGpB"}

package/out/src/services/chaintracker/chaintracks/util/HeightRange.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HeightRange = void 0;
+class HeightRange {
+    constructor(minHeight, maxHeight) {
+        this.minHeight = minHeight;
+        this.maxHeight = maxHeight;
+    }
+    /**
+     * @param headers
+     * @returns range of height values from the given headers, or the empty range if there are no headers.
+     */
+    static from(headers) {
+        if (headers.length === 0)
+            return HeightRange.empty;
+        const minHeight = headers.reduce((min, h) => Math.min(min, h.height), headers[0].height);
+        const maxHeight = headers.reduce((max, h) => Math.max(max, h.height), headers[0].height);
+        return new HeightRange(minHeight, maxHeight);
+    }
+    get length() {
+        return Math.max(0, this.maxHeight - this.minHeight + 1);
+    }
+    get isEmpty() {
+        return this.minHeight > this.maxHeight;
+    }
+    toString() {
+        return this.isEmpty ? '<empty>' : `${this.minHeight}-${this.maxHeight}`;
+    }
+    /**
+     * @param range HeightRange or single height value.
+     * @returns true if `range` is entirely within this range.
+     */
+    contains(range) {
+        if (typeof range === 'number') {
+            return this.minHeight <= range && this.maxHeight >= range;
+        }
+        return this.minHeight <= range.minHeight && this.maxHeight >= range.maxHeight;
+    }
+    /**
+     * Return the intersection with another height range.
+     *
+     * Intersection with an empty range is always empty.
+     *
+     * The result is always a single, possibly empty, range.
+     * @param range
+     * @returns
+     */
+    intersect(range) {
+        return new HeightRange(Math.max(this.minHeight, range.minHeight), Math.min(this.maxHeight, range.maxHeight));
+    }
+    /**
+     * Return the union with another height range.
+     *
+     * Only valid if the two ranges overlap or touch, or one is empty.
+     *
+     * Throws an error if the union would create two disjoint ranges.
+     *
+     * @param range
+     * @returns
+     */
+    union(range) {
+        if (this.isEmpty)
+            return range.copy();
+        if (range.isEmpty)
+            return this.copy();
+        if (this.maxHeight + 1 < range.minHeight || range.maxHeight + 1 < this.minHeight)
+            throw new Error('Union of ranges with a gap between them is not supported.');
+        return new HeightRange(Math.min(this.minHeight, range.minHeight), Math.max(this.maxHeight, range.maxHeight));
+    }
+    /**
+     * Returns `range` subtracted from this range.
+     *
+     * Throws an error if the subtraction would create two disjoint ranges.
+     *
+     * @param range
+     * @returns
+     */
+    subtract(range) {
+        if (this.isEmpty || range.isEmpty)
+            return this.copy();
+        if (this.minHeight < range.minHeight && this.maxHeight > range.maxHeight)
+            throw new Error('Subtraction of range that creates two disjoint ranges is not supported.');
+        if (range.maxHeight < this.minHeight || range.minHeight > this.maxHeight)
+            // Leave untouched. Subtracted is either all lower or all higher.
+            return this.copy();
+        if (range.minHeight <= this.minHeight && range.maxHeight < this.maxHeight)
+            // Remove a chunk on the low side.
+            return new HeightRange(range.maxHeight + 1, this.maxHeight);
+        if (range.minHeight <= this.minHeight && range.maxHeight >= this.maxHeight)
+            // Remove the whole thing
+            return new HeightRange(this.minHeight, this.minHeight - 1); // empty
+        if (range.minHeight <= this.maxHeight && range.maxHeight >= this.maxHeight)
+            // Remove a chunk on the high side.
+            return new HeightRange(this.minHeight, range.minHeight - 1);
+        throw new Error('All cases should have been handled :-) .');
+    }
+    /**
+     * If `range` is not empty and this is not empty, returns a new range minHeight
+     * replaced by to range.maxHeight + 1.
+     *
+     * Otherwise returns a copy of this range.
+     *
+     * This returns the portion of this range that is strictly above `range`.
+     */
+    above(range) {
+        if (range.isEmpty || this.isEmpty)
+            return this.copy();
+        return new HeightRange(range.maxHeight + 1, this.maxHeight);
+    }
+    /**
+     * Return a copy of this range.
+     */
+    copy() {
+        return new HeightRange(this.minHeight, this.maxHeight);
+    }
+}
+exports.HeightRange = HeightRange;
+HeightRange.empty = new HeightRange(0, -1);
+//# sourceMappingURL=HeightRange.js.map

package/out/src/services/chaintracker/chaintracks/util/HeightRange.js.map

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

package/out/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A reader-writer lock to manage concurrent access.
+ * Allows multiple readers or one writer at a time.
+ */
+export declare class SingleWriterMultiReaderLock {
+    private readers;
+    private writerActive;
+    private readerQueue;
+    private writerQueue;
+    private checkQueues;
+    withReadLock<T>(fn: () => Promise<T>): Promise<T>;
+    withWriteLock<T>(fn: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=SingleWriterMultiReaderLock.d.ts.map

package/out/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleWriterMultiReaderLock.d.ts","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,WAAW,CAAwB;IAE3C,OAAO,CAAC,WAAW;IAeb,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA0BjD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAwBzD"}

package/out/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SingleWriterMultiReaderLock = void 0;
+/**
+ * A reader-writer lock to manage concurrent access.
+ * Allows multiple readers or one writer at a time.
+ */
+class SingleWriterMultiReaderLock {
+    constructor() {
+        this.readers = 0;
+        this.writerActive = false;
+        this.readerQueue = [];
+        this.writerQueue = [];
+    }
+    checkQueues() {
+        if (this.writerActive || this.readers > 0)
+            return;
+        if (this.writerQueue.length > 0) {
+            // If there are waiting writers and no active readers or writers, start the next writer
+            const resolve = this.writerQueue.shift();
+            resolve();
+        }
+        else if (this.readerQueue.length > 0) {
+            // If there are waiting readers and no waiting writers, start all readers
+            const readers = this.readerQueue.splice(0);
+            for (const resolve of readers) {
+                resolve();
+            }
+        }
+    }
+    async withReadLock(fn) {
+        if (!this.writerActive && this.writerQueue.length === 0) {
+            // Fast path: no active writer or waiting writers, proceed immediately
+            this.readers++;
+            try {
+                return await fn();
+            }
+            finally {
+                this.readers--;
+                this.checkQueues();
+            }
+        }
+        else {
+            // Queue the reader until writers are done
+            const promise = new Promise(resolve => {
+                this.readerQueue.push(resolve);
+            });
+            await promise;
+            this.readers++;
+            try {
+                return await fn();
+            }
+            finally {
+                this.readers--;
+                this.checkQueues();
+            }
+        }
+    }
+    async withWriteLock(fn) {
+        if (!this.writerActive && this.readers === 0) {
+            // Fast path: no active writer or readers, proceed immediately
+            this.writerActive = true;
+            try {
+                return await fn();
+            }
+            finally {
+                this.writerActive = false;
+                this.checkQueues();
+            }
+        }
+        else {
+            const promise = new Promise(resolve => {
+                this.writerQueue.push(resolve);
+            });
+            await promise;
+            this.writerActive = true;
+            try {
+                return await fn();
+            }
+            finally {
+                this.writerActive = false;
+                this.checkQueues();
+            }
+        }
+    }
+}
+exports.SingleWriterMultiReaderLock = SingleWriterMultiReaderLock;
+//# sourceMappingURL=SingleWriterMultiReaderLock.js.map

package/out/src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SingleWriterMultiReaderLock.js","sourceRoot":"","sources":["../../../../../../../src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,2BAA2B;IAAxC;QACU,YAAO,GAAW,CAAC,CAAA;QACnB,iBAAY,GAAY,KAAK,CAAA;QAC7B,gBAAW,GAAsB,EAAE,CAAA;QACnC,gBAAW,GAAsB,EAAE,CAAA;IAmE7C,CAAC;IAjES,WAAW;QACjB,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC;YAAE,OAAM;QACjD,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,uFAAuF;YACvF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAG,CAAA;YACzC,OAAO,EAAE,CAAA;QACX,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,yEAAyE;YACzE,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;YAC1C,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAI,EAAoB;QACxC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxD,sEAAsE;YACtE,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAA;YACnB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,EAAE,CAAA;gBACd,IAAI,CAAC,WAAW,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,0CAA0C;YAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;gBAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAChC,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,CAAA;YACb,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAA;YACnB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,EAAE,CAAA;gBACd,IAAI,CAAC,WAAW,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAI,EAAoB;QACzC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC7C,8DAA8D;YAC9D,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;YACxB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAA;YACnB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;gBACzB,IAAI,CAAC,WAAW,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;gBAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAChC,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,CAAA;YACb,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;YACxB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAA;YACnB,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;gBACzB,IAAI,CAAC,WAAW,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAvED,kEAuEC"}

package/out/src/services/chaintracker/chaintracks/util/blockHeaderUtilities.d.ts

@@ -1,12 +1,28 @@
 import { BigNumber } from '@bsv/sdk';
-import { BaseBlockHeader, BlockHeader } from '../Api/BlockHeaderApi';
 import { Chain } from '../../../../sdk/types';
+import { ChaintracksFsApi } from '../Api/ChaintracksFsApi';
+import { BulkHeaderFileInfo } from './BulkHeaderFile';
+import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
+import { BaseBlockHeader, BlockHeader } from '../../../../sdk/WalletServices.interfaces';
 /**
  * Computes sha256 hash of file contents read as bytes with no encoding.
  * @param filepath Full filepath to file.
- * @param bufferSize Optional read buffer size to use. Defaults to 80,000 bytes.
+ * @param bufferSize Optional read buffer size to use. Defaults to 80,000 bytes. Currently ignored.
  * @returns `{hash, length}` where `hash` is base64 string form of file hash and `length` is file length in bytes.
  */
+export declare function sha256HashOfBinaryFile(fs: ChaintracksFsApi, filepath: string, bufferSize?: number): Promise<{
+    hash: string;
+    length: number;
+}>;
+/**
+ * Validates the contents of a bulk header file.
+ * @param bf BulkHeaderFileInfo containing `data` to validate.
+ * @param prevHash Required previous header hash.
+ * @param prevChainWork Required previous chain work.
+ * @param fetch Optional ChaintracksFetchApi instance for fetching data.
+ * @returns Validated BulkHeaderFileInfo with `validated` set to true.
+ */
+export declare function validateBulkFileData(bf: BulkHeaderFileInfo, prevHash: string, prevChainWork: string, fetch?: ChaintracksFetchApi): Promise<BulkHeaderFileInfo>;
 /**
  * Validate headers contained in an array of bytes. The headers must be consecutive block headers, 80 bytes long,
  *  where the hash of each header equals the previousHash of the following header.
@@ -16,7 +32,16 @@ import { Chain } from '../../../../sdk/types';
  * @param count Optional number of headers to validate. Validates to end of buffer if missing.
  * @returns Header hash of last header validated or previousHash if there where none.
  */
-export declare function validateBufferOfHeaders(buffer: number[], previousHash: string, offset?: number, count?: number): string;
+export declare function validateBufferOfHeaders(buffer: Uint8Array, previousHash: string, offset?: number, count?: number, previousChainWork?: string): {
+    lastHeaderHash: string;
+    lastChainWork: string | undefined;
+};
+/**
+ * Verifies that buffer begins with valid genesis block header for the specified chain.
+ * @param buffer
+ * @param chain
+ */
+export declare function validateGenesisHeader(buffer: Uint8Array, chain: Chain): void;
 /**
  * @param work chainWork as a BigNumber
  * @returns Converted chainWork value from BN to hex string of 32 bytes.
@@ -48,16 +73,8 @@ export declare function convertBitsToTarget(bits: number | number[]): BigNumber;
  * @returns 32 byte Buffer with "chainWork" value
  */
 export declare function convertBitsToWork(bits: number | number[]): string;
-export declare function deserializeBaseBlockHeaders(buffer: number[], offset?: number, count?: number | undefined): BaseBlockHeader[];
-export declare function deserializeBlockHeaders(firstHeight: number, buffer: number[], offset?: number, count?: number | undefined): BlockHeader[];
-/**
- * Extract an array of block hashes and of merkleRoots from a buffer of serialized block headers.
- * @param buffer
- */
-export declare function extractHashesAndRoots(buffer: Buffer): {
-    hashes: Buffer[];
-    merkleRoots: Buffer[];
-};
+export declare function deserializeBaseBlockHeaders(buffer: number[] | Uint8Array, offset?: number, count?: number | undefined): BaseBlockHeader[];
+export declare function deserializeBlockHeaders(firstHeight: number, buffer: number[] | Uint8Array, offset?: number, count?: number | undefined): BlockHeader[];
 /**
  * Given a block header, ensures that its format is correct. This does not
  * check its difficulty or validity relative to the chain of headers.
@@ -88,7 +105,7 @@ export declare function validateHeaderDifficulty(hash: Buffer, bits: number): bo
  * @returns doule sha256 hash of header bytes reversed
  * @publicbody
  */
-export declare function blockHash(header: BaseBlockHeader | number[]): string;
+export declare function blockHash(header: BaseBlockHeader | number[] | Uint8Array): string;
 /**
  * Serializes a block header as an 80 byte Buffer.
  * The exact serialized format is defined in the Bitcoin White Paper
@@ -97,12 +114,14 @@ export declare function blockHash(header: BaseBlockHeader | number[]): string;
  * @returns 80 byte Buffer
  * @publicbody
  */
-export declare function serializeBlockHeader(header: BaseBlockHeader, buffer?: number[], offset?: number): number[];
+export declare function serializeBaseBlockHeader(header: BaseBlockHeader, buffer?: number[], offset?: number): number[];
+export declare function serializeBaseBlockHeaders(headers: BlockHeader[]): Uint8Array;
 /**
- * Deserialize a block header from an 80 byte buffer
+ * Deserialize a BaseBlockHeader from an 80 byte buffer
  * @publicbody
  */
-export declare function deserializeBlockHeader(buffer: number[], offset?: number): BaseBlockHeader;
+export declare function deserializeBaseBlockHeader(buffer: number[] | Uint8Array, offset?: number): BaseBlockHeader;
+export declare function deserializeBlockHeader(buffer: number[] | Uint8Array, offset: number | undefined, height: number): BlockHeader;
 /**
  * Returns the genesis block for the specified chain.
  * @publicbody
@@ -126,15 +145,15 @@ export declare function swapByteOrder(buffer: number[]): number[];
  * @publicbody
  */
 export declare function convertUint32ToBuffer(n: number, littleEndian?: boolean): number[];
-export declare function writeUInt32LE(n: number, a: number[], offset: number): number;
-export declare function writeUInt32BE(n: number, a: number[], offset: number): number;
-export declare function readUInt32LE(a: number[], offset: number): number;
-export declare function readUInt32BE(a: number[], offset: number): number;
+export declare function writeUInt32LE(n: number, a: number[] | Uint8Array, offset: number): number;
+export declare function writeUInt32BE(n: number, a: number[] | Uint8Array, offset: number): number;
+export declare function readUInt32LE(a: number[] | Uint8Array, offset: number): number;
+export declare function readUInt32BE(a: number[] | Uint8Array, offset: number): number;
 /**
  * @param buffer four byte buffer with Uint32 number encoded
  * @param littleEndian true for little-endian byte order in Buffer
  * @returns a number value in the Uint32 value range
  * @publicbody
  */
-export declare function convertBufferToUint32(buffer: number[], littleEndian?: boolean): number;
+export declare function convertBufferToUint32(buffer: number[] | Uint8Array, littleEndian?: boolean): number;
 //# sourceMappingURL=blockHeaderUtilities.d.ts.map