@lodestar/beacon-node 1.50.0-dev.fda8006fc3 → 1.50.0-dev.fe4e7408b4

package/lib/execution/engine/restTransport.d.ts

@@ -0,0 +1,46 @@
+import { ForkName } from "@lodestar/params";
+import { ExecutionPayload, ExecutionRequests, Root, RootHex } from "@lodestar/types";
+import { BlobAndProof } from "@lodestar/types/deneb";
+import { BlobAndProofV2 } from "@lodestar/types/fulu";
+import { ClientVersion, PayloadAttributes, PayloadId, VersionedHashes } from "./interface.js";
+import { JsonRpcHttpClientEventEmitter } from "./jsonRpcHttpClient.js";
+import { EngineRestHttpClient } from "./restHttpClient.js";
+import { ExecutionForkName } from "./sszTypes.js";
+import { ForkchoiceUpdatedResult, GetPayloadResult, IEngineTransport, PayloadStatusResult } from "./transport.js";
+import { ExecutionPayloadBodyV2 } from "./types.js";
+export type EngineCapabilities = {
+    supportedForks: Set<string>;
+    blobsRevisions: Set<string>;
+    limits: {
+        bodiesMaxCount: number;
+        blobsMaxVersionedHashes: number;
+        payloadMaxBytes: number;
+    };
+};
+export declare function toExecutionForkName(fork: ForkName): ExecutionForkName;
+/** The header format is not pinned by the spec, the JSON `ClientVersionV1` shape is what ELs parse today */
+export declare function formatClientVersionHeader(clientVersion: ClientVersion): string;
+/**
+ * REST engine API with SSZ encoded bodies
+ * https://github.com/ethereum/execution-apis/blob/main/src/engine/refactor.md
+ */
+export declare class RestEngineTransport implements IEngineTransport {
+    private readonly client;
+    private limits;
+    constructor(client: EngineRestHttpClient);
+    get emitter(): JsonRpcHttpClientEventEmitter;
+    /** Does not emit client events, a missing REST API must not be mistaken for an unhealthy engine */
+    getCapabilities(): Promise<EngineCapabilities>;
+    newPayload(fork: ForkName, executionPayload: ExecutionPayload, versionedHashes?: VersionedHashes, parentBeaconBlockRoot?: Root, executionRequests?: ExecutionRequests): Promise<PayloadStatusResult>;
+    forkchoiceUpdated(fork: ForkName, headBlockHash: RootHex, safeBlockHash: RootHex, finalizedBlockHash: RootHex, payloadAttributes?: PayloadAttributes): Promise<ForkchoiceUpdatedResult>;
+    getPayload(fork: ForkName, payloadId: PayloadId): Promise<GetPayloadResult>;
+    getPayloadBodiesByHashV2(blockHashes: RootHex[]): Promise<(ExecutionPayloadBodyV2 | null)[]>;
+    getBlobsV1(versionedHashes: VersionedHashes): Promise<(BlobAndProof | null)[]>;
+    /**
+     * Blobs and proofs are views into the response body rather than copies, the response is all-or-nothing
+     * so every byte of it is needed. The pooled buffers of the JSON-RPC transport are not used.
+     */
+    getBlobsV2(versionedHashes: VersionedHashes, _buffers?: Uint8Array[]): Promise<BlobAndProofV2[] | null>;
+    getClientVersion(_clientVersion: ClientVersion): Promise<ClientVersion[]>;
+}
+//# sourceMappingURL=restTransport.d.ts.map

