Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

refactor: flatten fork logic in notifyNewPayload #7385

Open
wants to merge 4 commits into
base: unstable
Choose a base branch
from
+284 −52
Open

refactor: flatten fork logic in notifyNewPayload #7385

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b29d470
Refactor
ensi321 Jan 22, 2025
45e6f5d
lint
ensi321 Jan 22, 2025
dae5d4a
Address comment
ensi321 Jan 23, 2025
a2306ef
address comment
ensi321 Jan 30, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
83 changes: 38 additions & 45 deletions packages/beacon-node/src/execution/engine/http.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,8 @@ import {
assertReqSizeLimit,
deserializeBlobAndProofs,
deserializeExecutionPayloadBody,
getPayloadMethodByFork,
newPayloadMethodByFork,
parseExecutionPayload,
serializeBeaconBlockRoot,
serializeExecutionPayload,
Expand Down Expand Up @@ -204,58 +206,56 @@ export class ExecutionEngineHttp implements IExecutionEngine {
parentBlockRoot?: Root,
executionRequests?: ExecutionRequests
): Promise<ExecutePayloadResponse> {
const method =
ForkSeq[fork] >= ForkSeq.electra
? "engine_newPayloadV4"
: ForkSeq[fork] >= ForkSeq.deneb
? "engine_newPayloadV3"
: ForkSeq[fork] >= ForkSeq.capella
? "engine_newPayloadV2"
: "engine_newPayloadV1";
const method = newPayloadMethodByFork(fork);

const serializedExecutionPayload = serializeExecutionPayload(fork, executionPayload);

let engineRequest: EngineRequest;
if (ForkSeq[fork] >= ForkSeq.deneb) {
if (versionedHashes === undefined) {
throw Error(`versionedHashes required in notifyNewPayload for fork=${fork}`);
}
if (parentBlockRoot === undefined) {
throw Error(`parentBlockRoot required in notifyNewPayload for fork=${fork}`);
}

const serializedVersionedHashes = serializeVersionedHashes(versionedHashes);
const parentBeaconBlockRoot = serializeBeaconBlockRoot(parentBlockRoot);

if (ForkSeq[fork] >= ForkSeq.electra) {
if (executionRequests === undefined) {
throw Error(`executionRequests required in notifyNewPayload for fork=${fork}`);
switch (method) {
case "engine_newPayloadV1":
case "engine_newPayloadV2":
engineRequest = {
method,
params: [serializedExecutionPayload],
methodOpts: notifyNewPayloadOpts,
};
break;
case "engine_newPayloadV3":
if (versionedHashes === undefined || parentBlockRoot === undefined) {
throw Error(
`versionedHashes and parentBlockRoot required in notifyNewPayload for fork=${fork} versionedHashes=${versionedHashes} parentBlockRoot=${parentBlockRoot}`
);
}
const serializedExecutionRequests = serializeExecutionRequests(executionRequests);
engineRequest = {
method: "engine_newPayloadV4",
method,
params: [
serializedExecutionPayload,
serializedVersionedHashes,
parentBeaconBlockRoot,
serializedExecutionRequests,
serializeVersionedHashes(versionedHashes),
serializeBeaconBlockRoot(parentBlockRoot),
],
methodOpts: notifyNewPayloadOpts,
};
} else {
break;
case "engine_newPayloadV4":
if (versionedHashes === undefined || parentBlockRoot === undefined || executionRequests === undefined) {
ensi321 marked this conversation as resolved.
Show resolved Hide resolved
throw Error(
`versionedHashes, parentBlockRoot, and executionRequests required in notifyNewPayload for fork=${fork} versionedHashes=${versionedHashes} parentBlockRoot=${parentBlockRoot} executionRequests=${executionRequests}`
ensi321 marked this conversation as resolved.
Show resolved Hide resolved
);
}
engineRequest = {
method: "engine_newPayloadV3",
params: [serializedExecutionPayload, serializedVersionedHashes, parentBeaconBlockRoot],
method,
params: [
serializedExecutionPayload,
serializeVersionedHashes(versionedHashes),
serializeBeaconBlockRoot(parentBlockRoot),
serializeExecutionRequests(executionRequests),
],
methodOpts: notifyNewPayloadOpts,
};
}
} else {
const method = ForkSeq[fork] >= ForkSeq.capella ? "engine_newPayloadV2" : "engine_newPayloadV1";
engineRequest = {
method,
params: [serializedExecutionPayload],
methodOpts: notifyNewPayloadOpts,
};
break;
default:
throw Error(`Unsupported method: ${method}`);
}

const {status, latestValidHash, validationError} = await (
Expand Down Expand Up @@ -415,14 +415,7 @@ export class ExecutionEngineHttp implements IExecutionEngine {
executionRequests?: ExecutionRequests;
shouldOverrideBuilder?: boolean;
}> {
const method =
ForkSeq[fork] >= ForkSeq.electra
? "engine_getPayloadV4"
: ForkSeq[fork] >= ForkSeq.deneb
? "engine_getPayloadV3"
: ForkSeq[fork] >= ForkSeq.capella
? "engine_getPayloadV2"
: "engine_getPayloadV1";
const method = getPayloadMethodByFork(fork);
const payloadResponse = await this.rpc.fetchWithRetries<
EngineApiRpcReturnTypes[typeof method],
EngineApiRpcParamTypes[typeof method]
Expand Down
32 changes: 32 additions & 0 deletions packages/beacon-node/src/execution/engine/types.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,9 @@ import {
ForkName,
ForkSeq,
WITHDRAWAL_REQUEST_TYPE,
isForkBlobs,
isForkPostElectra,
isForkWithdrawals,
} from "@lodestar/params";
import {ExecutionPayload, ExecutionRequests, Root, Wei, bellatrix, capella, deneb, electra, ssz} from "@lodestar/types";
import {BlobAndProof} from "@lodestar/types/deneb";
Expand Down Expand Up @@ -82,6 +85,9 @@ export type EngineApiRpcParamTypes = {
engine_getBlobsV1: [DATA[]];
};

export type EngineGetPayloadMethod = keyof EngineApiRpcReturnTypes & `engine_getPayloadV${number}`;
export type EngineNewPayloadMethod = keyof EngineApiRpcReturnTypes & `engine_newPayloadV${number}`;
ensi321 marked this conversation as resolved.
Show resolved Hide resolved

export type PayloadStatus = {
status: ExecutionPayloadStatus;
latestValidHash: DATA | null;
Expand Down Expand Up @@ -222,6 +228,32 @@ export interface BlobsBundleRpc {
proofs: DATA[]; // some ELs could also provide proofs, each 48 bytes
}

export function getPayloadMethodByFork(fork: ForkName): EngineGetPayloadMethod {
switch (true) {
case isForkPostElectra(fork):
return "engine_getPayloadV4";
case isForkBlobs(fork):
return "engine_getPayloadV3";
case isForkWithdrawals(fork):
return "engine_getPayloadV2";
default:
return "engine_getPayloadV1";
}
}

export function newPayloadMethodByFork(fork: ForkName): EngineNewPayloadMethod {
switch (true) {
case isForkPostElectra(fork):
return "engine_newPayloadV4";
case isForkBlobs(fork):
return "engine_newPayloadV3";
case isForkWithdrawals(fork):
return "engine_newPayloadV2";
default:
return "engine_newPayloadV1";
}
}

export function serializeExecutionPayload(fork: ForkName, data: ExecutionPayload): ExecutionPayloadRpc {
const payload: ExecutionPayloadRpc = {
parentHash: bytesToData(data.parentHash),
Expand Down
Loading