Crate reth_node_builder

Standalone crate for Reth configuration and builder types.

features

• js-tracer: Enable the JavaScript tracer for the debug_trace endpoints

Re-exports

pub use components::NodeComponents;

pub use components::NodeComponentsBuilder;

pub use node::*;

Modules

add_ons

Node add-ons. Depend on core NodeComponents.

common

Helper types that can be used by launchers.

components

Support for configuring the components of a node. Support for configuring the components of a node.

engine_tree_config

Temporarily re-export engine tree config. Engine tree configuration.

exex

Support for installing the ExExs (execution extensions) in a node. Types for launching execution extensions (ExEx).

hooks

Node event hooks.

node

Support for configuring the higher level node types.

payload

This crate defines abstractions to create and update payloads (blocks)

payload_builder

This crate defines abstractions to create and update payloads (blocks)

rpc

Builder support for rpc components.

setup

Helpers for setting up parts of the node.

Structs

AddOns

Additional node extensions.

AddOnsContext

Context passed to NodeAddOns::launch_add_ons,

AnyNodeTypes

A NodeTypes type builder.

AnyNodeTypesWithEngine

A NodeTypesWithEngine type builder.

BuilderContext

Captures the necessary context for building the components of the node.

DefaultNodeLauncher

The default launcher for a node.

EngineNodeLauncher

The engine node launcher.

ExExLauncher

Can launch execution extensions.

ForkchoiceStateTracker

The struct that keeps track of the received forkchoice state and their status.

FullNodeTypesAdapter

An adapter type that adds the builtin provider type to the user configured node types.

LaunchContext

Reusable setup for launching a node.

NextBlockEnvAttributes

Represents additional attributes required to configure the next block. This is used to configure the next block’s environment ConfigureEvmEnv::next_cfg_and_block_env and contains fields that can’t be derived from the parent header alone (attributes that are determined by the CL.)

NodeAdapter

Container for the node’s types and the components and other internals that can be used by addons of the node.

NodeBuilder

Declaratively construct a node.

NodeBuilderWithComponents

A fully type configured node builder.

NodeBuilderWithTypes

A node builder that also has the configured types.

NodeConfig

This includes all necessary configuration to launch the node. The individual configuration options can be overwritten before launching the node.

NodeHandle

A Handle to the launched node.

NodeTypesAdapter

Container for the node’s types and the database the node uses.

NodeTypesWithDBAdapter

An adapter type combining NodeTypes and db into NodeTypesWithDB.

OnForkChoiceUpdated

Represents the outcome of forkchoice update.

PayloadEvents

Represents a receiver for various payload events.

WithLaunchContext

A NodeBuilder with it’s launch context already configured.

Enums

BeaconEngineMessage

A message for the beacon engine from other components of the node (engine RPC API invoked by the consensus layer).

BeaconOnNewPayloadError

Represents all error cases when handling a new payload.

EngineApiMessageVersion

The version of Engine API message.

EngineObjectValidationError

Thrown when the payload or attributes are known to be invalid before processing.

Events

Payload builder events.

ForkchoiceStateHash

A helper type to check represent hashes of a [ForkchoiceState]

ForkchoiceStatus

A simplified representation of [PayloadStatusEnum] specifically for FCU.

InvalidPayloadAttributesError

Thrown when validating the correctness of a payloadattributes object.

MessageValidationKind

A type that represents whether or not we are validating a payload or payload attributes.

PayloadBuilderError

Possible error variants during payload building.

PayloadKind

Determines how we should choose the payload to return.

PayloadOrAttributes

Either an [ExecutionPayload] or a types that implements the PayloadAttributes trait.

VersionSpecificValidationError

Thrown when validating an execution payload OR payload attributes fails due to:

Traits

Block

Abstraction of block data type.

BlockBody

Abstraction for block’s body.

BuiltPayload

Represents a built payload type that contains a built [SealedBlock] and can be converted into engine API execution payloads.

ConfigureEvm

Trait for configuring the EVM for executing full blocks.

ConfigureEvmEnv

This represents the set of methods used to configure the EVM’s environment before block execution.

EngineTypes

This type defines the versioned types of the engine API.

EngineValidator

Type that validates the payloads processed by the engine.

FullBlock

Helper trait that unifies all behaviour required by block to support full node operations.

FullNodeComponents

Encapsulates all types and components of the node.

FullNodePrimitives

Helper trait that sets trait bounds on NodePrimitives.

FullNodeTypes

A helper trait that is downstream of the NodeTypesWithEngine trait and adds stateful components to the node.

FullProvider

Helper trait to unify all provider traits for simplicity.

FullReceipt

Helper trait that unifies all behaviour required by receipt to support full node operations.

FullSignedTx

Helper trait that unifies all behaviour required by block to support full node operations.

InvalidBlockHook

An invalid block hook.

LaunchNode

A general purpose trait that launches a new node of any kind.

NodeAddOns

Customizable node add-on types.

NodePrimitives

Configures all the primitive types of the node.

NodeTypes

The type that configures the essential types of an Ethereum-like node.

NodeTypesWithDB

A helper trait that is downstream of the NodeTypesWithEngine trait and adds database to the node.

NodeTypesWithEngine

The type that configures an Ethereum-like node with an engine for consensus.

PayloadAttributes

The execution payload attribute type the CL node emits via the engine API. This trait should be implemented by types that could be used to spawn a payload job.

PayloadAttributesBuilder

A builder that can return the current payload attribute.

PayloadBuilder

A type that can request, subscribe to and resolve payloads.

PayloadBuilderAttributes

This can be implemented by types that describe a currently running payload job.

PayloadBuilderConfig

Re-export the core configuration traits. A trait that provides payload builder settings.

PayloadStoreExt

A helper trait for internal usage to retrieve and resolve payloads.

PayloadTypes

The types that are used by the engine API.

PayloadValidator

Type that validates an [ExecutionPayload].

RethNetworkConfig

Re-export the core configuration traits. A trait that represents the configured network and can be used to apply additional configuration to the network.

RethTransactionPoolConfig

Re-export the core configuration traits. A trait that provides all basic config values for the transaction pool and is implemented by the TxPoolArgs type.

Functions

validate_parent_beacon_block_root_presence

Validate the presence of the parentBeaconBlockRoot field according to the given timestamp. This method is meant to be used with either a payloadAttributes field or a full payload, with the engine_forkchoiceUpdated and engine_newPayload methods respectively.

validate_payload_timestamp

Validates the timestamp depending on the version called:

validate_version_specific_fields

Validates the presence or exclusion of fork-specific fields based on the ethereum execution payload, or payload attributes, and the message version.

validate_withdrawals_presence

Validates the presence of the withdrawals field according to the payload timestamp. After Shanghai, withdrawals field must be Some. Before Shanghai, withdrawals field must be None;

Type Aliases

BlockTy

Helper adapter type for accessing NodePrimitives::Block on NodeTypes.

BodyTy

Helper adapter type for accessing NodePrimitives::BlockBody on NodeTypes.

EthApiBuilderCtx

Alias for reth_rpc_eth_types::EthApiBuilderCtx, adapter for [RpcNodeCore].

HeaderTy

Helper adapter type for accessing NodePrimitives::BlockHeader on NodeTypes.

ReceiptTy

Helper adapter type for accessing NodePrimitives::Receipt on NodeTypes.

RethFullAdapter

The adapter type for a reth node with the builtin provider type

TxTy

Helper adapter type for accessing NodePrimitives::SignedTx on NodeTypes.