@lodestar/prover 1.9.1

package/lib/utils/gitData/index.js

@@ -0,0 +1,68 @@
+import { execSync } from "node:child_process";
+// This file is created in the build step and is distributed through NPM
+// MUST be in sync with `-/gitDataPath.ts` and `package.json` files.
+import { readGitDataFile } from "./gitDataPath.js";
+/** Reads git data from a persisted file or local git data at build time. */
+export function readAndGetGitData() {
+    var _a, _b;
+    try {
+        // Gets git data containing current branch and commit info from persistent file.
+        let persistedGitData;
+        try {
+            persistedGitData = readGitDataFile();
+        }
+        catch (e) {
+            persistedGitData = {};
+        }
+        const currentGitData = getGitData();
+        return {
+            // If the CLI is run from source, prioritze current git data
+            // over `.git-data.json` file, which might be stale here.
+            branch: currentGitData.branch && currentGitData.branch.length > 0
+                ? currentGitData.branch
+                : (_a = persistedGitData.branch) !== null && _a !== void 0 ? _a : "",
+            commit: currentGitData.commit && currentGitData.commit.length > 0
+                ? currentGitData.commit
+                : (_b = persistedGitData.commit) !== null && _b !== void 0 ? _b : "",
+        };
+    }
+    catch (e) {
+        return {
+            branch: "",
+            commit: "",
+        };
+    }
+}
+/** Gets git data containing current branch and commit info from CLI. */
+export function getGitData() {
+    var _a, _b;
+    return {
+        branch: (_a = process.env.GIT_BRANCH) !== null && _a !== void 0 ? _a : getBranch(),
+        commit: (_b = process.env.GIT_COMMIT) !== null && _b !== void 0 ? _b : getCommit(),
+    };
+}
+/** Tries to get branch from git CLI. */
+function getBranch() {
+    try {
+        return shellSilent("git rev-parse --abbrev-ref HEAD");
+    }
+    catch (e) {
+        return "";
+    }
+}
+/** Tries to get commit from git from git CLI. */
+function getCommit() {
+    try {
+        return shellSilent("git rev-parse --verify HEAD");
+    }
+    catch (e) {
+        return "";
+    }
+}
+/** Silent shell that won't pollute stdout, or stderr */
+function shellSilent(cmd) {
+    return execSync(cmd, { stdio: ["ignore", "pipe", "ignore"] })
+        .toString()
+        .trim();
+}
+//# sourceMappingURL=index.js.map

package/lib/utils/gitData/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/gitData/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AAE5C,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EAAC,eAAe,EAAU,MAAM,kBAAkB,CAAC;AAE1D,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB;;IAC/B,IAAI;QACF,gFAAgF;QAChF,IAAI,gBAAkC,CAAC;QACvC,IAAI;YACF,gBAAgB,GAAG,eAAe,EAAE,CAAC;SACtC;QAAC,OAAO,CAAC,EAAE;YACV,gBAAgB,GAAG,EAAE,CAAC;SACvB;QAED,MAAM,cAAc,GAAG,UAAU,EAAE,CAAC;QAEpC,OAAO;YACL,4DAA4D;YAC5D,yDAAyD;YACzD,MAAM,EACJ,cAAc,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBACvD,CAAC,CAAC,cAAc,CAAC,MAAM;gBACvB,CAAC,CAAC,MAAA,gBAAgB,CAAC,MAAM,mCAAI,EAAE;YACnC,MAAM,EACJ,cAAc,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBACvD,CAAC,CAAC,cAAc,CAAC,MAAM;gBACvB,CAAC,CAAC,MAAA,gBAAgB,CAAC,MAAM,mCAAI,EAAE;SACpC,CAAC;KACH;IAAC,OAAO,CAAC,EAAE;QACV,OAAO;YACL,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;SACX,CAAC;KACH;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU;;IACxB,OAAO;QACL,MAAM,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,UAAU,mCAAI,SAAS,EAAE;QAC7C,MAAM,EAAE,MAAA,OAAO,CAAC,GAAG,CAAC,UAAU,mCAAI,SAAS,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,SAAS,SAAS;IAChB,IAAI;QACF,OAAO,WAAW,CAAC,iCAAiC,CAAC,CAAC;KACvD;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAED,iDAAiD;AACjD,SAAS,SAAS;IAChB,IAAI;QACF,OAAO,WAAW,CAAC,6BAA6B,CAAC,CAAC;KACnD;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,EAAE,CAAC;KACX;AACH,CAAC;AAED,wDAAwD;AACxD,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAC,CAAC;SACxD,QAAQ,EAAE;SACV,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/lib/utils/gitData/writeGitData.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=writeGitData.d.ts.map