package/lib/execution/engine/restTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restTransport.d.ts","sourceRoot":"","sources":["../../../src/execution/engine/restTransport.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,QAAQ,EAA+B,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAC,gBAAgB,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAiC,MAAM,iBAAiB,CAAC;AACnH,OAAO,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAEL,aAAa,EAEb,iBAAiB,EACjB,SAAS,EACT,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAC,6BAA6B,EAAU,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAC,oBAAoB,EAA0B,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAcL,iBAAiB,EAiBlB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAC,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,gBAAgB,CAAC;AAChH,OAAO,EACL,sBAAsB,EAIvB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,uBAAuB,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAC,CAAC;CAC5F,CAAC;AAuBF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAMrE;AAED,4GAA4G;AAC5G,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAE9E;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IAG9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAkB;IAEhC,YAA6B,MAAM,EAAE,oBAAoB,EAAI;IAE7D,IAAI,OAAO,IAAI,6BAA6B,CAE3C;IAED,mGAAmG;IAC7F,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA4CnD;IAEK,UAAU,CACd,IAAI,EAAE,QAAQ,EACd,gBAAgB,EAAE,gBAAgB,EAClC,eAAe,CAAC,EAAE,eAAe,EACjC,qBAAqB,CAAC,EAAE,IAAI,EAC5B,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;IAEK,iBAAiB,CACrB,IAAI,EAAE,QAAQ,EACd,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,kBAAkB,EAAE,OAAO,EAC3B,iBAAiB,CAAC,EAAE,iBAAiB,GACpC,OAAO,CAAC,uBAAuB,CAAC,CA4ClC;IAEK,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkEhF;IAEK,wBAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,sBAAsB,GAAG,IAAI,CAAC,EAAE,CAAC,CAkBjG;IAEK,UAAU,CAAC,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAgBnF;IAED;;;OAGG;IACG,UAAU,CAAC,eAAe,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CA0B5G;IAEK,gBAAgB,CAAC,cAAc,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA2B9E;CACF"}

package/lib/execution/engine/restTransport.js

