@bopen-io/wallet-toolbox 2.6.2-brc153.5 → 2.14.6

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

@@ -6,17 +6,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ChaintracksAppendableFile = exports.ChaintracksWritableFile = exports.ChaintracksReadableFile = exports.ChaintracksFs = exports.ChaintracksFsStatics = void 0;
 const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
+const MAX_CHAINTRACKS_FILE_IO_BYTES = 100_000 * 80;
+function validateFileIoBounds(length, offset) {
+    if (!Number.isSafeInteger(length) ||
+        length < 0 ||
+        length > MAX_CHAINTRACKS_FILE_IO_BYTES ||
+        !Number.isSafeInteger(offset) ||
+        offset < 0 ||
+        !Number.isSafeInteger(offset + length)) {
+        throw new RangeError(`Chaintracks file I/O requires a non-negative safe offset and at most ${MAX_CHAINTRACKS_FILE_IO_BYTES} bytes`);
+    }
+}
 class ChaintracksFsStatics {
     static async delete(path) {
         await node_fs_1.promises.unlink(path);
     }
     static async writeFile(path, data) {
+        if (!(data instanceof Uint8Array))
+            throw new TypeError('Chaintracks file data must be a Uint8Array');
+        validateFileIoBounds(data.byteLength, 0);
         await this.ensureFoldersExist(path);
         await node_fs_1.promises.writeFile(path, Buffer.from(data));
     }
     static async readFile(path) {
-        const buffer = await node_fs_1.promises.readFile(path);
-        return Uint8Array.from(buffer);
+        const file = await ChaintracksReadableFile.openAsReadable(path);
+        try {
+            const length = await file.getLength();
+            validateFileIoBounds(length, 0);
+            return await file.read(length, 0);
+        }
+        finally {
+            await file.close();
+        }
     }
     static async openReadableFile(path) {
         return await ChaintracksReadableFile.openAsReadable(path);
@@ -29,7 +50,8 @@ class ChaintracksFsStatics {
     }
     static async ensureFoldersExist(path) {
         const parsedPath = node_path_1.default.parse(path);
-        await node_fs_1.promises.mkdir(parsedPath.dir, { recursive: true });
+        if (parsedPath.dir !== '')
+            await node_fs_1.promises.mkdir(parsedPath.dir, { recursive: true });
     }
     static pathJoin(...parts) {
         return node_path_1.default.join(...parts);
@@ -55,13 +77,24 @@ class ChaintracksReadableFile {
     }
     async getLength() {
         const stats = await this.f.stat();
+        if (!stats.isFile() || !Number.isSafeInteger(stats.size) || stats.size < 0) {
+            throw new Error('Chaintracks readable resource must be a regular file with a safe length');
+        }
         return stats.size;
     }
     async read(length, offset) {
-        length ||= 80 * 1024; // Default to 80KB if no length is specified
+        length ??= 80 * 1024; // Default to 80KB if no length is specified
+        offset ??= 0;
+        validateFileIoBounds(length, offset);
         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;
+        let bytesRead = 0;
+        while (bytesRead < length) {
+            const result = await this.f.read(buffer, bytesRead, length - bytesRead, offset + bytesRead);
+            if (result.bytesRead === 0)
+                break;
+            bytesRead += result.bytesRead;
+        }
+        const rb = bytesRead < length ? buffer.subarray(0, bytesRead) : buffer;
         return Uint8Array.from(rb);
     }
     static async openAsReadable(path) {
@@ -82,19 +115,32 @@ class ChaintracksFolderAwareFile extends ChaintracksReadableFile {
             this.foldersEnsured = true;
         }
     }
+    async writeAll(data) {
+        if (!(data instanceof Uint8Array))
+            throw new TypeError('Chaintracks file data must be a Uint8Array');
+        validateFileIoBounds(data.length, 0);
+        const buffer = Buffer.from(data);
+        let bytesWritten = 0;
+        while (bytesWritten < buffer.length) {
+            const result = await this.f.write(buffer, bytesWritten, buffer.length - bytesWritten, null);
+            if (result.bytesWritten === 0)
+                throw new Error('Chaintracks file write made no progress');
+            bytesWritten += result.bytesWritten;
+        }
+    }
 }
 class ChaintracksWritableFile extends ChaintracksFolderAwareFile {
     constructor(path, f) {
         super(path, f);
     }
     static async openAsWritable(path) {
+        await ChaintracksFsStatics.ensureFoldersExist(path);
         const f = await node_fs_1.promises.open(path, 'w');
         const file = new ChaintracksWritableFile(path, f);
         return file;
     }
-    async append(_data) {
-        await this.ensureFoldersExist();
-        throw new Error('Method not implemented.');
+    async append(data) {
+        await this.writeAll(data);
     }
 }
 exports.ChaintracksWritableFile = ChaintracksWritableFile;
@@ -103,13 +149,13 @@ class ChaintracksAppendableFile extends ChaintracksFolderAwareFile {
         super(path, f);
     }
     static async openAsAppendable(path) {
+        await ChaintracksFsStatics.ensureFoldersExist(path);
         const f = await node_fs_1.promises.open(path, 'a+');
         const file = new ChaintracksAppendableFile(path, f);
         return file;
     }
     async append(data) {
-        await this.ensureFoldersExist();
-        await this.f.write(Buffer.from(data));
+        await this.writeAll(data);
     }
 }
 exports.ChaintracksAppendableFile = ChaintracksAppendableFile;

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

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

@@ -0,0 +1,48 @@
+import type { BulkFileDownloadBudgetApi, BulkFileDownloadBudgetSnapshot } from '../Api/BulkFileDataCacheApi';
+export interface DurableFileBulkFileDownloadBudgetOptions {
+    maxBytes: number;
+    stateFile: string;
+    windowMsecs?: number;
+    now?: () => number;
+    /** Maximum wait for the cross-process state lock. Default: 30 seconds. */
+    lockTimeoutMsecs?: number;
+    /** Delay between cross-process lock attempts. Default: 25 milliseconds. */
+    lockRetryMsecs?: number;
+}
+/**
+ * Crash-safe fixed-window reservation ledger for remote bulk-header bytes.
+ *
+ * State is flushed before `consume` resolves, so a crash may conservatively
+ * over-count an attempt but can never reset the allowance or permit an
+ * unrecorded request. Deployments must place `stateFile` on durable storage.
+ *
+ * @public
+ */
+export declare class DurableFileBulkFileDownloadBudget implements BulkFileDownloadBudgetApi {
+    private readonly maxBytes;
+    private readonly windowMsecs;
+    private readonly stateFile;
+    private readonly lockFolder;
+    private readonly lockTimeoutMsecs;
+    private readonly lockRetryMsecs;
+    private readonly now;
+    private tail;
+    private snapshotState;
+    constructor(options: DurableFileBulkFileDownloadBudgetOptions);
+    /**
+     * Load and validate the durable ledger before the service becomes ready.
+     *
+     * `consume` also initializes lazily, but services should await this method so
+     * readiness reports the persisted allowance and corrupt state fails startup.
+     */
+    initialize(): Promise<void>;
+    consume(byteCount: number): Promise<void>;
+    snapshot(): BulkFileDownloadBudgetSnapshot;
+    private consumeSerialized;
+    private newState;
+    private readState;
+    private writeState;
+    private validNow;
+    private withStateLock;
+}
+//# sourceMappingURL=DurableFileBulkFileDownloadBudget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DurableFileBulkFileDownloadBudget.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/DurableFileBulkFileDownloadBudget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAE5G,MAAM,WAAW,wCAAwC;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAUD;;;;;;;;GAQG;AACH,qBAAa,iCAAkC,YAAW,yBAAyB;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,aAAa,CAAa;IAElC,YAAY,OAAO,EAAE,wCAAwC,EAkB5D;IAED;;;;;OAKG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAWhC;IAEK,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9C;IAED,QAAQ,IAAI,8BAA8B,CAQzC;YAEa,iBAAiB;IAkB/B,OAAO,CAAC,QAAQ;YAaF,SAAS;YAsBT,UAAU;IAqBxB,OAAO,CAAC,QAAQ;YAQF,aAAa;CAmD5B"}

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

@@ -0,0 +1,280 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DurableFileBulkFileDownloadBudget = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const sdk_1 = require("../../../../sdk");
+/**
+ * Crash-safe fixed-window reservation ledger for remote bulk-header bytes.
+ *
+ * State is flushed before `consume` resolves, so a crash may conservatively
+ * over-count an attempt but can never reset the allowance or permit an
+ * unrecorded request. Deployments must place `stateFile` on durable storage.
+ *
+ * @public
+ */
+class DurableFileBulkFileDownloadBudget {
+    maxBytes;
+    windowMsecs;
+    stateFile;
+    lockFolder;
+    lockTimeoutMsecs;
+    lockRetryMsecs;
+    now;
+    tail = Promise.resolve();
+    snapshotState;
+    constructor(options) {
+        this.maxBytes = positiveInteger(options.maxBytes, 'maxBytes');
+        this.windowMsecs = positiveInteger(options.windowMsecs ?? 60 * 60 * 1000, 'windowMsecs');
+        this.lockTimeoutMsecs = positiveInteger(options.lockTimeoutMsecs ?? 30_000, 'lockTimeoutMsecs');
+        this.lockRetryMsecs = positiveInteger(options.lockRetryMsecs ?? 25, 'lockRetryMsecs');
+        if (this.lockRetryMsecs > this.lockTimeoutMsecs) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('lockRetryMsecs', 'no greater than lockTimeoutMsecs');
+        }
+        if (typeof options.stateFile !== 'string' || options.stateFile.trim() === '') {
+            throw new sdk_1.WERR_INVALID_PARAMETER('stateFile', 'a non-empty path');
+        }
+        this.stateFile = path.resolve(options.stateFile);
+        this.lockFolder = `${this.stateFile}.lock`;
+        if (options.now !== undefined && typeof options.now !== 'function') {
+            throw new sdk_1.WERR_INVALID_PARAMETER('now', 'a function when defined');
+        }
+        this.now = options.now ?? Date.now;
+        this.snapshotState = this.newState(this.now());
+    }
+    /**
+     * Load and validate the durable ledger before the service becomes ready.
+     *
+     * `consume` also initializes lazily, but services should await this method so
+     * readiness reports the persisted allowance and corrupt state fails startup.
+     */
+    async initialize() {
+        const operation = this.tail.then(async () => {
+            await this.withStateLock(async () => {
+                await this.readState();
+            });
+        });
+        this.tail = operation.then(() => undefined, () => undefined);
+        await operation;
+    }
+    async consume(byteCount) {
+        positiveInteger(byteCount, 'byteCount');
+        const operation = this.tail.then(async () => await this.consumeSerialized(byteCount));
+        this.tail = operation.then(() => undefined, () => undefined);
+        return await operation;
+    }
+    snapshot() {
+        return {
+            maxBytes: this.snapshotState.maxBytes,
+            consumedBytes: this.snapshotState.consumedBytes,
+            remainingBytes: this.snapshotState.maxBytes - this.snapshotState.consumedBytes,
+            windowStartedAt: this.snapshotState.windowStartedAt,
+            windowMsecs: this.snapshotState.windowMsecs
+        };
+    }
+    async consumeSerialized(byteCount) {
+        await this.withStateLock(async () => {
+            const now = this.validNow();
+            let state = await this.readState();
+            if (now - state.windowStartedAt >= this.windowMsecs)
+                state = this.newState(now);
+            const remaining = this.maxBytes - state.consumedBytes;
+            if (byteCount > remaining) {
+                throw new Error(`Bulk-header download budget exceeded: requested ${byteCount} bytes with ` +
+                    `${remaining} bytes remaining in the current window.`);
+            }
+            state.consumedBytes += byteCount;
+            await this.writeState(state);
+            this.snapshotState = state;
+        });
+    }
+    newState(windowStartedAt) {
+        if (!Number.isSafeInteger(windowStartedAt) || windowStartedAt < 0) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('now()', 'a non-negative safe integer');
+        }
+        return {
+            version: 1,
+            maxBytes: this.maxBytes,
+            windowMsecs: this.windowMsecs,
+            windowStartedAt,
+            consumedBytes: 0
+        };
+    }
+    async readState() {
+        let parsed;
+        try {
+            parsed = JSON.parse(await node_fs_1.promises.readFile(this.stateFile, 'utf8'));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return this.newState(this.validNow());
+            throw new Error(`Unable to read durable bulk-header download budget: ${String(error)}`);
+        }
+        if (!isBudgetState(parsed))
+            throw new Error('Durable bulk-header download budget state is invalid.');
+        // Configuration changes never reset an active allowance. A lower maximum
+        // clamps consumption to "fully spent" and a shorter window takes effect
+        // only after the longer active window has elapsed.
+        const migrated = {
+            ...parsed,
+            maxBytes: this.maxBytes,
+            windowMsecs: Math.max(parsed.windowMsecs, this.windowMsecs),
+            consumedBytes: Math.min(parsed.consumedBytes, this.maxBytes)
+        };
+        this.snapshotState = migrated;
+        return migrated;
+    }
+    async writeState(state) {
+        const folder = path.dirname(this.stateFile);
+        await node_fs_1.promises.mkdir(folder, { recursive: true });
+        const temporary = path.join(folder, `.${path.basename(this.stateFile)}.${process.pid}.${(0, node_crypto_1.randomUUID)()}.tmp`);
+        let handle;
+        try {
+            handle = await node_fs_1.promises.open(temporary, 'wx', 0o600);
+            await handle.writeFile(JSON.stringify(state));
+            await handle.sync();
+            await handle.close();
+            handle = undefined;
+            await node_fs_1.promises.rename(temporary, this.stateFile);
+            await syncDirectory(folder);
+        }
+        finally {
+            await handle?.close().catch(() => undefined);
+            await node_fs_1.promises.unlink(temporary).catch(error => {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            });
+        }
+    }
+    validNow() {
+        const value = this.now();
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('now()', 'a non-negative safe integer');
+        }
+        return value;
+    }
+    async withStateLock(work) {
+        const token = (0, node_crypto_1.randomUUID)();
+        const ownerFile = path.join(this.lockFolder, 'owner');
+        const startedAt = Date.now();
+        await node_fs_1.promises.mkdir(path.dirname(this.stateFile), { recursive: true });
+        for (;;) {
+            try {
+                await node_fs_1.promises.mkdir(this.lockFolder, { mode: 0o700 });
+                try {
+                    await node_fs_1.promises.writeFile(ownerFile, token, { encoding: 'utf8', flag: 'wx', mode: 0o600 });
+                }
+                catch (error) {
+                    await node_fs_1.promises.rmdir(this.lockFolder).catch(() => undefined);
+                    throw error;
+                }
+                break;
+            }
+            catch (error) {
+                if (error.code !== 'EEXIST')
+                    throw error;
+                if (Date.now() - startedAt >= this.lockTimeoutMsecs) {
+                    throw new Error(`Timed out acquiring durable bulk-header download budget lock ${this.lockFolder}. ` +
+                        'The lock is never reclaimed automatically after a crash; verify that no writer is active before removing it.');
+                }
+                await new Promise(resolve => setTimeout(resolve, this.lockRetryMsecs));
+            }
+        }
+        let outcome;
+        try {
+            outcome = { ok: true, value: await work() };
+        }
+        catch (error) {
+            outcome = { ok: false, error };
+        }
+        let releaseError;
+        try {
+            let owner;
+            try {
+                owner = await node_fs_1.promises.readFile(ownerFile, 'utf8');
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            if (owner === token) {
+                await node_fs_1.promises.unlink(ownerFile);
+                await node_fs_1.promises.rmdir(this.lockFolder);
+            }
+        }
+        catch (error) {
+            releaseError = error;
+        }
+        if (!outcome.ok)
+            throw outcome.error;
+        if (releaseError != null)
+            throw releaseError;
+        return outcome.value;
+    }
+}
+exports.DurableFileBulkFileDownloadBudget = DurableFileBulkFileDownloadBudget;
+function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new sdk_1.WERR_INVALID_PARAMETER(name, 'a positive safe integer');
+    }
+    return value;
+}
+function isBudgetState(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    const state = value;
+    return (state.version === 1 &&
+        Number.isSafeInteger(state.maxBytes) &&
+        Number.isSafeInteger(state.windowMsecs) &&
+        Number.isSafeInteger(state.windowStartedAt) &&
+        Number.isSafeInteger(state.consumedBytes) &&
+        state.maxBytes > 0 &&
+        state.windowMsecs > 0 &&
+        state.windowStartedAt >= 0 &&
+        state.consumedBytes >= 0 &&
+        state.consumedBytes <= state.maxBytes);
+}
+async function syncDirectory(folder) {
+    const handle = await node_fs_1.promises.open(folder, 'r');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=DurableFileBulkFileDownloadBudget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DurableFileBulkFileDownloadBudget.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/DurableFileBulkFileDownloadBudget.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAwC;AACxC,qCAAwC;AACxC,MAAY,IAAI,sCAAiB;AACjC,yCAAwD;AAsBxD;;;;;;;;GAQG;AACH;IACmB,QAAQ,CAAQ;IAChB,WAAW,CAAQ;IACnB,SAAS,CAAQ;IACjB,UAAU,CAAQ;IAClB,gBAAgB,CAAQ;IACxB,cAAc,CAAQ;IACtB,GAAG,CAAc;IAC1B,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;IACvC,aAAa,CAAa;IAElC,YAAY,OAAiD;QAC3D,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;QAC7D,IAAI,CAAC,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,CAAA;QACxF,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,OAAO,CAAC,gBAAgB,IAAI,MAAM,EAAE,kBAAkB,CAAC,CAAA;QAC/F,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAA;QACrF,IAAI,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAChD,MAAM,IAAI,4BAAsB,CAAC,gBAAgB,EAAE,kCAAkC,CAAC,CAAA;QACxF,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7E,MAAM,IAAI,4BAAsB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA;QACnE,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAChD,IAAI,CAAC,UAAU,GAAG,GAAG,IAAI,CAAC,SAAS,OAAO,CAAA;QAC1C,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YACnE,MAAM,IAAI,4BAAsB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC1C,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE;gBAClC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;YACxB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CACxB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QACD,MAAM,SAAS,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,eAAe,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;QACrF,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CACxB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QACD,OAAO,MAAM,SAAS,CAAA;IACxB,CAAC;IAED,QAAQ;QACN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ;YACrC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,aAAa;YAC/C,cAAc,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa;YAC9E,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe;YACnD,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,WAAW;SAC5C,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC/C,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI,EAAE;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC3B,IAAI,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAA;YAClC,IAAI,GAAG,GAAG,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC,WAAW;gBAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAA;YACrD,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,mDAAmD,SAAS,cAAc;oBACxE,GAAG,SAAS,yCAAyC,CACxD,CAAA;YACH,CAAC;YACD,KAAK,CAAC,aAAa,IAAI,SAAS,CAAA;YAChC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;YAC5B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC5B,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,QAAQ,CAAC,eAAuB;QACtC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,4BAAsB,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,eAAe;YACf,aAAa,EAAE,CAAC;SACjB,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAA;YAC7F,MAAM,IAAI,KAAK,CAAC,uDAAuD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACzF,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;QACpG,yEAAyE;QACzE,wEAAwE;QACxE,mDAAmD;QACnD,MAAM,QAAQ,GAAgB;YAC5B,GAAG,MAAM;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC;YAC3D,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC;SAC7D,CAAA;QACD,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAA;QAC7B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAkB;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC3C,MAAM,kBAAE,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,IAAI,IAAA,wBAAU,GAAE,MAAM,CAAC,CAAA;QAC3G,IAAI,MAAiC,CAAA;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;YAC9C,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;YAC7C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YACnB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;YACpB,MAAM,GAAG,SAAS,CAAA;YAClB,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAC1C,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YAC5C,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;gBACvC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAA;YACrE,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAEO,QAAQ;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,4BAAsB,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAA;QAC1E,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,KAAK,CAAC,aAAa,CAAI,IAAsB;QACnD,MAAM,KAAK,GAAG,IAAA,wBAAU,GAAE,CAAA;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjE,SAAS,CAAC;YACR,IAAI,CAAC;gBACH,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBAChD,IAAI,CAAC;oBACH,MAAM,kBAAE,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBACrF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;oBACtD,MAAM,KAAK,CAAA;gBACb,CAAC;gBACD,MAAK;YACP,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAA;gBACnE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACpD,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,UAAU,IAAI;wBACjF,8GAA8G,CACjH,CAAA;gBACH,CAAC;gBACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAA;YACxE,CAAC;QACH,CAAC;QACD,IAAI,OAA+D,CAAA;QACnE,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,EAAE,CAAA;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;QAChC,CAAC;QACD,IAAI,YAAqB,CAAA;QACzB,IAAI,CAAC;YACH,IAAI,KAAyB,CAAA;YAC7B,IAAI,CAAC;gBACH,KAAK,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;YAC9C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,KAAK,CAAA;YACrE,CAAC;YACD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;gBACpB,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;gBAC1B,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,GAAG,KAAK,CAAA;QACtB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,OAAO,CAAC,KAAK,CAAA;QACpC,IAAI,YAAY,IAAI,IAAI;YAAE,MAAM,YAAY,CAAA;QAC5C,OAAO,OAAO,CAAC,KAAK,CAAA;IACtB,CAAC;CACF;;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,IAAY;IAClD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,4BAAsB,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAA;IACnE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC5D,MAAM,KAAK,GAAG,KAA6B,CAAA;IAC3C,OAAO,CACL,KAAK,CAAC,OAAO,KAAK,CAAC;QACnB,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC;QACvC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC;QAC3C,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;QACzC,KAAK,CAAC,QAAS,GAAG,CAAC;QACnB,KAAK,CAAC,WAAY,GAAG,CAAC;QACtB,KAAK,CAAC,eAAgB,IAAI,CAAC;QAC3B,KAAK,CAAC,aAAc,IAAI,CAAC;QACzB,KAAK,CAAC,aAAc,IAAI,KAAK,CAAC,QAAS,CACxC,CAAA;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,30 @@
+import type { BulkFileDownloadBudgetApi } from '../Api/BulkFileDataCacheApi';
+export interface FixedWindowBulkFileDownloadBudgetOptions {
+    maxBytes: number;
+    windowMsecs?: number;
+    now?: () => number;
+}
+/**
+ * Conservative process-local byte reservation budget for remote bulk-header
+ * downloads. A reservation is retained even when the subsequent request
+ * fails, preventing a failing upstream from bypassing the bound.
+ *
+ * @public
+ */
+export declare class FixedWindowBulkFileDownloadBudget implements BulkFileDownloadBudgetApi {
+    private readonly maxBytes;
+    private readonly windowMsecs;
+    private readonly now;
+    private windowStartedAt;
+    private consumedBytes;
+    constructor(options: FixedWindowBulkFileDownloadBudgetOptions);
+    consume(byteCount: number): void;
+    snapshot(): {
+        maxBytes: number;
+        consumedBytes: number;
+        remainingBytes: number;
+        windowStartedAt: number;
+        windowMsecs: number;
+    };
+}
+//# sourceMappingURL=FixedWindowBulkFileDownloadBudget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FixedWindowBulkFileDownloadBudget.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/FixedWindowBulkFileDownloadBudget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAE5E,MAAM,WAAW,wCAAwC;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,iCAAkC,YAAW,yBAAyB;IACjF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAI;IAEzB,YAAY,OAAO,EAAE,wCAAwC,EAY5D;IAED,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAgB/B;IAED,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAA;QAChB,aAAa,EAAE,MAAM,CAAA;QACrB,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,EAAE,MAAM,CAAA;QACvB,WAAW,EAAE,MAAM,CAAA;KACpB,CAQA;CACF"}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixedWindowBulkFileDownloadBudget = void 0;
+const sdk_1 = require("../../../../sdk");
+/**
+ * Conservative process-local byte reservation budget for remote bulk-header
+ * downloads. A reservation is retained even when the subsequent request
+ * fails, preventing a failing upstream from bypassing the bound.
+ *
+ * @public
+ */
+class FixedWindowBulkFileDownloadBudget {
+    maxBytes;
+    windowMsecs;
+    now;
+    windowStartedAt;
+    consumedBytes = 0;
+    constructor(options) {
+        if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 1) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('maxBytes', 'a positive safe integer');
+        }
+        const windowMsecs = options.windowMsecs ?? 60 * 60 * 1000;
+        if (!Number.isSafeInteger(windowMsecs) || windowMsecs < 1) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('windowMsecs', 'a positive safe integer');
+        }
+        this.maxBytes = options.maxBytes;
+        this.windowMsecs = windowMsecs;
+        this.now = options.now ?? Date.now;
+        this.windowStartedAt = this.now();
+    }
+    consume(byteCount) {
+        if (!Number.isSafeInteger(byteCount) || byteCount < 1) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('byteCount', 'a positive safe integer');
+        }
+        const now = this.now();
+        if (now - this.windowStartedAt >= this.windowMsecs) {
+            this.windowStartedAt = now;
+            this.consumedBytes = 0;
+        }
+        if (this.consumedBytes + byteCount > this.maxBytes) {
+            throw new Error(`Bulk-header download budget exceeded: requested ${byteCount} bytes with ` +
+                `${this.maxBytes - this.consumedBytes} bytes remaining in the current window.`);
+        }
+        this.consumedBytes += byteCount;
+    }
+    snapshot() {
+        return {
+            maxBytes: this.maxBytes,
+            consumedBytes: this.consumedBytes,
+            remainingBytes: this.maxBytes - this.consumedBytes,
+            windowStartedAt: this.windowStartedAt,
+            windowMsecs: this.windowMsecs
+        };
+    }
+}
+exports.FixedWindowBulkFileDownloadBudget = FixedWindowBulkFileDownloadBudget;
+//# sourceMappingURL=FixedWindowBulkFileDownloadBudget.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FixedWindowBulkFileDownloadBudget.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/FixedWindowBulkFileDownloadBudget.ts"],"names":[],"mappings":";;;AAAA,yCAAwD;AASxD;;;;;;GAMG;AACH;IACmB,QAAQ,CAAQ;IAChB,WAAW,CAAQ;IACnB,GAAG,CAAc;IAC1B,eAAe,CAAQ;IACvB,aAAa,GAAG,CAAC,CAAA;IAEzB,YAAY,OAAiD;QAC3D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,4BAAsB,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAA;QACzE,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QACzD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,4BAAsB,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAA;QAC5E,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QAClC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACnC,CAAC;IAED,OAAO,CAAC,SAAiB;QACvB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,4BAAsB,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAA;QAC1E,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,CAAC,eAAe,GAAG,GAAG,CAAA;YAC1B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAA;QACxB,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,mDAAmD,SAAS,cAAc;gBACxE,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,yCAAyC,CACjF,CAAA;QACH,CAAC;QACD,IAAI,CAAC,aAAa,IAAI,SAAS,CAAA;IACjC,CAAC;IAED,QAAQ;QAON,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,cAAc,EAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa;YAClD,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAA;IACH,CAAC;CACF"}

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