package/lib/utils/gitData/writeGitData.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// For RATIONALE of this file, check packages/cli/src/util/gitData/gitDataPath.ts
+// Persist exact commit in NPM distributions for easier tracking of the build
+import { writeGitDataFile } from "./gitDataPath.js";
+import { getGitData } from "./index.js";
+// Script to write the git data file (json) used by the build procedures to persist git data.
+writeGitDataFile(getGitData());
+//# sourceMappingURL=writeGitData.js.map

package/lib/utils/gitData/writeGitData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeGitData.js","sourceRoot":"","sources":["../../../src/utils/gitData/writeGitData.ts"],"names":[],"mappings":";AAEA,iFAAiF;AACjF,6EAA6E;AAE7E,OAAO,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAC,UAAU,EAAC,MAAM,YAAY,CAAC;AAEtC,6FAA6F;AAC7F,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC"}

package/lib/utils/json_rpc.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from "@lodestar/logger";
+import { JsonRpcErrorPayload, JsonRpcNotificationPayload, JsonRpcRequestPayload, JsonRpcRequest, JsonRpcResponse, JsonRpcResponseWithErrorPayload, JsonRpcResponseWithResultPayload, JsonRpcResponseOrBatch, JsonRpcBatchResponse, JsonRpcRequestOrBatch, JsonRpcBatchRequest } from "../types.js";
+export declare function getResponseForRequest<P, R, E = unknown>(payload: JsonRpcRequest<P>, res?: R, error?: JsonRpcErrorPayload<E>): JsonRpcResponse<R, E>;
+export declare function getErrorResponseForUnverifiedRequest<P, D = unknown>(payload: JsonRpcRequest<P>, message: string, data?: D): JsonRpcResponseWithErrorPayload<D>;
+export declare function isValidResponse<R, E>(response: JsonRpcResponseOrBatch<R, E> | undefined): response is JsonRpcResponseWithResultPayload<R> | JsonRpcResponseWithResultPayload<R>[];
+export declare function isValidBatchResponse<R, E>(payload: JsonRpcBatchRequest, response: JsonRpcBatchResponse<R, E>): response is JsonRpcBatchResponse<R, E> | JsonRpcResponseWithResultPayload<R>[];
+export declare function mergeBatchReqResp(payload: JsonRpcBatchRequest, response: JsonRpcBatchResponse): {
+    request: JsonRpcRequest;
+    response: JsonRpcResponse;
+}[];
+export declare function isNotification<P>(payload: JsonRpcRequest<P>): payload is JsonRpcNotificationPayload<P>;
+export declare function isRequest<P>(payload: JsonRpcRequest<P>): payload is JsonRpcRequestPayload<P>;
+export declare function isBatchRequest<P>(payload: JsonRpcRequestOrBatch<P>): payload is JsonRpcBatchRequest<P>;
+export declare function isBatchResponse<R>(response: JsonRpcResponseOrBatch<R>): response is JsonRpcBatchResponse<R>;
+export declare function logRequest(payload: JsonRpcRequestOrBatch | undefined | null, logger: Logger): void;
+export declare function logResponse(response: JsonRpcResponseOrBatch | undefined, logger: Logger): void;
+//# sourceMappingURL=json_rpc.d.ts.map

package/lib/utils/json_rpc.js

