@lodestar/beacon-node 1.38.0 → 1.39.0-dev.39dac0f03d

package/lib/eth1/eth1DepositsCache.js

@@ -1,119 +0,0 @@
-import { byteArrayEquals } from "@chainsafe/ssz";
-import { ssz } from "@lodestar/types";
-import { Eth1Error, Eth1ErrorCode } from "./errors.js";
-import { getDepositsWithProofs } from "./utils/deposits.js";
-import { getEth1DataForBlocks } from "./utils/eth1Data.js";
-import { assertConsecutiveDeposits } from "./utils/eth1DepositEvent.js";
-export class Eth1DepositsCache {
-    unsafeAllowDepositDataOverwrite;
-    db;
-    config;
-    constructor(opts, config, db) {
-        this.config = config;
-        this.db = db;
-        this.unsafeAllowDepositDataOverwrite = opts.unsafeAllowDepositDataOverwrite ?? false;
-    }
-    /**
-     * Returns a list of `Deposit` objects, within the given deposit index `range`.
-     *
-     * The `depositCount` is used to generate the proofs for the `Deposits`. For example, if we
-     * have 100 proofs, but the Ethereum Consensus chain only acknowledges 50 of them, we must produce our
-     * proofs with respect to a tree size of 50.
-     */
-    async get(indexRange, eth1Data) {
-        const depositEvents = await this.db.depositEvent.values(indexRange);
-        const depositRootTree = await this.db.depositDataRoot.getDepositRootTree();
-        return getDepositsWithProofs(depositEvents, depositRootTree, eth1Data);
-    }
-    /**
-     * Add log to cache
-     * This function enforces that `logs` are imported one-by-one with consecutive indexes
-     */
-    async add(depositEvents) {
-        assertConsecutiveDeposits(depositEvents);
-        const lastLog = await this.db.depositEvent.lastValue();
-        const firstEvent = depositEvents[0];
-        // Check, validate and skip if we got any deposit events already present in DB
-        // This can happen if the remote eth1/EL resets its head in these four scenarios:
-        //   1. Remote eth1/EL resynced/restarted from head behind its previous head pre-merge
-        //   2. In a post merge scenario, Lodestar restarted from finalized state from DB which
-        //      generally is a few epochs behind the last synced head. This causes eth1 tracker to reset
-        //      and refetch the deposits as the lodestar syncs further along (Post merge there is 1-1
-        //      correspondence between EL and CL blocks)
-        //   3. The EL reorged beyond the eth1 follow distance.
-        //
-        // While 1. & 2. are benign and we handle them below by checking if the duplicate log fetched
-        // is same as one written in DB. Refer to this issue for some data dump of how this happens
-        // https://github.com/ChainSafe/lodestar/issues/3674
-        //
-        // If the duplicate log fetched is not same as written in DB then its probablu scenario 3.
-        // which would be a catastrophic event for the network (or we messed up real bad!!!).
-        //
-        // So we provide for a way to overwrite this log without deleting full db via
-        // --unsafeAllowDepositDataOverwrite cli flag which will just overwrite the previous tracker data
-        // if any. This option as indicated by its name is unsafe and to be only used if you know what
-        // you are doing.
-        if (lastLog !== null && firstEvent !== undefined) {
-            const newIndex = firstEvent.index;
-            const lastLogIndex = lastLog.index;
-            if (!this.unsafeAllowDepositDataOverwrite && firstEvent.index <= lastLog.index) {
-                // lastLogIndex - newIndex + 1 events are duplicate since this is a consecutive log
-                // as asserted by assertConsecutiveDeposits. Splice those events out from depositEvents.
-                const skipEvents = depositEvents.splice(0, lastLogIndex - newIndex + 1);
-                // After splicing skipEvents will contain duplicate events to be checked and validated
-                // and rest of the remaining events in depositEvents could be safely written to DB and
-                // move the tracker along.
-                for (const depositEvent of skipEvents) {
-                    const prevDBSerializedEvent = await this.db.depositEvent.getBinary(depositEvent.index);
-                    if (!prevDBSerializedEvent) {
-                        throw new Eth1Error({ code: Eth1ErrorCode.MISSING_DEPOSIT_LOG, newIndex, lastLogIndex });
-                    }
-                    const serializedEvent = ssz.phase0.DepositEvent.serialize(depositEvent);
-                    if (!byteArrayEquals(prevDBSerializedEvent, serializedEvent)) {
-                        throw new Eth1Error({ code: Eth1ErrorCode.DUPLICATE_DISTINCT_LOG, newIndex, lastLogIndex });
-                    }
-                }
-            }
-            else if (newIndex > lastLogIndex + 1) {
-                // deposit events need to be consective, the way we fetch our tracker. If the deposit event
-                // is not consecutive it means either our tracker, or the corresponding eth1/EL
-                // node or the database has messed up. All these failures are critical and the tracker
-                // shouldn't proceed without the resolution of this error.
-                throw new Eth1Error({ code: Eth1ErrorCode.NON_CONSECUTIVE_LOGS, newIndex, lastLogIndex });
-            }
-        }
-        const depositRoots = depositEvents.map((depositEvent) => ({
-            index: depositEvent.index,
-            root: ssz.phase0.DepositData.hashTreeRoot(depositEvent.depositData),
-        }));
-        // Store events after verifying that data is consecutive
-        // depositDataRoot will throw if adding non consecutive roots
-        await this.db.depositDataRoot.batchPutValues(depositRoots);
-        await this.db.depositEvent.batchPutValues(depositEvents);
-    }
-    /**
-     * Appends partial eth1 data (depositRoot, depositCount) in a block range (inclusive)
-     * Returned array is sequential and ascending in blockNumber
-     * @param fromBlock
-     * @param toBlock
-     */
-    async getEth1DataForBlocks(blocks, lastProcessedDepositBlockNumber) {
-        const highestBlock = blocks.at(-1)?.blockNumber;
-        return getEth1DataForBlocks(blocks, this.db.depositEvent.valuesStream({ lte: highestBlock, reverse: true }), await this.db.depositDataRoot.getDepositRootTree(), lastProcessedDepositBlockNumber);
-    }
-    /**
-     * Returns the highest blockNumber stored in DB if any
-     */
-    async getHighestDepositEventBlockNumber() {
-        const latestEvent = await this.db.depositEvent.lastValue();
-        return latestEvent?.blockNumber || null;
-    }
-    /**
-     * Returns the lowest blockNumber stored in DB if any
-     */
-    async getLowestDepositEventBlockNumber() {
-        const firstEvent = await this.db.depositEvent.firstValue();
-        return firstEvent?.blockNumber || null;
-    }
-}
-//# sourceMappingURL=eth1DepositsCache.js.map