@@ -1 +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;IAF1B,YACS,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACtB;IAEJ;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,cAAyB;IAE9C;;OAEG;IACH,IAAI,OAAO,YAEV;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAE,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,CAKhD;IAED;;OAEG;IACH,IAAI,MAAM,WAET;IAED;;OAEG;IACH,QAAQ,IAAK,MAAM,CAElB;IAED;;;OAGG;IACH,QAAQ,CAAE,KAAK,EAAE,WAAW,GAAG,MAAM,WAKpC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAE,KAAK,EAAE,WAAW,eAG5B;IAED;;;;;;;;;OASG;IACH,KAAK,CAAE,KAAK,EAAE,WAAW,eAKxB;IAED;;;;;;;OAOG;IACH,QAAQ,CAAE,KAAK,EAAE,WAAW,eAgB3B;IAED;;;;;;;OAOG;IACH,KAAK,CAAE,KAAK,EAAE,WAAW,eAGxB;IAED;;OAEG;IACH,IAAI,IAAK,WAAW,CAEnB;CACF"}
+{"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;IAF1B,YACS,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACtB;IAEJ;;;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,CAK/C;IAED;;OAEG;IACH,IAAI,MAAM,WAET;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,WAKnC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,eAG3B;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,eAOvB;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,eA0B1B;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,eAGvB;IAED;;OAEG;IACH,IAAI,IAAI,WAAW,CAElB;CACF"}

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

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