@@ -0,0 +1,115 @@
+import { UNVERIFIED_RESPONSE_CODE } from "../constants.js";
+import { isNullish } from "./validation.js";
+export function getResponseForRequest(payload, res, error) {
+    // If it's a notification
+    if (!isRequest(payload)) {
+        throw new Error("Cannot generate response for notification");
+    }
+    if (!isNullish(res) && isNullish(error)) {
+        return {
+            jsonrpc: payload.jsonrpc,
+            id: payload.id,
+            result: res,
+        };
+    }
+    if (!isNullish(error)) {
+        return {
+            jsonrpc: payload.jsonrpc,
+            id: payload.id,
+            error,
+        };
+    }
+    throw new Error("Either result or error must be defined.");
+}
+export function getErrorResponseForUnverifiedRequest(payload, message, data) {
+    return isNullish(data)
+        ? getResponseForRequest(payload, undefined, {
+            code: UNVERIFIED_RESPONSE_CODE,
+            message,
+        })
+        : getResponseForRequest(payload, undefined, {
+            code: UNVERIFIED_RESPONSE_CODE,
+            message,
+            data,
+        });
+}
+function isValidResponsePayload(response) {
+    return !isNullish(response) && isNullish(response.error);
+}
+export function isValidResponse(response) {
+    return Array.isArray(response) ? response.every(isValidResponsePayload) : isValidResponsePayload(response);
+}
+export function isValidBatchResponse(payload, response) {
+    for (const [index, req] of payload.entries()) {
+        if (isRequest(req)) {
+            if (response[index].id !== req.id || !isValidResponse(response[index]))
+                return false;
+        }
+    }
+    return true;
+}
+export function mergeBatchReqResp(payload, response) {
+    const result = [];
+    for (const [index, req] of payload.entries()) {
+        if (isRequest(req)) {
+            // Some providers return raw json-rpc response, some return only result
+            // we need to just merge the result back based on the provider
+            result.push({ request: req, response: response[index] });
+        }
+    }
+    return result;
+}
+export function isNotification(payload) {
+    return !("id" in payload);
+}
+export function isRequest(payload) {
+    return "id" in payload;
+}
+export function isBatchRequest(payload) {
+    return Array.isArray(payload);
+}
+export function isBatchResponse(response) {
+    return Array.isArray(response);
+}
+function logRequestPayload(payload, logger) {
+    logger.debug("PR -> EL", {
+        id: isRequest(payload) ? payload.id : "notification",
+        method: payload.method,
+        params: JSON.stringify(payload.params),
+    });
+}
+export function logRequest(payload, logger) {
+    if (payload === undefined || payload === null) {
+        return;
+    }
+    for (const p of isBatchRequest(payload) ? payload : [payload]) {
+        logRequestPayload(p, logger);
+    }
+}
+function logResponsePayload(response, logger) {
+    if (response === undefined || response === null) {
+        logger.debug("PR <- EL (empty response)");
+        return;
+    }
+    if (isValidResponse(response)) {
+        logger.debug("PR <- EL", {
+            id: response.id,
+            result: JSON.stringify(response.result),
+        });
+    }
+    else {
+        logger.debug("PR <- E:", {
+            id: response.id,
+            error: JSON.stringify(response.error),
+        });
+    }
+}
+export function logResponse(response, logger) {
+    if (response === undefined || response === null) {
+        return;
+    }
+    for (const p of isBatchResponse(response) ? response : [response]) {
+        logResponsePayload(p, logger);
+    }
+}
+//# sourceMappingURL=json_rpc.js.map

package/lib/utils/json_rpc.js.map

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

package/lib/utils/logger.d.ts

