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

Update Merge Engine API (Kiln v1) #91

Merged
merged 4 commits into from
Feb 9, 2022
Merged

Update Merge Engine API (Kiln v1) #91

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
2daa726
Update Merge Engine API
yperbasis Jan 23, 2022
0e25bcc
Engine API updated
yperbasis Jan 25, 2022
ee8057d
Add INVALID_TERMINAL_BLOCK to EngineStatus
yperbasis Jan 27, 2022
50ece30
Merge branch 'master' into new_merge_approach
yperbasis Feb 6, 2022
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
40 changes: 28 additions & 12 deletions remote/ethbackend.proto
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,17 +13,22 @@ service ETHBACKEND {
rpc NetVersion(NetVersionRequest) returns (NetVersionReply);

rpc NetPeerCount(NetPeerCountRequest) returns (NetPeerCountReply);
// "The Merge" RPC Requests to be netively implemented in the Erigon Node Backend

// Fetch Execution Payload using its id.
// ------------------------------------------------------------------------
// "The Merge" RPC requests natively implemented in the Erigon node backend

// Fetch Execution Payload using its ID.
rpc EngineGetPayloadV1(EngineGetPayloadRequest) returns (types.ExecutionPayload);

// Execute the payload.
rpc EngineExecutePayloadV1(types.ExecutionPayload) returns (EngineExecutePayloadReply);
// Validate and possibly execute the payload.
rpc EngineNewPayloadV1(types.ExecutionPayload) returns (EnginePayloadStatus);

// Update fork choice
rpc EngineForkChoiceUpdatedV1(EngineForkChoiceUpdatedRequest) returns (EngineForkChoiceUpdatedReply);

// End of the Merge requests
// ------------------------------------------------------------------------

// Version returns the service version number
rpc Version(google.protobuf.Empty) returns (types.VersionReply);

Expand Down Expand Up @@ -68,30 +73,41 @@ message NetPeerCountReply { uint64 count = 1; }
message EngineGetPayloadRequest {
uint64 payloadId = 1;
}
message EngineExecutePayloadReply {
string status = 1;

enum EngineStatus {
VALID = 0;
INVALID = 1;
SYNCING = 2;
ACCEPTED = 3;
INVALID_BLOCK_HASH = 4;
INVALID_TERMINAL_BLOCK = 5;
}

message EnginePayloadStatus {
EngineStatus status = 1;
types.H256 latestValidHash = 2;
string validationError = 3;
}

message EnginePreparePayload {
message EnginePayloadAttributes {
uint64 timestamp = 1;
types.H256 random = 2;
types.H160 feeRecipient = 3;
types.H160 suggestedFeeRecipient = 3;
}

message EngineForkChoiceUpdated {
message EngineForkChoiceState {
types.H256 headBlockHash = 1;
types.H256 safeBlockHash = 2;
types.H256 finalizedBlockHash = 3;
}

message EngineForkChoiceUpdatedRequest {
EngineForkChoiceUpdated forkchoice = 1;
EnginePreparePayload prepare = 2;
EngineForkChoiceState forkchoiceState = 1;
EnginePayloadAttributes payloadAttributes = 2;
}

message EngineForkChoiceUpdatedReply {
string status = 1;
EnginePayloadStatus payloadStatus = 1;
uint64 payloadId = 2;
}

Expand Down