@lodestar/prover 1.9.1

package/lib/proof_provider/proof_provider.js

@@ -0,0 +1,171 @@
+import { getClient } from "@lodestar/api/beacon";
+import { createChainForkConfig } from "@lodestar/config";
+import { networksChainConfig } from "@lodestar/config/networks";
+import { Lightclient, LightclientEvent, RunStatusCode } from "@lodestar/light-client";
+import { LightClientRestTransport } from "@lodestar/light-client/transport";
+import { isForkWithdrawals } from "@lodestar/params";
+import { LCTransport } from "../interfaces.js";
+import { assertLightClient } from "../utils/assertion.js";
+import { getExecutionPayloads, getGenesisData, getSyncCheckpoint, getUnFinalizedRangeForPayloads, } from "../utils/consensus.js";
+import { bufferToHex } from "../utils/conversion.js";
+import { PayloadStore } from "./payload_store.js";
+export class ProofProvider {
+    constructor(opts) {
+        this.opts = opts;
+        this.store = new PayloadStore({ api: opts.api, logger: opts.logger });
+        this.logger = opts.logger;
+        this.config = opts.config;
+        this.api = opts.api;
+        this.network = opts.config.PRESET_BASE;
+    }
+    async waitToBeReady() {
+        return this.readyPromise;
+    }
+    static init(opts) {
+        if (opts.transport === LCTransport.P2P) {
+            throw new Error("P2P mode not supported yet");
+        }
+        opts.logger.info("Creating ProofProvider instance with REST APIs", {
+            network: opts.network,
+            urls: opts.urls.join(","),
+        });
+        const config = opts.network
+            ? createChainForkConfig(networksChainConfig[opts.network])
+            : createChainForkConfig(opts.config);
+        const api = getClient({ urls: opts.urls }, { config });
+        const transport = new LightClientRestTransport(api);
+        const provider = new ProofProvider({
+            ...opts,
+            config,
+            api,
+            transport,
+        });
+        provider.readyPromise = provider.sync(opts.wsCheckpoint).catch((e) => {
+            opts.logger.error("Error while syncing", e);
+            return Promise.reject(e);
+        });
+        return provider;
+    }
+    async sync(wsCheckpoint) {
+        if (this.lightClient !== undefined) {
+            throw Error("Light client already initialized and syncing.");
+        }
+        this.logger.info("Starting sync for proof provider");
+        const { api, config, transport } = this.opts;
+        const checkpointRoot = await getSyncCheckpoint(api, wsCheckpoint);
+        const genesisData = await getGenesisData(api);
+        this.logger.info("Initializing lightclient", { checkpointRoot: bufferToHex(checkpointRoot) });
+        this.lightClient = await Lightclient.initializeFromCheckpointRoot({
+            checkpointRoot,
+            config,
+            transport,
+            genesisData,
+        });
+        assertLightClient(this.lightClient);
+        // Wait for the lightclient to start
+        await new Promise((resolve) => {
+            var _a, _b;
+            const lightClientStarted = (status) => {
+                var _a;
+                if (status === RunStatusCode.started) {
+                    (_a = this.lightClient) === null || _a === void 0 ? void 0 : _a.emitter.off(LightclientEvent.statusChange, lightClientStarted);
+                    resolve();
+                }
+            };
+            (_a = this.lightClient) === null || _a === void 0 ? void 0 : _a.emitter.on(LightclientEvent.statusChange, lightClientStarted);
+            this.logger.info("Initiating lightclient");
+            (_b = this.lightClient) === null || _b === void 0 ? void 0 : _b.start();
+        });
+        this.logger.info("Lightclient synced", this.getStatus());
+        this.registerEvents();
+        // Load the payloads from the CL
+        this.logger.info("Building EL payload history");
+        const { start, end } = await getUnFinalizedRangeForPayloads(this.lightClient);
+        const payloads = await getExecutionPayloads({
+            api: this.opts.api,
+            startSlot: start,
+            endSlot: end,
+            logger: this.logger,
+        });
+        for (const payload of Object.values(payloads)) {
+            this.store.set(payload, false);
+        }
+        // Load the finalized payload from the CL
+        const finalizedSlot = this.lightClient.getFinalized().beacon.slot;
+        this.logger.debug("Getting finalized slot from lightclient", { finalizedSlot });
+        const finalizedPayload = await getExecutionPayloads({
+            api: this.opts.api,
+            startSlot: finalizedSlot,
+            endSlot: finalizedSlot,
+            logger: this.logger,
+        });
+        this.store.set(finalizedPayload[finalizedSlot], true);
+        this.logger.info("Proof provider ready");
+    }
+    getStatus() {
+        if (!this.lightClient) {
+            return {
+                latest: 0,
+                finalized: 0,
+                status: RunStatusCode.uninitialized,
+            };
+        }
+        return {
+            latest: this.lightClient.getHead().beacon.slot,
+            finalized: this.lightClient.getFinalized().beacon.slot,
+            status: this.lightClient.status,
+        };
+    }
+    async getExecutionPayload(blockNumber) {
+        assertLightClient(this.lightClient);
+        if (typeof blockNumber === "string" && blockNumber === "finalized") {
+            const payload = this.store.finalized;
+            if (!payload)
+                throw new Error("No finalized payload");
+            return payload;
+        }
+        if (typeof blockNumber === "string" && blockNumber === "latest") {
+            const payload = this.store.latest;
+            if (!payload)
+                throw new Error("No latest payload");
+            return payload;
+        }
+        if ((typeof blockNumber === "string" && blockNumber.startsWith("0x")) || typeof blockNumber === "number") {
+            const payload = await this.store.get(blockNumber);
+            if (!payload)
+                throw new Error(`No payload for blockNumber ${blockNumber}`);
+            return payload;
+        }
+        throw new Error(`Invalid blockNumber "${blockNumber}"`);
+    }
+    async processLCHeader(lcHeader, finalized = false) {
+        const fork = this.opts.config.getForkName(lcHeader.beacon.slot);
+        if (!isForkWithdrawals(fork)) {
+            return;
+        }
+        const sszType = this.opts.config.getExecutionForkTypes(lcHeader.beacon.slot).ExecutionPayloadHeader;
+        if (isForkWithdrawals(fork) &&
+            (!("execution" in lcHeader) || sszType.equals(lcHeader.execution, sszType.defaultValue()))) {
+            throw new Error("Execution payload is required for execution fork");
+        }
+        await this.store.processLCHeader(lcHeader, finalized);
+    }
+    registerEvents() {
+        assertLightClient(this.lightClient);
+        this.opts.signal.addEventListener("abort", () => {
+            var _a;
+            (_a = this.lightClient) === null || _a === void 0 ? void 0 : _a.stop();
+        });
+        this.lightClient.emitter.on(LightclientEvent.lightClientFinalityHeader, async (data) => {
+            await this.processLCHeader(data, true).catch((e) => {
+                this.logger.error("Error processing finality update", null, e);
+            });
+        });
+        this.lightClient.emitter.on(LightclientEvent.lightClientOptimisticHeader, async (data) => {
+            await this.processLCHeader(data).catch((e) => {
+                this.logger.error("Error processing optimistic update", null, e);
+            });
+        });
+    }
+}
+//# sourceMappingURL=proof_provider.js.map