package/lib/eth1/eth1DepositsCache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"eth1DepositsCache.js","sourceRoot":"","sources":["../../src/eth1/eth1DepositsCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAS,GAAG,EAAC,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAC,SAAS,EAAE,aAAa,EAAC,MAAM,aAAa,CAAC;AAErD,OAAO,EAAC,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAC,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAC,yBAAyB,EAAC,MAAM,6BAA6B,CAAC;AAEtE,MAAM,OAAO,iBAAiB;IAC5B,+BAA+B,CAAU;IACzC,EAAE,CAAY;IACd,MAAM,CAAkB;IAExB,YAAY,IAAiD,EAAE,MAAuB,EAAE,EAAa;QACnG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,+BAA+B,GAAG,IAAI,CAAC,+BAA+B,IAAI,KAAK,CAAC;IACvF,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,UAAiC,EAAE,QAAyB;QACpE,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpE,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC3E,OAAO,qBAAqB,CAAC,aAAa,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,aAAoC;QAC5C,yBAAyB,CAAC,aAAa,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAEpC,8EAA8E;QAC9E,iFAAiF;QACjF,sFAAsF;QACtF,uFAAuF;QACvF,gGAAgG;QAChG,6FAA6F;QAC7F,gDAAgD;QAChD,uDAAuD;QACvD,EAAE;QACF,6FAA6F;QAC7F,2FAA2F;QAC3F,oDAAoD;QACpD,EAAE;QACF,0FAA0F;QAC1F,qFAAqF;QACrF,EAAE;QACF,6EAA6E;QAC7E,iGAAiG;QACjG,8FAA8F;QAC9F,iBAAiB;QACjB,IAAI,OAAO,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;YAClC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;YAEnC,IAAI,CAAC,IAAI,CAAC,+BAA+B,IAAI,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC/E,mFAAmF;gBACnF,wFAAwF;gBACxF,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,YAAY,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;gBACxE,sFAAsF;gBACtF,sFAAsF;gBACtF,0BAA0B;gBAC1B,KAAK,MAAM,YAAY,IAAI,UAAU,EAAE,CAAC;oBACtC,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;oBACvF,IAAI,CAAC,qBAAqB,EAAE,CAAC;wBAC3B,MAAM,IAAI,SAAS,CAAC,EAAC,IAAI,EAAE,aAAa,CAAC,mBAAmB,EAAE,QAAQ,EAAE,YAAY,EAAC,CAAC,CAAC;oBACzF,CAAC;oBACD,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;oBACxE,IAAI,CAAC,eAAe,CAAC,qBAAqB,EAAE,eAAe,CAAC,EAAE,CAAC;wBAC7D,MAAM,IAAI,SAAS,CAAC,EAAC,IAAI,EAAE,aAAa,CAAC,sBAAsB,EAAE,QAAQ,EAAE,YAAY,EAAC,CAAC,CAAC;oBAC5F,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,QAAQ,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC;gBACvC,2FAA2F;gBAC3F,+EAA+E;gBAC/E,sFAAsF;gBACtF,0DAA0D;gBAC1D,MAAM,IAAI,SAAS,CAAC,EAAC,IAAI,EAAE,aAAa,CAAC,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAC,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACxD,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,CAAC;SACpE,CAAC,CAAC,CAAC;QAEJ,wDAAwD;QACxD,6DAA6D;QAC7D,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,oBAAoB,CACxB,MAAmB,EACnB,+BAA8C;QAE9C,MAAM,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC;QAChD,OAAO,oBAAoB,CACzB,MAAM,EACN,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,EAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,EACrE,MAAM,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,kBAAkB,EAAE,EAClD,+BAA+B,CAChC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iCAAiC;QACrC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAC3D,OAAO,WAAW,EAAE,WAAW,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gCAAgC;QACpC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;QAC3D,OAAO,UAAU,EAAE,WAAW,IAAI,IAAI,CAAC;IACzC,CAAC;CACF"}

package/lib/eth1/eth1MergeBlockTracker.d.ts

