@lodestar/prover 1.9.1

package/lib/cli/cmds/start/options.js

@@ -0,0 +1,67 @@
+import { DEFAULT_PROXY_REQUEST_TIMEOUT } from "../../../constants.js";
+import { LCTransport } from "../../../interfaces.js";
+import { alwaysAllowedMethods } from "../../../utils/process.js";
+export const startOptions = {
+    port: {
+        description: "Port number to start the proxy.",
+        type: "number",
+        default: 8080,
+    },
+    executionRpcUrl: {
+        description: "RPC url for the execution node.",
+        type: "string",
+        demandOption: true,
+        group: "execution",
+    },
+    unverifiedWhitelist: {
+        description: `Methods which are allowed to forward. If not provided, all methods are allowed. ${alwaysAllowedMethods.join(",")} are always allowed.`,
+        type: "array",
+        demandOption: false,
+        group: "execution",
+    },
+    requestTimeout: {
+        description: "Number of ms to wait for a response from the execution node.",
+        default: DEFAULT_PROXY_REQUEST_TIMEOUT,
+        type: "number",
+        demandOption: false,
+        group: "execution",
+    },
+    beaconUrls: {
+        description: "The beacon node PRC urls for 'rest' mode.",
+        type: "string",
+        array: true,
+        conflicts: ["beaconBootnodes"],
+        group: "beacon",
+    },
+    beaconBootnodes: {
+        description: "The beacon node PRC urls for 'p2p' mode.",
+        type: "string",
+        array: true,
+        conflicts: ["beaconUrls"],
+        group: "beacon",
+    },
+    wsCheckpoint: {
+        description: "The trusted checkpoint root to start the lightclient. If not provided will initialize from the latest finalized slot. It shouldn't be older than weak subjectivity period",
+        type: "string",
+        demandOption: false,
+        group: "beacon",
+    },
+};
+export function parseStartArgs(args) {
+    var _a, _b, _c;
+    if (!args.beaconUrls && !args.beaconBootnodes) {
+        throw new Error("Either --beaconUrls or --beaconBootnodes must be provided");
+    }
+    // Remove undefined values to allow deepmerge to inject default values downstream
+    return {
+        port: args.port,
+        executionRpcUrl: args.executionRpcUrl,
+        transport: args.beaconUrls ? LCTransport.Rest : LCTransport.P2P,
+        urls: (_a = args.beaconUrls) !== null && _a !== void 0 ? _a : [],
+        bootnodes: (_b = args.beaconBootnodes) !== null && _b !== void 0 ? _b : [],
+        wsCheckpoint: args.wsCheckpoint,
+        unverifiedWhitelist: args.unverifiedWhitelist,
+        requestTimeout: (_c = args.requestTimeout) !== null && _c !== void 0 ? _c : DEFAULT_PROXY_REQUEST_TIMEOUT,
+    };
+}
+//# sourceMappingURL=options.js.map

package/lib/cli/cmds/start/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/cli/cmds/start/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,6BAA6B,EAAC,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAEnD,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAoB/D,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,IAAI,EAAE;QACJ,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI;KACd;IAED,eAAe,EAAE;QACf,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,WAAW;KACnB;IAED,mBAAmB,EAAE;QACnB,WAAW,EAAE,mFAAmF,oBAAoB,CAAC,IAAI,CACvH,GAAG,CACJ,sBAAsB;QACvB,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,WAAW;KACnB;IAED,cAAc,EAAE;QACd,WAAW,EAAE,8DAA8D;QAC3E,OAAO,EAAE,6BAA6B;QACtC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,WAAW;KACnB;IAED,UAAU,EAAE;QACV,WAAW,EAAE,2CAA2C;QACxD,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,CAAC,iBAAiB,CAAC;QAC9B,KAAK,EAAE,QAAQ;KAChB;IAED,eAAe,EAAE;QACf,WAAW,EAAE,0CAA0C;QACvD,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,KAAK,EAAE,QAAQ;KAChB;IAED,YAAY,EAAE;QACZ,WAAW,EACT,2KAA2K;QAC7K,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,KAAK;QACnB,KAAK,EAAE,QAAQ;KAChB;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAe;;IAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;QAC7C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;KAC9E;IAED,iFAAiF;IACjF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG;QAC/D,IAAI,EAAE,MAAA,IAAI,CAAC,UAAU,mCAAI,EAAE;QAC3B,SAAS,EAAE,MAAA,IAAI,CAAC,eAAe,mCAAI,EAAE;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,cAAc,EAAE,MAAA,IAAI,CAAC,cAAc,mCAAI,6BAA6B;KACrE,CAAC;AACJ,CAAC"}

