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

package/out/src/services/chaintracker/LocalChainTracker.js

@@ -0,0 +1,465 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalChainTracker = void 0;
+/**
+ * Local-first SDK ChainTracker with explicit management and fallback state.
+ *
+ * A definitive local `false` validation is never overridden by a remote
+ * source. Fallback is reserved for local exceptions or explicit remote-only
+ * mode, and applications can require agreement across multiple independent
+ * references before accepting a fallback result.
+ *
+ * @public
+ */
+class LocalChainTracker {
+    local;
+    fallbacks;
+    fallbackOnLocalError;
+    requiredFallbackAgreement;
+    requiredConsistencyAgreement;
+    maxHeightLag;
+    autoRecover;
+    recoverLocal;
+    clearLocal;
+    now;
+    verificationContext = 0;
+    resetting = false;
+    eventEpoch = 0;
+    observerGeneration = 0;
+    eventSubscriptions = new Map();
+    eventSetups = new Map();
+    status;
+    constructor(options) {
+        this.local = options.local;
+        this.fallbacks = [...(options.fallbacks ?? [])];
+        this.fallbackOnLocalError = options.fallbackOnLocalError ?? true;
+        this.requiredFallbackAgreement = this.validateAgreement(options.requiredFallbackAgreement ?? 1, 'requiredFallbackAgreement');
+        this.requiredConsistencyAgreement = this.validateAgreement(options.requiredConsistencyAgreement ?? 2, 'requiredConsistencyAgreement');
+        this.maxHeightLag = this.validateHeightLag(options.maxHeightLag ?? 6);
+        this.autoRecover = options.autoRecover ?? false;
+        this.recoverLocal = options.recoverLocal;
+        this.clearLocal = options.clearLocal;
+        this.now = options.now ?? (() => new Date());
+        this.status = {
+            mode: options.mode ?? 'local-primary',
+            activeSource: options.mode === 'remote-only' ? 'fallback' : 'local',
+            consistency: 'unchecked'
+        };
+    }
+    getMode() {
+        return this.status.mode;
+    }
+    setMode(mode) {
+        if (this.status.mode !== mode)
+            this.verificationContext++;
+        this.status = {
+            ...this.status,
+            mode,
+            activeSource: mode === 'remote-only' ? 'fallback' : 'local'
+        };
+    }
+    /** Local mode/source generation marker for consumers that invalidate derived verdicts. */
+    getVerificationContext() {
+        return `local-chaintracks:${this.sourceContext()}`;
+    }
+    /**
+     * Fresh token for providers participating in this attempt's canonical authority.
+     * Remote-only uses fallbacks only; local-primary uses the local client only.
+     * A missing participating identity fails closed. Unused providers are omitted
+     * and cannot stand in. This is not an atomic multi-source snapshot.
+     */
+    async getVerificationContextToken(signal) {
+        const context = this.sourceContext();
+        this.throwIfAborted(signal);
+        this.assertCurrentContext(context, 'canonical token lookup');
+        const sources = this.attemptSources();
+        if (sources.length === 0)
+            throw new Error('No canonical ChainTracks source is available');
+        await this.ensureEventObservers(sources);
+        const tips = await Promise.all(sources.map(async (source) => await source.findChainTipHash()));
+        this.throwIfAborted(signal);
+        this.assertCurrentContext(context, 'canonical token lookup');
+        if (!this.sameSources(sources, this.attemptSources())) {
+            throw new Error('Local ChainTracks provider changed during canonical token lookup');
+        }
+        if (tips.some(tip => tip == null || tip === '')) {
+            throw new Error('Canonical ChainTracks source identity is unavailable');
+        }
+        return JSON.stringify({ context, eventEpoch: this.eventEpoch, tips });
+    }
+    async dispose() {
+        this.observerGeneration++;
+        await Promise.all(Array.from(this.eventSubscriptions.entries()).map(async ([source, subscription]) => {
+            this.eventSubscriptions.delete(source);
+            await source.unsubscribe(subscription).catch(() => undefined);
+        }));
+    }
+    getStatus() {
+        return { ...this.status };
+    }
+    getLocalClient() {
+        return this.local;
+    }
+    async currentHeight() {
+        const context = this.sourceContext();
+        this.assertCurrentContext(context, 'height lookup');
+        if (this.status.mode === 'remote-only') {
+            const height = await this.fallbackHeight();
+            this.assertCurrentContext(context, 'height lookup');
+            return height;
+        }
+        const local = this.local;
+        try {
+            const height = await local.getPresentHeight();
+            this.assertCurrentContext(context, 'height lookup');
+            this.status = { ...this.status, activeSource: 'local', localHeight: height, lastError: undefined };
+            return height;
+        }
+        catch (error) {
+            this.assertCurrentContext(context, 'height lookup');
+            this.recordError(error);
+            if (!this.fallbackOnLocalError)
+                throw error;
+            const height = await this.fallbackHeight();
+            this.assertCurrentContext(context, 'height lookup');
+            return height;
+        }
+    }
+    async isValidRootForHeight(root, height) {
+        const context = this.sourceContext();
+        this.assertCurrentContext(context, 'root validation');
+        if (this.status.mode !== 'remote-only') {
+            const local = this.local;
+            try {
+                const valid = await local.isValidRootForHeight(root, height);
+                if (typeof valid !== 'boolean') {
+                    throw new TypeError('Local ChainTracker returned a non-boolean Merkle-root verdict.');
+                }
+                this.assertCurrentContext(context, 'root validation');
+                this.status = { ...this.status, activeSource: 'local', lastError: undefined };
+                return valid;
+            }
+            catch (error) {
+                this.assertCurrentContext(context, 'root validation');
+                this.recordError(error);
+                if (!this.fallbackOnLocalError)
+                    throw error;
+            }
+        }
+        const valid = await this.fallbackValidation(root, height);
+        this.assertCurrentContext(context, 'root validation');
+        return valid;
+    }
+    async synchronize() {
+        await this.local.startListening();
+        await this.local.listening();
+        return await this.checkConsistency();
+    }
+    async clearLocalData() {
+        const clearLocal = this.clearLocal;
+        if (clearLocal == null)
+            throw new Error('Local ChainTracks clearing is not configured.');
+        const reset = this.beginReset();
+        await this.applyReset(reset, clearLocal);
+        this.status = {
+            mode: this.status.mode,
+            activeSource: this.status.mode === 'remote-only' ? 'fallback' : 'local',
+            consistency: 'unchecked'
+        };
+        return this.getStatus();
+    }
+    async checkConsistency() {
+        return await this.checkConsistencyInternal(true);
+    }
+    async checkConsistencyInternal(allowRecovery) {
+        const checkedAt = this.now().toISOString();
+        try {
+            const localHeight = await this.local.getPresentHeight();
+            const localTipHash = await this.local.findChainTipHash();
+            const references = await Promise.all(this.fallbacks.map(async (client, index) => {
+                try {
+                    return { client, index, height: await client.getPresentHeight() };
+                }
+                catch {
+                    return undefined;
+                }
+            }));
+            const available = references.filter((value) => value != null);
+            if (available.length === 0) {
+                this.status = {
+                    ...this.status,
+                    activeSource: 'local',
+                    consistency: 'insufficient-references',
+                    localHeight,
+                    localTipHash,
+                    checkedAt,
+                    lastError: undefined
+                };
+                return this.getStatus();
+            }
+            if (available.length < this.requiredConsistencyAgreement) {
+                this.status = {
+                    ...this.status,
+                    activeSource: 'local',
+                    consistency: 'insufficient-references',
+                    localHeight,
+                    localTipHash,
+                    checkedAt,
+                    lastError: undefined
+                };
+                return this.getStatus();
+            }
+            // The Nth highest reference height is the greatest height reached by at
+            // least N references. A stale or inflated minority cannot move it.
+            const referenceHeight = [...available].map(reference => reference.height).sort((a, b) => b - a)[this.requiredConsistencyAgreement - 1];
+            const comparisonHeight = Math.min(localHeight, referenceHeight);
+            const heightLag = Math.max(0, referenceHeight - localHeight);
+            const localHeader = await this.local.findHeaderForHeight(comparisonHeight);
+            const referenceHeaders = await Promise.all(available
+                .filter(reference => reference.height >= comparisonHeight)
+                .map(async (reference) => {
+                try {
+                    return await reference.client.findHeaderForHeight(comparisonHeight);
+                }
+                catch {
+                    return undefined;
+                }
+            }));
+            const agreements = new Map();
+            for (const header of referenceHeaders) {
+                if (header != null)
+                    agreements.set(header.hash, (agreements.get(header.hash) ?? 0) + 1);
+            }
+            const [expectedHash, referenceAgreement] = [...agreements.entries()].sort(([hashA, countA], [hashB, countB]) => countB - countA || hashA.localeCompare(hashB))[0] ?? [undefined, 0];
+            const enoughReferences = referenceAgreement >= this.requiredConsistencyAgreement;
+            let consistency;
+            if (!enoughReferences)
+                consistency = 'insufficient-references';
+            else if (localHeader?.hash !== expectedHash)
+                consistency = 'diverged';
+            else if (heightLag > this.maxHeightLag)
+                consistency = 'lagging';
+            else
+                consistency = 'agreed';
+            this.status = {
+                ...this.status,
+                activeSource: 'local',
+                consistency,
+                localHeight,
+                localTipHash,
+                referenceHeight,
+                heightLag,
+                comparisonHeight,
+                expectedHash,
+                referenceAgreement,
+                checkedAt,
+                lastError: undefined
+            };
+            if ((consistency === 'diverged' || consistency === 'lagging') &&
+                allowRecovery &&
+                this.autoRecover &&
+                this.recoverLocal != null &&
+                expectedHash != null) {
+                const reset = this.beginReset();
+                await this.applyReset(reset, async () => await this.recoverLocal({
+                    reason: consistency,
+                    localHeight,
+                    referenceHeight,
+                    heightLag,
+                    comparisonHeight,
+                    expectedHash,
+                    referenceAgreement
+                }));
+                const recoveredAt = this.now().toISOString();
+                const recovered = await this.checkConsistencyInternal(false);
+                this.status = { ...recovered, recoveredAt };
+            }
+            return this.getStatus();
+        }
+        catch (error) {
+            this.status = {
+                ...this.status,
+                consistency: 'error',
+                checkedAt,
+                lastError: this.errorMessage(error)
+            };
+            return this.getStatus();
+        }
+    }
+    async fallbackHeight() {
+        let lastError;
+        for (const [index, fallback] of this.fallbacks.entries()) {
+            try {
+                const height = await fallback.getPresentHeight();
+                this.recordFallback(index);
+                return height;
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        const error = lastError ?? new Error('No fallback ChainTracks source is configured.');
+        this.recordError(error);
+        throw error;
+    }
+    attemptSources() {
+        return this.status.mode === 'remote-only' ? [...this.fallbacks] : [this.local];
+    }
+    sameSources(left, right) {
+        return left.length === right.length && left.every((source, index) => source === right[index]);
+    }
+    async applyReset(reset, nextLocal) {
+        await this.dispose();
+        this.assertResetOwner(reset);
+        const local = await nextLocal();
+        this.assertResetOwner(reset);
+        this.local = local;
+        this.resetting = false;
+    }
+    sourceContext() {
+        const nested = (source) => {
+            const provider = source;
+            return String(provider.getVerificationContext?.() ?? '');
+        };
+        return JSON.stringify([
+            this.verificationContext,
+            this.resetting,
+            this.status.mode,
+            this.eventEpoch,
+            this.observerGeneration,
+            nested(this.local),
+            this.fallbacks.map(nested)
+        ]);
+    }
+    assertCurrentContext(context, operation) {
+        if (this.resetting || context !== this.sourceContext()) {
+            throw new Error(`Local ChainTracks provider changed during ${operation}`);
+        }
+    }
+    throwIfAborted(signal) {
+        if (signal?.aborted === true)
+            throw signal.reason ?? new Error('Local ChainTracks token lookup aborted');
+    }
+    beginReset() {
+        this.verificationContext++;
+        this.resetting = true;
+        return this.verificationContext;
+    }
+    assertResetOwner(reset) {
+        if (reset !== this.verificationContext)
+            throw new Error('Local ChainTracks reset was superseded');
+    }
+    reorgSubscribe(source) {
+        if (source.supportsReorgEvents === false)
+            return undefined;
+        const events = source;
+        if (typeof events.subscribeReorgs === 'function')
+            return async (listener) => await events.subscribeReorgs(listener);
+        if (source.supportsReorgEvents === true) {
+            throw new Error('Chaintracks provider promised reorg events but subscribeReorgs is not implemented');
+        }
+        return undefined;
+    }
+    async ensureEventObservers(sources) {
+        await Promise.all(sources.map(async (source) => {
+            const subscribe = this.reorgSubscribe(source);
+            if (subscribe == null)
+                return;
+            if (this.eventSubscriptions.has(source))
+                return;
+            const pending = this.eventSetups.get(source);
+            if (pending !== undefined) {
+                await pending;
+                if (!this.eventSubscriptions.has(source) &&
+                    !this.resetting &&
+                    (source === this.local || this.fallbacks.includes(source))) {
+                    await this.ensureEventObservers([source]);
+                }
+                return;
+            }
+            const generation = this.observerGeneration;
+            const current = () => !this.resetting &&
+                generation === this.observerGeneration &&
+                (source === this.local || this.fallbacks.includes(source));
+            const setup = (async () => {
+                const subscription = await subscribe(() => {
+                    if (current())
+                        this.eventEpoch++;
+                });
+                if (!current()) {
+                    await source.unsubscribe(subscription).catch(() => undefined);
+                    return;
+                }
+                this.eventSubscriptions.set(source, subscription);
+            })();
+            this.eventSetups.set(source, setup);
+            try {
+                await setup;
+            }
+            finally {
+                if (this.eventSetups.get(source) === setup)
+                    this.eventSetups.delete(source);
+            }
+        }));
+    }
+    async fallbackValidation(root, height) {
+        let valid = 0;
+        let invalid = 0;
+        let lastError;
+        for (const [index, fallback] of this.fallbacks.entries()) {
+            try {
+                const verdict = await fallback.isValidRootForHeight(root, height);
+                if (typeof verdict !== 'boolean') {
+                    throw new TypeError('Fallback ChainTracker returned a non-boolean Merkle-root verdict.');
+                }
+                if (verdict === true)
+                    valid++;
+                else
+                    invalid++;
+                if (valid >= this.requiredFallbackAgreement) {
+                    this.recordFallback(index);
+                    return true;
+                }
+                if (invalid >= this.requiredFallbackAgreement) {
+                    this.recordFallback(index);
+                    return false;
+                }
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        const error = lastError ??
+            new Error(`Fallback agreement unavailable: ${valid} valid and ${invalid} invalid responses, ` +
+                `${this.requiredFallbackAgreement} required.`);
+        this.recordError(error);
+        throw error;
+    }
+    recordFallback(index) {
+        this.status = {
+            ...this.status,
+            activeSource: `fallback-${index + 1}`,
+            lastFallbackAt: this.now().toISOString(),
+            lastError: undefined
+        };
+    }
+    recordError(error) {
+        this.status = { ...this.status, activeSource: 'unavailable', lastError: this.errorMessage(error) };
+    }
+    errorMessage(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+    validateAgreement(value, name) {
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new Error(`${name} must be a positive safe integer`);
+        return value;
+    }
+    validateHeightLag(value) {
+        if (!Number.isSafeInteger(value) || value < 0) {
+            throw new Error('maxHeightLag must be a non-negative safe integer');
+        }
+        return value;
+    }
+}
+exports.LocalChainTracker = LocalChainTracker;
+//# sourceMappingURL=LocalChainTracker.js.map

package/out/src/services/chaintracker/LocalChainTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalChainTracker.js","sourceRoot":"","sources":["../../../../src/services/chaintracker/LocalChainTracker.ts"],"names":[],"mappings":";;;AA6DA;;;;;;;;;GASG;AACH;IACU,KAAK,CAAsB;IAClB,SAAS,CAAwB;IACjC,oBAAoB,CAAS;IAC7B,yBAAyB,CAAQ;IACjC,4BAA4B,CAAQ;IACpC,YAAY,CAAQ;IACpB,WAAW,CAAS;IACpB,YAAY,CAA0C;IACtD,UAAU,CAAwC;IAClD,GAAG,CAAY;IACxB,mBAAmB,GAAG,CAAC,CAAA;IACvB,SAAS,GAAG,KAAK,CAAA;IACjB,UAAU,GAAG,CAAC,CAAA;IACd,kBAAkB,GAAG,CAAC,CAAA;IACb,kBAAkB,GAAG,IAAI,GAAG,EAAgC,CAAA;IAC5D,WAAW,GAAG,IAAI,GAAG,EAAuC,CAAA;IACrE,MAAM,CAAyB;IAEvC,YAAY,OAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAA;QAC/C,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,IAAI,CAAA;QAChE,IAAI,CAAC,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,CACrD,OAAO,CAAC,yBAAyB,IAAI,CAAC,EACtC,2BAA2B,CAC5B,CAAA;QACD,IAAI,CAAC,4BAA4B,GAAG,IAAI,CAAC,iBAAiB,CACxD,OAAO,CAAC,4BAA4B,IAAI,CAAC,EACzC,8BAA8B,CAC/B,CAAA;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAA;QAC/C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACxC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;QACpC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,eAAe;YACrC,YAAY,EAAE,OAAO,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;YACnE,WAAW,EAAE,WAAW;SACzB,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAA;IACzB,CAAC;IAED,OAAO,CAAC,IAA2B;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,mBAAmB,EAAE,CAAA;QACzD,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,IAAI;YACJ,YAAY,EAAE,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;SAC5D,CAAA;IACH,CAAC;IAED,0FAA0F;IAC1F,sBAAsB;QACpB,OAAO,qBAAqB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAA;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,2BAA2B,CAAC,MAAoB;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QACpC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC3B,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAA;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACzF,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE,CAAC,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAA;QAC5F,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC3B,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAA;QAC5D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QACzE,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE;YACjF,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACtC,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAC/D,CAAC,CAAC,CACH,CAAA;IACH,CAAC;IAED,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QACpC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;QACnD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;YAC1C,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YACnD,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAA;YAC7C,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YACnD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;YAClG,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YACnD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YACvB,IAAI,CAAC,IAAI,CAAC,oBAAoB;gBAAE,MAAM,KAAK,CAAA;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;YAC1C,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;YACnD,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,IAAY,EAAE,MAAc;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;QACpC,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QACrD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;YACxB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;gBAC5D,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAA;gBACvF,CAAC;gBACD,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;gBACrD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;gBAC7E,OAAO,KAAK,CAAA;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;gBACrD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;gBACvB,IAAI,CAAC,IAAI,CAAC,oBAAoB;oBAAE,MAAM,KAAK,CAAA;YAC7C,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACzD,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAA;QACrD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAA;QACjC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAA;QAC5B,OAAO,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QAClC,IAAI,UAAU,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;QAC/B,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;YACvE,WAAW,EAAE,WAAW;SACzB,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,MAAM,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAA;IAClD,CAAC;IAEO,KAAK,CAAC,wBAAwB,CAAC,aAAsB;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAA;YACvD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAA;YACxD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;gBACzC,IAAI,CAAC;oBACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAA;gBACnE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,SAAS,CAAA;gBAClB,CAAC;YACH,CAAC,CAAC,CACH,CAAA;YACD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CACjC,CAAC,KAAK,EAA4E,EAAE,CAAC,KAAK,IAAI,IAAI,CACnG,CAAA;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,GAAG;oBACZ,GAAG,IAAI,CAAC,MAAM;oBACd,YAAY,EAAE,OAAO;oBACrB,WAAW,EAAE,yBAAyB;oBACtC,WAAW;oBACX,YAAY;oBACZ,SAAS;oBACT,SAAS,EAAE,SAAS;iBACrB,CAAA;gBACD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;YACzB,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,4BAA4B,EAAE,CAAC;gBACzD,IAAI,CAAC,MAAM,GAAG;oBACZ,GAAG,IAAI,CAAC,MAAM;oBACd,YAAY,EAAE,OAAO;oBACrB,WAAW,EAAE,yBAAyB;oBACtC,WAAW;oBACX,YAAY;oBACZ,SAAS;oBACT,SAAS,EAAE,SAAS;iBACrB,CAAA;gBACD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;YACzB,CAAC;YAED,wEAAwE;YACxE,mEAAmE;YACnE,MAAM,eAAe,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAC7F,IAAI,CAAC,4BAA4B,GAAG,CAAC,CACtC,CAAA;YACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,eAAe,CAAC,CAAA;YAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,WAAW,CAAC,CAAA;YAC5D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;YAC1E,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CACxC,SAAS;iBACN,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,MAAM,IAAI,gBAAgB,CAAC;iBACzD,GAAG,CAAC,KAAK,EAAC,SAAS,EAAC,EAAE;gBACrB,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAA;gBACrE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,SAAS,CAAA;gBAClB,CAAC;YACH,CAAC,CAAC,CACL,CAAA;YACD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAA;YAC5C,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;gBACtC,IAAI,MAAM,IAAI,IAAI;oBAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACzF,CAAC;YACD,MAAM,CAAC,YAAY,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CACvE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CACpF,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;YAEtB,MAAM,gBAAgB,GAAG,kBAAkB,IAAI,IAAI,CAAC,4BAA4B,CAAA;YAChF,IAAI,WAAyC,CAAA;YAC7C,IAAI,CAAC,gBAAgB;gBAAE,WAAW,GAAG,yBAAyB,CAAA;iBACzD,IAAI,WAAW,EAAE,IAAI,KAAK,YAAY;gBAAE,WAAW,GAAG,UAAU,CAAA;iBAChE,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY;gBAAE,WAAW,GAAG,SAAS,CAAA;;gBAC1D,WAAW,GAAG,QAAQ,CAAA;YAC3B,IAAI,CAAC,MAAM,GAAG;gBACZ,GAAG,IAAI,CAAC,MAAM;gBACd,YAAY,EAAE,OAAO;gBACrB,WAAW;gBACX,WAAW;gBACX,YAAY;gBACZ,eAAe;gBACf,SAAS;gBACT,gBAAgB;gBAChB,YAAY;gBACZ,kBAAkB;gBAClB,SAAS;gBACT,SAAS,EAAE,SAAS;aACrB,CAAA;YAED,IACE,CAAC,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,SAAS,CAAC;gBACzD,aAAa;gBACb,IAAI,CAAC,WAAW;gBAChB,IAAI,CAAC,YAAY,IAAI,IAAI;gBACzB,YAAY,IAAI,IAAI,EACpB,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;gBAC/B,MAAM,IAAI,CAAC,UAAU,CACnB,KAAK,EACL,KAAK,IAAI,EAAE,CACT,MAAM,IAAI,CAAC,YAAa,CAAC;oBACvB,MAAM,EAAE,WAAW;oBACnB,WAAW;oBACX,eAAe;oBACf,SAAS;oBACT,gBAAgB;oBAChB,YAAY;oBACZ,kBAAkB;iBACnB,CAAC,CACL,CAAA;gBACD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;gBAC5C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAA;gBAC5D,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,SAAS,EAAE,WAAW,EAAE,CAAA;YAC7C,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,GAAG;gBACZ,GAAG,IAAI,CAAC,MAAM;gBACd,WAAW,EAAE,OAAO;gBACpB,SAAS;gBACT,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;aACpC,CAAA;YACD,OAAO,IAAI,CAAC,SAAS,EAAE,CAAA;QACzB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,IAAI,SAAkB,CAAA;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,gBAAgB,EAAE,CAAA;gBAChD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;gBAC1B,OAAO,MAAM,CAAA;YACf,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAA;YACnB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,IAAI,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QACrF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACvB,MAAM,KAAK,CAAA;IACb,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChF,CAAC;IAEO,WAAW,CAAC,IAA4B,EAAE,KAA6B;QAC7E,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/F,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,SAA8C;QACpF,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;QACpB,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAA;QAC/B,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;IACxB,CAAC;IAEO,aAAa;QACnB,MAAM,MAAM,GAAG,CAAC,MAA4B,EAAU,EAAE;YACtD,MAAM,QAAQ,GAAG,MAAmF,CAAA;YACpG,OAAO,MAAM,CAAC,QAAQ,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,CAAC,CAAA;QACD,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,CAAC,mBAAmB;YACxB,IAAI,CAAC,SAAS;YACd,IAAI,CAAC,MAAM,CAAC,IAAI;YAChB,IAAI,CAAC,UAAU;YACf,IAAI,CAAC,kBAAkB;YACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YAClB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;SAC3B,CAAC,CAAA;IACJ,CAAC;IAEO,oBAAoB,CAAC,OAAe,EAAE,SAAiB;QAC7D,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,6CAA6C,SAAS,EAAE,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,MAAoB;QACzC,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI;YAAE,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAC1G,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,mBAAmB,EAAE,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;QACrB,OAAO,IAAI,CAAC,mBAAmB,CAAA;IACjC,CAAC;IAEO,gBAAgB,CAAC,KAAa;QACpC,IAAI,KAAK,KAAK,IAAI,CAAC,mBAAmB;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnG,CAAC;IAEO,cAAc,CAAC,MAA4B;QACjD,IAAI,MAAM,CAAC,mBAAmB,KAAK,KAAK;YAAE,OAAO,SAAS,CAAA;QAC1D,MAAM,MAAM,GAAG,MAEd,CAAA;QACD,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,UAAU;YAAE,OAAO,KAAK,EAAC,QAAQ,EAAC,EAAE,CAAC,MAAM,MAAM,CAAC,eAAgB,CAAC,QAAQ,CAAC,CAAA;QAClH,IAAI,MAAM,CAAC,mBAAmB,KAAK,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAA;QACtG,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,OAA+B;QAChE,MAAM,OAAO,CAAC,GAAG,CACf,OAAO,CAAC,GAAG,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE;YACzB,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAC7C,IAAI,SAAS,IAAI,IAAI;gBAAE,OAAM;YAC7B,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAM;YAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,OAAO,CAAA;gBACb,IACE,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC;oBACpC,CAAC,IAAI,CAAC,SAAS;oBACf,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC1D,CAAC;oBACD,MAAM,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;gBAC3C,CAAC;gBACD,OAAM;YACR,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAA;YAC1C,MAAM,OAAO,GAAG,GAAY,EAAE,CAC5B,CAAC,IAAI,CAAC,SAAS;gBACf,UAAU,KAAK,IAAI,CAAC,kBAAkB;gBACtC,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;YAC5D,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE;gBACxB,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;oBACxC,IAAI,OAAO,EAAE;wBAAE,IAAI,CAAC,UAAU,EAAE,CAAA;gBAClC,CAAC,CAAC,CAAA;gBACF,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;oBACf,MAAM,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;oBAC7D,OAAM;gBACR,CAAC;gBACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;YACnD,CAAC,CAAC,EAAE,CAAA;YACJ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;YACnC,IAAI,CAAC;gBACH,MAAM,KAAK,CAAA;YACb,CAAC;oBAAS,CAAC;gBACT,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK;oBAAE,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YAC7E,CAAC;QACH,CAAC,CAAC,CACH,CAAA;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,IAAY,EAAE,MAAc;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,IAAI,OAAO,GAAG,CAAC,CAAA;QACf,IAAI,SAAkB,CAAA;QACtB,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YACzD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;gBACjE,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;oBACjC,MAAM,IAAI,SAAS,CAAC,mEAAmE,CAAC,CAAA;gBAC1F,CAAC;gBACD,IAAI,OAAO,KAAK,IAAI;oBAAE,KAAK,EAAE,CAAA;;oBACxB,OAAO,EAAE,CAAA;gBACd,IAAI,KAAK,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;oBAC5C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;oBAC1B,OAAO,IAAI,CAAA;gBACb,CAAC;gBACD,IAAI,OAAO,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;oBAC9C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;oBAC1B,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,CAAA;YACnB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GACT,SAAS;YACT,IAAI,KAAK,CACP,mCAAmC,KAAK,cAAc,OAAO,sBAAsB;gBACjF,GAAG,IAAI,CAAC,yBAAyB,YAAY,CAChD,CAAA;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACvB,MAAM,KAAK,CAAA;IACb,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,YAAY,EAAE,YAAY,KAAK,GAAG,CAAC,EAAE;YACrC,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACxC,SAAS,EAAE,SAAS;SACrB,CAAA;IACH,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAA;IACpG,CAAC;IAEO,YAAY,CAAC,KAAc;QACjC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC;IAEO,iBAAiB,CAAC,KAAa,EAAE,IAAY;QACnD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kCAAkC,CAAC,CAAA;QACzG,OAAO,KAAK,CAAA;IACd,CAAC;IAEO,iBAAiB,CAAC,KAAa;QACrC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}

package/out/src/services/chaintracker/chaintracks/Api/BlockHeaderApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockHeaderApi.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAE7F,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAE7F;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAMD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,IAAI,eAAe,CAEvF;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,CAAA;AAE5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,eAAe,CAEnF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,WAAW,CAE3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,eAAe,CAEnF"}
+{"version":3,"file":"BlockHeaderApi.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAE7F,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAE7F;;;GAGG;AACH,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAChC;AAmDD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,IAAI,eAAe,CAEvF;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,CAAA;AAE5E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,eAAe,CAGnF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,WAAW,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,eAAe,CAgBnF"}

package/out/src/services/chaintracker/chaintracks/Api/BlockHeaderApi.js

@@ -4,35 +4,87 @@ exports.isLive = isLive;
 exports.isBaseBlockHeader = isBaseBlockHeader;
 exports.isBlockHeader = isBlockHeader;
 exports.isLiveBlockHeader = isLiveBlockHeader;
-//
-// TYPE GUARDS
-//
+function dataProperties(value) {
+    if (value == null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    try {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            return undefined;
+        const descriptors = Object.getOwnPropertyDescriptors(value);
+        if (Object.keys(descriptors).length > 64 || Object.values(descriptors).some(d => d.get != null || d.set != null)) {
+            return undefined;
+        }
+        return descriptors;
+    }
+    catch {
+        return undefined;
+    }
+}
+function valueOf(properties, name) {
+    const property = properties[name];
+    return property != null && Object.prototype.hasOwnProperty.call(property, 'value') ? property.value : undefined;
+}
+function isUint32(value) {
+    return Number.isSafeInteger(value) && value >= 0 && value <= 0xffffffff;
+}
+function isHeight(value) {
+    return Number.isSafeInteger(value) && value >= 0 && value <= 0x7fffffff;
+}
+function isHash(value) {
+    return typeof value === 'string' && /^[0-9a-fA-F]{64}$/.test(value);
+}
+function hasBaseHeaderShape(properties) {
+    return (isUint32(valueOf(properties, 'version')) &&
+        isHash(valueOf(properties, 'previousHash')) &&
+        isHash(valueOf(properties, 'merkleRoot')) &&
+        isUint32(valueOf(properties, 'time')) &&
+        isUint32(valueOf(properties, 'bits')) &&
+        isUint32(valueOf(properties, 'nonce')));
+}
 /**
  * Type guard function.
  * @publicbody
  */
 function isLive(header) {
-    return header.headerId !== undefined;
+    return isLiveBlockHeader(header);
 }
 /**
  * Type guard function.
  * @publicbody
  */
 function isBaseBlockHeader(header) {
-    return typeof header.previousHash === 'string';
+    const properties = dataProperties(header);
+    return properties != null && hasBaseHeaderShape(properties);
 }
 /**
  * Type guard function.
  * @publicbody
  */
 function isBlockHeader(header) {
-    return 'height' in header && typeof header.previousHash === 'string';
+    const properties = dataProperties(header);
+    return (properties != null &&
+        hasBaseHeaderShape(properties) &&
+        isHeight(valueOf(properties, 'height')) &&
+        isHash(valueOf(properties, 'hash')));
 }
 /**
  * Type guard function.
  * @publicbody
  */
 function isLiveBlockHeader(header) {
-    return 'chainWork' in header && typeof header.previousHash === 'string';
+    const properties = dataProperties(header);
+    const headerId = properties == null ? undefined : valueOf(properties, 'headerId');
+    const previousHeaderId = properties == null ? undefined : valueOf(properties, 'previousHeaderId');
+    return (properties != null &&
+        hasBaseHeaderShape(properties) &&
+        isHeight(valueOf(properties, 'height')) &&
+        isHash(valueOf(properties, 'hash')) &&
+        isHash(valueOf(properties, 'chainWork')) &&
+        Number.isSafeInteger(headerId) &&
+        headerId >= 1 &&
+        (previousHeaderId === null || (Number.isSafeInteger(previousHeaderId) && previousHeaderId >= 1)) &&
+        typeof valueOf(properties, 'isActive') === 'boolean' &&
+        typeof valueOf(properties, 'isChainTip') === 'boolean');
 }
 //# sourceMappingURL=BlockHeaderApi.js.map

package/out/src/services/chaintracker/chaintracks/Api/BlockHeaderApi.js.map

@@ -1 +1 @@
-{"version":3,"file":"BlockHeaderApi.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts"],"names":[],"mappings":";;;;;;AAqCA,EAAE;AACF,cAAc;AACd,EAAE;AAEF;;;GAGG;AACH,gBAAuB,MAAqC;IAC1D,OAAQ,MAA0B,CAAC,QAAQ,KAAK,SAAS,CAAA;AAC3D,CAAC;AAKD;;;GAGG;AACH,2BAAkC,MAAsB;IACtD,OAAO,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAA;AAChD,CAAC;AAED;;;GAGG;AACH,uBAA8B,MAAsB;IAClD,OAAO,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,2BAAkC,MAAsB;IACtD,OAAO,WAAW,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAA;AACzE,CAAC"}
+{"version":3,"file":"BlockHeaderApi.js","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/Api/BlockHeaderApi.ts"],"names":[],"mappings":"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"}

package/out/src/services/chaintracker/chaintracks/Api/BulkFileDataCacheApi.d.ts

@@ -0,0 +1,48 @@
+import type { BulkHeaderFileInfo } from '../util/BulkHeaderFile';
+/**
+ * Persistent backing cache for immutable bulk-header objects.
+ *
+ * Implementations may read packaged checkpoint assets, application storage,
+ * or a filesystem. The manager validates the byte length and SHA-256 digest
+ * before using any returned value or persisting a downloaded value.
+ *
+ * @public
+ */
+export interface BulkFileDataCacheApi {
+    get(file: Readonly<BulkHeaderFileInfo>): Promise<Uint8Array | undefined>;
+    set(file: Readonly<BulkHeaderFileInfo>, data: Uint8Array): Promise<void>;
+    /**
+     * Preserve a rejected object outside the active cache namespace. The manager
+     * calls this before attempting a replacement and never removes a last-good
+     * object merely because a newer source is unavailable.
+     */
+    quarantine?(file: Readonly<BulkHeaderFileInfo>, reason: string, 
+    /** Exact rejected bytes, used to avoid quarantining a concurrent replacement. */
+    rejectedData?: Uint8Array): Promise<void>;
+    /**
+     * Promote a validated legacy entry into the implementation's preferred
+     * immutable namespace. Implementations should make this idempotent.
+     */
+    promoteValidated?(file: Readonly<BulkHeaderFileInfo>, data: Uint8Array): Promise<void>;
+    delete?(file: Readonly<BulkHeaderFileInfo>): Promise<void>;
+}
+/**
+ * A deployment-defined budget for remote bulk-header downloads.
+ * Implementations should throw before the request when the requested byte
+ * reservation would exceed the configured budget.
+ *
+ * @public
+ */
+export interface BulkFileDownloadBudgetApi {
+    consume(byteCount: number): void | Promise<void>;
+    snapshot?(): BulkFileDownloadBudgetSnapshot;
+}
+/** @public */
+export interface BulkFileDownloadBudgetSnapshot {
+    maxBytes: number;
+    consumedBytes: number;
+    remainingBytes: number;
+    windowStartedAt: number;
+    windowMsecs: number;
+}
+//# sourceMappingURL=BulkFileDataCacheApi.d.ts.map

package/out/src/services/chaintracker/chaintracks/Api/BulkFileDataCacheApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkFileDataCacheApi.d.ts","sourceRoot":"","sources":["../../../../../../src/services/chaintracker/chaintracks/Api/BulkFileDataCacheApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IACxE,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE;;;;OAIG;IACH,UAAU,CAAC,CACT,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAClC,MAAM,EAAE,MAAM;IACd,iFAAiF;IACjF,YAAY,CAAC,EAAE,UAAU,GACxB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB;;;OAGG;IACH,gBAAgB,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF,MAAM,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,8BAA8B,CAAA;CAC5C;AAED,cAAc;AACd,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;CACpB"}

package/out/src/services/chaintracker/chaintracks/Api/BulkFileDataCacheApi.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BulkFileDataCacheApi.js.map