@@ -0,0 +1,4 @@
+import { Logger } from "@lodestar/utils";
+import { LogOptions } from "../interfaces.js";
+export declare function getLogger(opts: LogOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/utils/logger.js

@@ -0,0 +1,12 @@
+import { getBrowserLogger } from "@lodestar/logger/browser";
+import { getEmptyLogger } from "@lodestar/logger/empty";
+export function getLogger(opts) {
+    if (opts.logger)
+        return opts.logger;
+    if (opts.logLevel) {
+        return getBrowserLogger({ level: opts.logLevel });
+    }
+    // For the case when user don't want to fill in the logs of consumer browser
+    return getEmptyLogger();
+}
+//# sourceMappingURL=logger.js.map

package/lib/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AAGtD,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAEpC,IAAI,IAAI,CAAC,QAAQ,EAAE;QACjB,OAAO,gBAAgB,CAAC,EAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAC,CAAC,CAAC;KACjD;IAED,4EAA4E;IAC5E,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC"}

package/lib/utils/process.d.ts

@@ -0,0 +1,20 @@
+import { Logger } from "@lodestar/logger";
+import { ELVerifiedRequestHandler } from "../interfaces.js";
+import { ProofProvider } from "../proof_provider/proof_provider.js";
+import { JsonRpcRequestOrBatch, JsonRpcBatchRequest, JsonRpcResponseOrBatch } from "../types.js";
+import { ELRpc } from "./rpc.js";
+export declare const verifiableMethodHandlers: Record<string, ELVerifiedRequestHandler<any, any>>;
+export declare const verifiableMethods: string[];
+export declare const alwaysAllowedMethods: string[];
+export declare function splitRequestsInChunks(payload: JsonRpcRequestOrBatch, unverifiedWhitelist?: string[]): {
+    verifiable: JsonRpcBatchRequest;
+    nonVerifiable: JsonRpcBatchRequest;
+    blocked: JsonRpcBatchRequest;
+};
+export declare function processAndVerifyRequest({ payload, rpc, proofProvider, logger, }: {
+    payload: JsonRpcRequestOrBatch;
+    rpc: ELRpc;
+    proofProvider: ProofProvider;
+    logger: Logger;
+}): Promise<JsonRpcResponseOrBatch | undefined>;
+//# sourceMappingURL=process.d.ts.map

package/lib/utils/process.js

@@ -0,0 +1,75 @@
+import { eth_getBalance } from "../verified_requests/eth_getBalance.js";
+import { eth_getTransactionCount } from "../verified_requests/eth_getTransactionCount.js";
+import { eth_getBlockByHash } from "../verified_requests/eth_getBlockByHash.js";
+import { eth_getBlockByNumber } from "../verified_requests/eth_getBlockByNumber.js";
+import { eth_getCode } from "../verified_requests/eth_getCode.js";
+import { eth_call } from "../verified_requests/eth_call.js";
+import { eth_estimateGas } from "../verified_requests/eth_estimateGas.js";
+import { getResponseForRequest, isBatchRequest, isRequest } from "./json_rpc.js";
+import { isNullish } from "./validation.js";
+/* eslint-disable @typescript-eslint/naming-convention, @typescript-eslint/no-explicit-any */
+export const verifiableMethodHandlers = {
+    eth_getBalance: eth_getBalance,
+    eth_getTransactionCount: eth_getTransactionCount,
+    eth_getBlockByHash: eth_getBlockByHash,
+    eth_getBlockByNumber: eth_getBlockByNumber,
+    eth_getCode: eth_getCode,
+    eth_call: eth_call,
+    eth_estimateGas: eth_estimateGas,
+};
+export const verifiableMethods = Object.keys(verifiableMethodHandlers);
+export const alwaysAllowedMethods = ["eth_subscribe", "eth_unsubscribe", "eth_getProof"];
+export function splitRequestsInChunks(payload, unverifiedWhitelist) {
+    const verifiable = [];
+    const nonVerifiable = [];
+    const blocked = [];
+    for (const pay of isBatchRequest(payload) ? payload : [payload]) {
+        if (isRequest(pay) && verifiableMethods.includes(pay.method)) {
+            verifiable.push(pay);
+            continue;
+        }
+        // If unverifiedWhitelist is not set that implies all methods are allowed
+        if ((isRequest(pay) && isNullish(unverifiedWhitelist)) || (unverifiedWhitelist === null || unverifiedWhitelist === void 0 ? void 0 : unverifiedWhitelist.includes(pay.method))) {
+            nonVerifiable.push(pay);
+            continue;
+        }
+        if (alwaysAllowedMethods.includes(pay.method)) {
+            nonVerifiable.push(pay);
+            continue;
+        }
+        blocked.push(pay);
+    }
+    return { verifiable, nonVerifiable, blocked };
+}
+export async function processAndVerifyRequest({ payload, rpc, proofProvider, logger, }) {
+    await proofProvider.waitToBeReady();
+    const { verifiable, nonVerifiable, blocked } = splitRequestsInChunks(payload, proofProvider.opts.unverifiedWhitelist);
+    const verifiedResponses = [];
+    const nonVerifiedResponses = [];
+    const blockedResponses = [];
+    for (const request of verifiable) {
+        logger.debug("Processing verifiable request", {
+            method: request.method,
+            params: JSON.stringify(request.params),
+        });
+        const verifiableRequestHandler = verifiableMethodHandlers[request.method];
+        const response = await verifiableRequestHandler({ payload: request, rpc, proofProvider, logger });
+        verifiedResponses.push(response);
+    }
+    if (nonVerifiable.length > 0) {
+        logger.warn("Forwarding non-verifiable requests to EL provider.", { count: nonVerifiable.length });
+        const response = await rpc.batchRequest(nonVerifiable, { raiseError: false });
+        nonVerifiedResponses.push(...response.map((r) => r.response));
+    }
+    for (const request of blocked) {
+        blockedResponses.push(getResponseForRequest(request, undefined, { message: `Method "${request.method}" not allowed.` }));
+    }
+    const responses = [...verifiedResponses, ...nonVerifiedResponses, ...blockedResponses];
+    if (responses.length === 1) {
+        return responses[0];
+    }
+    else {
+        return responses;
+    }
+}
+//# sourceMappingURL=process.js.map

package/lib/utils/process.js.map

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

package/lib/utils/req_resp.d.ts

@@ -0,0 +1,5 @@
+import http from "node:http";
+import { JsonRpcRequestPayload, JsonRpcResponse } from "../types.js";
+export declare const fetchRequestPayload: (req: http.IncomingMessage) => Promise<JsonRpcRequestPayload>;
+export declare const fetchResponseBody: (res: http.IncomingMessage) => Promise<JsonRpcResponse>;
+//# sourceMappingURL=req_resp.d.ts.map

package/lib/utils/req_resp.js

@@ -0,0 +1,33 @@
+export const fetchRequestPayload = async (req) => {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        req.on("data", (chunk) => {
+            body += chunk;
+        });
+        req.on("end", () => {
+            try {
+                resolve(JSON.parse(body));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    });
+};
+export const fetchResponseBody = async (res) => {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        res.on("data", (chunk) => {
+            body += chunk;
+        });
+        res.on("end", () => {
+            try {
+                resolve(JSON.parse(body));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    });
+};
+//# sourceMappingURL=req_resp.js.map

package/lib/utils/req_resp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"req_resp.js","sourceRoot":"","sources":["../../src/utils/req_resp.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,GAAyB,EAAkC,EAAE;IACrG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI;gBACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0B,CAAC,CAAC;aACpD;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,GAAG,CAAC,CAAC;aACb;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,GAAyB,EAA4B,EAAE;IAC7F,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,IAAI;gBACF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC,CAAC;aAC9C;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,CAAC,GAAG,CAAC,CAAC;aACb;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/lib/utils/rpc.d.ts

@@ -0,0 +1,26 @@
+import { Logger } from "@lodestar/logger";
+import { ELRequestHandler } from "../interfaces.js";
+import { ELApi, ELApiParams, ELApiReturn, JsonRpcBatchRequest, JsonRpcRequest, JsonRpcResponse, JsonRpcResponseWithResultPayload } from "../types.js";
+export type Optional<T, K extends keyof T> = Omit<T, K> & {
+    [P in keyof T]?: T[P] | undefined;
+};
+export declare class ELRpc {
+    private handler;
+    private logger;
+    constructor(handler: ELRequestHandler, logger: Logger);
+    request<K extends keyof ELApi, E extends boolean>(method: K, params: ELApiParams[K], opts: {
+        raiseError: E;
+    }): Promise<E extends false ? JsonRpcResponse<ELApiReturn[K]> : JsonRpcResponseWithResultPayload<ELApiReturn[K]>>;
+    batchRequest<E extends boolean>(input: JsonRpcBatchRequest, opts: {
+        raiseError: E;
+    }): Promise<E extends false ? {
+        request: JsonRpcRequest;
+        response: JsonRpcResponse;
+    }[] : {
+        request: JsonRpcRequest;
+        response: JsonRpcResponseWithResultPayload<unknown>;
+    }[]>;
+    verifyCompatibility(): Promise<void>;
+    private getRequestId;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/lib/utils/rpc.js

@@ -0,0 +1,55 @@
+import { ZERO_ADDRESS } from "../constants.js";
+import { isRequest, isValidBatchResponse, isValidResponse, logRequest, logResponse, mergeBatchReqResp, } from "./json_rpc.js";
+import { isNullish } from "./validation.js";
+export class ELRpc {
+    constructor(handler, logger) {
+        this.handler = handler;
+        this.logger = logger;
+    }
+    async request(method, params, opts) {
+        const { raiseError } = opts;
+        const payload = { jsonrpc: "2.0", method, params, id: this.getRequestId() };
+        logRequest(payload, this.logger);
+        const response = await this.handler(payload);
+        logResponse(response, this.logger);
+        if (raiseError && !isValidResponse(response)) {
+            throw new Error(`Invalid response from RPC. method=${method} params=${JSON.stringify(params)}`);
+        }
+        return response;
+    }
+    async batchRequest(input, opts) {
+        const payloads = [];
+        for (const req of input) {
+            if (isRequest(req) && isNullish(req.id)) {
+                payloads.push({ jsonrpc: "2.0", method: req.method, params: req.params, id: this.getRequestId() });
+            }
+            else {
+                payloads.push(req);
+            }
+        }
+        logRequest(payloads, this.logger);
+        const response = await this.handler(payloads);
+        logResponse(response, this.logger);
+        if (isNullish(response)) {
+            throw new Error("Invalid empty response from server.");
+        }
+        if (opts.raiseError && !isValidBatchResponse(payloads, response)) {
+            throw new Error(`Invalid response from RPC. payload=${JSON.stringify(payloads)} response=${JSON.stringify(response)}}`);
+        }
+        return mergeBatchReqResp(payloads, response);
+    }
+    async verifyCompatibility() {
+        try {
+            await this.request("eth_getProof", [ZERO_ADDRESS, [], "latest"], { raiseError: true });
+        }
+        catch (err) {
+            this.logger.error("Execution compatibility failed.", undefined, err);
+            throw new Error("RPC does not support 'eth_getProof', which is required for the prover to work properly.");
+        }
+    }
+    getRequestId() {
+        // TODO: Find better way to generate random id
+        return (Math.random() * 10000).toFixed(0);
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/lib/utils/rpc.js.map

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

package/lib/utils/validation.d.ts

@@ -0,0 +1,30 @@
+import { Bytes32, allForks } from "@lodestar/types";
+import { Logger } from "@lodestar/utils";
+import { ChainForkConfig } from "@lodestar/config";
+import { ELBlock, ELProof, ELStorageProof, HexString } from "../types.js";
+export declare function isBlockNumber(block: number | string): boolean;
+export declare function isValidAccount({ address, stateRoot, proof, logger, }: {
+    address: HexString;
+    stateRoot: Bytes32;
+    proof: ELProof;
+    logger: Logger;
+}): Promise<boolean>;
+export declare function isValidStorageKeys({ storageKeys, proof, logger, }: {
+    storageKeys: HexString[];
+    proof: ELStorageProof;
+    logger: Logger;
+}): Promise<boolean>;
+export declare function isValidBlock({ executionPayload, block, logger, config, }: {
+    executionPayload: allForks.ExecutionPayload;
+    block: ELBlock;
+    logger: Logger;
+    config: ChainForkConfig;
+}): Promise<boolean>;
+export declare function isValidCodeHash({ codeHash, codeResponse, }: {
+    codeHash: string;
+    codeResponse: string;
+    logger: Logger;
+}): Promise<boolean>;
+export declare function isNullish<T>(val: T | undefined | null): val is null | undefined;
+export declare function isPresent<T>(val: T | undefined | null): val is T;
+//# sourceMappingURL=validation.d.ts.map

package/lib/utils/validation.js

@@ -0,0 +1,94 @@
+import { Block } from "@ethereumjs/block";
+import { RLP } from "@ethereumjs/rlp";
+import { Trie } from "@ethereumjs/trie";
+import { Account, KECCAK256_NULL_S } from "@ethereumjs/util";
+import { keccak256 } from "ethereum-cryptography/keccak.js";
+import { blockDataFromELBlock, bufferToHex, hexToBuffer, padLeft } from "./conversion.js";
+import { getChainCommon } from "./execution.js";
+const emptyAccountSerialize = new Account().serialize();
+const storageKeyLength = 32;
+export function isBlockNumber(block) {
+    if (typeof block === "number") {
+        return true;
+    }
+    // If block is hex and less than 32 byte long it is a block number, else it's a block hash
+    return hexToBuffer(block).byteLength < 32;
+}
+export async function isValidAccount({ address, stateRoot, proof, logger, }) {
+    const trie = await Trie.create();
+    const key = keccak256(hexToBuffer(address));
+    try {
+        const expectedAccountRLP = await trie.verifyProof(Buffer.from(stateRoot), Buffer.from(key), proof.accountProof.map(hexToBuffer));
+        // Shresth Agrawal (2022) Patronum source code. https://github.com/lightclients/patronum
+        const account = Account.fromAccountData({
+            nonce: BigInt(proof.nonce),
+            balance: BigInt(proof.balance),
+            storageRoot: proof.storageHash,
+            codeHash: proof.codeHash,
+        });
+        return account.serialize().equals(expectedAccountRLP ? expectedAccountRLP : emptyAccountSerialize);
+    }
+    catch (err) {
+        logger.error("Error verifying account proof", undefined, err);
+        return false;
+    }
+}
+export async function isValidStorageKeys({ storageKeys, proof, logger, }) {
+    const trie = await Trie.create();
+    for (let i = 0; i < storageKeys.length; i++) {
+        const sp = proof.storageProof[i];
+        const key = keccak256(padLeft(hexToBuffer(storageKeys[i]), storageKeyLength));
+        try {
+            const expectedStorageRLP = await trie.verifyProof(hexToBuffer(proof.storageHash), Buffer.from(key), sp.proof.map(hexToBuffer));
+            const isStorageValid = (!expectedStorageRLP && sp.value === "0x0") ||
+                (!!expectedStorageRLP && expectedStorageRLP.equals(RLP.encode(sp.value)));
+            if (!isStorageValid)
+                return false;
+        }
+        catch (err) {
+            logger.error("Error verifying storage keys", undefined, err);
+            return false;
+        }
+    }
+    return true;
+}
+export async function isValidBlock({ executionPayload, block, logger, config, }) {
+    const common = getChainCommon(config.PRESET_BASE);
+    common.setHardforkByBlockNumber(executionPayload.blockNumber, undefined, executionPayload.timestamp);
+    const blockObject = Block.fromBlockData(blockDataFromELBlock(block), { common });
+    if (bufferToHex(executionPayload.blockHash) !== bufferToHex(blockObject.hash())) {
+        logger.error("Block hash does not match", {
+            rpcBlockHash: bufferToHex(blockObject.hash()),
+            beaconExecutionBlockHash: bufferToHex(executionPayload.blockHash),
+        });
+        return false;
+    }
+    if (bufferToHex(executionPayload.parentHash) !== bufferToHex(blockObject.header.parentHash)) {
+        logger.error("Block parent hash does not match", {
+            rpcBlockHash: bufferToHex(blockObject.header.parentHash),
+            beaconExecutionBlockHash: bufferToHex(executionPayload.parentHash),
+        });
+        return false;
+    }
+    if (!(await blockObject.validateTransactionsTrie())) {
+        logger.error("Block transactions could not be verified.", {
+            blockHash: bufferToHex(blockObject.hash()),
+            blockNumber: blockObject.header.number,
+        });
+        return false;
+    }
+    return true;
+}
+export async function isValidCodeHash({ codeHash, codeResponse, }) {
+    // if there is no code hash for that address
+    if (codeResponse === "0x" && codeHash === `0x${KECCAK256_NULL_S}`)
+        return true;
+    return bufferToHex(keccak256(hexToBuffer(codeResponse))) === codeHash;
+}
+export function isNullish(val) {
+    return val === null || val === undefined;
+}
+export function isPresent(val) {
+    return !isNullish(val);
+}
+//# sourceMappingURL=validation.js.map

package/lib/utils/validation.js.map

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