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::InvalidTransactionError;
• pub use transaction::PooledTransactionsElement;
• pub use transaction::PooledTransactionsElementEcRecovered;
• pub use transaction::Transaction;
• pub use transaction::TransactionMeta;
• pub use transaction::TransactionSigned;
• pub use transaction::TransactionSignedEcRecovered;
• pub use transaction::TransactionSignedNoHash;
• 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.
• ReceiptWithBloomRef
  Receipt reference type with calculated bloom filter.
• Receipts
  A collection of receipts organized as a two-dimensional vector.
• ReusableDecompressorreth-codec
  Reusable decompressor that uses its own internal buffer.
• 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.
• StaticFileSegment
  Segment of the data that can be moved to static files.
• ValidationError
  Reason for rejecting provided ForkId.

Constants

• RECEIPT_COMPRESSORreth-codec
  Thread receipt compressor.
• RECEIPT_DECOMPRESSORreth-codec
  Thread receipt decompressor.
• TRANSACTION_COMPRESSORreth-codec
  Thread Transaction compressor.
• TRANSACTION_DECOMPRESSORreth-codec
  Thread Transaction decompressor.

Statics

• DEV_HARDFORKS
  Dev hardforks
• RECEIPT_DICTIONARYreth-codec
  Compression/Decompression dictionary for Receipt.
• TRANSACTION_DICTIONARYreth-codec
  Compression/Decompression dictionary for Transaction.

Traits

• 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

• create_receipt_compressorreth-codec
  Fn creates receipt [Compressor]
• create_receipt_decompressorreth-codec
  Fn creates receipt [Decompressor]
• create_tx_compressorreth-codec
  Fn creates tx [Compressor]
• create_tx_decompressorreth-codec
  Fn creates tx [Decompressor]
• 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_addresssecp256k1
  Converts a public key into an ethereum address by hashing the encoded public key with keccak256.
• recover_signer_uncheckedsecp256k1
  Recovers the address of the sender using secp256k1 pubkey recovery.
• sign_messagesecp256k1
  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.