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

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

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InlineBulkFileDataValidator = void 0;
+exports.normalizeBulkFileDataValidationRequest = normalizeBulkFileDataValidationRequest;
+const Hash_1 = require("@bsv/sdk/primitives/Hash");
+const sdk_1 = require("../../../../sdk");
+const utilityHelpers_noBuffer_1 = require("../../../../utility/utilityHelpers.noBuffer");
+const BulkFileDataValidatorApi_1 = require("../Api/BulkFileDataValidatorApi");
+const blockHeaderUtilities_1 = require("./blockHeaderUtilities");
+const MAX_HEADERS_PER_FILE = 100_000;
+const HEX_32_BYTES = /^[0-9a-f]{64}$/;
+const SAFE_FILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._~-]{0,254}$/;
+const SUPPORTED_CHAINS = new Set(['main', 'test', 'stn', 'ttn', 'tstn', 'mock']);
+function canonicalSha256(value) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9+/]{43}=$/.test(value))
+        return false;
+    try {
+        const bytes = (0, utilityHelpers_noBuffer_1.asArray)(value, 'base64');
+        return bytes.length === 32 && (0, utilityHelpers_noBuffer_1.asString)(bytes, 'base64') === value;
+    }
+    catch {
+        return false;
+    }
+}
+/** Normalize and snapshot a complete validator request before asynchronous work. */
+function normalizeBulkFileDataValidationRequest(request) {
+    if (request == null || typeof request !== 'object' || Array.isArray(request)) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('validation request', 'a plain data object');
+    }
+    const prototype = Object.getPrototypeOf(request);
+    const descriptors = Object.getOwnPropertyDescriptors(request);
+    if ((prototype !== Object.prototype && prototype !== null) ||
+        Object.values(descriptors).some(descriptor => descriptor.get != null || descriptor.set != null)) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('validation request', 'an accessor-free plain data object');
+    }
+    const own = (name, required = true) => {
+        const descriptor = descriptors[name];
+        if (descriptor == null) {
+            if (!required)
+                return undefined;
+            throw new sdk_1.WERR_INVALID_PARAMETER('validation request', `an own ${name} data property`);
+        }
+        return 'value' in descriptor ? descriptor.value : undefined;
+    };
+    const data = own('data');
+    const count = own('count');
+    const firstHeight = own('firstHeight');
+    const fileName = own('fileName');
+    const fileHash = own('fileHash', false);
+    const prevHash = own('prevHash');
+    const prevChainWork = own('prevChainWork');
+    const lastHash = own('lastHash', false);
+    const lastChainWork = own('lastChainWork', false);
+    const chain = own('chain', false);
+    if (!(data instanceof Uint8Array))
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.data', 'a Uint8Array');
+    if (!Number.isSafeInteger(count) || count < 1 || count > MAX_HEADERS_PER_FILE) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.count', `an integer from 1 through ${MAX_HEADERS_PER_FILE}`);
+    }
+    if (data.byteLength !== count * 80) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.data', 'exactly count times 80 bytes');
+    }
+    if (!Number.isSafeInteger(firstHeight) ||
+        firstHeight < 0 ||
+        firstHeight + count - 1 > 0x7fffffff) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.firstHeight', 'a supported block-header range');
+    }
+    if (typeof fileName !== 'string' || !SAFE_FILE_NAME.test(fileName) || fileName === '.' || fileName === '..') {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.fileName', 'a safe path-free ASCII file name');
+    }
+    if (fileHash !== undefined && !canonicalSha256(fileHash)) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.fileHash', 'a canonical base64 SHA-256 digest when defined');
+    }
+    for (const [name, value, optional] of [
+        ['prevHash', prevHash, false],
+        ['prevChainWork', prevChainWork, false],
+        ['lastHash', lastHash, true],
+        ['lastChainWork', lastChainWork, true]
+    ]) {
+        if ((value === undefined || value === null) && optional)
+            continue;
+        if (typeof value !== 'string' || !HEX_32_BYTES.test(value)) {
+            throw new sdk_1.WERR_INVALID_PARAMETER(`request.${name}`, 'exactly 32 lowercase hexadecimal bytes');
+        }
+    }
+    if (chain !== undefined && (typeof chain !== 'string' || !SUPPORTED_CHAINS.has(chain))) {
+        throw new sdk_1.WERR_INVALID_PARAMETER('request.chain', 'a supported Chaintracks network when defined');
+    }
+    return {
+        fileName,
+        data: data.slice(),
+        count: count,
+        fileHash: fileHash,
+        firstHeight: firstHeight,
+        prevHash: prevHash,
+        prevChainWork: prevChainWork,
+        lastHash: lastHash,
+        lastChainWork: lastChainWork,
+        chain: chain
+    };
+}
+/**
+ * Portable complete-object validator. Node services should normally inject
+ * `NodeBulkFileDataValidator`; browser and mobile consumers retain this
+ * dependency-free fallback.
+ *
+ * @public
+ */
+class InlineBulkFileDataValidator {
+    async validate(request) {
+        let rejectedData;
+        try {
+            request = normalizeBulkFileDataValidationRequest(request);
+            rejectedData = request.data;
+            const expectedLength = request.count * 80;
+            if (request.data.length !== expectedLength) {
+                throw new sdk_1.WERR_INVALID_PARAMETER('file.data', `bulk file ${request.fileName} data length ${request.data.length} does not match expected count ${request.count}`);
+            }
+            const fileHash = (0, utilityHelpers_noBuffer_1.asString)((0, Hash_1.sha256)((0, utilityHelpers_noBuffer_1.asArray)(request.data)), 'base64');
+            if (request.fileHash != null && fileHash !== request.fileHash) {
+                throw new sdk_1.WERR_INVALID_PARAMETER('fileHash', `a match for retrieved data for ${request.fileName}`);
+            }
+            const { lastHeaderHash, lastChainWork } = (0, blockHeaderUtilities_1.validateBufferOfHeaders)(request.data, request.prevHash, 0, request.count, request.prevChainWork);
+            if (request.lastHash && request.lastHash !== lastHeaderHash) {
+                throw new sdk_1.WERR_INVALID_PARAMETER('file.lastHash', `expected ${request.lastHash} but got ${lastHeaderHash}`);
+            }
+            if (request.lastChainWork && request.lastChainWork !== lastChainWork) {
+                throw new sdk_1.WERR_INVALID_PARAMETER('file.lastChainWork', `expected ${request.lastChainWork} but got ${lastChainWork}`);
+            }
+            if (request.firstHeight === 0 && request.chain != null)
+                (0, blockHeaderUtilities_1.validateGenesisHeader)(request.data, request.chain);
+            return {
+                data: request.data,
+                fileHash,
+                lastHeaderHash,
+                lastChainWork: lastChainWork
+            };
+        }
+        catch (error) {
+            if (error instanceof BulkFileDataValidatorApi_1.BulkFileDataValidationError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            throw new BulkFileDataValidatorApi_1.BulkFileDataValidationError(message.slice(0, 4096), rejectedData);
+        }
+    }
+}
+exports.InlineBulkFileDataValidator = InlineBulkFileDataValidator;
+//# sourceMappingURL=InlineBulkFileDataValidator.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { type BulkFileDataValidationRequest, type BulkFileDataValidationResult, type BulkFileDataValidatorApi, type BulkFileDataValidatorStats } from '../Api/BulkFileDataValidatorApi';
+export interface NodeBulkFileDataValidatorOptions {
+    /** Number of validation workers. Defaults to one to bound CPU usage. */
+    maxWorkers?: number;
+    /** Maximum number of waiting validations. Defaults to eight. */
+    maxQueue?: number;
+    /** Per-object validation deadline. Defaults to two minutes. */
+    taskTimeoutMsecs?: number;
+    /** Test-only worker entry override. */
+    workerPath?: string;
+}
+/**
+ * Bounded Node worker pool for complete bulk-header verification.
+ *
+ * A bounded private copy transfers to the worker and back without structured
+ * cloning. This preserves the caller's source bytes if a worker crashes while
+ * queue bounds prevent validation copies from consuming unbounded memory.
+ *
+ * @public
+ */
+export declare class NodeBulkFileDataValidator implements BulkFileDataValidatorApi {
+    private readonly maxQueue;
+    private readonly taskTimeoutMsecs;
+    private readonly workerPath;
+    private readonly workers;
+    private readonly queue;
+    private nextTaskId;
+    private destroyed;
+    private readonly stats;
+    constructor(options?: NodeBulkFileDataValidatorOptions);
+    validate(request: BulkFileDataValidationRequest): Promise<BulkFileDataValidationResult>;
+    getStats(): BulkFileDataValidatorStats;
+    destroy(): Promise<void>;
+    private spawnWorker;
+    private dispatch;
+    private complete;
+    private validateWorkerResult;
+    private failWorker;
+    private updateQueueStats;
+}
+//# sourceMappingURL=NodeBulkFileDataValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeBulkFileDataValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/NodeBulkFileDataValidator.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAChC,MAAM,iCAAiC,CAAA;AAUxC,MAAM,WAAW,gCAAgC;IAC/C,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AA8BD;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,wBAAwB;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAWrB;IAED,YAAY,OAAO,GAAE,gCAAqC,EAkBzD;IAEK,QAAQ,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAyB5F;IAED,QAAQ,IAAI,0BAA0B,CAMrC;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAe7B;IAED,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,QAAQ;IA4BhB,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,gBAAgB;CAKzB"}

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

@@ -0,0 +1,271 @@
+"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.NodeBulkFileDataValidator = void 0;
+const path = __importStar(require("node:path"));
+const node_worker_threads_1 = require("node:worker_threads");
+const BulkFileDataValidatorApi_1 = require("../Api/BulkFileDataValidatorApi");
+const InlineBulkFileDataValidator_1 = require("./InlineBulkFileDataValidator");
+const MAX_VALIDATION_WORKERS = 32;
+const MAX_VALIDATION_QUEUE = 1024;
+const MAX_TASK_TIMEOUT_MSECS = 60 * 60 * 1000;
+const MAX_HEADER_BYTES = 100_000 * 80;
+const SHA256_BASE64 = /^[A-Za-z0-9+/]{43}=$/;
+const HEX_32_BYTES = /^[0-9a-f]{64}$/;
+/**
+ * Bounded Node worker pool for complete bulk-header verification.
+ *
+ * A bounded private copy transfers to the worker and back without structured
+ * cloning. This preserves the caller's source bytes if a worker crashes while
+ * queue bounds prevent validation copies from consuming unbounded memory.
+ *
+ * @public
+ */
+class NodeBulkFileDataValidator {
+    maxQueue;
+    taskTimeoutMsecs;
+    workerPath;
+    workers = [];
+    queue = [];
+    nextTaskId = 1;
+    destroyed = false;
+    stats = {
+        submitted: 0,
+        completed: 0,
+        failed: 0,
+        rejected: 0,
+        workerRestarts: 0,
+        inFlight: 0,
+        queued: 0,
+        maxQueueDepth: 0,
+        totalValidationMsecs: 0,
+        maxValidationMsecs: 0
+    };
+    constructor(options = {}) {
+        const maxWorkers = boundedPositiveInteger(options.maxWorkers ?? 1, 'maxWorkers', MAX_VALIDATION_WORKERS);
+        this.maxQueue = boundedPositiveInteger(options.maxQueue ?? 8, 'maxQueue', MAX_VALIDATION_QUEUE);
+        this.taskTimeoutMsecs = boundedPositiveInteger(options.taskTimeoutMsecs ?? 2 * 60 * 1000, 'taskTimeoutMsecs', MAX_TASK_TIMEOUT_MSECS);
+        if (options.workerPath !== undefined &&
+            (typeof options.workerPath !== 'string' ||
+                options.workerPath.trim() === '' ||
+                options.workerPath.includes('\u0000'))) {
+            throw new Error('workerPath must be a non-empty filesystem path when defined');
+        }
+        this.workerPath = path.resolve(options.workerPath ?? path.join(__dirname, 'BulkFileDataValidator.worker.js'));
+        for (let index = 0; index < maxWorkers; index++)
+            this.spawnWorker();
+    }
+    async validate(request) {
+        if (this.destroyed)
+            throw new Error('Bulk-header validator has been destroyed');
+        const idle = this.workers.some(slot => slot.task == null && !slot.terminating);
+        if (!idle && this.queue.length >= this.maxQueue) {
+            this.stats.rejected++;
+            throw new Error(`Bulk-header validation queue is full (${this.maxQueue} waiting objects).`);
+        }
+        let snapshot;
+        try {
+            snapshot = (0, InlineBulkFileDataValidator_1.normalizeBulkFileDataValidationRequest)(request);
+        }
+        catch (error) {
+            this.stats.rejected++;
+            throw error;
+        }
+        return await new Promise((resolve, reject) => {
+            this.stats.submitted++;
+            if (!Number.isSafeInteger(this.nextTaskId)) {
+                reject(new Error('Bulk-header validator exhausted its task identifier space.'));
+                return;
+            }
+            this.queue.push({ id: this.nextTaskId++, request: snapshot, startedAt: 0, resolve, reject });
+            this.updateQueueStats();
+            this.dispatch();
+        });
+    }
+    getStats() {
+        return {
+            ...this.stats,
+            inFlight: this.workers.filter(slot => slot.task != null).length,
+            queued: this.queue.length
+        };
+    }
+    async destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        const error = new Error('Bulk-header validator was destroyed');
+        for (const task of this.queue.splice(0))
+            task.reject(error);
+        for (const slot of this.workers) {
+            if (slot.task != null) {
+                clearTimeout(slot.task.timer);
+                slot.task.reject(error);
+                slot.task = undefined;
+            }
+            slot.terminating = true;
+        }
+        await Promise.all(this.workers.map(async (slot) => await slot.worker.terminate()));
+        this.workers.length = 0;
+    }
+    spawnWorker() {
+        if (this.destroyed)
+            return;
+        const worker = new node_worker_threads_1.Worker(this.workerPath);
+        const slot = { worker, terminating: false };
+        worker.on('message', (message) => {
+            try {
+                this.complete(slot, message);
+            }
+            catch (error) {
+                this.failWorker(slot, error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+        worker.on('error', error => this.failWorker(slot, error instanceof Error ? error : new Error(String(error))));
+        worker.on('exit', code => {
+            if (!slot.terminating)
+                this.failWorker(slot, new Error(`Validation worker exited unexpectedly with code ${code}`));
+        });
+        this.workers.push(slot);
+    }
+    dispatch() {
+        for (const slot of this.workers) {
+            if (slot.task != null || slot.terminating)
+                continue;
+            const task = this.queue.shift();
+            if (task == null)
+                break;
+            slot.task = task;
+            task.startedAt = Date.now();
+            task.timer = setTimeout(() => {
+                this.failWorker(slot, new Error(`Bulk-header validation exceeded ${this.taskTimeoutMsecs}ms`));
+            }, this.taskTimeoutMsecs);
+            const data = ownedArrayBuffer(task.request.data);
+            try {
+                slot.worker.postMessage({ id: task.id, request: { ...task.request, data } }, [data]);
+            }
+            catch (error) {
+                this.failWorker(slot, error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        this.updateQueueStats();
+    }
+    complete(slot, message) {
+        const task = slot.task;
+        if (task?.id !== message.id)
+            return;
+        clearTimeout(task.timer);
+        const duration = Date.now() - task.startedAt;
+        this.stats.totalValidationMsecs += duration;
+        this.stats.maxValidationMsecs = Math.max(this.stats.maxValidationMsecs, duration);
+        if (message.ok) {
+            this.validateWorkerResult(message.result, task);
+            slot.task = undefined;
+            this.stats.completed++;
+            task.resolve({ ...message.result, data: new Uint8Array(message.result.data) });
+        }
+        else {
+            if (!(message.data instanceof ArrayBuffer) || message.data.byteLength > MAX_HEADER_BYTES) {
+                throw new Error('Validation worker returned invalid rejected data.');
+            }
+            slot.task = undefined;
+            this.stats.failed++;
+            const detail = (typeof message.error === 'string' ? message.error : (message.error?.message ?? 'Validation failed')).slice(0, 4096);
+            const error = new BulkFileDataValidatorApi_1.BulkFileDataValidationError(detail, new Uint8Array(message.data));
+            if (typeof message.error !== 'string' && message.error.stack != null)
+                error.stack = message.error.stack;
+            task.reject(error);
+        }
+        this.dispatch();
+    }
+    validateWorkerResult(result, task) {
+        if (result == null ||
+            typeof result !== 'object' ||
+            !(result.data instanceof ArrayBuffer) ||
+            result.data.byteLength !== task.request.count * 80 ||
+            typeof result.fileHash !== 'string' ||
+            !SHA256_BASE64.test(result.fileHash) ||
+            Buffer.from(result.fileHash, 'base64').toString('base64') !== result.fileHash ||
+            typeof result.lastHeaderHash !== 'string' ||
+            !HEX_32_BYTES.test(result.lastHeaderHash) ||
+            typeof result.lastChainWork !== 'string' ||
+            !HEX_32_BYTES.test(result.lastChainWork) ||
+            (task.request.fileHash !== undefined && result.fileHash !== task.request.fileHash) ||
+            (task.request.lastHash != null && result.lastHeaderHash !== task.request.lastHash) ||
+            (task.request.lastChainWork != null && result.lastChainWork !== task.request.lastChainWork)) {
+            throw new Error('Validation worker returned an invalid or mismatched result.');
+        }
+    }
+    failWorker(slot, error) {
+        if (slot.terminating)
+            return;
+        slot.terminating = true;
+        const task = slot.task;
+        slot.task = undefined;
+        if (task != null) {
+            clearTimeout(task.timer);
+            this.stats.failed++;
+            task.reject(error);
+        }
+        const index = this.workers.indexOf(slot);
+        if (index >= 0)
+            this.workers.splice(index, 1);
+        this.stats.workerRestarts++;
+        void slot.worker.terminate().finally(() => {
+            if (!this.destroyed) {
+                this.spawnWorker();
+                this.dispatch();
+            }
+        });
+    }
+    updateQueueStats() {
+        this.stats.queued = this.queue.length;
+        this.stats.inFlight = this.workers.filter(slot => slot.task != null).length;
+        this.stats.maxQueueDepth = Math.max(this.stats.maxQueueDepth, this.queue.length);
+    }
+}
+exports.NodeBulkFileDataValidator = NodeBulkFileDataValidator;
+function boundedPositiveInteger(value, name, maximum) {
+    if (!Number.isSafeInteger(value) || value < 1 || value > maximum) {
+        throw new Error(`${name} must be a positive safe integer no greater than ${maximum}`);
+    }
+    return value;
+}
+function ownedArrayBuffer(data) {
+    if (data.byteOffset !== 0 || data.byteLength !== data.buffer.byteLength || !(data.buffer instanceof ArrayBuffer)) {
+        throw new Error('Bulk-header validation task does not own an exact ArrayBuffer.');
+    }
+    return data.buffer;
+}
+//# sourceMappingURL=NodeBulkFileDataValidator.js.map

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

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

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

@@ -3,10 +3,13 @@
  * Allows multiple readers or one writer at a time.
  */
 export declare class SingleWriterMultiReaderLock {
+    private readonly maxQueued;
     private readers;
     private writerActive;
     private readonly readerQueue;
     private readonly writerQueue;
+    constructor(maxQueued?: number);
+    private assertQueueCapacity;
     private checkQueues;
     withReadLock<T>(fn: () => Promise<T>): Promise<T>;
     withWriteLock<T>(fn: () => Promise<T>): Promise<T>;

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

@@ -1 +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,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,OAAO,CAAC,WAAW;IAeb,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBtD;IAEK,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuBvD;CACF"}
+{"version":3,"file":"SingleWriterMultiReaderLock.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,2BAA2B;IAM1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IALtC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IAEpD,YAA6B,SAAS,SAAO,EAI5C;IAED,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,WAAW;IAeb,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAyBtD;IAEK,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBvD;CACF"}

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

@@ -1,15 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SingleWriterMultiReaderLock = void 0;
+const sdk_1 = require("../../../../sdk");
 /**
  * A reader-writer lock to manage concurrent access.
  * Allows multiple readers or one writer at a time.
  */
 class SingleWriterMultiReaderLock {
+    maxQueued;
     readers = 0;
     writerActive = false;
     readerQueue = [];
     writerQueue = [];
+    constructor(maxQueued = 4096) {
+        this.maxQueued = maxQueued;
+        if (!Number.isSafeInteger(maxQueued) || maxQueued < 1 || maxQueued > 100_000) {
+            throw new sdk_1.WERR_INVALID_PARAMETER('maxQueued', 'an integer from 1 through 100000');
+        }
+    }
+    assertQueueCapacity() {
+        if (this.readerQueue.length + this.writerQueue.length >= this.maxQueued) {
+            throw new sdk_1.WERR_INVALID_OPERATION(`Chaintracks lock queue reached its ${this.maxQueued}-operation limit`);
+        }
+    }
     checkQueues() {
         if (this.writerActive || this.readers > 0)
             return;
@@ -40,6 +53,7 @@ class SingleWriterMultiReaderLock {
         }
         else {
             // Queue the reader until writers are done
+            this.assertQueueCapacity();
             const promise = new Promise(resolve => {
                 this.readerQueue.push(resolve);
             });
@@ -67,6 +81,7 @@ class SingleWriterMultiReaderLock {
             }
         }
         else {
+            this.assertQueueCapacity();
             const promise = new Promise(resolve => {
                 this.writerQueue.push(resolve);
             });

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

@@ -1 +1 @@
-{"version":3,"file":"SingleWriterMultiReaderLock.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH;IACU,OAAO,GAAW,CAAC,CAAA;IACnB,YAAY,GAAY,KAAK,CAAA;IACpB,WAAW,GAAsB,EAAE,CAAA;IACnC,WAAW,GAAsB,EAAE,CAAA;IAE5C,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"}
+{"version":3,"file":"SingleWriterMultiReaderLock.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/util/SingleWriterMultiReaderLock.ts"],"names":[],"mappings":"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"}

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

@@ -10,7 +10,7 @@ import { BaseBlockHeader, BlockHeader } from '../../../../sdk/WalletServices.int
  * @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<{
+export declare function sha256HashOfBinaryFile(fs: ChaintracksFsApi, filepath: string, bufferSize?: number): Promise<{
     hash: string;
     length: number;
 }>;
@@ -75,16 +75,29 @@ export declare function convertBitsToTarget(bits: number | number[]): BigNumber;
 export declare function convertBitsToWork(bits: number | number[]): string;
 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[];
+/**
+ * Validates the exact data representation of an unpositioned 80-byte block
+ * header before it reaches a chain lookup, queue, or serializer.
+ */
+export declare function validateBaseBlockHeaderFormat(header: BaseBlockHeader): void;
 export declare function validateHeaderFormat(header: BlockHeader): void;
 /**
- * Ensures that a header has a valid proof-of-work
- * Requires chain is 'main'
+ * Ensures that a header has a valid proof-of-work target and hash.
  *
  * @param header The header to validate
  *
  * @returns true if the header is valid
  */
-export declare function validateHeaderDifficulty(hash: Buffer, bits: number): boolean;
+export declare function validateHeaderDifficulty(hash: number[] | Uint8Array, bits: number): boolean;
+/**
+ * Ensures that a structured header's computed hash satisfies its declared
+ * proof-of-work target.
+ *
+ * @param header Header whose format and hash have already been checked.
+ * @returns true if the header has valid proof-of-work.
+ * @publicbody
+ */
+export declare function validateHeaderProofOfWork(header: BlockHeader): true;
 /**
  * Computes double sha256 hash of bitcoin block header
  * bytes are reversed to bigendian order

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

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