package/lib/cli/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import "./applyPreset.js";
+import "source-map-support/register.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/cli/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// MUST import first to apply preset from args
+import "./applyPreset.js";
+import { YargsError } from "../utils/errors.js";
+import { getLodestarProverCli, yarg } from "./cli.js";
+import "source-map-support/register.js";
+const prover = getLodestarProverCli();
+void prover
+    .fail((msg, err) => {
+    if (msg) {
+        // Show command help message when no command is provided
+        if (msg.includes("Not enough non-option arguments")) {
+            yarg.showHelp();
+            // eslint-disable-next-line no-console
+            console.log("\n");
+        }
+    }
+    const errorMessage = err !== undefined ? (err instanceof YargsError ? err.message : err.stack) : msg || "Unknown error";
+    // eslint-disable-next-line no-console
+    console.error(` ✖ ${errorMessage}\n`);
+    process.exit(1);
+})
+    // Execute CLI
+    .parse();
+//# sourceMappingURL=index.js.map

package/lib/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,8CAA8C;AAC9C,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAC,oBAAoB,EAAE,IAAI,EAAC,MAAM,UAAU,CAAC;AACpD,OAAO,gCAAgC,CAAC;AAExC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;AAEtC,KAAK,MAAM;KACR,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACjB,IAAI,GAAG,EAAE;QACP,wDAAwD;QACxD,IAAI,GAAG,CAAC,QAAQ,CAAC,iCAAiC,CAAC,EAAE;YACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,sCAAsC;YACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;SACnB;KACF;IAED,MAAM,YAAY,GAChB,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,eAAe,CAAC;IAErG,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;IAEF,cAAc;KACb,KAAK,EAAE,CAAC"}

package/lib/cli/options.d.ts

@@ -0,0 +1,22 @@
+import { NetworkName } from "@lodestar/config/networks";
+import { LogLevel } from "@lodestar/utils";
+import { CliCommandOptions } from "../utils/command.js";
+export type GlobalArgs = {
+    network: string;
+    logLevel: string;
+    presetFile?: string;
+    preset: string;
+    paramsFile: string;
+};
+export type GlobalOptions = {
+    logLevel: LogLevel;
+} & ({
+    paramsFile: string;
+    network?: never;
+} | {
+    network: NetworkName;
+    paramsFile?: never;
+});
+export declare const globalOptions: CliCommandOptions<GlobalArgs>;
+export declare function parseGlobalArgs(args: GlobalArgs): GlobalOptions;
+//# sourceMappingURL=options.d.ts.map

package/lib/cli/options.js

@@ -0,0 +1,50 @@
+import { networksChainConfig } from "@lodestar/config/networks";
+import { LogLevels } from "@lodestar/utils";
+import { ACTIVE_PRESET } from "@lodestar/params";
+export const globalOptions = {
+    network: {
+        description: "Specify the network to connect.",
+        type: "string",
+        choices: [
+            ...Object.keys(networksChainConfig),
+            "dev",
+        ],
+        conflicts: ["paramsFile"],
+    },
+    paramsFile: {
+        description: "Network configuration file",
+        type: "string",
+        conflicts: ["network"],
+    },
+    logLevel: {
+        description: "Set the log level.",
+        type: "string",
+        choices: LogLevels,
+        default: "info",
+    },
+    // hidden option to allow for LODESTAR_PRESET to be set
+    preset: {
+        hidden: true,
+        type: "string",
+        default: ACTIVE_PRESET,
+    },
+    presetFile: {
+        hidden: true,
+        description: "Preset configuration file to override the active preset with custom values",
+        type: "string",
+    },
+};
+export function parseGlobalArgs(args) {
+    // Remove undefined values to allow deepmerge to inject default values downstream
+    if (args.network) {
+        return {
+            network: args.network,
+            logLevel: args.logLevel,
+        };
+    }
+    return {
+        logLevel: args.logLevel,
+        paramsFile: args.paramsFile,
+    };
+}
+//# sourceMappingURL=options.js.map