@@ -0,0 +1,14 @@
+import type { BulkFileDataValidationRequest, BulkFileDataValidationResult, BulkFileDataValidatorApi } from '../Api/BulkFileDataValidatorApi';
+/** Normalize and snapshot a complete validator request before asynchronous work. */
+export declare function normalizeBulkFileDataValidationRequest(request: unknown): BulkFileDataValidationRequest;
+/**
+ * Portable complete-object validator. Node services should normally inject
+ * `NodeBulkFileDataValidator`; browser and mobile consumers retain this
+ * dependency-free fallback.
+ *
+ * @public
+ */
+export declare class InlineBulkFileDataValidator implements BulkFileDataValidatorApi {
+    validate(request: BulkFileDataValidationRequest): Promise<BulkFileDataValidationResult>;
+}
+//# sourceMappingURL=InlineBulkFileDataValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InlineBulkFileDataValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/InlineBulkFileDataValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,iCAAiC,CAAA;AAmBxC,oFAAoF;AACpF,wBAAgB,sCAAsC,CAAC,OAAO,EAAE,OAAO,GAAG,6BAA6B,CA8EtG;AAED;;;;;;GAMG;AACH,qBAAa,2BAA4B,YAAW,wBAAwB;IACpE,QAAQ,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAgD5F;CACF"}