Module builder 

Re-exported from reth_node_builder

Modules

add_ons

Node add-ons. Depend on core NodeComponents.

aliases

Type aliases for traits that are often used together

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.

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.

invalid_block_hook

Invalid block hook helpers for the node builder.

node

Support for configuring the higher level node types.

payload

Abstractions for working with execution payloads.

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,

AnyNode

A Node type builder

AnyNodeTypes

A NodeTypes type builder.

AnyNodeTypesWithEngine

A NodeTypes type builder.

BuilderContext

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

BuiltPayloadExecutedBlock

Represents an executed block for payload building purposes.

ConsensusEngineHandle

A cloneable sender type that can be used to send engine API messages.

DebugNodeLauncher

Node launcher with support for launching various debugging utilities.

DebugNodeLauncherFuture

Future for the DebugNodeLauncher.

EngineApiExt

Provides access to an EngineApi instance with a callback

EngineNodeLauncher

The engine node launcher.

ExExLauncher

Can launch execution extensions.

ForkchoiceStateTracker

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

FullNode

The launched node with all components including RPC handlers.

FullNodeTypesAdapter

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

InvalidBlockHooks

Multiple InvalidBlockHooks that are executed in order.

LaunchContext

Reusable setup for launching a node.

NextBlockEnvAttributes

Represents additional attributes required to configure the next block.

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.

NoopInvalidBlockHook

A no-op InvalidBlockHook that does nothing.

OnForkChoiceUpdated

Represents the outcome of forkchoice update.

PayloadEvents

Represents a receiver for various payload events.

TreeConfig

The configuration of the engine tree.

WithLaunchContext

A NodeBuilder with its 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).

BeaconForkChoiceUpdateError

Represents error cases for an applied forkchoice update.

BeaconOnNewPayloadError

Represents all error cases when handling a new payload.

ConsensusEngineEvent

Events emitted by the consensus engine.

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.

NewPayloadError

Error validating payload received over newPayload API.

PayloadBuilderError

Possible error variants during payload building.

PayloadKind

Determines how we should choose the payload to return.

PayloadOrAttributes

A unified type for handling both execution payloads and payload attributes.

VersionSpecificValidationError

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

Constants

DEFAULT_MEMORY_BLOCK_BUFFER_TARGET

How close to the canonical head we persist blocks.

DEFAULT_MULTIPROOF_TASK_CHUNK_SIZE

The size of proof targets chunk to spawn in one multiproof calculation.

DEFAULT_MULTIPROOF_TASK_CHUNK_SIZE_V2

The size of proof targets chunk to spawn in one multiproof calculation when V2 proofs are enabled. This is 4x the default chunk size to take advantage of more efficient V2 proof computation.

DEFAULT_PERSISTENCE_THRESHOLD

Triggers persistence when the number of canonical blocks in memory exceeds this threshold.

DEFAULT_PREWARM_MAX_CONCURRENCY

Default maximum concurrency for prewarm task.

DEFAULT_RESERVED_CPU_CORES

Default number of reserved CPU cores for non-reth processes.

MIN_WORKER_COUNT

Minimum number of workers we allow configuring explicitly.

Traits

Block

Abstraction of block data type.

BlockBody

Abstraction for block’s body.

BlockReaderFor

This is a type alias to make type bounds simpler, when we have a NetworkPrimitives and need a BlockReader whose associated types match the NetworkPrimitives associated types.

BuildNextEnv

Trait to build the EVM environment for the next block from the given payload attributes.

BuiltPayload

Represents a successfully built execution payload (block).

ConfigureEngineEvm

ConfigureEvm extension providing methods for executing payloads.

ConfigureEvm

A complete configuration of EVM for Reth.

DebugNode

Node extension with support for debugging utilities.

EngineApiValidator

Type that validates the payloads processed by the engine API.

EngineTypes

This type defines the versioned types of the engine API based on the ethereum engine API.

ExecutableTxIterator

Iterator over executable transactions.

ExecutableTxTuple

A helper trait representing a pair of a “raw” transactions iterator and a closure that can be used to convert them to an executable transaction. This tuple is used in the engine to parallelize heavy work like decoding or recovery.

ExecutionPayload

Represents the core data structure of an execution payload.

FullBlock

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

FullNodeComponents

Encapsulates all types and components of the node.

FullNodeTypes

A helper trait that is downstream of the NodeTypes 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.

Node

A crate::Node is a NodeTypes that comes with preconfigured components.

NodeAddOns

Customizable node add-on types.

NodeComponents

An abstraction over the components of a node, consisting of:

NodeComponentsBuilder

A type that configures all the customizable components of the node and knows how to build them.

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 NodeTypes trait and adds database to the node.

PayloadAttributes

Basic attributes required to initiate payload construction.

PayloadAttributesBuilder

Factory trait for creating payload attributes.

PayloadBuilderAttributes

Attributes used to guide the construction of a new execution payload.

PayloadBuilderConfig

A trait that provides payload builder settings.

PayloadBuilderFor

Helper trait to bound PayloadBuilder to the node’s engine types.

PayloadTypes

Core trait that defines the associated types for working with execution payloads.

PayloadValidator

Type that validates an ExecutionPayload.

RethNetworkConfig

A trait that represents the configured network and can be used to apply additional configuration to the network.

RethTransactionPoolConfig

A trait that provides all basic config values for the transaction pool and is implemented by the TxPoolArgs type.

Functions

has_enough_parallelism

Determines if the host has enough parallelism to run the payload processor.

validate_execution_requests

Validates that execution requests are valid according to Engine API specification.

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

BeaconConsensusEngineEventDeprecated

Type alias for backwards compat

BeaconConsensusEngineHandleDeprecated

Type alias for backwards compat

BlockTy

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

BodyTy

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

ComponentsFor

A helper type to obtain components for a given node when FullNodeTypes::Types is a Node implementation.

DefaultDebugBlockProvider

Type alias for the default debug block provider. We use etherscan provider to satisfy the bounds.

FullNodeFor

Helper type alias to define FullNode for a given Node.

HeaderTy

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

NodeHandleFor

Helper type alias to define NodeHandle for a given Node.

PayloadAttrTy

Helper adapter type for accessing PayloadTypes::PayloadAttributes on NodeTypes.

PrimitivesTy

Helper type for getting the Primitives associated type from a 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.