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::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.
• PooledTransaction
  All possible transactions that can be included in a response to GetPooledTransactions. A response to GetPooledTransactions. This can include either a blob transaction, or a non-4844 signed 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
  Recover signer from message hash, without ensuring that the signature has a low s value.
• 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].