mirror of
https://gitlab.com/pulsechaincom/prysm-pulse.git
synced 2025-01-09 11:11:20 +00:00
d17996f8b0
* Update V3 from V4 * Fix build v3 -> v4 * Update ssz * Update beacon_chain.pb.go * Fix formatter import * Update update-mockgen.sh comment to v4 * Fix conflicts. Pass build and tests * Fix test
401 lines
15 KiB
Protocol Buffer
401 lines
15 KiB
Protocol Buffer
// Copyright 2021 Prysmatic Labs.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
syntax = "proto3";
|
|
|
|
package ethereum.eth.v2;
|
|
|
|
import "proto/eth/ext/options.proto";
|
|
import "proto/eth/v1/attestation.proto";
|
|
import "proto/eth/v1/beacon_block.proto";
|
|
import "proto/eth/v2/version.proto";
|
|
import "proto/eth/v2/withdrawals.proto";
|
|
import "proto/engine/v1/execution_engine.proto";
|
|
|
|
option csharp_namespace = "Ethereum.Eth.V2";
|
|
option go_package = "github.com/prysmaticlabs/prysm/v4/proto/eth/v2;eth";
|
|
option java_multiple_files = true;
|
|
option java_outer_classname = "SyncCommitteeProto";
|
|
option java_package = "org.ethereum.eth.v2";
|
|
option php_namespace = "Ethereum\\Eth\\v2";
|
|
|
|
message BlockRequestV2 {
|
|
// The block identifier. Can be one of: "head" (canonical head in node's view), "genesis",
|
|
// "finalized", <slot>, <hex encoded blockRoot with 0x prefix>.
|
|
bytes block_id = 1;
|
|
}
|
|
|
|
message BlockResponseV2 {
|
|
v2.Version version = 1;
|
|
SignedBeaconBlockContainer data = 2;
|
|
bool execution_optimistic = 3;
|
|
bool finalized = 4;
|
|
}
|
|
|
|
message BlindedBlockResponse {
|
|
v2.Version version = 1;
|
|
SignedBlindedBeaconBlockContainer data = 2;
|
|
bool execution_optimistic = 3;
|
|
bool finalized = 4;
|
|
}
|
|
|
|
message BeaconBlockContainerV2 {
|
|
oneof block {
|
|
v1.BeaconBlock phase0_block = 1;
|
|
BeaconBlockAltair altair_block = 2;
|
|
BeaconBlockBellatrix bellatrix_block = 3;
|
|
BeaconBlockCapella capella_block = 4;
|
|
}
|
|
}
|
|
|
|
message SignedBeaconBlockContainer {
|
|
oneof message {
|
|
v1.BeaconBlock phase0_block = 1;
|
|
BeaconBlockAltair altair_block = 2;
|
|
BeaconBlockBellatrix bellatrix_block = 3;
|
|
BeaconBlockCapella capella_block = 4;
|
|
}
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 5 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message BlindedBeaconBlockContainer {
|
|
oneof block {
|
|
v1.BeaconBlock phase0_block = 1;
|
|
BeaconBlockAltair altair_block = 2;
|
|
BlindedBeaconBlockBellatrix bellatrix_block = 3;
|
|
BlindedBeaconBlockCapella capella_block = 4;
|
|
}
|
|
}
|
|
|
|
message SignedBlindedBeaconBlockContainer {
|
|
oneof message {
|
|
v1.BeaconBlock phase0_block = 1;
|
|
BeaconBlockAltair altair_block = 2;
|
|
BlindedBeaconBlockBellatrix bellatrix_block = 3;
|
|
BlindedBeaconBlockCapella capella_block = 4;
|
|
}
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 5 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message SignedBeaconBlockBellatrix {
|
|
BeaconBlockBellatrix message = 1;
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 2 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message SignedBeaconBlockCapella {
|
|
BeaconBlockCapella message = 1;
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 2 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message SignedBlindedBeaconBlockBellatrix {
|
|
BlindedBeaconBlockBellatrix message = 1;
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 2 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message SignedBlindedBeaconBlockCapella {
|
|
BlindedBeaconBlockCapella message = 1;
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 2 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
message SignedBeaconBlockAltair {
|
|
BeaconBlockAltair message = 1;
|
|
|
|
// 96 byte BLS signature from the validator that produced this block.
|
|
bytes signature = 2 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
}
|
|
|
|
// The Ethereum consensus beacon block. The message does not contain a validator signature.
|
|
message BeaconBlockBellatrix {
|
|
// Beacon chain slot that this block represents.
|
|
uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.Slot"];
|
|
|
|
// Validator index of the validator that proposed the block header.
|
|
uint64 proposer_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.ValidatorIndex"];
|
|
|
|
// 32 byte root of the parent block.
|
|
bytes parent_root = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// 32 byte root of the resulting state after processing this block.
|
|
bytes state_root = 4 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// The block body itself.
|
|
BeaconBlockBodyBellatrix body = 5;
|
|
}
|
|
|
|
// The Ethereum consensus beacon block. The message does not contain a validator signature.
|
|
message BlindedBeaconBlockBellatrix {
|
|
// Beacon chain slot that this block represents.
|
|
uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.Slot"];
|
|
|
|
// Validator index of the validator that proposed the block header.
|
|
uint64 proposer_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.ValidatorIndex"];
|
|
|
|
// 32 byte root of the parent block.
|
|
bytes parent_root = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// 32 byte root of the resulting state after processing this block.
|
|
bytes state_root = 4 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// The block body itself.
|
|
BlindedBeaconBlockBodyBellatrix body = 5;
|
|
}
|
|
|
|
// The Ethereum consensus beacon block. The message does not contain a validator signature.
|
|
message BeaconBlockCapella {
|
|
// Beacon chain slot that this block represents.
|
|
uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.Slot"];
|
|
|
|
// Validator index of the validator that proposed the block header.
|
|
uint64 proposer_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.ValidatorIndex"];
|
|
|
|
// 32 byte root of the parent block.
|
|
bytes parent_root = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// 32 byte root of the resulting state after processing this block.
|
|
bytes state_root = 4 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// The block body itself.
|
|
BeaconBlockBodyCapella body = 5;
|
|
}
|
|
|
|
// The Ethereum consensus beacon block. The message does not contain a validator signature.
|
|
message BlindedBeaconBlockCapella {
|
|
// Beacon chain slot that this block represents.
|
|
uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.Slot"];
|
|
|
|
// Validator index of the validator that proposed the block header.
|
|
uint64 proposer_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.ValidatorIndex"];
|
|
|
|
// 32 byte root of the parent block.
|
|
bytes parent_root = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// 32 byte root of the resulting state after processing this block.
|
|
bytes state_root = 4 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// The block body itself.
|
|
BlindedBeaconBlockBodyCapella body = 5;
|
|
}
|
|
|
|
// The Ethereum consensus beacon block. The message does not contain a validator signature.
|
|
message BeaconBlockAltair {
|
|
// Beacon chain slot that this block represents.
|
|
uint64 slot = 1 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.Slot"];
|
|
|
|
// Validator index of the validator that proposed the block header.
|
|
uint64 proposer_index = 2 [(ethereum.eth.ext.cast_type) = "github.com/prysmaticlabs/prysm/v4/consensus-types/primitives.ValidatorIndex"];
|
|
|
|
// 32 byte root of the parent block.
|
|
bytes parent_root = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// 32 byte root of the resulting state after processing this block.
|
|
bytes state_root = 4 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// The block body itself.
|
|
BeaconBlockBodyAltair body = 5;
|
|
}
|
|
|
|
message BeaconBlockBodyBellatrix {
|
|
// The validators RANDAO reveal 96 byte value.
|
|
bytes randao_reveal = 1 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
|
|
// A reference to the Ethereum 1.x chain.
|
|
v1.Eth1Data eth1_data = 2;
|
|
|
|
// 32 byte field of arbitrary data. This field may contain any data and
|
|
// is not used for anything other than a fun message.
|
|
bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// Block operations
|
|
// Refer to spec constants at https://github.com/ethereum/consensus-specs/blob/dev/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
|
|
// At most MAX_PROPOSER_SLASHINGS.
|
|
repeated v1.ProposerSlashing proposer_slashings = 4 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_ATTESTER_SLASHINGS.
|
|
repeated v1.AttesterSlashing attester_slashings = 5 [(ethereum.eth.ext.ssz_max) = "2"];
|
|
|
|
// At most MAX_ATTESTATIONS.
|
|
repeated v1.Attestation attestations = 6 [(ethereum.eth.ext.ssz_max) = "128"];
|
|
|
|
// At most MAX_DEPOSITS.
|
|
repeated v1.Deposit deposits = 7 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_VOLUNTARY_EXITS.
|
|
repeated v1.SignedVoluntaryExit voluntary_exits = 8 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// Sync aggregate object to track sync committee votes for light client support.
|
|
v1.SyncAggregate sync_aggregate = 9;
|
|
|
|
// Execution payload: the embedded execution payload of the block [New in Bellatrix]
|
|
ethereum.engine.v1.ExecutionPayload execution_payload = 10;
|
|
}
|
|
|
|
message BlindedBeaconBlockBodyBellatrix {
|
|
// The validators RANDAO reveal 96 byte value.
|
|
bytes randao_reveal = 1 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
|
|
// A reference to the Ethereum 1.x chain.
|
|
v1.Eth1Data eth1_data = 2;
|
|
|
|
// 32 byte field of arbitrary data. This field may contain any data and
|
|
// is not used for anything other than a fun message.
|
|
bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// Block operations
|
|
// Refer to spec constants at https://github.com/ethereum/consensus-specs/blob/dev/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
|
|
// At most MAX_PROPOSER_SLASHINGS.
|
|
repeated v1.ProposerSlashing proposer_slashings = 4 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_ATTESTER_SLASHINGS.
|
|
repeated v1.AttesterSlashing attester_slashings = 5 [(ethereum.eth.ext.ssz_max) = "2"];
|
|
|
|
// At most MAX_ATTESTATIONS.
|
|
repeated v1.Attestation attestations = 6 [(ethereum.eth.ext.ssz_max) = "128"];
|
|
|
|
// At most MAX_DEPOSITS.
|
|
repeated v1.Deposit deposits = 7 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_VOLUNTARY_EXITS.
|
|
repeated v1.SignedVoluntaryExit voluntary_exits = 8 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// Sync aggregate object to track sync committee votes for light client support.
|
|
v1.SyncAggregate sync_aggregate = 9;
|
|
|
|
// Execution payload header: the embedded execution payload of the block [New in Bellatrix]
|
|
ethereum.engine.v1.ExecutionPayloadHeader execution_payload_header = 10;
|
|
}
|
|
|
|
message BeaconBlockBodyCapella {
|
|
// The validators RANDAO reveal 96 byte value.
|
|
bytes randao_reveal = 1 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
|
|
// A reference to the Ethereum 1.x chain.
|
|
v1.Eth1Data eth1_data = 2;
|
|
|
|
// 32 byte field of arbitrary data. This field may contain any data and
|
|
// is not used for anything other than a fun message.
|
|
bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// Block operations
|
|
// Refer to spec constants at https://github.com/ethereum/consensus-specs/blob/dev/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
|
|
// At most MAX_PROPOSER_SLASHINGS.
|
|
repeated v1.ProposerSlashing proposer_slashings = 4 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_ATTESTER_SLASHINGS.
|
|
repeated v1.AttesterSlashing attester_slashings = 5 [(ethereum.eth.ext.ssz_max) = "2"];
|
|
|
|
// At most MAX_ATTESTATIONS.
|
|
repeated v1.Attestation attestations = 6 [(ethereum.eth.ext.ssz_max) = "128"];
|
|
|
|
// At most MAX_DEPOSITS.
|
|
repeated v1.Deposit deposits = 7 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_VOLUNTARY_EXITS.
|
|
repeated v1.SignedVoluntaryExit voluntary_exits = 8 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// Sync aggregate object to track sync committee votes for light client support.
|
|
v1.SyncAggregate sync_aggregate = 9;
|
|
|
|
// Execution payload: the embedded execution payload of the block [Modified in Capella]
|
|
ethereum.engine.v1.ExecutionPayloadCapella execution_payload = 10;
|
|
|
|
// BLS To Execution Changes: signed messages to change withdrawal credentials [New in Capella]
|
|
repeated SignedBLSToExecutionChange bls_to_execution_changes = 11 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
}
|
|
|
|
message BlindedBeaconBlockBodyCapella {
|
|
// The validators RANDAO reveal 96 byte value.
|
|
bytes randao_reveal = 1 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
|
|
// A reference to the Ethereum 1.x chain.
|
|
v1.Eth1Data eth1_data = 2;
|
|
|
|
// 32 byte field of arbitrary data. This field may contain any data and
|
|
// is not used for anything other than a fun message.
|
|
bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// Block operations
|
|
// Refer to spec constants at https://github.com/ethereum/consensus-specs/blob/dev/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
|
|
// At most MAX_PROPOSER_SLASHINGS.
|
|
repeated v1.ProposerSlashing proposer_slashings = 4 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_ATTESTER_SLASHINGS.
|
|
repeated v1.AttesterSlashing attester_slashings = 5 [(ethereum.eth.ext.ssz_max) = "2"];
|
|
|
|
// At most MAX_ATTESTATIONS.
|
|
repeated v1.Attestation attestations = 6 [(ethereum.eth.ext.ssz_max) = "128"];
|
|
|
|
// At most MAX_DEPOSITS.
|
|
repeated v1.Deposit deposits = 7 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_VOLUNTARY_EXITS.
|
|
repeated v1.SignedVoluntaryExit voluntary_exits = 8 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// Sync aggregate object to track sync committee votes for light client support.
|
|
v1.SyncAggregate sync_aggregate = 9;
|
|
|
|
// Execution payload header: the embedded execution payload of the block [Modified in Capella]
|
|
ethereum.engine.v1.ExecutionPayloadHeaderCapella execution_payload_header = 10;
|
|
|
|
// BLS To Execution Changes: signed messages to change withdrawal credentials [New in Capella]
|
|
repeated SignedBLSToExecutionChange bls_to_execution_changes = 11 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
}
|
|
|
|
message BeaconBlockBodyAltair {
|
|
// The validators RANDAO reveal 96 byte value.
|
|
bytes randao_reveal = 1 [(ethereum.eth.ext.ssz_size) = "96"];
|
|
|
|
// A reference to the Ethereum 1.x chain.
|
|
v1.Eth1Data eth1_data = 2;
|
|
|
|
// 32 byte field of arbitrary data. This field may contain any data and
|
|
// is not used for anything other than a fun message.
|
|
bytes graffiti = 3 [(ethereum.eth.ext.ssz_size) = "32"];
|
|
|
|
// Block operations
|
|
// Refer to spec constants at https://github.com/ethereum/consensus-specs/blob/dev/specs/core/0_beacon-chain.md#max-operations-per-block
|
|
|
|
// At most MAX_PROPOSER_SLASHINGS.
|
|
repeated v1.ProposerSlashing proposer_slashings = 4 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_ATTESTER_SLASHINGS.
|
|
repeated v1.AttesterSlashing attester_slashings = 5 [(ethereum.eth.ext.ssz_max) = "2"];
|
|
|
|
// At most MAX_ATTESTATIONS.
|
|
repeated v1.Attestation attestations = 6 [(ethereum.eth.ext.ssz_max) = "128"];
|
|
|
|
// At most MAX_DEPOSITS.
|
|
repeated v1.Deposit deposits = 7 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// At most MAX_VOLUNTARY_EXITS.
|
|
repeated v1.SignedVoluntaryExit voluntary_exits = 8 [(ethereum.eth.ext.ssz_max) = "16"];
|
|
|
|
// Sync aggregate object to track sync committee votes for light client support. [New in ]
|
|
v1.SyncAggregate sync_aggregate = 9;
|
|
}
|