@@ -1,65 +0,0 @@
-import { ChainConfig } from "@lodestar/config";
-import { Logger } from "@lodestar/utils";
-import { Metrics } from "../metrics/index.js";
-import { EthJsonRpcBlockRaw, IEth1Provider, PowMergeBlock, TDProgress } from "./interface.js";
-export declare enum StatusCode {
-    STOPPED = "STOPPED",
-    SEARCHING = "SEARCHING",
-    FOUND = "FOUND"
-}
-export type Eth1MergeBlockTrackerModules = {
-    config: ChainConfig;
-    logger: Logger;
-    signal: AbortSignal;
-    metrics: Metrics | null;
-};
-/**
- * Follows the eth1 chain to find a (or multiple?) merge blocks that cross the threshold of total terminal difficulty
- *
- * Finding the mergeBlock could be done in demand when proposing pre-merge blocks. However, that would slow block
- * production during the weeks between BELLATRIX_EPOCH and TTD.
- */
-export declare class Eth1MergeBlockTracker {
-    private readonly eth1Provider;
-    private readonly config;
-    private readonly logger;
-    private readonly metrics;
-    private readonly blocksByHashCache;
-    private readonly intervals;
-    private status;
-    private latestEth1Block;
-    private getTerminalPowBlockFromEth1Promise;
-    private readonly safeTDFactor;
-    constructor({ config, logger, signal, metrics }: Eth1MergeBlockTrackerModules, eth1Provider: IEth1Provider);
-    /**
-     * Returns the most recent POW block that satisfies the merge block condition
-     */
-    getTerminalPowBlock(): Promise<PowMergeBlock | null>;
-    getTDProgress(): TDProgress | null;
-    /**
-     * Get a POW block by hash checking the local cache first
-     */
-    getPowBlock(powBlockHash: string): Promise<PowMergeBlock | null>;
-    /**
-     * Should only start polling for mergeBlock if:
-     * - after BELLATRIX_FORK_EPOCH
-     * - Beacon node synced
-     * - head state not isMergeTransitionComplete
-     */
-    startPollingMergeBlock(): void;
-    private close;
-    private getTerminalPowBlockFromEth1;
-    /**
-     * **internal** + **unsafe** since it can create multiple backward searches that overload the eth1 client.
-     * Must be called in a wrapper to ensure that there's only once concurrent call to this fn.
-     */
-    private internalGetTerminalPowBlockFromEth1;
-    private cacheBlock;
-}
-export declare function toPowBlock(block: EthJsonRpcBlockRaw): PowMergeBlock;
-/**
- * TTD values can be very large, for xDAI > 1e45. So scale down.
- * To be good, TTD should be rendered as a number < Number.MAX_TD_RENDER_VALUE ~= 9e15
- */
-export declare function getSafeTDFactor(ttd: bigint): bigint;
-//# sourceMappingURL=eth1MergeBlockTracker.d.ts.map

