@bopen-io/wallet-toolbox 1.7.18 → 1.7.20-idb-fix.1

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

@@ -0,0 +1,129 @@
+import { HeightRange } from './HeightRange';
+import { ChaintracksFsApi } from '../Api/ChaintracksFsApi';
+import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
+import { ChaintracksStorageBase } from '../Storage/ChaintracksStorageBase';
+import { Chain } from '../../../../sdk/types';
+/**
+ * Descriptive information about a single bulk header file.
+ */
+export interface BulkHeaderFileInfo {
+    /**
+     * filename and extension, no path
+     */
+    fileName: string;
+    /**
+     * chain height of first header in file
+     */
+    firstHeight: number;
+    /**
+     * count of how many headers the file contains. File size must be 80 * count.
+     */
+    count: number;
+    /**
+     * prevChainWork is the cummulative chain work up to the first header in this file's data, as a hex string.
+     */
+    prevChainWork: string;
+    /**
+     * lastChainWork is the cummulative chain work including the last header in this file's data, as a hex string.
+     */
+    lastChainWork: string;
+    /**
+     * previousHash of first header in file in standard hex string block hash encoding
+     */
+    prevHash: string;
+    /**
+     * block hash of last header in the file in standard hex string block hash encoding
+     */
+    lastHash: string | null;
+    /**
+     * file contents single sha256 hash as base64 string
+     */
+    fileHash: string | null;
+    /**
+     * Which chain: 'main' or 'test'
+     */
+    chain?: Chain;
+    data?: Uint8Array;
+    /**
+     * true iff these properties should be considered pre-validated, including a valid required fileHash of data (when not undefined).
+     */
+    validated?: boolean;
+    /**
+     * optional, used for database storage
+     */
+    fileId?: number;
+    /**
+     * optional, if valid `${sourceUrl}/${fileName}` is the source of this data.
+     */
+    sourceUrl?: string;
+}
+export declare abstract class BulkHeaderFile implements BulkHeaderFileInfo {
+    chain?: Chain | undefined;
+    count: number;
+    data?: Uint8Array<ArrayBufferLike> | undefined;
+    fileHash: string | null;
+    fileId?: number | undefined;
+    fileName: string;
+    firstHeight: number;
+    lastChainWork: string;
+    lastHash: string | null;
+    prevChainWork: string;
+    prevHash: string;
+    sourceUrl?: string | undefined;
+    validated?: boolean | undefined;
+    constructor(info: BulkHeaderFileInfo);
+    abstract readDataFromFile(length: number, offset: number): Promise<Uint8Array | undefined>;
+    get heightRange(): HeightRange;
+    ensureData(): Promise<Uint8Array>;
+    /**
+     * 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.
+     */
+    computeFileHash(): Promise<string>;
+    releaseData(): Promise<void>;
+    toCdnInfo(): BulkHeaderFileInfo;
+    toStorageInfo(): BulkHeaderFileInfo;
+}
+export declare class BulkHeaderFileFs extends BulkHeaderFile {
+    fs: ChaintracksFsApi;
+    rootFolder: string;
+    constructor(info: BulkHeaderFileInfo, fs: ChaintracksFsApi, rootFolder: string);
+    readDataFromFile(length: number, offset: number): Promise<Uint8Array | undefined>;
+    ensureData(): Promise<Uint8Array>;
+}
+export declare class BulkHeaderFileStorage extends BulkHeaderFile {
+    storage: ChaintracksStorageBase;
+    fetch?: ChaintracksFetchApi | undefined;
+    constructor(info: BulkHeaderFileInfo, storage: ChaintracksStorageBase, fetch?: ChaintracksFetchApi | undefined);
+    readDataFromFile(length: number, offset: number): Promise<Uint8Array | undefined>;
+    ensureData(): Promise<Uint8Array>;
+}
+/**
+ * Describes a collection of bulk block header files.
+ */
+export interface BulkHeaderFilesInfo {
+    /**
+     * Where this file was fetched or read from.
+     */
+    rootFolder: string;
+    /**
+     * Sub-path to this resource on rootFolder
+     */
+    jsonFilename: string;
+    /**
+     * Array of information about each bulk block header file.
+     */
+    files: BulkHeaderFileInfo[];
+    /**
+     * Maximum number of headers in a single file in this collection of files.
+     */
+    headersPerFile: number;
+}
+export declare abstract class BulkHeaderFiles implements BulkHeaderFilesInfo {
+    rootFolder: string;
+    jsonFilename: string;
+    files: BulkHeaderFileInfo[];
+    headersPerFile: number;
+    constructor(rootFolder: string, jsonFilename: string, files: BulkHeaderFileInfo[], headersPerFile: number);
+}
+//# sourceMappingURL=BulkHeaderFile.d.ts.map

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

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

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 || !this.fetch) {
+            throw new WERR_errors_1.WERR_INVALID_PARAMETER('sourceUrl and fetch', '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,14 @@
+import { HttpClient } from '@bsv/sdk';
+import { ChaintracksFetchApi } from '../Api/ChaintracksFetchApi';
+/**
+ * This class implements the ChaintracksFetchApi
+ * using the @bsv/sdk `defaultHttpClient`.
+ */
+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;AAGhE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,UAAU,EAAE,UAAU,CAAsB;;IAItC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwB1C,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuB3C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;CAQnD"}

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

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChaintracksFetch = void 0;
+const sdk_1 = require("@bsv/sdk");
+const utilityHelpers_1 = require("../../../../utility/utilityHelpers");
+/**
+ * This class implements the ChaintracksFetchApi
+ * using the @bsv/sdk `defaultHttpClient`.
+ */
+class ChaintracksFetch {
+    constructor() {
+        this.httpClient = (0, sdk_1.defaultHttpClient)();
+    }
+    async download(url) {
+        for (let retry = 0;; retry++) {
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Content-Type': 'application/octet-stream'
+                }
+            });
+            if (!response.ok) {
+                if (response.statusText === 'Too Many Requests' && retry < 3) {
+                    // WhatsOnChain rate limits requests, so backoff and retry
+                    await (0, utilityHelpers_1.wait)(1000 * (retry + 1));
+                    continue;
+                }
+                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'
+            }
+        };
+        let json;
+        for (let retry = 0;; retry++) {
+            const response = await fetch(url, requestJsonOptions);
+            if (!response.ok) {
+                if (response.statusText === 'Too Many Requests' && retry < 3) {
+                    await (0, utilityHelpers_1.wait)(1000 * (retry + 1));
+                    continue;
+                }
+                throw new Error(`Failed to fetch JSON from ${url}: ${response.statusText}`);
+            }
+            json = (await response.json());
+            break;
+        }
+        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;AAExD,uEAAyD;AAEzD;;;GAGG;AACH,MAAa,gBAAgB;IAG3B;QAFA,eAAU,GAAe,IAAA,uBAAiB,GAAE,CAAA;IAE7B,CAAC;IAEhB,KAAK,CAAC,QAAQ,CAAC,GAAW;QACxB,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE;oBACP,cAAc,EAAE,0BAA0B;iBAC3C;aACF,CAAC,CAAA;YAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,QAAQ,CAAC,UAAU,KAAK,mBAAmB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC7D,0DAA0D;oBAC1D,MAAM,IAAA,qBAAI,EAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;oBAC9B,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAC3E,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAA;YAEzC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;IACH,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,IAAI,IAAO,CAAA;QACX,KAAK,IAAI,KAAK,GAAG,CAAC,GAAI,KAAK,EAAE,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;YACrD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,QAAQ,CAAC,UAAU,KAAK,mBAAmB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;oBAC7D,MAAM,IAAA,qBAAI,EAAC,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;oBAC9B,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;YAC7E,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;YACnC,MAAK;QACP,CAAC;QACD,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;AA5DD,4CA4DC"}

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

@@ -0,0 +1,47 @@
+import { ChaintracksAppendableFileApi, ChaintracksFsApi, ChaintracksReadableFileApi, ChaintracksWritableFileApi } from '../Api/ChaintracksFsApi';
+import { promises as fs } from 'fs';
+import Path from 'path';
+export declare abstract class ChaintracksFsStatics {
+    static delete(path: string): Promise<void>;
+    static writeFile(path: string, data: Uint8Array): Promise<void>;
+    static readFile(path: string): Promise<Uint8Array>;
+    static openReadableFile(path: string): Promise<ChaintracksReadableFileApi>;
+    static openWritableFile(path: string): Promise<ChaintracksWritableFileApi>;
+    static openAppendableFile(path: string): Promise<ChaintracksAppendableFileApi>;
+    static ensureFoldersExist(path: string): Promise<void>;
+    static pathJoin(...parts: string[]): string;
+}
+/**
+ * This object is an implementation of the `ChaintracksFsApi` interface
+ * using the `fs` package which may not be available in all environments.
+ */
+export declare const ChaintracksFs: ChaintracksFsApi;
+export declare class ChaintracksReadableFile implements ChaintracksReadableFileApi {
+    path: string;
+    parsedPath: Path.ParsedPath;
+    f: fs.FileHandle;
+    protected constructor(path: string, f: fs.FileHandle);
+    close(): Promise<void>;
+    getLength(): Promise<number>;
+    read(length?: number, offset?: number): Promise<Uint8Array>;
+    static openAsReadable(path: string): Promise<ChaintracksReadableFile>;
+}
+export declare class ChaintracksWritableFile implements ChaintracksWritableFileApi {
+    path: string;
+    parsedPath: Path.ParsedPath;
+    f: fs.FileHandle;
+    foldersEnsured: boolean;
+    private constructor();
+    static openAsWritable(path: string): Promise<ChaintracksWritableFile>;
+    close(): Promise<void>;
+    ensureFoldersExist(): Promise<void>;
+    append(data: Uint8Array): Promise<void>;
+}
+export declare class ChaintracksAppendableFile extends ChaintracksReadableFile implements ChaintracksAppendableFileApi {
+    foldersEnsured: boolean;
+    private constructor();
+    static openAsAppendable(path: string): Promise<ChaintracksAppendableFile>;
+    ensureFoldersExist(): Promise<void>;
+    append(data: Uint8Array): Promise<void>;
+}
+//# sourceMappingURL=ChaintracksFs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChaintracksFs.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/ChaintracksFs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,gBAAgB,EAChB,0BAA0B,EAC1B,0BAA0B,EAC3B,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAA;AACnC,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,8BAAsB,oBAAoB;WAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;WAGnC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;WAIxD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;WAI3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;WAGnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;WAInE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;WAGvE,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;CAG5C;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,gBAAuC,CAAA;AAEnE,qBAAa,uBAAwB,YAAW,0BAA0B;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,IAAI,CAAC,UAAU,CAAA;IAC3B,CAAC,EAAE,EAAE,CAAC,UAAU,CAAA;IAEhB,SAAS,aAAa,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU;IAM9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAK5B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;WAQpD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAK5E;AAED,qBAAa,uBAAwB,YAAW,0BAA0B;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,IAAI,CAAC,UAAU,CAAA;IAC3B,CAAC,EAAE,EAAE,CAAC,UAAU,CAAA;IAChB,cAAc,EAAE,OAAO,CAAQ;IAE/B,OAAO;WAMM,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9C;AAED,qBAAa,yBAA0B,SAAQ,uBAAwB,YAAW,4BAA4B;IAC5G,cAAc,EAAE,OAAO,CAAQ;IAE/B,OAAO;WAIM,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAMzE,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAI9C"}

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

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChaintracksAppendableFile = exports.ChaintracksWritableFile = exports.ChaintracksReadableFile = exports.ChaintracksFs = exports.ChaintracksFsStatics = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+class ChaintracksFsStatics {
+    static async delete(path) {
+        await fs_1.promises.unlink(path);
+    }
+    static async writeFile(path, data) {
+        await this.ensureFoldersExist(path);
+        await fs_1.promises.writeFile(path, Buffer.from(data));
+    }
+    static async readFile(path) {
+        const buffer = await fs_1.promises.readFile(path);
+        return Uint8Array.from(buffer);
+    }
+    static async openReadableFile(path) {
+        return await ChaintracksReadableFile.openAsReadable(path);
+    }
+    static async openWritableFile(path) {
+        return await ChaintracksWritableFile.openAsWritable(path);
+    }
+    static async openAppendableFile(path) {
+        return await ChaintracksAppendableFile.openAsAppendable(path);
+    }
+    static async ensureFoldersExist(path) {
+        const parsedPath = path_1.default.parse(path);
+        await fs_1.promises.mkdir(parsedPath.dir, { recursive: true });
+    }
+    static pathJoin(...parts) {
+        return path_1.default.join(...parts);
+    }
+}
+exports.ChaintracksFsStatics = ChaintracksFsStatics;
+/**
+ * This object is an implementation of the `ChaintracksFsApi` interface
+ * using the `fs` package which may not be available in all environments.
+ */
+exports.ChaintracksFs = ChaintracksFsStatics;
+class ChaintracksReadableFile {
+    constructor(path, f) {
+        this.path = path;
+        this.f = f;
+        this.parsedPath = path_1.default.parse(path);
+    }
+    async close() {
+        await this.f.close();
+    }
+    async getLength() {
+        const stats = await this.f.stat();
+        return stats.size;
+    }
+    async read(length, offset) {
+        length || (length = 80 * 1024); // Default to 80KB if no length is specified
+        const buffer = Buffer.alloc(length);
+        const rr = await this.f.read(buffer, 0, length, offset || 0);
+        const rb = rr.bytesRead < length ? buffer.subarray(0, rr.bytesRead) : buffer;
+        return Uint8Array.from(rb);
+    }
+    static async openAsReadable(path) {
+        const f = await fs_1.promises.open(path, 'r');
+        const file = new ChaintracksReadableFile(path, f);
+        return file;
+    }
+}
+exports.ChaintracksReadableFile = ChaintracksReadableFile;
+class ChaintracksWritableFile {
+    constructor(path, f) {
+        this.foldersEnsured = false;
+        this.path = path;
+        this.f = f;
+        this.parsedPath = path_1.default.parse(path);
+    }
+    static async openAsWritable(path) {
+        const f = await fs_1.promises.open(path, 'w');
+        const file = new ChaintracksWritableFile(path, f);
+        return file;
+    }
+    async close() {
+        await this.f.close();
+    }
+    async ensureFoldersExist() {
+        if (!this.foldersEnsured) {
+            await ChaintracksFsStatics.ensureFoldersExist(this.path);
+            this.foldersEnsured = true;
+        }
+    }
+    async append(data) {
+        await this.ensureFoldersExist();
+        throw new Error('Method not implemented.');
+    }
+}
+exports.ChaintracksWritableFile = ChaintracksWritableFile;
+class ChaintracksAppendableFile extends ChaintracksReadableFile {
+    constructor(path, f) {
+        super(path, f);
+        this.foldersEnsured = false;
+    }
+    static async openAsAppendable(path) {
+        const f = await fs_1.promises.open(path, 'a+');
+        const file = new ChaintracksAppendableFile(path, f);
+        return file;
+    }
+    async ensureFoldersExist() {
+        if (!this.foldersEnsured) {
+            await ChaintracksFsStatics.ensureFoldersExist(this.path);
+            this.foldersEnsured = true;
+        }
+    }
+    async append(data) {
+        await this.ensureFoldersExist();
+        await this.f.write(Buffer.from(data));
+    }
+}
+exports.ChaintracksAppendableFile = ChaintracksAppendableFile;
+//# sourceMappingURL=ChaintracksFs.js.map

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

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

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

@@ -0,0 +1,90 @@
+import { BlockHeader } from '../../../../sdk/WalletServices.interfaces';
+export interface HeightRangeApi {
+    minHeight: number;
+    maxHeight: number;
+}
+export interface HeightRanges {
+    bulk: HeightRange;
+    live: HeightRange;
+}
+/**
+ * Represents a range of block heights.
+ *
+ * Operations support integrating contiguous batches of headers,
+ */
+export declare class HeightRange implements HeightRangeApi {
+    minHeight: number;
+    maxHeight: number;
+    constructor(minHeight: number, maxHeight: number);
+    /**
+     * All ranges where maxHeight is less than minHeight are considered empty.
+     * The canonical empty range is (0, -1).
+     */
+    static readonly empty: HeightRange;
+    /**
+     * @returns true iff minHeight is greater than maxHeight.
+     */
+    get isEmpty(): boolean;
+    /**
+     * @param headers an array of objects with a non-negative integer `height` property.
+     * @returns range of height values from the given headers, or the empty range if there are no headers.
+     */
+    static from(headers: BlockHeader[]): HeightRange;
+    /**
+     * @returns the number of heights in the range, or 0 if the range is empty.
+     */
+    get length(): number;
+    /**
+     * @returns an easy to read string representation of the height range.
+     */
+    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;;;;GAIG;AACH,qBAAa,WAAY,YAAW,cAAc;IAEvC,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,MAAM;gBADjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;IAG1B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,cAAyB;IAE9C;;OAEG;IACH,IAAI,OAAO,YAEV;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW;IAOhD;;OAEG;IACH,IAAI,MAAM,WAET;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAOpC;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW;IAO5B;;;;;;;;;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"}