package/lib/cli/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/cli/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAW,SAAS,EAAC,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAe/C,MAAM,CAAC,MAAM,aAAa,GAAkC;IAC1D,OAAO,EAAE;QACP,WAAW,EAAE,iCAAiC;QAC9C,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC;YACnC,KAAK;SACN;QACD,SAAS,EAAE,CAAC,YAAY,CAAC;KAC1B;IAED,UAAU,EAAE;QACV,WAAW,EAAE,4BAA4B;QACzC,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,CAAC,SAAS,CAAC;KACvB;IAED,QAAQ,EAAE;QACR,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;QAClB,OAAO,EAAE,MAAM;KAChB;IAED,uDAAuD;IACvD,MAAM,EAAE;QACN,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,aAAa;KACvB;IAED,UAAU,EAAE;QACV,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,QAAQ;KACf;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,iFAAiF;IACjF,IAAI,IAAI,CAAC,OAAO,EAAE;QAChB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAsB;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAoB;SACpC,CAAC;KACH;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAoB;QACnC,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC;AACJ,CAAC"}

package/lib/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const MAX_REQUEST_LIGHT_CLIENT_UPDATES = 128;
+export declare const MAX_PAYLOAD_HISTORY = 32;
+export declare const UNVERIFIED_RESPONSE_CODE = -33091;
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const DEFAULT_PROXY_REQUEST_TIMEOUT = 3000;
+//# sourceMappingURL=constants.d.ts.map

package/lib/constants.js

@@ -0,0 +1,7 @@
+// https://github.com/ethereum/consensus-specs/blob/dev/specs/altair/light-client/p2p-interface.md#configuration
+export const MAX_REQUEST_LIGHT_CLIENT_UPDATES = 128;
+export const MAX_PAYLOAD_HISTORY = 32;
+export const UNVERIFIED_RESPONSE_CODE = -33091;
+export const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export const DEFAULT_PROXY_REQUEST_TIMEOUT = 3000;
+//# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AACzE,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./interfaces.js";
+export { createVerifiedExecutionProvider } from "./web3_provider.js";
+export { createVerifiedExecutionProxy } from "./web3_proxy.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.js

@@ -0,0 +1,4 @@
+export * from "./interfaces.js";
+export { createVerifiedExecutionProvider } from "./web3_provider.js";
+export { createVerifiedExecutionProxy } from "./web3_proxy.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAC,+BAA+B,EAAC,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAAC,4BAA4B,EAAC,MAAM,iBAAiB,CAAC"}

package/lib/index.web.d.ts

@@ -0,0 +1,3 @@
+export * from "./interfaces.js";
+export { createVerifiedExecutionProvider } from "./web3_provider.js";
+//# sourceMappingURL=index.web.d.ts.map

package/lib/index.web.js

@@ -0,0 +1,3 @@
+export * from "./interfaces.js";
+export { createVerifiedExecutionProvider } from "./web3_provider.js";
+//# sourceMappingURL=index.web.js.map

package/lib/index.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.js","sourceRoot":"","sources":["../src/index.web.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAC,+BAA+B,EAAC,MAAM,oBAAoB,CAAC"}

package/lib/interfaces.d.ts