package/lib/eth1/eth1MergeBlockTracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"eth1MergeBlockTracker.d.ts","sourceRoot":"","sources":["../../src/eth1/eth1MergeBlockTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAC,MAAM,EAA2B,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAE5C,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAA0B,UAAU,EAAC,MAAM,gBAAgB,CAAC;AAGpH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAkBD,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACzB,CAAC;AAIF;;;;;GAKG;AACH,qBAAa,qBAAqB;IAe9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAd/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,kCAAkC,CAA8C;IACxF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGpC,EAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAC,EAAE,4BAA4B,EAC9C,YAAY,EAAE,aAAa;IAiC9C;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAe1D,aAAa,IAAI,UAAU,GAAG,IAAI;IAsBlC;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkBtE;;;;;OAKG;IACH,sBAAsB,IAAI,IAAI;IAsB9B,OAAO,CAAC,KAAK;YAIC,2BAA2B;IA4CzC;;;OAGG;YACW,mCAAmC;IA6DjD,OAAO,CAAC,UAAU;CAInB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CAQnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/lib/eth1/eth1MergeBlockTracker.js

@@ -1,262 +0,0 @@
-import { pruneSetToMax, toRootHex } from "@lodestar/utils";
-import { ZERO_HASH_HEX } from "../constants/index.js";
-import { enumToIndexMap } from "../util/enum.js";
-import { dataToRootHex, quantityToBigint, quantityToNum } from "./provider/utils.js";
-export var StatusCode;
-(function (StatusCode) {
-    StatusCode["STOPPED"] = "STOPPED";
-    StatusCode["SEARCHING"] = "SEARCHING";
-    StatusCode["FOUND"] = "FOUND";
-})(StatusCode || (StatusCode = {}));
-/** For metrics, index order = declaration order of StatusCode  */
-const statusCodeIdx = enumToIndexMap(StatusCode);
-/**
- * Bounds `blocksByHashCache` cache, imposing a max distance between highest and lowest block numbers.
- * In case of extreme forking the cache might grow unbounded.
- */
-const MAX_CACHE_POW_BLOCKS = 1024;
-const MAX_TD_RENDER_VALUE = Number.MAX_SAFE_INTEGER;
-// get_pow_block_at_total_difficulty
-/**
- * Follows the eth1 chain to find a (or multiple?) merge blocks that cross the threshold of total terminal difficulty
- *
- * Finding the mergeBlock could be done in demand when proposing pre-merge blocks. However, that would slow block
- * production during the weeks between BELLATRIX_EPOCH and TTD.
- */
-export class Eth1MergeBlockTracker {
-    eth1Provider;
-    config;
-    logger;
-    metrics;
-    blocksByHashCache = new Map();
-    intervals = [];
-    status;
-    latestEth1Block = null;
-    getTerminalPowBlockFromEth1Promise = null;
-    safeTDFactor;
-    constructor({ config, logger, signal, metrics }, eth1Provider) {
-        this.eth1Provider = eth1Provider;
-        this.config = config;
-        this.logger = logger;
-        this.metrics = metrics;
-        this.status = { code: StatusCode.STOPPED };
-        signal.addEventListener("abort", () => this.close(), { once: true });
-        this.safeTDFactor = getSafeTDFactor(this.config.TERMINAL_TOTAL_DIFFICULTY);
-        const scaledTTD = this.config.TERMINAL_TOTAL_DIFFICULTY / this.safeTDFactor;
-        // Only run metrics if necessary
-        if (metrics) {
-            // TTD can't be dynamically changed during execution, register metric once
-            metrics.eth1.eth1MergeTTD.set(Number(scaledTTD));
-            metrics.eth1.eth1MergeTDFactor.set(Number(this.safeTDFactor));
-            metrics.eth1.eth1MergeStatus.addCollect(() => {
-                // Set merge ttd, merge status and merge block status
-                metrics.eth1.eth1MergeStatus.set(statusCodeIdx[this.status.code]);
-                if (this.latestEth1Block !== null) {
-                    // Set latestBlock stats
-                    metrics.eth1.eth1LatestBlockNumber.set(this.latestEth1Block.number);
-                    metrics.eth1.eth1LatestBlockTD.set(Number(this.latestEth1Block.totalDifficulty / this.safeTDFactor));
-                    metrics.eth1.eth1LatestBlockTimestamp.set(this.latestEth1Block.timestamp);
-                }
-            });
-        }
-    }
-    /**
-     * Returns the most recent POW block that satisfies the merge block condition
-     */
-    async getTerminalPowBlock() {
-        switch (this.status.code) {
-            case StatusCode.STOPPED:
-                // If not module is not polling fetch the mergeBlock explicitly
-                return this.getTerminalPowBlockFromEth1();
-            case StatusCode.SEARCHING:
-                // Assume that polling would have found the block
-                return null;
-            case StatusCode.FOUND:
-                return this.status.mergeBlock;
-        }
-    }
-    getTDProgress() {
-        if (this.latestEth1Block === null) {
-            return this.latestEth1Block;
-        }
-        const tdDiff = this.config.TERMINAL_TOTAL_DIFFICULTY - this.latestEth1Block.totalDifficulty;
-        if (tdDiff > BigInt(0)) {
-            return {
-                ttdHit: false,
-                tdFactor: this.safeTDFactor,
-                tdDiffScaled: Number((tdDiff / this.safeTDFactor)),
-                ttd: this.config.TERMINAL_TOTAL_DIFFICULTY,
-                td: this.latestEth1Block.totalDifficulty,
-                timestamp: this.latestEth1Block.timestamp,
-            };
-        }
-        return {
-            ttdHit: true,
-        };
-    }
-    /**
-     * Get a POW block by hash checking the local cache first
-     */
-    async getPowBlock(powBlockHash) {
-        // Check cache first
-        const cachedBlock = this.blocksByHashCache.get(powBlockHash);
-        if (cachedBlock) {
-            return cachedBlock;
-        }
-        // Fetch from node
-        const blockRaw = await this.eth1Provider.getBlockByHash(powBlockHash);
-        if (blockRaw) {
-            const block = toPowBlock(blockRaw);
-            this.cacheBlock(block);
-            return block;
-        }
-        return null;
-    }
-    /**
-     * Should only start polling for mergeBlock if:
-     * - after BELLATRIX_FORK_EPOCH
-     * - Beacon node synced
-     * - head state not isMergeTransitionComplete
-     */
-    startPollingMergeBlock() {
-        if (this.status.code !== StatusCode.STOPPED) {
-            return;
-        }
-        this.status = { code: StatusCode.SEARCHING };
-        this.logger.info("Starting search for terminal POW block", {
-            TERMINAL_TOTAL_DIFFICULTY: this.config.TERMINAL_TOTAL_DIFFICULTY,
-        });
-        const interval = setInterval(() => {
-            // Preemptively try to find merge block and cache it if found.
-            // Future callers of getTerminalPowBlock() will re-use the cached found mergeBlock.
-            this.getTerminalPowBlockFromEth1().catch((e) => {
-                this.logger.error("Error on findMergeBlock", {}, e);
-                this.metrics?.eth1.eth1PollMergeBlockErrors.inc();
-            });
-        }, this.config.SECONDS_PER_ETH1_BLOCK * 1000);
-        this.intervals.push(interval);
-    }
-    close() {
-        this.intervals.forEach(clearInterval);
-    }
-    async getTerminalPowBlockFromEth1() {
-        if (!this.getTerminalPowBlockFromEth1Promise) {
-            this.getTerminalPowBlockFromEth1Promise = this.internalGetTerminalPowBlockFromEth1()
-                .then((mergeBlock) => {
-                // Persist found merge block here to affect both caller paths:
-                // - internal searcher
-                // - external caller if STOPPED
-                if (mergeBlock && this.status.code !== StatusCode.FOUND) {
-                    if (this.status.code === StatusCode.SEARCHING) {
-                        this.close();
-                    }
-                    this.logger.info("Terminal POW block found!", {
-                        hash: mergeBlock.blockHash,
-                        number: mergeBlock.number,
-                        totalDifficulty: mergeBlock.totalDifficulty,
-                    });
-                    this.status = { code: StatusCode.FOUND, mergeBlock };
-                    this.metrics?.eth1.eth1MergeBlockDetails.set({
-                        terminalBlockHash: mergeBlock.blockHash,
-                        // Convert all number/bigints to string labels
-                        terminalBlockNumber: mergeBlock.number.toString(10),
-                        terminalBlockTD: mergeBlock.totalDifficulty.toString(10),
-                    }, 1);
-                }
-                return mergeBlock;
-            })
-                .finally(() => {
-                this.getTerminalPowBlockFromEth1Promise = null;
-            });
-        }
-        else {
-            // This should no happen, since getTerminalPowBlockFromEth1() should resolve faster than SECONDS_PER_ETH1_BLOCK.
-            // else something is wrong: the el-cl comms are two slow, or the backsearch got stuck in a deep search.
-            this.metrics?.eth1.getTerminalPowBlockPromiseCacheHit.inc();
-        }
-        return this.getTerminalPowBlockFromEth1Promise;
-    }
-    /**
-     * **internal** + **unsafe** since it can create multiple backward searches that overload the eth1 client.
-     * Must be called in a wrapper to ensure that there's only once concurrent call to this fn.
-     */
-    async internalGetTerminalPowBlockFromEth1() {
-        // Search merge block by hash
-        // Terminal block hash override takes precedence over terminal total difficulty
-        const terminalBlockHash = toRootHex(this.config.TERMINAL_BLOCK_HASH);
-        if (terminalBlockHash !== ZERO_HASH_HEX) {
-            const block = await this.getPowBlock(terminalBlockHash);
-            if (block) {
-                return block;
-            }
-            // if a TERMINAL_BLOCK_HASH other than ZERO_HASH is configured and we can't find it, return NONE
-            return null;
-        }
-        // Search merge block by TTD
-        const latestBlockRaw = await this.eth1Provider.getBlockByNumber("latest");
-        if (!latestBlockRaw) {
-            throw Error("getBlockByNumber('latest') returned null");
-        }
-        let block = toPowBlock(latestBlockRaw);
-        this.latestEth1Block = { ...block, timestamp: quantityToNum(latestBlockRaw.timestamp) };
-        this.cacheBlock(block);
-        // This code path to look backwards for the merge block is only necessary if:
-        // - The network has not yet found the merge block
-        // - There are descendants of the merge block in the eth1 chain
-        // For the search below to require more than a few hops, multiple block proposers in a row must fail to detect
-        // an existing merge block. Such situation is extremely unlikely, so this search is left un-optimized. Since
-        // this class can start eagerly looking for the merge block when not necessary, startPollingMergeBlock() should
-        // only be called when there is certainty that a mergeBlock search is necessary.
-        while (true) {
-            if (block.totalDifficulty < this.config.TERMINAL_TOTAL_DIFFICULTY) {
-                // TTD not reached yet
-                return null;
-            }
-            // else block.totalDifficulty >= this.config.TERMINAL_TOTAL_DIFFICULTY
-            // Potential mergeBlock! Must find the first block that passes TTD
-            // Allow genesis block to reach TTD https://github.com/ethereum/consensus-specs/pull/2719
-            if (block.parentHash === ZERO_HASH_HEX) {
-                return block;
-            }
-            const parent = await this.getPowBlock(block.parentHash);
-            if (!parent) {
-                throw Error(`Unknown parent of block with TD>TTD ${block.parentHash}`);
-            }
-            this.metrics?.eth1.eth1ParentBlocksFetched.inc();
-            // block.td > TTD && parent.td < TTD => block is mergeBlock
-            if (parent.totalDifficulty < this.config.TERMINAL_TOTAL_DIFFICULTY) {
-                // Is terminal total difficulty block AND has verified block -> parent relationship
-                return block;
-            }
-            block = parent;
-        }
-    }
-    cacheBlock(block) {
-        this.blocksByHashCache.set(block.blockHash, block);
-        pruneSetToMax(this.blocksByHashCache, MAX_CACHE_POW_BLOCKS);
-    }
-}
-export function toPowBlock(block) {
-    // Validate untrusted data from API
-    return {
-        number: quantityToNum(block.number),
-        blockHash: dataToRootHex(block.hash),
-        parentHash: dataToRootHex(block.parentHash),
-        totalDifficulty: quantityToBigint(block.totalDifficulty),
-    };
-}
-/**
- * TTD values can be very large, for xDAI > 1e45. So scale down.
- * To be good, TTD should be rendered as a number < Number.MAX_TD_RENDER_VALUE ~= 9e15
- */
-export function getSafeTDFactor(ttd) {
-    const safeIntegerMult = ttd / BigInt(MAX_TD_RENDER_VALUE);
-    // TTD < MAX_TD_RENDER_VALUE, no need to scale down
-    if (safeIntegerMult === BigInt(0)) {
-        return BigInt(1);
-    }
-    // Return closest power of 10 to ensure TD < max
-    const safeIntegerMultDigits = safeIntegerMult.toString(10).length;
-    return BigInt(10) ** BigInt(safeIntegerMultDigits);
-}
-//# sourceMappingURL=eth1MergeBlockTracker.js.map

package/lib/eth1/eth1MergeBlockTracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"eth1MergeBlockTracker.js","sourceRoot":"","sources":["../../src/eth1/eth1MergeBlockTracker.ts"],"names":[],"mappings":"AAEA,OAAO,EAAS,aAAa,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAC,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAC,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAEnF,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,6BAAe,CAAA;AACjB,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAOD,kEAAkE;AAClE,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAElC,MAAM,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CAAC;AASpD,oCAAoC;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAeb;IAdF,MAAM,CAAc;IACpB,MAAM,CAAS;IACf,OAAO,CAAiB;IAExB,iBAAiB,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,SAAS,GAAqB,EAAE,CAAC;IAE1C,MAAM,CAAS;IACf,eAAe,GAAkC,IAAI,CAAC;IACtD,kCAAkC,GAAyC,IAAI,CAAC;IACvE,YAAY,CAAS;IAEtC,YACE,EAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAA+B,EAC9C,YAA2B;QAA3B,iBAAY,GAAZ,YAAY,CAAe;QAE5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,IAAI,CAAC,MAAM,GAAG,EAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAC,CAAC;QAEzC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;QAEnE,IAAI,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,GAAG,IAAI,CAAC,YAAY,CAAC;QAE5E,gCAAgC;QAChC,IAAI,OAAO,EAAE,CAAC;YACZ,0EAA0E;YAC1E,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,SAAmB,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAsB,CAAC,CAAC,CAAC;YAExE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,GAAG,EAAE;gBAC3C,qDAAqD;gBACrD,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAElE,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;oBAClC,wBAAwB;oBACxB,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;oBACpE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;oBACrG,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACvB,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACzB,KAAK,UAAU,CAAC,OAAO;gBACrB,+DAA+D;gBAC/D,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAC;YAE5C,KAAK,UAAU,CAAC,SAAS;gBACvB,iDAAiD;gBACjD,OAAO,IAAI,CAAC;YAEd,KAAK,UAAU,CAAC,KAAK;gBACnB,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,CAAC;IACH,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,eAAe,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,GAAG,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC;QAE5F,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,IAAI,CAAC,YAAY;gBAC3B,YAAY,EAAE,MAAM,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAW,CAAC;gBAC5D,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,yBAAyB;gBAC1C,EAAE,EAAE,IAAI,CAAC,eAAe,CAAC,eAAe;gBACxC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,SAAS;aAC1C,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,YAAoB;QACpC,oBAAoB;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,kBAAkB;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;QACtE,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,sBAAsB;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,EAAC,IAAI,EAAE,UAAU,CAAC,SAAS,EAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE;YACzD,yBAAyB,EAAE,IAAI,CAAC,MAAM,CAAC,yBAAyB;SACjE,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;YAChC,8DAA8D;YAC9D,mFAAmF;YACnF,IAAI,CAAC,2BAA2B,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,EAAE,CAAU,CAAC,CAAC;gBAC7D,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,wBAAwB,CAAC,GAAG,EAAE,CAAC;YACpD,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;QAE9C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAEO,KAAK,CAAC,2BAA2B;QACvC,IAAI,CAAC,IAAI,CAAC,kCAAkC,EAAE,CAAC;YAC7C,IAAI,CAAC,kCAAkC,GAAG,IAAI,CAAC,mCAAmC,EAAE;iBACjF,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;gBACnB,8DAA8D;gBAC9D,sBAAsB;gBACtB,+BAA+B;gBAC/B,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC;oBACxD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,SAAS,EAAE,CAAC;wBAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;oBACf,CAAC;oBAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;wBAC5C,IAAI,EAAE,UAAU,CAAC,SAAS;wBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,eAAe,EAAE,UAAU,CAAC,eAAe;qBAC5C,CAAC,CAAC;oBAEH,IAAI,CAAC,MAAM,GAAG,EAAC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,UAAU,EAAC,CAAC;oBACnD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAC1C;wBACE,iBAAiB,EAAE,UAAU,CAAC,SAAS;wBACvC,8CAA8C;wBAC9C,mBAAmB,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACnD,eAAe,EAAE,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;qBACzD,EACD,CAAC,CACF,CAAC;gBACJ,CAAC;gBAED,OAAO,UAAU,CAAC;YACpB,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,IAAI,CAAC,kCAAkC,GAAG,IAAI,CAAC;YACjD,CAAC,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACN,gHAAgH;YAChH,uGAAuG;YACvG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,kCAAkC,CAAC,GAAG,EAAE,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC,kCAAkC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,mCAAmC;QAC/C,6BAA6B;QAC7B,+EAA+E;QAC/E,MAAM,iBAAiB,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACrE,IAAI,iBAAiB,KAAK,aAAa,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;YACxD,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC;YACf,CAAC;YACD,gGAAgG;YAChG,OAAO,IAAI,CAAC;QACd,CAAC;QAED,4BAA4B;QAC5B,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,KAAK,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;QACvC,IAAI,CAAC,eAAe,GAAG,EAAC,GAAG,KAAK,EAAE,SAAS,EAAE,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,EAAC,CAAC;QACtF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEvB,6EAA6E;QAC7E,kDAAkD;QAClD,+DAA+D;QAC/D,8GAA8G;QAC9G,4GAA4G;QAC5G,+GAA+G;QAC/G,gFAAgF;QAEhF,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE,CAAC;gBAClE,sBAAsB;gBACtB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,sEAAsE;YACtE,kEAAkE;YAElE,yFAAyF;YACzF,IAAI,KAAK,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;gBACvC,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACxD,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,KAAK,CAAC,uCAAuC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACzE,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,CAAC;YAEjD,2DAA2D;YAC3D,IAAI,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,yBAAyB,EAAE,CAAC;gBACnE,mFAAmF;gBACnF,OAAO,KAAK,CAAC;YACf,CAAC;YACD,KAAK,GAAG,MAAM,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAoB;QACrC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACnD,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,mCAAmC;IACnC,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;QACnC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;QACpC,UAAU,EAAE,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QAC3C,eAAe,EAAE,gBAAgB,CAAC,KAAK,CAAC,eAAe,CAAC;KACzD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,eAAe,GAAG,GAAG,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE1D,mDAAmD;IACnD,IAAI,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,MAAM,qBAAqB,GAAG,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAClE,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAAC;AACrD,CAAC"}

