# beacon_chain # Copyright (c) 2023-2024 Status Research & Development GmbH # Licensed and distributed under either of # * MIT license (license terms in the root directory or at https://opensource.org/licenses/MIT). # * Apache v2 license (license terms in the root directory or at https://www.apache.org/licenses/LICENSE-2.0). # at your option. This file may not be copied, modified, or distributed except according to those terms. {.push raises: [].} import ".."/datatypes/[altair, deneb] from stew/byteutils import to0xHex from ".."/datatypes/phase0 import Attestation, AttesterSlashing from ../datatypes/bellatrix import ExecutionAddress from ".."/datatypes/capella import SignedBLSToExecutionChange from ".."/eth2_merkleization import hash_tree_root type # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#validatorregistrationv1 ValidatorRegistrationV1* = object fee_recipient*: ExecutionAddress gas_limit*: uint64 timestamp*: uint64 pubkey*: ValidatorPubKey # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#signedvalidatorregistrationv1 SignedValidatorRegistrationV1* = object message*: ValidatorRegistrationV1 signature*: ValidatorSig # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/deneb/builder.md#builderbid BuilderBid* = object header*: deneb.ExecutionPayloadHeader # [Modified in Deneb] blob_kzg_commitments*: KzgCommitments # [New in Deneb] value*: UInt256 pubkey*: ValidatorPubKey # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#signedbuilderbid # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/deneb/builder.md#executionpayloadheader SignedBuilderBid* = object message*: BuilderBid signature*: ValidatorSig # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/deneb/builder.md#blindedbeaconblockbody BlindedBeaconBlockBody* = object randao_reveal*: ValidatorSig eth1_data*: Eth1Data graffiti*: GraffitiBytes proposer_slashings*: List[ProposerSlashing, Limit MAX_PROPOSER_SLASHINGS] attester_slashings*: List[AttesterSlashing, Limit MAX_ATTESTER_SLASHINGS] attestations*: List[Attestation, Limit MAX_ATTESTATIONS] deposits*: List[Deposit, Limit MAX_DEPOSITS] voluntary_exits*: List[SignedVoluntaryExit, Limit MAX_VOLUNTARY_EXITS] sync_aggregate*: SyncAggregate execution_payload_header*: deneb.ExecutionPayloadHeader bls_to_execution_changes*: List[SignedBLSToExecutionChange, Limit MAX_BLS_TO_EXECUTION_CHANGES] blob_kzg_commitments*: KzgCommitments # [New in Deneb] # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#blindedbeaconblock # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/deneb/builder.md#blindedbeaconblockbody BlindedBeaconBlock* = object slot*: Slot proposer_index*: uint64 parent_root*: Eth2Digest state_root*: Eth2Digest body*: BlindedBeaconBlockBody # [Modified in Deneb] MaybeBlindedBeaconBlock* = object case isBlinded*: bool of false: data*: deneb.BlockContents of true: blindedData*: BlindedBeaconBlock # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#signedblindedbeaconblock # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/capella/builder.md#blindedbeaconblockbody SignedBlindedBeaconBlock* = object message*: BlindedBeaconBlock signature*: ValidatorSig # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/deneb/builder.md#executionpayloadandblobsbundle ExecutionPayloadAndBlobsBundle* = object execution_payload*: deneb.ExecutionPayload blobs_bundle*: BlobsBundle # Not spec, but suggested by spec BlindedExecutionPayloadAndBlobsBundle* = object execution_payload_header*: deneb.ExecutionPayloadHeader blob_kzg_commitments*: KzgCommitments # [New in Deneb] const # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/builder.md#domain-types DOMAIN_APPLICATION_BUILDER* = DomainType([byte 0x00, 0x00, 0x00, 0x01]) # https://github.com/ethereum/builder-specs/blob/v0.4.0/specs/bellatrix/validator.md#constants EPOCHS_PER_VALIDATOR_REGISTRATION_SUBMISSION* = 1 # Spec is 1 second, but mev-boost indirection can induce delay when the relay # itself has already consumed the entire second. BUILDER_PROPOSAL_DELAY_TOLERANCE* = 1500.milliseconds func shortLog*(v: BlindedBeaconBlock): auto = ( slot: shortLog(v.slot), proposer_index: v.proposer_index, parent_root: shortLog(v.parent_root), state_root: shortLog(v.state_root), eth1data: v.body.eth1_data, graffiti: $v.body.graffiti, proposer_slashings_len: v.body.proposer_slashings.len(), attester_slashings_len: v.body.attester_slashings.len(), attestations_len: v.body.attestations.len(), deposits_len: v.body.deposits.len(), voluntary_exits_len: v.body.voluntary_exits.len(), sync_committee_participants: v.body.sync_aggregate.num_active_participants, block_number: v.body.execution_payload_header.block_number, # TODO checksum hex? shortlog? block_hash: to0xHex(v.body.execution_payload_header.block_hash.data), parent_hash: to0xHex(v.body.execution_payload_header.parent_hash.data), fee_recipient: to0xHex(v.body.execution_payload_header.fee_recipient.data), bls_to_execution_changes_len: v.body.bls_to_execution_changes.len(), blob_kzg_commitments_len: 0, # Deneb compat ) func shortLog*(v: SignedBlindedBeaconBlock): auto = ( blck: shortLog(v.message), signature: shortLog(v.signature) ) func toSignedBlindedBeaconBlock*(blck: deneb.SignedBeaconBlock): SignedBlindedBeaconBlock = SignedBlindedBeaconBlock( message: BlindedBeaconBlock( slot: blck.message.slot, proposer_index: blck.message.proposer_index, parent_root: blck.message.parent_root, state_root: blck.message.state_root, body: BlindedBeaconBlockBody( randao_reveal: blck.message.body.randao_reveal, eth1_data: blck.message.body.eth1_data, graffiti: blck.message.body.graffiti, proposer_slashings: blck.message.body.proposer_slashings, attester_slashings: blck.message.body.attester_slashings, attestations: blck.message.body.attestations, deposits: blck.message.body.deposits, voluntary_exits: blck.message.body.voluntary_exits, sync_aggregate: blck.message.body.sync_aggregate, execution_payload_header: ExecutionPayloadHeader( parent_hash: blck.message.body.execution_payload.parent_hash, fee_recipient: blck.message.body.execution_payload.fee_recipient, state_root: blck.message.body.execution_payload.state_root, receipts_root: blck.message.body.execution_payload.receipts_root, logs_bloom: blck.message.body.execution_payload.logs_bloom, prev_randao: blck.message.body.execution_payload.prev_randao, block_number: blck.message.body.execution_payload.block_number, gas_limit: blck.message.body.execution_payload.gas_limit, gas_used: blck.message.body.execution_payload.gas_used, timestamp: blck.message.body.execution_payload.timestamp, extra_data: blck.message.body.execution_payload.extra_data, base_fee_per_gas: blck.message.body.execution_payload.base_fee_per_gas, block_hash: blck.message.body.execution_payload.block_hash, transactions_root: hash_tree_root(blck.message.body.execution_payload.transactions), withdrawals_root: hash_tree_root(blck.message.body.execution_payload.withdrawals), blob_gas_used: blck.message.body.execution_payload.blob_gas_used, excess_blob_gas: blck.message.body.execution_payload.excess_blob_gas), bls_to_execution_changes: blck.message.body.bls_to_execution_changes, blob_kzg_commitments: blck.message.body.blob_kzg_commitments)), signature: blck.signature)