package execution

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc InsertBlocks (InsertBlocksRequest, InsertionResult)

  execution.proto:181

  Chain Putters.

  message InsertBlocksRequest

  execution.proto:102

  • repeated Block blocks = 1

  message InsertionResult

  execution.proto:114

  • ExecutionStatus result = 1

• rpc ValidateChain (ValidationRequest, ValidationReceipt)

  execution.proto:183

  Chain Validation and ForkChoice.

  message ValidationRequest

  execution.proto:118

  • optional types.H256 hash = 1

  • uint64 number = 2

  message ValidationReceipt

  execution.proto:26

  Result we receive after validation

  • ExecutionStatus validation_status = 1

  • optional types.H256 latest_valid_hash = 2

  • string validation_error = 3

• rpc UpdateForkChoice (ForkChoice, ForkChoiceReceipt)

  execution.proto:184

  message ForkChoiceReceipt

  execution.proto:19

  • ExecutionStatus status = 1

  • optional types.H256 latest_valid_hash = 2

    Return latest valid hash in case of halt of execution.

  • string validation_error = 3

• rpc AssembleBlock (AssembleBlockRequest, AssembleBlockResponse)

  execution.proto:187

  Block Assembly EAGAIN design here, AssembleBlock initiates the asynchronous request, and GetAssembleBlock just return it if ready.

  message AssembleBlockRequest

  execution.proto:123

  • optional types.H256 parent_hash = 1

  • uint64 timestamp = 2

  • optional types.H256 prev_randao = 3

  • optional types.H160 suggested_fee_recipient = 4

  • repeated types.Withdrawal withdrawals = 5

    added in Shapella (EIP-4895)

  • optional types.H256 parent_beacon_block_root = 6

    added in Dencun (EIP-4788)

  message AssembleBlockResponse

  execution.proto:132

  • uint64 id = 1

  • bool busy = 2

• rpc GetAssembledBlock (GetAssembledBlockRequest, GetAssembledBlockResponse)

  execution.proto:188

  message GetAssembledBlockRequest

  execution.proto:137

  • uint64 id = 1

  message GetAssembledBlockResponse

  execution.proto:148

  • optional AssembledBlockData data = 1

  • bool busy = 2

• rpc CurrentHeader (google.protobuf.Empty, GetHeaderResponse)

  execution.proto:190

  Chain Getters.

• rpc GetTD (GetSegmentRequest, GetTDResponse)

  execution.proto:191

  message GetTDResponse

  execution.proto:84

  • optional types.H256 td = 1

• rpc GetHeader (GetSegmentRequest, GetHeaderResponse)

  execution.proto:192

• rpc GetBody (GetSegmentRequest, GetBodyResponse)

  execution.proto:193

  message GetBodyResponse

  execution.proto:88

  • optional BlockBody body = 1

• rpc HasBlock (GetSegmentRequest, HasBlockResponse)

  execution.proto:194

  message HasBlockResponse

  execution.proto:175

  • bool has_block = 1

• rpc GetBodiesByRange (GetBodiesByRangeRequest, GetBodiesBatchResponse)

  execution.proto:196

  Ranges

  message GetBodiesByRangeRequest

  execution.proto:161

  • uint64 start = 1

  • uint64 count = 2

• rpc GetBodiesByHashes (GetBodiesByHashesRequest, GetBodiesBatchResponse)

  execution.proto:197

  message GetBodiesByHashesRequest

  execution.proto:157

  • repeated types.H256 hashes = 1

• rpc IsCanonicalHash (types.H256, IsCanonicalResponse)

  execution.proto:199

  Chain checkers

  message IsCanonicalResponse

  execution.proto:32

  • bool canonical = 1

    Whether hash is canonical or not.

• rpc GetHeaderHashNumber (types.H256, GetHeaderHashNumberResponse)

  execution.proto:200

  message GetHeaderHashNumberResponse

  execution.proto:92

  • optional uint64 block_number = 1

    null if not found.

• rpc GetForkChoice (google.protobuf.Empty, ForkChoice)

  execution.proto:201

• rpc Ready (google.protobuf.Empty, ReadyResponse)

  execution.proto:204

  Misc We want to figure out whether we processed snapshots and cleanup sync cycles.

  message ReadyResponse

  execution.proto:166

  • bool ready = 1

• rpc FrozenBlocks (google.protobuf.Empty, FrozenBlocksResponse)

  execution.proto:206

  Frozen blocks are how many blocks are in snapshots .seg files.

  message FrozenBlocksResponse

  execution.proto:170

  • uint64 frozen_blocks = 1

  • bool has_gap = 2

Used in: GetAssembledBlockResponse

• optional types.ExecutionPayload execution_payload = 1

• optional types.H256 block_value = 2

• optional types.BlobsBundleV1 blobs_bundle = 3

• optional types.RequestsBundle requests = 4

Used in: InsertBlocksRequest

• optional Header header = 1

• optional BlockBody body = 2

Body is a block body for execution

Used in: Block, GetBodiesBatchResponse, GetBodyResponse

• optional types.H256 block_hash = 1

• uint64 block_number = 2

• repeated bytes transactions = 3

  Raw transactions in byte format.

• repeated Header uncles = 4

• repeated types.Withdrawal withdrawals = 5

  added in Shapella (EIP-4895)

Used in: ForkChoiceReceipt, InsertionResult, ValidationReceipt

• Success = 0

• BadBlock = 1

• TooFarAway = 2

• MissingSegment = 3

• InvalidForkchoice = 4

• Busy = 5

Used as request type in: Execution.UpdateForkChoice

Used as response type in: Execution.GetForkChoice

• optional types.H256 head_block_hash = 1

• uint64 timeout = 2

  Timeout in milliseconds for fcu before it becomes async.

• optional types.H256 finalized_block_hash = 3

• optional types.H256 safe_block_hash = 4

Used as response type in: Execution.GetBodiesByHashes, Execution.GetBodiesByRange

• repeated BlockBody bodies = 1

Used as response type in: Execution.CurrentHeader, Execution.GetHeader

• optional Header header = 1

Used as request type in: Execution.GetBody, Execution.GetHeader, Execution.GetTD, Execution.HasBlock

• optional uint64 block_number = 1

  Get headers/body by number or hash, invalid if none set.

• optional types.H256 block_hash = 2

Header is a header for execution

Used in: Block, BlockBody, GetHeaderResponse

• optional types.H256 parent_hash = 1

• optional types.H160 coinbase = 2

• optional types.H256 state_root = 3

• optional types.H256 receipt_root = 4

• optional types.H2048 logs_bloom = 5

• optional types.H256 prev_randao = 6

• uint64 block_number = 7

• uint64 gas_limit = 8

• uint64 gas_used = 9

• uint64 timestamp = 10

• uint64 nonce = 11

• bytes extra_data = 12

• optional types.H256 difficulty = 13

• optional types.H256 block_hash = 14

  We keep this so that we can validate it

• optional types.H256 ommer_hash = 15

• optional types.H256 transaction_hash = 16

• optional types.H256 base_fee_per_gas = 17

• optional types.H256 withdrawal_hash = 18

  added in Shapella (EIP-4895)

• optional uint64 blob_gas_used = 19

  added in Dencun (EIP-4844)

• optional uint64 excess_blob_gas = 20

  added in Dencun (EIP-4844)

• optional types.H256 parent_beacon_block_root = 21

  added in Dencun (EIP-4788)

• optional types.H256 requests_hash = 22

  added in Pectra (EIP-7685)

• optional uint64 aura_step = 23

  AuRa

• optional bytes aura_seal = 24