package/lib/eth1/index.d.ts

@@ -1,46 +0,0 @@
-import { CachedBeaconStateAllForks } from "@lodestar/state-transition";
-import { Root } from "@lodestar/types";
-import { Eth1DepositDataTrackerModules } from "./eth1DepositDataTracker.js";
-import { Eth1MergeBlockTrackerModules } from "./eth1MergeBlockTracker.js";
-import { Eth1DataAndDeposits, IEth1ForBlockProduction, IEth1Provider, PowMergeBlock, TDProgress } from "./interface.js";
-import { Eth1Options } from "./options.js";
-import { Eth1Provider } from "./provider/eth1Provider.js";
-export { Eth1Provider };
-export type { IEth1ForBlockProduction, IEth1Provider };
-export declare function initializeEth1ForBlockProduction(opts: Eth1Options, modules: Pick<Eth1DepositDataTrackerModules, "db" | "config" | "metrics" | "logger" | "signal">): IEth1ForBlockProduction;
-export declare class Eth1ForBlockProduction implements IEth1ForBlockProduction {
-    private readonly eth1DepositDataTracker;
-    private readonly eth1MergeBlockTracker;
-    constructor(opts: Eth1Options, modules: Eth1DepositDataTrackerModules & Eth1MergeBlockTrackerModules & {
-        eth1Provider?: IEth1Provider;
-    });
-    getEth1DataAndDeposits(state: CachedBeaconStateAllForks): Promise<Eth1DataAndDeposits>;
-    getTerminalPowBlock(): Promise<Root | null>;
-    getPowBlock(powBlockHash: string): Promise<PowMergeBlock | null>;
-    getTDProgress(): TDProgress | null;
-    startPollingMergeBlock(): void;
-    isPollingEth1Data(): boolean;
-    stopPollingEth1Data(): void;
-}
-/**
- * Disabled version of Eth1ForBlockProduction
- * May produce invalid blocks by not adding new deposits and voting for the same eth1Data
- */
-export declare class Eth1ForBlockProductionDisabled implements IEth1ForBlockProduction {
-    /**
-     * Returns same eth1Data as in state and no deposits
-     * May produce invalid blocks if deposits have to be added
-     */
-    getEth1DataAndDeposits(state: CachedBeaconStateAllForks): Promise<Eth1DataAndDeposits>;
-    /**
-     * Will miss the oportunity to propose the merge block but will still produce valid blocks
-     */
-    getTerminalPowBlock(): Promise<Root | null>;
-    /** Will not be able to validate the merge block */
-    getPowBlock(_powBlockHash: string): Promise<PowMergeBlock | null>;
-    getTDProgress(): TDProgress | null;
-    isPollingEth1Data(): boolean;
-    startPollingMergeBlock(): void;
-    stopPollingEth1Data(): void;
-}
-//# sourceMappingURL=index.d.ts.map