@@ -0,0 +1,69 @@
+import { ChainConfig } from "@lodestar/config";
+import { NetworkName } from "@lodestar/config/networks";
+import { Logger, LogLevel } from "@lodestar/utils";
+import { ProofProvider } from "./proof_provider/proof_provider.js";
+import { JsonRpcRequest, JsonRpcRequestOrBatch, JsonRpcResponse, JsonRpcResponseOrBatch } from "./types.js";
+import { ELRpc } from "./utils/rpc.js";
+export declare enum LCTransport {
+    Rest = "Rest",
+    P2P = "P2P"
+}
+export type NetworkOrConfig = {
+    network: NetworkName;
+    config?: never;
+} | {
+    network?: never;
+    config: Partial<ChainConfig>;
+};
+export type RootProviderInitOptions = ConsensusNodeOptions & NetworkOrConfig & {
+    signal: AbortSignal;
+    logger: Logger;
+    wsCheckpoint?: string;
+    unverifiedWhitelist?: string[];
+};
+export type ELRequestHandler<Params = unknown[], Response = unknown> = (payload: JsonRpcRequestOrBatch<Params>) => Promise<JsonRpcResponseOrBatch<Response> | undefined>;
+export type ELRequestHandlerAny = ELRequestHandler<any, any>;
+export interface EIP1193Provider {
+    request: (payload: JsonRpcRequestOrBatch) => Promise<JsonRpcResponseOrBatch>;
+}
+export interface RequestProvider {
+    request(payload: JsonRpcRequestOrBatch, callback: (err: Error | undefined, response: JsonRpcResponseOrBatch) => void): void;
+}
+export interface SendProvider {
+    send(payload: JsonRpcRequest, callback: (err?: Error | null, response?: JsonRpcResponse) => void): void;
+}
+export interface EthersProvider {
+    send(method: string, params: Array<unknown>): Promise<JsonRpcResponse>;
+}
+export interface SendAsyncProvider {
+    sendAsync(payload: JsonRpcRequestOrBatch): Promise<JsonRpcResponseOrBatch>;
+}
+export type Web3Provider = SendProvider | EthersProvider | SendAsyncProvider | RequestProvider | EIP1193Provider;
+export type ELVerifiedRequestHandlerOpts<Params = unknown[]> = {
+    payload: JsonRpcRequest<Params>;
+    rpc: ELRpc;
+    proofProvider: ProofProvider;
+    logger: Logger;
+};
+export type ELVerifiedRequestHandler<Params = unknown[], Response = unknown> = (opts: ELVerifiedRequestHandlerOpts<Params>) => Promise<JsonRpcResponse<Response>>;
+export type LogOptions = {
+    logger?: Logger;
+    logLevel?: never;
+} | {
+    logLevel?: LogLevel;
+    logger?: never;
+};
+export type ConsensusNodeOptions = {
+    transport: LCTransport.Rest;
+    urls: string[];
+} | {
+    transport: LCTransport.P2P;
+    bootnodes: string[];
+};
+export type RootProviderOptions = {
+    signal?: AbortSignal;
+    wsCheckpoint?: string;
+    unverifiedWhitelist?: string[];
+};
+export type VerifiedExecutionInitOptions = LogOptions & ConsensusNodeOptions & NetworkOrConfig & RootProviderOptions;
+//# sourceMappingURL=interfaces.d.ts.map

package/lib/interfaces.js

@@ -0,0 +1,6 @@
+export var LCTransport;
+(function (LCTransport) {
+    LCTransport["Rest"] = "Rest";
+    LCTransport["P2P"] = "P2P";
+})(LCTransport || (LCTransport = {}));
+//# sourceMappingURL=interfaces.js.map

package/lib/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,4BAAa,CAAA;IACb,0BAAW,CAAA;AACb,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB"}

package/lib/proof_provider/ordered_map.d.ts

@@ -0,0 +1,8 @@
+export declare class OrderedMap<T> extends Map<number, T> {
+    private _min;
+    private _max;
+    get min(): number;
+    get max(): number;
+    set(key: number, value: T): this;
+}
+//# sourceMappingURL=ordered_map.d.ts.map

package/lib/proof_provider/ordered_map.js

@@ -0,0 +1,24 @@
+export class OrderedMap extends Map {
+    constructor() {
+        super(...arguments);
+        this._min = 0;
+        this._max = 0;
+    }
+    get min() {
+        return this._min;
+    }
+    get max() {
+        return this._max;
+    }
+    set(key, value) {
+        if (key < this._min) {
+            this._min = key;
+        }
+        if (key > this._max) {
+            this._max = key;
+        }
+        super.set(key, value);
+        return this;
+    }
+}
+//# sourceMappingURL=ordered_map.js.map

package/lib/proof_provider/ordered_map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordered_map.js","sourceRoot":"","sources":["../../src/proof_provider/ordered_map.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAc,SAAQ,GAAc;IAAjD;;QACU,SAAI,GAAG,CAAC,CAAC;QACT,SAAI,GAAG,CAAC,CAAC;IAsBnB,CAAC;IApBC,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAQ;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE;YACnB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;SACjB;QAED,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE;YACnB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;SACjB;QAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/proof_provider/payload_store.d.ts

@@ -0,0 +1,25 @@
+import { Api } from "@lodestar/api";
+import { allForks, capella } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+/**
+ * The in-memory store for the execution payloads to be used to verify the proofs
+ */
+export declare class PayloadStore {
+    private opts;
+    private finalizedRoots;
+    private unfinalizedRoots;
+    private payloads;
+    private latestBlockRoot;
+    constructor(opts: {
+        api: Api;
+        logger: Logger;
+    });
+    get finalized(): allForks.ExecutionPayload | undefined;
+    get latest(): allForks.ExecutionPayload | undefined;
+    get(blockId: number | string): Promise<allForks.ExecutionPayload | undefined>;
+    getOrFetchFinalizedPayload(blockNumber: number): Promise<allForks.ExecutionPayload | undefined>;
+    set(payload: allForks.ExecutionPayload, finalized: boolean): void;
+    processLCHeader(header: capella.LightClientHeader, finalized?: boolean): Promise<void>;
+    private prune;
+}
+//# sourceMappingURL=payload_store.d.ts.map

