@lodestar/beacon-node 1.50.0-dev.08c4bed201 → 1.50.0-dev.09bef4706f

package/lib/execution/engine/restHttpClient.js

@@ -0,0 +1,201 @@
+import { ErrorAborted, FetchError, LodestarError, TimeoutError, fetch, isValidHttpUrl, retry } from "@lodestar/utils";
+import { JsonRpcHttpClientEvent, JsonRpcHttpClientEventEmitter, } from "./jsonRpcHttpClient.js";
+import { encodeJwtToken } from "./jwt.js";
+export const ENGINE_REST_BASE_PATH = "/engine/v1";
+export const EXECUTION_VERSION_HEADER = "Eth-Execution-Version";
+export const CLIENT_VERSION_HEADER = "X-Engine-Client-Version";
+export const MEDIA_TYPE_SSZ = "application/octet-stream";
+export const MEDIA_TYPE_JSON = "application/json";
+const REQUEST_TIMEOUT = 30 * 1000;
+/** Limits the amount of error detail printed with REST errors */
+const MAX_ERROR_DETAIL_LENGTH = 500;
+/** Non-2xx response, `type` and `detail` are taken from the problem+json body when present */
+export class EngineRestError extends Error {
+    status;
+    type;
+    detail;
+    constructor(status, type, detail, routeId) {
+        super(`Engine REST error: status=${status} type=${type ?? "unknown"}${detail ? ` detail=${detail}` : ""}, ${routeId}`);
+        this.status = status;
+        this.type = type;
+        this.detail = detail;
+    }
+}
+export class EngineRestResponseError extends LodestarError {
+    constructor(routeId, reason) {
+        super({ code: "ENGINE_REST_INVALID_RESPONSE", routeId, reason }, `Invalid engine REST response: ${reason}, ${routeId}`);
+    }
+}
+/**
+ * HTTP/1.1 client for the REST engine API. Only transport concerns live here, encoding of
+ * request and response bodies is up to the caller.
+ */
+export class EngineRestHttpClient {
+    urls;
+    opts;
+    emitter = new JsonRpcHttpClientEventEmitter();
+    metrics;
+    constructor(urls, opts = {}) {
+        this.urls = urls;
+        this.opts = opts;
+        if (urls.length === 0) {
+            throw Error("No urls provided to EngineRestHttpClient");
+        }
+        for (const [i, url] of urls.entries()) {
+            if (!isValidHttpUrl(url)) {
+                throw Error(`EngineRestHttpClient.urls[${i}] must be a valid URL: ${url}`);
+            }
+        }
+        this.metrics = opts.metrics ?? null;
+    }
+    /** Perform request with retries, emitting response and error events consumed by the engine state tracking */
+    async request(req, opts) {
+        try {
+            const response = await this.requestWithRetries(req, opts);
+            this.emitter.emit(JsonRpcHttpClientEvent.RESPONSE, { payload: req, response });
+            return response;
+        }
+        catch (error) {
+            this.emitter.emit(JsonRpcHttpClientEvent.ERROR, { payload: req, error: error });
+            throw error;
+        }
+    }
+    /** Perform request with retries without emitting events, used to probe support for the REST API */
+    async requestWithRetries(req, opts) {
+        const routeId = opts?.routeId ?? "unknown";
+        return retry(() => this.requestAnyUrl(req, opts), {
+            retries: opts?.retries ?? this.opts.retries ?? 0,
+            retryDelay: opts?.retryDelay ?? this.opts.retryDelay,
+            shouldRetry: opts?.shouldRetry ?? isRetryableEngineRestError,
+            signal: this.opts.signal,
+            onRetry: () => {
+                this.metrics?.retryCount.inc({ routeId });
+            },
+        });
+    }
+    async requestAnyUrl(req, opts) {
+        const routeId = opts?.routeId ?? "unknown";
+        let lastError = null;
+        for (let i = 0; i < this.urls.length; i++) {
+            if (i > 0) {
+                this.metrics?.requestUsedFallbackUrl.inc({ routeId });
+            }
+            try {
+                return await this.requestOneUrl(this.urls[i], req, opts);
+            }
+            catch (e) {
+                if (!isRetryableEngineRestError(e)) {
+                    throw e;
+                }
+                lastError = e;
+            }
+        }
+        throw lastError ?? Error("Unknown error");
+    }
+    async requestOneUrl(baseUrl, req, opts) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), opts?.timeout ?? this.opts.timeout ?? REQUEST_TIMEOUT);
+        // Not AbortSignal.any(), Node retains every composite until the long-lived parent signal aborts
+        const onParentSignalAbort = () => controller.abort();
+        this.opts.signal?.addEventListener("abort", onParentSignalAbort, { once: true });
+        if (this.opts.signal?.aborted) {
+            controller.abort();
+        }
+        const routeId = opts?.routeId ?? "unknown";
+        const timer = this.metrics?.requestTime.startTimer({ routeId });
+        this.metrics?.activeRequests.inc({ routeId }, 1);
+        try {
+            const url = new URL(`${ENGINE_REST_BASE_PATH}${req.path}`, baseUrl);
+            for (const [key, value] of Object.entries(req.query ?? {})) {
+                url.searchParams.set(key, String(value));
+            }
+            const headers = {
+                Accept: req.responseType === "ssz" ? MEDIA_TYPE_SSZ : MEDIA_TYPE_JSON,
+            };
+            if (req.body !== undefined) {
+                headers["Content-Type"] = MEDIA_TYPE_SSZ;
+            }
+            if (req.executionFork !== undefined) {
+                headers[EXECUTION_VERSION_HEADER] = req.executionFork;
+            }
+            if (this.opts.clientVersion !== undefined) {
+                headers[CLIENT_VERSION_HEADER] = this.opts.clientVersion;
+            }
+            if (this.opts.jwtSecret) {
+                const jwtClaim = { iat: Math.floor(Date.now() / 1000), id: this.opts.jwtId };
+                headers.Authorization = `Bearer ${encodeJwtToken(jwtClaim, this.opts.jwtSecret)}`;
+            }
+            this.metrics?.requestBytes.inc({ routeId }, req.body?.length ?? 0);
+            const res = await fetch(url, {
+                method: req.method,
+                body: req.body,
+                headers,
+                signal: controller.signal,
+            });
+            const streamTimer = this.metrics?.streamTime.startTimer({ routeId });
+            let body;
+            try {
+                body = new Uint8Array(await res.arrayBuffer());
+            }
+            catch (e) {
+                throw new FetchError(url, e);
+            }
+            finally {
+                streamTimer?.();
+            }
+            this.metrics?.responseBytes.inc({ routeId }, body.length);
+            if (!res.ok) {
+                const { type, detail } = parseProblemBody(body);
+                throw new EngineRestError(res.status, type, detail, routeId);
+            }
+            if (res.status !== 200 && res.status !== 204) {
+                throw new EngineRestResponseError(routeId, `Unexpected status ${res.status}`);
+            }
+            const contentType = res.headers.get("content-type")?.split(";", 1)[0].trim().toLowerCase();
+            const expectedContentType = req.responseType === "ssz" ? MEDIA_TYPE_SSZ : MEDIA_TYPE_JSON;
+            if (res.status !== 204 && contentType !== expectedContentType) {
+                throw new EngineRestResponseError(routeId, `Unexpected content type ${contentType}`);
+            }
+            return { status: res.status, body };
+        }
+        catch (e) {
+            this.metrics?.requestErrors.inc({ routeId });
+            if (controller.signal.aborted) {
+                if (this.opts.signal?.aborted) {
+                    throw new ErrorAborted("request");
+                }
+                throw new TimeoutError("request");
+            }
+            throw e;
+        }
+        finally {
+            timer?.();
+            this.metrics?.activeRequests.dec({ routeId }, 1);
+            clearTimeout(timeout);
+            this.opts.signal?.removeEventListener("abort", onParentSignalAbort);
+        }
+    }
+}
+/** Client errors are deterministic apart from timeouts and rate limits, transport failures and server errors are retried */
+export function isRetryableEngineRestError(e) {
+    return ((e instanceof EngineRestError && (e.status >= 500 || e.status === 408 || e.status === 429)) ||
+        e instanceof TimeoutError ||
+        (e instanceof FetchError && e.type !== "input" && e.type !== "aborted"));
+}
+function parseProblemBody(body) {
+    const text = new TextDecoder().decode(body);
+    try {
+        const problem = JSON.parse(text);
+        if (typeof problem === "object" && problem !== null) {
+            return {
+                type: "type" in problem && typeof problem.type === "string" ? problem.type : null,
+                detail: ("detail" in problem && typeof problem.detail === "string" ? problem.detail : text).slice(0, MAX_ERROR_DETAIL_LENGTH) || null,
+            };
+        }
+    }
+    catch {
+        // Legacy endpoints and proxies may return plain text instead of a problem document.
+    }
+    return { type: null, detail: text.slice(0, MAX_ERROR_DETAIL_LENGTH) || null };
+}
+//# sourceMappingURL=restHttpClient.js.map

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

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

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

@@ -0,0 +1,48 @@
+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 { EngineTransportMetrics } from "./transportMetrics.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 readonly metrics?;
+    private limits;
+    constructor(client: EngineRestHttpClient, metrics?: EngineTransportMetrics | null | undefined);
+    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,EAAC,sBAAsB,EAAC,MAAM,uBAAuB,CAAC;AAC7D,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;IAIxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAJ3B,OAAO,CAAC,MAAM,CAAkB;IAEhC,YACmB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,YAAA,EACtD;IAEJ,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,CAiDlC;IAEK,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsEhF;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"}