package/lib/eth1/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eth1/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,yBAAyB,EAAC,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAC,IAAI,EAAC,MAAM,iBAAiB,CAAC;AAErC,OAAO,EAAyB,6BAA6B,EAAC,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAwB,4BAA4B,EAAC,MAAM,4BAA4B,CAAC;AAC/F,OAAO,EAAC,mBAAmB,EAAE,uBAAuB,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAC;AACtH,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AACzC,OAAO,EAAC,YAAY,EAAC,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAC,YAAY,EAAC,CAAC;AACtB,YAAY,EAAC,uBAAuB,EAAE,aAAa,EAAC,CAAC;AAkCrD,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,IAAI,CAAC,6BAA6B,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAC9F,uBAAuB,CAWzB;AAED,qBAAa,sBAAuB,YAAW,uBAAuB;IACpE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgC;IACvE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAwB;gBAG5D,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,6BAA6B,GAAG,4BAA4B,GAAG;QAAC,YAAY,CAAC,EAAE,aAAa,CAAA;KAAC;IAkBlG,sBAAsB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAOtF,mBAAmB,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAKjD,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIhE,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC,sBAAsB,IAAI,IAAI;IAI9B,iBAAiB,IAAI,OAAO;IAI5B,mBAAmB,IAAI,IAAI;CAG5B;AAED;;;GAGG;AACH,qBAAa,8BAA+B,YAAW,uBAAuB;IAC5E;;;OAGG;IACG,sBAAsB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI5F;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAIjD,mDAAmD;IAC7C,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIvE,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC,iBAAiB,IAAI,OAAO;IAI5B,sBAAsB,IAAI,IAAI;IAI9B,mBAAmB,IAAI,IAAI;CAG5B"}