package/lib/proof_provider/proof_provider.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,136 @@
+/// <reference types="node" />
+export type JsonRpcId = number | string;
+export type JsonRpcVersion = string | ("2.0" | "1.0");
+export interface JsonRpcRequestPayload<T = unknown[]> {
+    readonly jsonrpc: JsonRpcVersion;
+    readonly id: JsonRpcId;
+    readonly method: string;
+    readonly params: T;
+    readonly requestOptions?: unknown;
+}
+export interface JsonRpcNotificationPayload<T = unknown[]> {
+    readonly jsonrpc: JsonRpcVersion;
+    readonly method: string;
+    readonly params: T;
+    readonly requestOptions?: unknown;
+}
+export type JsonRpcRequest<T = unknown[]> = JsonRpcRequestPayload<T> | JsonRpcNotificationPayload<T>;
+export type JsonRpcBatchRequest<T = unknown[]> = JsonRpcRequest<T>[];
+export type JsonRpcRequestOrBatch<T = unknown[]> = JsonRpcRequest<T> | JsonRpcBatchRequest<T>;
+export interface JsonRpcResponseWithResultPayload<T> {
+    readonly id: number | string;
+    jsonrpc: string;
+    result: T;
+    error?: never;
+}
+export interface JsonRpcErrorPayload<T> {
+    readonly code?: number;
+    readonly data?: T;
+    readonly message: string;
+}
+export interface JsonRpcResponseWithErrorPayload<T> {
+    readonly id: number | string;
+    jsonrpc: string;
+    result?: never;
+    error: JsonRpcErrorPayload<T>;
+}
+export type JsonRpcResponse<T = any, E = any> = JsonRpcResponseWithResultPayload<T> | JsonRpcResponseWithErrorPayload<E>;
+export type JsonRpcBatchResponse<T = any, E = any> = JsonRpcResponse<T, E>[];
+export type JsonRpcResponseOrBatch<T = any, E = any> = JsonRpcResponse<T, E> | JsonRpcBatchResponse<T, E>;
+export type HexString = string;
+export type ELBlockNumberOrTag = number | string | "latest" | "earliest" | "pending";
+export interface ELProof {
+    readonly address: string;
+    readonly balance: string;
+    readonly codeHash: string;
+    readonly nonce: string;
+    readonly storageHash: string;
+    readonly accountProof: string[];
+    readonly storageProof: {
+        readonly key: string;
+        readonly value: string;
+        readonly proof: string[];
+    }[];
+}
+export interface ELTransaction {
+    readonly type: string;
+    readonly nonce: string;
+    readonly to: string | null;
+    readonly chainId?: string;
+    readonly input: string;
+    readonly value: string;
+    readonly gasPrice?: string;
+    readonly gas: string;
+    readonly maxFeePerGas?: string;
+    readonly maxPriorityFeePerGas?: string;
+    readonly blockHash: string;
+    readonly blockNumber: string;
+    readonly from: string;
+    readonly hash: string;
+    readonly r: string;
+    readonly s: string;
+    readonly v: string;
+    readonly transactionIndex: string;
+    readonly accessList?: {
+        address: string;
+        storageKeys: string[];
+    }[];
+    readonly data?: string;
+}
+export interface ELWithdrawal {
+    readonly index: string;
+    readonly validatorIndex: string;
+    readonly address: string;
+    readonly amount: string;
+}
+export interface ELBlock {
+    readonly parentHash: string;
+    readonly stateRoot: string;
+    readonly receiptsRoot: string;
+    readonly logsBloom: string;
+    readonly nonce: string;
+    readonly difficulty: string;
+    readonly totalDifficulty: string;
+    readonly number: string;
+    readonly gasLimit: string;
+    readonly gasUsed: string;
+    readonly timestamp: string;
+    readonly extraData?: Buffer | string;
+    readonly mixHash: string;
+    readonly hash: string;
+    readonly baseFeePerGas: string;
+    readonly miner: string;
+    readonly sha3Uncles: string;
+    readonly size: string;
+    readonly uncles: ELBlock[];
+    readonly transactions: ELTransaction[];
+    readonly transactionsRoot: string;
+    readonly withdrawals?: ELWithdrawal[];
+    readonly withdrawalsRoot?: string;
+}
+export interface ELAccessList {
+    readonly address: HexString;
+    readonly storageKeys: HexString[];
+}
+export interface ELAccessListResponse {
+    readonly error: string;
+    readonly gasUsed: HexString;
+    readonly accessList: ELAccessList[];
+}
+export type ELStorageProof = Pick<ELProof, "storageHash" | "storageProof">;
+export type ELApi = {
+    eth_createAccessList: (transaction: ELTransaction, block?: ELBlockNumberOrTag) => ELAccessListResponse;
+    eth_call: (transaction: ELTransaction, block?: ELBlockNumberOrTag) => HexString;
+    eth_estimateGas: (transaction: ELTransaction, block?: ELBlockNumberOrTag) => HexString;
+    eth_getCode: (address: string, block?: ELBlockNumberOrTag) => HexString;
+    eth_getProof: (address: string, storageKeys: string[], block?: ELBlockNumberOrTag) => ELProof;
+    eth_getBlockByNumber: (block: ELBlockNumberOrTag, hydrated?: boolean) => ELBlock | undefined;
+    eth_getBlockByHash: (block: string, hydrated?: boolean) => ELBlock | undefined;
+};
+export type ELApiParams = {
+    [K in keyof ELApi]: Parameters<ELApi[K]>;
+};
+export type ELApiReturn = {
+    [K in keyof ELApi]: ReturnType<ELApi[K]>;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js

@@ -0,0 +1,3 @@
+export {};
+/* eslint-enable @typescript-eslint/naming-convention */
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAmKA,wDAAwD"}

package/lib/utils/assertion.d.ts

@@ -0,0 +1,10 @@
+import { Lightclient } from "@lodestar/light-client";
+import { EIP1193Provider, EthersProvider, RequestProvider, SendAsyncProvider, SendProvider, Web3Provider } from "../interfaces.js";
+export declare function assertLightClient(client?: Lightclient): asserts client is Lightclient;
+export declare function isSendProvider(provider: Web3Provider): provider is SendProvider;
+export declare function isEthersProvider(provider: Web3Provider): provider is EthersProvider;
+export declare function isRequestProvider(provider: Web3Provider): provider is RequestProvider;
+export declare function isSendAsyncProvider(provider: Web3Provider): provider is SendAsyncProvider;
+export declare function isEIP1193Provider(provider: Web3Provider): provider is EIP1193Provider;
+export declare function isTruthy<T = unknown>(value: T): value is Exclude<T, undefined | null>;
+//# sourceMappingURL=assertion.d.ts.map

package/lib/utils/assertion.js

@@ -0,0 +1,34 @@
+export function assertLightClient(client) {
+    if (!client) {
+        throw new Error("Light client is not initialized yet.");
+    }
+}
+export function isSendProvider(provider) {
+    return ("send" in provider &&
+        typeof provider.send === "function" &&
+        provider.send.length > 1 &&
+        provider.send.constructor.name !== "AsyncFunction");
+}
+export function isEthersProvider(provider) {
+    return ("send" in provider &&
+        typeof provider.send === "function" &&
+        provider.send.length > 1 &&
+        provider.send.constructor.name === "AsyncFunction");
+}
+export function isRequestProvider(provider) {
+    return "request" in provider && typeof provider.request === "function" && provider.request.length > 1;
+}
+export function isSendAsyncProvider(provider) {
+    return ("sendAsync" in provider &&
+        typeof provider.sendAsync === "function" &&
+        provider.sendAsync.constructor.name === "AsyncFunction");
+}
+export function isEIP1193Provider(provider) {
+    return ("request" in provider &&
+        typeof provider.request === "function" &&
+        provider.request.constructor.name === "AsyncFunction");
+}
+export function isTruthy(value) {
+    return value !== undefined && value !== null && value !== false;
+}
+//# sourceMappingURL=assertion.js.map

package/lib/utils/assertion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.js","sourceRoot":"","sources":["../../src/utils/assertion.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,IAAI,CAAC,MAAM,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;KACzD;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,OAAO,CACL,MAAM,IAAI,QAAQ;QAClB,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU;QACnC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,OAAO,CACL,MAAM,IAAI,QAAQ;QAClB,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU;QACnC,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO,SAAS,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAsB;IACxD,OAAO,CACL,WAAW,IAAI,QAAQ;QACvB,OAAO,QAAQ,CAAC,SAAS,KAAK,UAAU;QACxC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,OAAO,CACL,SAAS,IAAI,QAAQ;QACrB,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU;QACtC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,eAAe,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAc,KAAQ;IAC5C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK,CAAC;AAClE,CAAC"}

package/lib/utils/command.d.ts

@@ -0,0 +1,22 @@
+import { Options, Argv } from "yargs";
+export type CliCommandOptions<OwnArgs> = Required<{
+    [key in keyof OwnArgs]: Options;
+}>;
+export interface CliCommand<OwnArgs = Record<never, never>, ParentArgs = Record<never, never>, R = any> {
+    command: string;
+    describe: string;
+    examples?: {
+        command: string;
+        description: string;
+    }[];
+    options?: CliCommandOptions<OwnArgs>;
+    subcommands?: CliCommand<any, OwnArgs & ParentArgs>[];
+    handler?: (args: OwnArgs & ParentArgs) => Promise<R>;
+}
+/**
+ * Register a CliCommand type to yargs. Recursively registers subcommands too.
+ * @param yargs
+ * @param cliCommand
+ */
+export declare function registerCommandToYargs(yargs: Argv, cliCommand: CliCommand<any, any>): void;
+//# sourceMappingURL=command.d.ts.map

package/lib/utils/command.js

@@ -0,0 +1,27 @@
+/**
+ * Register a CliCommand type to yargs. Recursively registers subcommands too.
+ * @param yargs
+ * @param cliCommand
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function registerCommandToYargs(yargs, cliCommand) {
+    yargs.command({
+        command: cliCommand.command,
+        describe: cliCommand.describe,
+        builder: (yargsBuilder) => {
+            yargsBuilder.options(cliCommand.options || {});
+            for (const subcommand of cliCommand.subcommands || []) {
+                registerCommandToYargs(yargsBuilder, subcommand);
+            }
+            if (cliCommand.examples) {
+                for (const example of cliCommand.examples) {
+                    yargsBuilder.example(`$0 ${example.command}`, example.description);
+                }
+            }
+            return yargs;
+        },
+        // eslint-disable-next-line @typescript-eslint/no-empty-function
+        handler: cliCommand.handler || function emptyHandler() { },
+    });
+}
+//# sourceMappingURL=command.js.map

package/lib/utils/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/utils/command.ts"],"names":[],"mappings":"AAiBA;;;;GAIG;AACH,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,KAAW,EAAE,UAAgC;IAClF,KAAK,CAAC,OAAO,CAAC;QACZ,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,OAAO,EAAE,CAAC,YAAY,EAAE,EAAE;YACxB,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC/C,KAAK,MAAM,UAAU,IAAI,UAAU,CAAC,WAAW,IAAI,EAAE,EAAE;gBACrD,sBAAsB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;aAClD;YACD,IAAI,UAAU,CAAC,QAAQ,EAAE;gBACvB,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,EAAE;oBACzC,YAAY,CAAC,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;iBACpE;aACF;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,gEAAgE;QAChE,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,SAAS,YAAY,KAAU,CAAC;KAChE,CAAC,CAAC;AACL,CAAC"}

package/lib/utils/consensus.d.ts

@@ -0,0 +1,19 @@
+import { Api } from "@lodestar/api/beacon";
+import { allForks, Bytes32, capella } from "@lodestar/types";
+import { GenesisData, Lightclient } from "@lodestar/light-client";
+import { Logger } from "@lodestar/utils";
+export declare function fetchNearestBlock(api: Api, slot: number, direction?: "up" | "down"): Promise<capella.SignedBeaconBlock>;
+export declare function getUnFinalizedRangeForPayloads(lightClient: Lightclient): Promise<{
+    start: number;
+    end: number;
+}>;
+export declare function getExecutionPayloads({ api, startSlot, endSlot, logger, }: {
+    api: Api;
+    startSlot: number;
+    endSlot: number;
+    logger: Logger;
+}): Promise<Record<number, allForks.ExecutionPayload>>;
+export declare function getExecutionPayloadForBlockNumber(api: Api, startSlot: number, blockNumber: number): Promise<Record<number, allForks.ExecutionPayload>>;
+export declare function getGenesisData(api: Pick<Api, "beacon">): Promise<GenesisData>;
+export declare function getSyncCheckpoint(api: Pick<Api, "beacon">, checkpoint?: string): Promise<Bytes32>;
+//# sourceMappingURL=consensus.d.ts.map

package/lib/utils/consensus.js

@@ -0,0 +1,74 @@
+import { ApiError } from "@lodestar/api";
+import { MAX_PAYLOAD_HISTORY } from "../constants.js";
+import { hexToBuffer } from "./conversion.js";
+export async function fetchNearestBlock(api, slot, direction = "down") {
+    const res = await api.beacon.getBlockV2(slot);
+    if (res.ok)
+        return res.response.data;
+    if (!res.ok && res.error.code === 404) {
+        return fetchNearestBlock(api, direction === "down" ? slot - 1 : slot + 1);
+    }
+    throw new Error(`Can not fetch nearest block for slot=${slot}`);
+}
+export async function getUnFinalizedRangeForPayloads(lightClient) {
+    const headSlot = lightClient.getHead().beacon.slot;
+    const finalizeSlot = lightClient.getFinalized().beacon.slot;
+    const endSlot = headSlot - MAX_PAYLOAD_HISTORY;
+    return {
+        start: headSlot,
+        end: endSlot < finalizeSlot ? finalizeSlot : endSlot,
+    };
+}
+export async function getExecutionPayloads({ api, startSlot, endSlot, logger, }) {
+    [startSlot, endSlot] = [Math.min(startSlot, endSlot), Math.max(startSlot, endSlot)];
+    if (startSlot === endSlot) {
+        logger.debug("Fetching EL payload", { slot: startSlot });
+    }
+    else {
+        logger.debug("Fetching EL payloads", { startSlot, endSlot });
+    }
+    const payloads = {};
+    let slot = endSlot;
+    let block = await fetchNearestBlock(api, slot, "down");
+    payloads[block.message.slot] = block.message.body.executionPayload;
+    while (slot >= startSlot) {
+        const previousBlock = await fetchNearestBlock(api, block.message.slot - 1, "down");
+        if (block.message.body.executionPayload.parentHash === previousBlock.message.body.executionPayload.blockHash) {
+            payloads[block.message.slot] = block.message.body.executionPayload;
+        }
+        slot = block.message.slot - 1;
+        block = previousBlock;
+    }
+    return payloads;
+}
+export async function getExecutionPayloadForBlockNumber(api, startSlot, blockNumber) {
+    const payloads = {};
+    let block = await fetchNearestBlock(api, startSlot, "down");
+    payloads[block.message.slot] = block.message.body.executionPayload;
+    while (payloads[block.message.slot].blockNumber !== blockNumber) {
+        const previousBlock = await fetchNearestBlock(api, block.message.slot - 1, "down");
+        block = previousBlock;
+    }
+    return payloads;
+}
+export async function getGenesisData(api) {
+    const res = await api.beacon.getGenesis();
+    ApiError.assert(res);
+    return {
+        genesisTime: Number(res.response.data.genesisTime),
+        genesisValidatorsRoot: res.response.data.genesisValidatorsRoot,
+    };
+}
+export async function getSyncCheckpoint(api, checkpoint) {
+    let syncCheckpoint = checkpoint ? hexToBuffer(checkpoint) : undefined;
+    if (syncCheckpoint && syncCheckpoint.byteLength !== 32) {
+        throw Error(`Checkpoint root must be 32 bytes. length=${syncCheckpoint.byteLength}`);
+    }
+    if (!syncCheckpoint) {
+        const res = await api.beacon.getStateFinalityCheckpoints("head");
+        ApiError.assert(res);
+        syncCheckpoint = res.response.data.finalized.root;
+    }
+    return syncCheckpoint;
+}
+//# sourceMappingURL=consensus.js.map

package/lib/utils/consensus.js.map

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

package/lib/utils/conversion.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="node" />
+import { BlockData, HeaderData } from "@ethereumjs/block";
+import { ELBlock, ELTransaction } from "../types.js";
+export declare function numberToHex(num: number | bigint): string;
+export declare function hexToNumber(num: string): number;
+export declare function hexToBigInt(num: string): bigint;
+export declare function bigIntToHex(num: bigint): string;
+export declare function bufferToHex(buffer: Buffer | Uint8Array): string;
+export declare function hexToBuffer(val: string): Buffer;
+export declare function padLeft<T extends Buffer | Uint8Array>(v: T, length: number): T;
+export declare function headerDataFromELBlock(blockInfo: ELBlock): HeaderData;
+export declare function txDataFromELBlock(txInfo: ELTransaction): {
+    data: string;
+    gasPrice: bigint | null;
+    gasLimit: string;
+    to: Buffer | undefined;
+    value: bigint | undefined;
+    maxFeePerGas: bigint | undefined;
+    maxPriorityFeePerGas: bigint | undefined;
+    type: string;
+    nonce: string;
+    chainId?: string | undefined;
+    input: string;
+    gas: string;
+    blockHash: string;
+    blockNumber: string;
+    from: string;
+    hash: string;
+    r: string;
+    s: string;
+    v: string;
+    transactionIndex: string;
+    accessList?: {
+        address: string;
+        storageKeys: string[];
+    }[] | undefined;
+};
+export declare function blockDataFromELBlock(blockInfo: ELBlock): BlockData;
+export declare function cleanObject<T extends Record<string, unknown> | unknown[]>(obj: T): T;
+/**
+ * Convert an array to array of chunks
+ * @example
+ * chunkIntoN([1,2,3,4], 2)
+ * => [[1,2], [3,4]]
+ */
+export declare function chunkIntoN<T extends unknown[]>(arr: T, n: number): T[];
+//# sourceMappingURL=conversion.d.ts.map