@@ -0,0 +1,399 @@
+import { CELLS_PER_EXT_BLOB, ForkName, ForkSeq, isForkPostBellatrix } from "@lodestar/params";
+import { LodestarError, fromHex, strip0xPrefix, toHex, toRootHex } from "@lodestar/utils";
+import { isValidBlobVersionedHashes } from "./blobVersionedHashes.js";
+import { ClientCode, ExecutionPayloadStatus, } from "./interface.js";
+import { EngineRestResponseError } from "./restHttpClient.js";
+import { BlobsRequest, BlobsV1Response, BlobsV2Response, BodiesByHashRequest, BodiesResponseBellatrix, BodiesResponseCapella, BodiesResponseGloas, BuiltPayloadBellatrix, BuiltPayloadCapella, BuiltPayloadDeneb, BuiltPayloadElectra, BuiltPayloadFulu, BuiltPayloadGloas, ExecutionPayloadEnvelopeBellatrix, ExecutionPayloadEnvelopeCapella, ExecutionPayloadEnvelopeDeneb, ExecutionPayloadEnvelopeElectra, ExecutionPayloadEnvelopeGloas, ForkchoiceUpdateBellatrix, ForkchoiceUpdateCapella, ForkchoiceUpdateDeneb, ForkchoiceUpdateGloas, ForkchoiceUpdateResponse, MAX_BLOBS_REQUEST, MAX_BODIES_REQUEST, PayloadStatus, PayloadStatusCode, executionForkName, } from "./sszTypes.js";
+import { assertReqSizeLimit, deserializeExecutionRequestsFromBytes, serializeExecutionRequestsToBytes, } from "./types.js";
+const DEFAULT_LIMITS = {
+    bodiesMaxCount: MAX_BODIES_REQUEST,
+    blobsMaxVersionedHashes: MAX_BLOBS_REQUEST,
+    payloadMaxBytes: 2 ** 26,
+};
+/** Payload ids are opaque `Bytes8` tokens, hex encoded in the `GET /payloads/{payloadId}` path */
+const PAYLOAD_ID_REGEX = /^0x[0-9a-fA-F]{16}$/;
+const textDecoder = new TextDecoder();
+// Same route ids as the JSON-RPC transport so client metrics stay comparable across transports
+const notifyNewPayloadOpts = { routeId: "notifyNewPayload" };
+const forkchoiceUpdatedOpts = { routeId: "forkchoiceUpdated" };
+const getPayloadOpts = { routeId: "getPayload" };
+const getPayloadBodiesByHashOpts = { routeId: "getPayloadBodiesByHash" };
+const getBlobsV1Opts = { routeId: "getBlobsV1" };
+const getBlobsV2Opts = { routeId: "getBlobsV2" };
+const getClientVersionOpts = { routeId: "getClientVersion" };
+const getCapabilitiesOpts = { routeId: "getCapabilities", retries: 0 };
+export function toExecutionForkName(fork) {
+    const name = isForkPostBellatrix(fork) ? executionForkName[fork] : null;
+    if (name === null) {
+        throw Error(`No execution fork name for fork=${fork}`);
+    }
+    return name;
+}
+/** The header format is not pinned by the spec, the JSON `ClientVersionV1` shape is what ELs parse today */
+export function formatClientVersionHeader(clientVersion) {
+    return JSON.stringify({ ...clientVersion, commit: `0x${clientVersion.commit}` });
+}
+/**
+ * REST engine API with SSZ encoded bodies
+ * https://github.com/ethereum/execution-apis/blob/main/src/engine/refactor.md
+ */
+export class RestEngineTransport {
+    client;
+    limits = DEFAULT_LIMITS;
+    constructor(client) {
+        this.client = client;
+    }
+    get emitter() {
+        return this.client.emitter;
+    }
+    /** Does not emit client events, a missing REST API must not be mistaken for an unhealthy engine */
+    async getCapabilities() {
+        const { body } = await this.client.requestWithRetries({ method: "GET", path: "/capabilities", responseType: "json" }, getCapabilitiesOpts);
+        const capabilities = parseJson(body, "getCapabilities");
+        if (!isRecord(capabilities) ||
+            !Array.isArray(capabilities.supported_forks) ||
+            !capabilities.supported_forks.every(isString)) {
+            throw new EngineRestResponseError("getCapabilities", "supported_forks must be an array of strings");
+        }
+        const versioned = capabilities.independently_versioned;
+        if (versioned !== undefined && !isRecord(versioned)) {
+            throw new EngineRestResponseError("getCapabilities", "independently_versioned must be an object");
+        }
+        const blobs = versioned?.blobs ?? [];
+        if (!Array.isArray(blobs) || !blobs.every(isString)) {
+            throw new EngineRestResponseError("getCapabilities", "blobs revisions must be an array of strings");
+        }
+        const advertisedLimits = capabilities.limits;
+        if (advertisedLimits !== undefined && !isRecord(advertisedLimits)) {
+            throw new EngineRestResponseError("getCapabilities", "limits must be an object");
+        }
+        const limits = { ...DEFAULT_LIMITS };
+        for (const [key, name] of [
+            ["bodies.max_count", "bodiesMaxCount"],
+            ["blobs.max_versioned_hashes", "blobsMaxVersionedHashes"],
+            ["payload.max_bytes", "payloadMaxBytes"],
+        ]) {
+            const value = advertisedLimits?.[key];
+            if (value === undefined)
+                continue;
+            if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
+                throw new EngineRestResponseError("getCapabilities", `${key} must be a positive integer`);
+            }
+            limits[name] = Math.min(value, DEFAULT_LIMITS[name]);
+        }
+        this.limits = limits;
+        return {
+            supportedForks: new Set(capabilities.supported_forks.map((fork) => fork.toLowerCase())),
+            blobsRevisions: new Set(blobs.map((rev) => rev.toLowerCase())),
+            limits,
+        };
+    }
+    async newPayload(fork, executionPayload, versionedHashes, parentBeaconBlockRoot, executionRequests) {
+        let body;
+        if (ForkSeq[fork] >= ForkSeq.deneb) {
+            if (parentBeaconBlockRoot === undefined) {
+                throw Error(`parentBlockRoot required in notifyNewPayload for fork=${fork}`);
+            }
+            if (versionedHashes === undefined) {
+                throw Error(`versionedHashes required in notifyNewPayload for fork=${fork}`);
+            }
+            // The envelope omits the expected hashes, so the EL cannot run Deneb is_valid_versioned_hashes
+            if (!isValidBlobVersionedHashes(executionPayload.transactions, versionedHashes)) {
+                return {
+                    status: ExecutionPayloadStatus.INVALID,
+                    latestValidHash: null,
+                    validationError: "Payload blob versioned hashes do not match the beacon commitments",
+                };
+            }
+            if (ForkSeq[fork] >= ForkSeq.electra) {
+                if (executionRequests === undefined) {
+                    throw Error(`executionRequests required in notifyNewPayload for fork=${fork}`);
+                }
+                const requests = serializeExecutionRequestsToBytes(fork, executionRequests);
+                body =
+                    ForkSeq[fork] >= ForkSeq.gloas
+                        ? ExecutionPayloadEnvelopeGloas.serialize({
+                            payload: executionPayload,
+                            parentBeaconBlockRoot,
+                            executionRequests: requests,
+                        })
+                        : ExecutionPayloadEnvelopeElectra.serialize({
+                            payload: executionPayload,
+                            parentBeaconBlockRoot,
+                            executionRequests: requests,
+                        });
+            }
+            else {
+                body = ExecutionPayloadEnvelopeDeneb.serialize({
+                    payload: executionPayload,
+                    parentBeaconBlockRoot,
+                });
+            }
+        }
+        else if (ForkSeq[fork] >= ForkSeq.capella) {
+            body = ExecutionPayloadEnvelopeCapella.serialize({ payload: executionPayload });
+        }
+        else {
+            body = ExecutionPayloadEnvelopeBellatrix.serialize({ payload: executionPayload });
+        }
+        if (body.length > this.limits.payloadMaxBytes) {
+            throw new LodestarError({
+                code: "ENGINE_REST_REQUEST_TOO_LARGE",
+                size: body.length,
+                limit: this.limits.payloadMaxBytes,
+            });
+        }
+        const res = await this.client.request({ method: "POST", path: "/payloads", executionFork: toExecutionForkName(fork), body, responseType: "ssz" }, notifyNewPayloadOpts);
+        return toPayloadStatusResult(deserializeResponse(PayloadStatus, res.body, "notifyNewPayload"));
+    }
+    async forkchoiceUpdated(fork, headBlockHash, safeBlockHash, finalizedBlockHash, payloadAttributes) {
+        const forkchoiceState = {
+            headBlockHash: fromHex(headBlockHash),
+            safeBlockHash: fromHex(safeBlockHash),
+            finalizedBlockHash: fromHex(finalizedBlockHash),
+        };
+        let body;
+        if (ForkSeq[fork] >= ForkSeq.gloas) {
+            body = ForkchoiceUpdateGloas.serialize({
+                forkchoiceState,
+                payloadAttributes: payloadAttributes ? [toPayloadAttributesGloas(fork, payloadAttributes)] : [],
+                custodyColumns: [],
+            });
+        }
+        else if (ForkSeq[fork] >= ForkSeq.deneb) {
+            body = ForkchoiceUpdateDeneb.serialize({
+                forkchoiceState,
+                payloadAttributes: payloadAttributes ? [toPayloadAttributesDeneb(fork, payloadAttributes)] : [],
+            });
+        }
+        else if (ForkSeq[fork] >= ForkSeq.capella) {
+            body = ForkchoiceUpdateCapella.serialize({
+                forkchoiceState,
+                payloadAttributes: payloadAttributes ? [toPayloadAttributesCapella(fork, payloadAttributes)] : [],
+            });
+        }
+        else {
+            body = ForkchoiceUpdateBellatrix.serialize({
+                forkchoiceState,
+                payloadAttributes: payloadAttributes ? [toPayloadAttributesBellatrix(payloadAttributes)] : [],
+            });
+        }
+        // If we are just fcUing and not asking execution for payload, retry is not required
+        // and we can move on, as the next fcU will be issued soon on the new slot
+        const fcUReqOpts = payloadAttributes !== undefined ? forkchoiceUpdatedOpts : { ...forkchoiceUpdatedOpts, retries: 0 };
+        const res = await this.client.request({ method: "POST", path: "/forkchoice", executionFork: toExecutionForkName(fork), body, responseType: "ssz" }, fcUReqOpts);
+        const { payloadStatus, payloadId } = deserializeResponse(ForkchoiceUpdateResponse, res.body, "forkchoiceUpdated");
+        return {
+            payloadStatus: toPayloadStatusResult(payloadStatus),
+            payloadId: payloadId.length > 0 ? toHex(payloadId[0]) : null,
+        };
+    }
+    async getPayload(fork, payloadId) {
+        if (!PAYLOAD_ID_REGEX.test(payloadId)) {
+            throw Error(`Invalid payloadId=${payloadId}, expected 0x prefixed 8 bytes hex`);
+        }
+        const res = await this.client.request({ method: "GET", path: `/payloads/${payloadId}`, executionFork: toExecutionForkName(fork), responseType: "ssz" }, getPayloadOpts);
+        if (ForkSeq[fork] >= ForkSeq.gloas) {
+            const { payload, blockValue, blobsBundle, executionRequests, shouldOverrideBuilder } = deserializeResponse(BuiltPayloadGloas, res.body, "getPayload");
+            return {
+                executionPayload: payload,
+                executionPayloadValue: blockValue,
+                blobsBundle,
+                executionRequests: deserializeExecutionRequestsFromBytes(fork, executionRequests),
+                shouldOverrideBuilder,
+            };
+        }
+        if (ForkSeq[fork] >= ForkSeq.fulu) {
+            const { payload, blockValue, blobsBundle, executionRequests, shouldOverrideBuilder } = deserializeResponse(BuiltPayloadFulu, res.body, "getPayload");
+            return {
+                executionPayload: payload,
+                executionPayloadValue: blockValue,
+                blobsBundle,
+                executionRequests: deserializeExecutionRequestsFromBytes(fork, executionRequests),
+                shouldOverrideBuilder,
+            };
+        }
+        if (ForkSeq[fork] >= ForkSeq.electra) {
+            const { payload, blockValue, blobsBundle, executionRequests, shouldOverrideBuilder } = deserializeResponse(BuiltPayloadElectra, res.body, "getPayload");
+            return {
+                executionPayload: payload,
+                executionPayloadValue: blockValue,
+                blobsBundle,
+                executionRequests: deserializeExecutionRequestsFromBytes(fork, executionRequests),
+                shouldOverrideBuilder,
+            };
+        }
+        if (ForkSeq[fork] >= ForkSeq.deneb) {
+            const { payload, blockValue, blobsBundle, shouldOverrideBuilder } = deserializeResponse(BuiltPayloadDeneb, res.body, "getPayload");
+            return { executionPayload: payload, executionPayloadValue: blockValue, blobsBundle, shouldOverrideBuilder };
+        }
+        if (ForkSeq[fork] >= ForkSeq.capella) {
+            const { payload, blockValue } = deserializeResponse(BuiltPayloadCapella, res.body, "getPayload");
+            return { executionPayload: payload, executionPayloadValue: blockValue, shouldOverrideBuilder: false };
+        }
+        const { payload, blockValue } = deserializeResponse(BuiltPayloadBellatrix, res.body, "getPayload");
+        return { executionPayload: payload, executionPayloadValue: blockValue, shouldOverrideBuilder: false };
+    }
+    async getPayloadBodiesByHashV2(blockHashes) {
+        assertReqSizeLimit(blockHashes.length, this.limits.bodiesMaxCount);
+        const body = BodiesByHashRequest.serialize({ blockHashes: blockHashes.map((hash) => fromHex(hash)) });
+        const res = await this.client.request({
+            method: "POST",
+            path: "/bodies/hash",
+            executionFork: toExecutionForkName(ForkName.gloas),
+            body,
+            responseType: "ssz",
+        }, getPayloadBodiesByHashOpts);
+        const bodies = deserializeBodiesResponse(ForkName.gloas, res.body);
+        if (bodies.length !== blockHashes.length) {
+            throw Error(`Invalid bodies response length=${bodies.length} blockHashes=${blockHashes.length}`);
+        }
+        return bodies;
+    }
+    async getBlobsV1(versionedHashes) {
+        assertReqSizeLimit(versionedHashes.length, this.limits.blobsMaxVersionedHashes);
+        const res = await this.client.request({ method: "POST", path: "/blobs/v1", body: BlobsRequest.serialize({ versionedHashes }), responseType: "ssz" }, getBlobsV1Opts);
+        // 204 means the EL cannot serve blobs at all, e.g. while syncing
+        if (res.status === 204) {
+            return versionedHashes.map(() => null);
+        }
+        const { entries } = deserializeResponse(BlobsV1Response, res.body, "getBlobsV1");
+        if (entries.length !== versionedHashes.length) {
+            throw Error(`Invalid blobs/v1 response length=${entries.length} versionedHashes=${versionedHashes.length}`);
+        }
+        return entries.map((entry) => (entry.available ? entry.contents : null));
+    }
+    /**
+     * Blobs and proofs are views into the response body rather than copies, the response is all-or-nothing
+     * so every byte of it is needed. The pooled buffers of the JSON-RPC transport are not used.
+     */
+    async getBlobsV2(versionedHashes, _buffers) {
+        assertReqSizeLimit(versionedHashes.length, this.limits.blobsMaxVersionedHashes);
+        const res = await this.client.request({ method: "POST", path: "/blobs/v2", body: BlobsRequest.serialize({ versionedHashes }), responseType: "ssz" }, getBlobsV2Opts);
+        // blobs/v2 is all-or-nothing, 204 means at least one blob is missing or the EL cannot serve blobs
+        if (res.status === 204) {
+            return null;
+        }
+        const { entries } = deserializeResponse(BlobsV2Response, res.body, "getBlobsV2", { reuseBytes: true });
+        if (entries.length !== versionedHashes.length) {
+            throw Error(`Invalid blobs/v2 response length=${entries.length} versionedHashes=${versionedHashes.length}`);
+        }
+        if (entries.some((entry) => !entry.available)) {
+            return null;
+        }
+        return entries.map(({ contents }) => {
+            if (contents.proofs.length !== CELLS_PER_EXT_BLOB) {
+                throw Error(`Invalid proofs length ${contents.proofs.length}, expected ${CELLS_PER_EXT_BLOB}`);
+            }
+            return contents;
+        });
+    }
+    async getClientVersion(_clientVersion) {
+        const { body } = await this.client.request({ method: "GET", path: "/identity", responseType: "json" }, getClientVersionOpts);
+        const versions = parseJson(body, "getClientVersion");
+        if (!Array.isArray(versions)) {
+            throw new EngineRestResponseError("getClientVersion", "Expected an array of client versions");
+        }
+        return versions.map((cv, i) => {
+            if (!isRecord(cv) ||
+                typeof cv.code !== "string" ||
+                typeof cv.name !== "string" ||
+                typeof cv.version !== "string" ||
+                typeof cv.commit !== "string") {
+                throw new EngineRestResponseError("getClientVersion", `Invalid client version at index ${i}`);
+            }
+            const code = Object.hasOwn(ClientCode, cv.code) ? ClientCode[cv.code] : ClientCode.XX;
+            return {
+                code,
+                name: cv.name,
+                version: cv.version,
+                commit: strip0xPrefix(cv.commit),
+            };
+        });
+    }
+}
+function toPayloadAttributesBellatrix(attributes) {
+    return {
+        timestamp: attributes.timestamp,
+        prevRandao: attributes.prevRandao,
+        suggestedFeeRecipient: fromHex(attributes.suggestedFeeRecipient),
+    };
+}
+function toPayloadAttributesCapella(fork, attributes) {
+    if (attributes.withdrawals === undefined) {
+        throw Error(`withdrawals required in payload attributes for fork=${fork}`);
+    }
+    return { ...toPayloadAttributesBellatrix(attributes), withdrawals: attributes.withdrawals };
+}
+function toPayloadAttributesDeneb(fork, attributes) {
+    if (attributes.parentBeaconBlockRoot === undefined) {
+        throw Error(`parentBeaconBlockRoot required in payload attributes for fork=${fork}`);
+    }
+    return { ...toPayloadAttributesCapella(fork, attributes), parentBeaconBlockRoot: attributes.parentBeaconBlockRoot };
+}
+function toPayloadAttributesGloas(fork, attributes) {
+    if (attributes.slotNumber === undefined) {
+        throw Error(`slotNumber required in payload attributes for fork=${fork}`);
+    }
+    if (attributes.targetGasLimit === undefined) {
+        throw Error(`targetGasLimit required in payload attributes for fork=${fork}`);
+    }
+    return {
+        ...toPayloadAttributesDeneb(fork, attributes),
+        slotNumber: attributes.slotNumber,
+        targetGasLimit: attributes.targetGasLimit,
+    };
+}
+function toPayloadStatusResult(payloadStatus) {
+    const latestValidHash = payloadStatus.latestValidHash.length > 0 ? toRootHex(payloadStatus.latestValidHash[0]) : null;
+    const validationError = payloadStatus.validationError.length > 0 ? textDecoder.decode(payloadStatus.validationError[0]) : null;
+    switch (payloadStatus.status) {
+        case PayloadStatusCode.VALID:
+            return { status: ExecutionPayloadStatus.VALID, latestValidHash, validationError };
+        case PayloadStatusCode.INVALID:
+            return { status: ExecutionPayloadStatus.INVALID, latestValidHash, validationError };
+        case PayloadStatusCode.SYNCING:
+            return { status: ExecutionPayloadStatus.SYNCING, latestValidHash, validationError };
+        case PayloadStatusCode.ACCEPTED:
+            return { status: ExecutionPayloadStatus.ACCEPTED, latestValidHash, validationError };
+        default:
+            return {
+                status: ExecutionPayloadStatus.ELERROR,
+                latestValidHash: null,
+                validationError: `Unknown payload status code ${payloadStatus.status}`,
+            };
+    }
+}
+function deserializeBodiesResponse(fork, data) {
+    if (ForkSeq[fork] >= ForkSeq.gloas) {
+        return deserializeResponse(BodiesResponseGloas, data, "getPayloadBodiesByHash").entries.map((entry) => entry.available ? entry.body : null);
+    }
+    if (ForkSeq[fork] >= ForkSeq.capella) {
+        return deserializeResponse(BodiesResponseCapella, data, "getPayloadBodiesByHash").entries.map((entry) => entry.available ? { ...entry.body, blockAccessList: null } : null);
+    }
+    return deserializeResponse(BodiesResponseBellatrix, data, "getPayloadBodiesByHash").entries.map((entry) => entry.available ? { transactions: entry.body.transactions, withdrawals: null, blockAccessList: null } : null);
+}
+/** A 2xx response that does not decode is an execution client error, not an unreachable client */
+function deserializeResponse(type, body, routeId, opts) {
+    try {
+        return type.deserialize(body, opts);
+    }
+    catch (e) {
+        throw new EngineRestResponseError(routeId, `Invalid SSZ: ${e.message}`);
+    }
+}
+function parseJson(body, routeId) {
+    try {
+        return JSON.parse(textDecoder.decode(body));
+    }
+    catch (e) {
+        throw new EngineRestResponseError(routeId, `Invalid JSON: ${e.message}`);
+    }
+}
+function isString(value) {
+    return typeof value === "string";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=restTransport.js.map

package/lib/execution/engine/restTransport.js.map

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