package/lib/eth1/index.js

@@ -1,121 +0,0 @@
-import { fromHex } from "@lodestar/utils";
-import { Eth1DepositDataTracker } from "./eth1DepositDataTracker.js";
-import { Eth1MergeBlockTracker } from "./eth1MergeBlockTracker.js";
-import { Eth1Provider } from "./provider/eth1Provider.js";
-export { Eth1Provider };
-// This module encapsulates all consumer functionality to the execution node (formerly eth1). The execution client
-// has to:
-//
-// - For genesis, the beacon node must follow the eth1 chain: get all deposit events + blocks within that range.
-//   Once the genesis conditions are met, start the POS chain with the resulting state. The logic is similar to the
-//   two points below, but the implementation is specialized for each scenario.
-//
-// - Follow the eth1 block chain to validate eth1Data votes. It needs all consecutive blocks within a specific range
-//   and at a distance from the head.
-//   ETH1_FOLLOW_DISTANCE 	        uint64(2**11) (= 2,048) 	Eth1 blocks 	~8 hours
-//   EPOCHS_PER_ETH1_VOTING_PERIOD 	uint64(2**6) (= 64)     	epochs 	      ~6.8 hours
-//
-// - Fetch ALL deposit events from the deposit contract to build the deposit tree and validate future merkle proofs.
-//   Then it must follow deposit events at a distance roughly similar to the `ETH1_FOLLOW_DISTANCE` parameter above.
-//
-// - [New bellatrix]: After BELLATRIX_FORK_EPOCH, it must fetch the block with hash
-//   `state.eth1_data.block_hash` to compute `terminal_total_difficulty`. Note this may change with
-//   https://github.com/ethereum/consensus-specs/issues/2603.
-//
-// - [New bellatrix]: On block production post BELLATRIX_FORK_EPOCH, pre merge, the beacon node must find the merge block
-//   crossing the `terminal_total_difficulty` boundary and include it in the block. After the merge block production
-//   will just use `execution_engine.assemble_block` without fetching individual blocks.
-//
-// - [New bellatrix]: Fork-choice must validate the merge block ensuring it crossed the `terminal_total_difficulty`
-//   boundary, so it must fetch the POW block referenced in the merge block + its POW parent block.
-//
-// With the merge the beacon node has to follow the eth1 chain at two distances:
-// 1. At `ETH1_FOLLOW_DISTANCE` for eth1Data to be re-org safe
-// 2. At the head to get the first merge block, tolerating possible re-orgs
-//
-// Then both streams of blocks should not be merged since it's harder to guard against re-orgs from (2) to (1).
-export function initializeEth1ForBlockProduction(opts, modules) {
-    if (opts.enabled) {
-        return new Eth1ForBlockProduction(opts, {
-            config: modules.config,
-            db: modules.db,
-            metrics: modules.metrics,
-            logger: modules.logger,
-            signal: modules.signal,
-        });
-    }
-    return new Eth1ForBlockProductionDisabled();
-}
-export class Eth1ForBlockProduction {
-    eth1DepositDataTracker;
-    eth1MergeBlockTracker;
-    constructor(opts, modules) {
-        const eth1Provider = modules.eth1Provider ||
-            new Eth1Provider(modules.config, { ...opts, logger: modules.logger }, modules.signal, modules.metrics?.eth1HttpClient);
-        this.eth1DepositDataTracker = opts.disableEth1DepositDataTracker
-            ? null
-            : new Eth1DepositDataTracker(opts, modules, eth1Provider);
-        this.eth1MergeBlockTracker = new Eth1MergeBlockTracker(modules, eth1Provider);
-    }
-    async getEth1DataAndDeposits(state) {
-        if (this.eth1DepositDataTracker === null) {
-            return { eth1Data: state.eth1Data, deposits: [] };
-        }
-        return this.eth1DepositDataTracker.getEth1DataAndDeposits(state);
-    }
-    async getTerminalPowBlock() {
-        const block = await this.eth1MergeBlockTracker.getTerminalPowBlock();
-        return block && fromHex(block.blockHash);
-    }
-    getPowBlock(powBlockHash) {
-        return this.eth1MergeBlockTracker.getPowBlock(powBlockHash);
-    }
-    getTDProgress() {
-        return this.eth1MergeBlockTracker.getTDProgress();
-    }
-    startPollingMergeBlock() {
-        this.eth1MergeBlockTracker.startPollingMergeBlock();
-    }
-    isPollingEth1Data() {
-        return this.eth1DepositDataTracker?.isPollingEth1Data() ?? false;
-    }
-    stopPollingEth1Data() {
-        this.eth1DepositDataTracker?.stopPollingEth1Data();
-    }
-}
-/**
- * Disabled version of Eth1ForBlockProduction
- * May produce invalid blocks by not adding new deposits and voting for the same eth1Data
- */
-export class Eth1ForBlockProductionDisabled {
-    /**
-     * Returns same eth1Data as in state and no deposits
-     * May produce invalid blocks if deposits have to be added
-     */
-    async getEth1DataAndDeposits(state) {
-        return { eth1Data: state.eth1Data, deposits: [] };
-    }
-    /**
-     * Will miss the oportunity to propose the merge block but will still produce valid blocks
-     */
-    async getTerminalPowBlock() {
-        return null;
-    }
-    /** Will not be able to validate the merge block */
-    async getPowBlock(_powBlockHash) {
-        throw Error("eth1 must be enabled to verify merge block");
-    }
-    getTDProgress() {
-        return null;
-    }
-    isPollingEth1Data() {
-        return false;
-    }
-    startPollingMergeBlock() {
-        // Ignore
-    }
-    stopPollingEth1Data() {
-        // Ignore
-    }
-}
-//# sourceMappingURL=index.js.map

package/lib/eth1/index.js.map

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