package/lib/proof_provider/payload_store.js

@@ -0,0 +1,154 @@
+import { MAX_PAYLOAD_HISTORY } from "../constants.js";
+import { getExecutionPayloadForBlockNumber, getExecutionPayloads } from "../utils/consensus.js";
+import { bufferToHex, hexToNumber } from "../utils/conversion.js";
+import { OrderedMap } from "./ordered_map.js";
+/**
+ * The in-memory store for the execution payloads to be used to verify the proofs
+ */
+export class PayloadStore {
+    constructor(opts) {
+        this.opts = opts;
+        // We store the block numbers only for finalized blocks
+        this.finalizedRoots = new OrderedMap();
+        // Unfinalized blocks are stored by the roots of the beacon chain
+        this.unfinalizedRoots = new Map();
+        // Payloads store with BlockELRoot as key
+        this.payloads = new Map();
+        this.latestBlockRoot = null;
+    }
+    get finalized() {
+        const finalizedMaxRoot = this.finalizedRoots.get(this.finalizedRoots.max);
+        if (finalizedMaxRoot) {
+            return this.payloads.get(finalizedMaxRoot);
+        }
+        return undefined;
+    }
+    get latest() {
+        if (this.latestBlockRoot) {
+            return this.payloads.get(this.latestBlockRoot);
+        }
+        return undefined;
+    }
+    async get(blockId) {
+        // Given block id is a block hash in hex (32 bytes root takes 64 hex chars + 2 for 0x prefix)
+        if (typeof blockId === "string" && blockId.startsWith("0x") && blockId.length === 64 + 2) {
+            return this.payloads.get(blockId);
+        }
+        // Given block id is a block number in hex
+        if (typeof blockId === "string" && blockId.startsWith("0x")) {
+            return this.getOrFetchFinalizedPayload(hexToNumber(blockId));
+        }
+        // Given block id is a block number in decimal string
+        if (typeof blockId === "string" && !blockId.startsWith("0x")) {
+            return this.getOrFetchFinalizedPayload(parseInt(blockId, 10));
+        }
+        // Given block id is a block number in decimal
+        if (typeof blockId === "number") {
+            return this.getOrFetchFinalizedPayload(blockId);
+        }
+        return undefined;
+    }
+    async getOrFetchFinalizedPayload(blockNumber) {
+        if (blockNumber > this.finalizedRoots.max) {
+            throw new Error(`Block number ${blockNumber} is higher than the latest finalized block number. We recommend to use block hash for unfinalized blocks.`);
+        }
+        let blockELRoot = this.finalizedRoots.get(blockNumber);
+        // check if we have payload cached locally else fetch from api
+        if (!blockELRoot) {
+            const payloads = await getExecutionPayloadForBlockNumber(this.opts.api, this.finalizedRoots.min, blockNumber);
+            for (const payload of Object.values(payloads)) {
+                this.set(payload, true);
+            }
+        }
+        blockELRoot = this.finalizedRoots.get(blockNumber);
+        if (blockELRoot) {
+            return this.payloads.get(blockELRoot);
+        }
+        return undefined;
+    }
+    set(payload, finalized) {
+        const blockRoot = bufferToHex(payload.blockHash);
+        this.payloads.set(blockRoot, payload);
+        if (this.latestBlockRoot) {
+            const latestPayload = this.payloads.get(this.latestBlockRoot);
+            if (latestPayload && latestPayload.blockNumber < payload.blockNumber) {
+                this.latestBlockRoot = blockRoot;
+            }
+        }
+        else {
+            this.latestBlockRoot = blockRoot;
+        }
+        if (finalized) {
+            this.finalizedRoots.set(payload.blockNumber, blockRoot);
+        }
+    }
+    async processLCHeader(header, finalized = false) {
+        const blockSlot = header.beacon.slot;
+        const blockNumber = header.execution.blockNumber;
+        const blockELRoot = bufferToHex(header.execution.blockHash);
+        const blockCLRoot = bufferToHex(header.beacon.stateRoot);
+        const existingELRoot = this.unfinalizedRoots.get(blockCLRoot);
+        // ==== Finalized blocks ====
+        // if the block is finalized, we need to update the finalizedRoots map
+        if (finalized) {
+            this.finalizedRoots.set(blockNumber, blockELRoot);
+            // If the block is finalized and we already have the payload
+            // We can remove it from the unfinalizedRoots map and do nothing else
+            if (existingELRoot) {
+                this.unfinalizedRoots.delete(blockCLRoot);
+            }
+            // If the block is finalized and we do not have the payload
+            // We need to fetch and set the payload
+            else if (finalized && !existingELRoot) {
+                this.payloads.set(bufferToHex(header.execution.blockHash), (await getExecutionPayloads({
+                    api: this.opts.api,
+                    startSlot: blockSlot,
+                    endSlot: blockSlot,
+                    logger: this.opts.logger,
+                }))[blockSlot]);
+            }
+            return;
+        }
+        // ==== Unfinalized blocks ====
+        // We already have the payload for this block
+        if (existingELRoot && existingELRoot === blockELRoot) {
+            return;
+        }
+        // Re-org happened, we need to update the payload
+        if (existingELRoot && existingELRoot !== blockELRoot) {
+            this.payloads.delete(existingELRoot);
+            this.unfinalizedRoots.set(blockCLRoot, blockELRoot);
+        }
+        // We do not have the payload for this block, we need to fetch it
+        const payload = (await getExecutionPayloads({
+            api: this.opts.api,
+            startSlot: blockSlot,
+            endSlot: blockSlot,
+            logger: this.opts.logger,
+        }))[blockSlot];
+        this.set(payload, false);
+        this.prune();
+    }
+    prune() {
+        if (this.finalizedRoots.size <= MAX_PAYLOAD_HISTORY)
+            return;
+        for (let blockNumber = this.finalizedRoots.max - MAX_PAYLOAD_HISTORY; blockNumber > this.finalizedRoots.min; blockNumber--) {
+            const blockELRoot = this.finalizedRoots.get(blockNumber);
+            if (blockELRoot) {
+                this.payloads.delete(blockELRoot);
+                this.finalizedRoots.delete(blockNumber);
+            }
+        }
+        for (const [clRoot, elRoot] of this.unfinalizedRoots) {
+            const payload = this.payloads.get(elRoot);
+            if (!payload) {
+                this.unfinalizedRoots.delete(clRoot);
+                continue;
+            }
+            if (payload.blockNumber < this.finalizedRoots.min) {
+                this.unfinalizedRoots.delete(clRoot);
+            }
+        }
+    }
+}
+//# sourceMappingURL=payload_store.js.map

