Skip to main content

reth_ethereum_engine_primitives/
lib.rs

1//! Ethereum specific engine API types and impls.
2
3#![doc(
4    html_logo_url = "https://raw.githubusercontent.com/paradigmxyz/reth/main/assets/reth-docs.png",
5    html_favicon_url = "https://avatars0.githubusercontent.com/u/97369466?s=256",
6    issue_tracker_base_url = "https://github.com/paradigmxyz/reth/issues/"
7)]
8#![cfg_attr(not(test), warn(unused_crate_dependencies))]
9#![cfg_attr(docsrs, feature(doc_cfg))]
10#![cfg_attr(not(feature = "std"), no_std)]
11
12extern crate alloc;
13
14mod payload;
15pub use payload::{BlobSidecars, EthBuiltPayload};
16
17mod error;
18pub use error::*;
19
20use alloy_rpc_types_engine::{ExecutionData, ExecutionPayload};
21pub use alloy_rpc_types_engine::{
22    ExecutionPayloadEnvelopeV2, ExecutionPayloadEnvelopeV3, ExecutionPayloadEnvelopeV4,
23    ExecutionPayloadEnvelopeV5, ExecutionPayloadEnvelopeV6, ExecutionPayloadV1,
24    PayloadAttributes as EthPayloadAttributes,
25};
26use reth_engine_primitives::EngineTypes;
27use reth_payload_primitives::{BuiltPayload, PayloadTypes};
28use reth_primitives_traits::{NodePrimitives, SealedBlock};
29
30/// The types used in the default mainnet ethereum beacon consensus engine.
31#[derive(Debug, Default, Clone, serde::Deserialize, serde::Serialize)]
32#[non_exhaustive]
33pub struct EthEngineTypes<T: PayloadTypes = EthPayloadTypes> {
34    _marker: core::marker::PhantomData<T>,
35}
36
37impl<
38        T: PayloadTypes<
39            ExecutionData = ExecutionData,
40            BuiltPayload: BuiltPayload<
41                Primitives: NodePrimitives<Block = reth_ethereum_primitives::Block>,
42            >,
43        >,
44    > PayloadTypes for EthEngineTypes<T>
45{
46    type ExecutionData = T::ExecutionData;
47    type BuiltPayload = T::BuiltPayload;
48    type PayloadAttributes = T::PayloadAttributes;
49
50    fn block_to_payload(
51        block: SealedBlock<
52            <<Self::BuiltPayload as BuiltPayload>::Primitives as NodePrimitives>::Block,
53        >,
54    ) -> Self::ExecutionData {
55        T::block_to_payload(block)
56    }
57}
58
59impl<T> EngineTypes for EthEngineTypes<T>
60where
61    T: PayloadTypes<ExecutionData = ExecutionData>,
62    T::BuiltPayload: BuiltPayload<Primitives: NodePrimitives<Block = reth_ethereum_primitives::Block>>
63        + TryInto<ExecutionPayloadV1>
64        + TryInto<ExecutionPayloadEnvelopeV2>
65        + TryInto<ExecutionPayloadEnvelopeV3>
66        + TryInto<ExecutionPayloadEnvelopeV4>
67        + TryInto<ExecutionPayloadEnvelopeV5>
68        + TryInto<ExecutionPayloadEnvelopeV6>,
69{
70    type ExecutionPayloadEnvelopeV1 = ExecutionPayloadV1;
71    type ExecutionPayloadEnvelopeV2 = ExecutionPayloadEnvelopeV2;
72    type ExecutionPayloadEnvelopeV3 = ExecutionPayloadEnvelopeV3;
73    type ExecutionPayloadEnvelopeV4 = ExecutionPayloadEnvelopeV4;
74    type ExecutionPayloadEnvelopeV5 = ExecutionPayloadEnvelopeV5;
75    type ExecutionPayloadEnvelopeV6 = ExecutionPayloadEnvelopeV6;
76}
77
78/// A default payload type for [`EthEngineTypes`]
79#[derive(Debug, Default, Clone, serde::Deserialize, serde::Serialize)]
80#[non_exhaustive]
81pub struct EthPayloadTypes;
82
83impl PayloadTypes for EthPayloadTypes {
84    type BuiltPayload = EthBuiltPayload;
85    type PayloadAttributes = EthPayloadAttributes;
86    type ExecutionData = ExecutionData;
87
88    fn block_to_payload(
89        block: SealedBlock<
90            <<Self::BuiltPayload as BuiltPayload>::Primitives as NodePrimitives>::Block,
91        >,
92    ) -> Self::ExecutionData {
93        let (payload, sidecar) =
94            ExecutionPayload::from_block_unchecked(block.hash(), &block.into_block());
95        ExecutionData { payload, sidecar }
96    }
97}