Crate reth_primitives

Commonly used types in Reth.

This crate contains Ethereum primitive types and helper functions.

Feature Flags

• alloy-compat: Adds compatibility conversions for certain alloy types.
• arbitrary: Adds proptest and arbitrary support for primitive types.
• test-utils: Export utilities for testing
• reth-codec: Enables db codec support for reth types including zstd compression for certain types.

Re-exports

pub use transaction::BlobTransaction;

pub use transaction::PooledTransactionsElement;

pub use transaction::PooledTransactionsElementEcRecovered;

pub use transaction::RecoveredTx;

pub use transaction::Transaction;

pub use transaction::TransactionMeta;

pub use transaction::TransactionSigned;

pub use transaction::TransactionSignedEcRecovered;

pub use transaction::TxType;

pub use reth_static_file_types as static_file;

pub use arbitrary;arbitrary

pub use c_kzg as kzg;c-kzg

Modules

arbitrary

The Arbitrary trait crate.

proofs

Helper function for calculating Merkle proofs and hashes.

serde_bincode_compatserde-bincode-compat

Bincode-compatible serde implementations for commonly used types in Reth.

transaction

Transaction types.

Macros

hardfork

Macro that defines different variants of a chain specific enum. See crate::Hardfork as an example.

Structs

Account

An Ethereum account.

Block

Ethereum full block.

BlockBody

A response to GetBlockBodies, containing bodies if any bodies were found.

BlockWithSenders

Sealed block with senders recovered from transactions.

Bytecode

Bytecode for an account.

ChainHardforks

Ordered list of a chain hardforks that implement Hardfork.

DisplayHardforks

A container for pretty-printing a list of hardforks.

EnrForkIdEntry

Represents a forward-compatible ENR entry for including the forkid in a node record via EIP-868. Forward compatibility is achieved via EIP-8.

EthPrimitives

Temp helper struct for integrating NodePrimitives.

ForkFilter

Filter that describes the state of blockchain and can be used to check incoming ForkIds for compatibility.

ForkHash

CRC32 hash of all previous forks starting from genesis block.

ForkId

A fork identifier as defined by EIP-2124. Serves as the chain compatibility identifier.

ForkTransition

Represents a transition from one fork to another

GotExpected

A pair of values, one of which is expected and one of which is actual.

GotExpectedBoxed

A pair of values, one of which is expected and one of which is actual.

Head

Describes the current head block.

Header

Ethereum Block header

Log

A log consists of an address, and some log data.

LogData

An Ethereum event log object.

Receipt

Receipt containing result of transaction execution.

ReceiptWithBloom

[Receipt] with calculated bloom filter.

Receipts

A collection of receipts organized as a two-dimensional vector.

SealedBlock

Sealed Ethereum full block.

SealedBlockWithSenders

Sealed block with senders recovered from transactions.

SealedHeader

A Header that is sealed at a precalculated hash, use SealedHeader::unseal() if you want to modify header.

StorageEntry

Account storage entry.

Enums

EthereumHardfork

The name of an Ethereum hardfork.

ForkCondition

The condition at which a fork is activated.

ForkFilterKey

How to filter forks.

HeaderError

Errors that can occur during header sanity checks.

InvalidTransactionError

Represents error variants that can happen when trying to validate a transaction.

StaticFileSegment

Segment of the data that can be moved to static files.

ValidationError

Reason for rejecting provided ForkId.

Statics

DEV_HARDFORKS

Dev hardforks

Traits

BlockBodyTxExt

Extension trait for [BlockBody] adding helper methods operating with transactions.

BlockExt

Extension trait for [reth_primitives_traits::Block] implementations allowing for conversions into common block parts containers such as SealedBlock, BlockWithSenders, etc.

EthereumHardforks

Helper methods for Ethereum forks.

Hardfork

Generic hardfork trait.

Hardforks

Generic trait over a set of ordered hardforks

NodePrimitives

Configures all the primitive types of the node.

Functions

gas_spent_by_transactions

Retrieves gas spent by transactions as a vector of tuples (transaction index, gas used). Retrieves gas spent by transactions as a vector of tuples (transaction index, gas used).

generate_valid_headerarbitrary

Generates a header which is valid with respect to past and future forks. This means, for example, that if the withdrawals root is present, the base fee per gas is also present.

logs_bloom

Compute the logs bloom filter for the given logs.

public_key_to_address

Converts a public key into an ethereum address by hashing the encoded public key with keccak256.

recover_signer_unchecked

Recovers the address of the sender using secp256k1 pubkey recovery.

sign_message

Signs message with the given secret key. Returns the corresponding signature.

valid_header_strategyarbitrary

Generates a proptest strategy for constructing an instance of a header which is valid with respect to past and future forks.

Type Aliases

SealedBlockFor

A helepr trait to construct SealedBlock from a [reth_primitives_traits::Block].