package/lib/proof_provider/payload_store.js.map

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

package/lib/proof_provider/proof_provider.d.ts

@@ -0,0 +1,36 @@
+import { Api } from "@lodestar/api/beacon";
+import { ChainForkConfig } from "@lodestar/config";
+import { NetworkName } from "@lodestar/config/networks";
+import { Lightclient, RunStatusCode } from "@lodestar/light-client";
+import { LightClientRestTransport } from "@lodestar/light-client/transport";
+import { allForks } from "@lodestar/types";
+import { RootProviderInitOptions } from "../interfaces.js";
+type RootProviderOptions = Omit<RootProviderInitOptions, "transport"> & {
+    transport: LightClientRestTransport;
+    api: Api;
+    config: ChainForkConfig;
+};
+export declare class ProofProvider {
+    readonly opts: RootProviderOptions;
+    private store;
+    private logger;
+    private readyPromise?;
+    readonly config: ChainForkConfig;
+    readonly network: NetworkName;
+    readonly api: Api;
+    lightClient?: Lightclient;
+    constructor(opts: RootProviderOptions);
+    waitToBeReady(): Promise<void>;
+    static init(opts: RootProviderInitOptions): ProofProvider;
+    private sync;
+    getStatus(): {
+        latest: number;
+        finalized: number;
+        status: RunStatusCode;
+    };
+    getExecutionPayload(blockNumber: number | string | "finalized" | "latest"): Promise<allForks.ExecutionPayload>;
+    processLCHeader(lcHeader: allForks.LightClientHeader, finalized?: boolean): Promise<void>;
+    private registerEvents;
+}
+export {};
+//# sourceMappingURL=proof_provider.d.ts.map