Module reth::primitives

Re-exported from reth_primitives.

Modules

• alloy_primitives
  alloy-primitives
• basefee
  Helpers for working with EIP-1559 base fee
• constants
  Ethereum protocol-related constants
• eip4844
  Helpers for working with EIP-4844 blob fee.
• genesis
  Types for genesis configuration of a chain.
• header
  Header types.
• kzg
• proofs
  Helper function for calculating Merkle proofs and hashes.
• revm_primitives
  revm-primitives
• static_file
  Commonly used types for static file usage.
• transaction
  Transaction types.

Macros

• address
  Converts a sequence of string literals containing hex-encoded data into a new Address at compile time.
• b256
  Converts a sequence of string literals containing hex-encoded data into a new B256 at compile time.
• bloom
  Converts a sequence of string literals containing hex-encoded data into a new Bloom at compile time.
• bytes
  Converts a sequence of string literals containing hex-encoded data into a new Bytes at compile time.
• hardfork
  Macro that defines different variants of a chain specific enum. See crate::Hardfork as an example.
• hex
  Macro for converting sequence of string literals containing hex-encoded data into an array of bytes.

Structs

• AccessList
  AccessList as defined in EIP-2930
• AccessListItem
  A list of addresses and storage keys that the transaction plans to access. Accesses outside the list are possible, but become more expensive.
• Account
  An Ethereum account.
• Address
  An Ethereum address, 20 bytes in length.
• BlobTransaction
  A response to GetPooledTransactions that includes blob data, their commitments, and their corresponding proofs.
• BlobTransactionSidecar
  This represents a set of blobs, and its corresponding commitments and proofs.
• Block
  Ethereum full block.
• BlockBody
  A response to GetBlockBodies, containing bodies if any bodies were found.
• BlockNumHash
  Block number and hash.
• BlockWithSenders
  Sealed block with senders recovered from transactions.
• Bloom
  Ethereum 256 byte bloom filter.
• Bytecode
  Bytecode for an account.
• Bytes
  Wrapper type around [bytes::Bytes] to support “0x” prefixed hex strings.
• BytesMut
  A unique reference to a contiguous slice of memory.
• ChainConfig
  Defines core blockchain settings per block.
• 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.
• 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
• Genesis
  The genesis block specification.
• GenesisAccount
  An account in the state of the genesis block.
• 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
  Block header
• JumpTable
  A map of valid jump destinations.
• Log
  A log consists of an address, and some log data.
• LogData
  An Ethereum event log object.
• PooledTransactionsElementEcRecovered
  A signed pooled transaction with recovered signer.
• 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.
• Requests
  A list of EIP-7685 requests.
• ReusableDecompressor
  Reusable decompressor that uses its own internal buffer.
• RpcBlockHash
  A block hash which may have a boolean requireCanonical field. If false, an RPC call should raise if a block matching the hash is not found. If true, an RPC call should additionally raise if the block is not in the canonical chain. https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1898.md#specification
• 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.
• Signature
  r, s: Values corresponding to the signature of the transaction and used to determine the sender of the transaction; formally Tr and Ts. This is expanded in Appendix F of yellow paper.
• StorageEntry
  Account storage entry.
• TransactionMeta
  Additional fields in the context of a block that contains this transaction.
• TransactionSigned
  Signed transaction.
• TransactionSignedEcRecovered
  Signed transaction with recovered signer.
• TransactionSignedNoHash
  Signed transaction without its Hash. Used type for inserting into the DB.
• TxDeposit
  Deposit transactions, also known as deposits are initiated on L1, and executed on L2.
• TxEip1559
  A transaction with a priority fee (EIP-1559).
• TxEip2930
  Transaction with an AccessList (EIP-2930).
• TxEip4844
  EIP-4844 Blob Transaction
• TxLegacy
  Legacy transaction.
• Withdrawal
  Withdrawal represents a validator withdrawal from the consensus layer.
• Withdrawals
  Represents a collection of Withdrawals.

Enums

• BlobTransactionValidationErrorkzg
  An error that can occur when validating a BlobTransactionSidecar::validate.
• BlockHashOrNumber
  Either a block hash or a block number
• BlockId
  A Block Identifier. https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1898.md
• BlockNumberOrTag
  A block Number (or tag - “latest”, “earliest”, “pending”)
• BloomInput
  Input to the Bloom::accrue method.
• EthereumHardfork
  The name of an Ethereum hardfork.
• ForkCondition
  The condition at which a fork is activated.
• ForkFilterKey
  How to filter forks.
• HeadersDirection
  Represents the direction for a headers request depending on the reverse field of the request.
• InvalidTransactionError
  Represents error variants that can happen when trying to validate a Transaction
• OptimismHardfork
  The name of an optimism hardfork.
• PooledTransactionsElement
  A response to GetPooledTransactions. This can include either a blob transaction, or a non-4844 signed transaction.
• Request
  Ethereum execution layer requests.
• StaticFileSegment
  Segment of the data that can be moved to static files.
• Transaction
  A raw transaction.
• TxKind
  The to field of a transaction. Either a target address, or empty for a contract creation.
• TxType
  Transaction Type
• ValidationError
  Reason for rejecting provided ForkId.

Constants

• DEPOSIT_TX_TYPE_IDoptimism
  Identifier for TxDeposit transaction.
• DEV_GENESIS_HASH
  Testnet genesis hash: 0x2f980576711e3617a5e4d83dd539548ec0f7792007d505a3d2e9674833af2d7c
• EIP1559_TX_TYPE_ID
  Identifier for TxEip1559 transaction.
• EIP2930_TX_TYPE_ID
  Identifier for TxEip2930 transaction.
• EIP4844_TX_TYPE_ID
  Identifier for TxEip4844 transaction.
• EMPTY_OMMER_ROOT_HASH
  Ommer root of empty list: 0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347
• HOLESKY_GENESIS_HASH
  Holesky genesis hash: 0xb5f7f912443c940f21fd611f12828d75b534364ed9e95ca4e307729a4661bde4
• KECCAK_EMPTY
  Keccak256 over empty array: 0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470
• LEGACY_TX_TYPE_ID
  Identifier for legacy transaction, however TxLegacy this is technically not typed.
• MAINNET_GENESIS_HASH
  The Ethereum mainnet genesis hash: 0x0d4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3
• RECEIPT_COMPRESSOR
  Thread receipt compressor.
• RECEIPT_DECOMPRESSOR
  Thread receipt decompressor.
• SEPOLIA_GENESIS_HASH
  Sepolia genesis hash: 0x25a5cc106eea7138acab33231d7160d69cb777ee0c2c553fcddf5138993e6dd9
• TRANSACTION_COMPRESSOR
  Thread Transaction compressor.
• TRANSACTION_DECOMPRESSOR
  Thread Transaction decompressor.

Statics

• BASE_MAINNEToptimism
  The Base mainnet spec
• BASE_SEPOLIAoptimism
  The Base Sepolia spec
• DEV_HARDFORKS
  Dev hardforks
• OP_MAINNEToptimism
  The Optimism Mainnet spec
• OP_SEPOLIAoptimism
  The OP Sepolia spec
• RECEIPT_DICTIONARY
  Compression/Decompression dictionary for Receipt.
• TRANSACTION_DICTIONARY
  Compression/Decompression dictionary for Transaction.

Traits

• Buf
  Read bytes from a buffer.
• BufMut
  A trait for values that provide sequential write access to bytes.
• EthereumHardforks
  Helper methods for Ethereum forks.
• FromRecoveredPooledTransaction
  A transaction type that can be created from a PooledTransactionsElementEcRecovered transaction.
• Hardfork
  Generic hardfork trait.
• Hardforks
  Generic trait over a set of ordered hardforks
• IntoRecoveredTransaction
  The inverse of TryFromRecoveredTransaction that ensure the transaction can be sent over the network
• OptimismHardforks
  Extends crate::EthereumHardforks with optimism helper methods.
• TryFromRecoveredTransaction
  A transaction type that can be created from a TransactionSignedEcRecovered transaction.
• UintTryTo
  ⚠️ Workaround for Rust issue #50133. Use TryFrom instead.

Functions

• eip191_hash_message
  Hash a message according to EIP-191 (version 0x01).
• format_ether
  Formats the given number of Wei as an Ether amount.
• gas_spent_by_transactions
  Retrieves gas spent by transactions as a vector of tuples (transaction index, gas used).
• generate_valid_header
  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.
• keccak256
  Simple interface to the Keccak-256 hash function.
• logs_bloom
  Calculate receipt logs bloom.
• 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_strategy
  Generates a proptest strategy for constructing an instance of a header which is valid with respect to past and future forks.

Type Aliases

• B64
  8-byte fixed byte-array type.
• B128
  16-byte fixed byte-array type.
• B256
  32-byte fixed byte-array type.
• B512
  64-byte fixed byte-array type.
• BlockHash
  A block hash.
• BlockNumber
  A block number.
• ChainId
  Chain identifier type (introduced in EIP-155).
• ForkBlock
  Block number and hash of the forked block.
• Selector
  Solidity contract functions are addressed using the first four bytes of the Keccak-256 hash of their signature.
• StorageKey
  An account storage key.
• StorageValue
  An account storage value.
• TxHash
  A transaction hash is a keccak hash of an RLP encoded signed transaction.
• TxHashOrNumber
  Either a transaction hash or number.
• TxIndex
  The index of transaction in a block.
• TxNumber
  The sequence number of all existing transactions.
• U8
  Uint for 8 bits. Similar to u8.
• U64
  Uint for 64 bits. Similar to u64.
• U128
  Uint for 128 bits. Similar to u128.
• U256
  Uint for 256 bits.