Crate alloy_consensus

alloy-consensus

Ethereum consensus interface.

This crate contains constants, types, and functions for implementing Ethereum EL consensus and communication. This includes headers, blocks, transactions, EIP-2718 envelopes, EIP-2930, EIP-4844, and more.

In general a type belongs in this crate if it is committed to in the EL block header. This includes:

• transactions
• blocks
• headers
• receipts
• EIP-2718 envelopes.

Provenance

Much of this code was ported from reth-primitives as part of ongoing alloy migrations.

Re-exports

• pub use constants::EMPTY_OMMER_ROOT_HASH;
• pub use constants::EMPTY_ROOT_HASH;
• pub use transaction::SignableTransaction;
• pub use transaction::Transaction;
• pub use transaction::TxEip1559;
• pub use transaction::TxEip2930;
• pub use transaction::TxEip4844;
• pub use transaction::TxEip4844Variant;
• pub use transaction::TxEip4844WithSidecar;
• pub use transaction::TxEip7702;
• pub use transaction::TxEnvelope;
• pub use transaction::TxLegacy;
• pub use transaction::TxType;
• pub use transaction::TypedTransaction;

Modules

• constants
  Ethereum protocol-related constants
• serde_bincode_compatserde and serde-bincode-compat
  Bincode-compatible serde implementations for consensus types.
• transaction
  Transaction types.
• utils
  Utilities for working with EIP-4844 field elements and implementing SidecarCoder.

Structs

• Account
  Represents an Account in the account trie.
• AnyHeader
  Block header representation with certain fields made optional to account for possible differencies in network implementations.
• AnyReceiptEnvelope
  Receipt envelope, as defined in EIP-2718.
• 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.
• Header
  Ethereum Block header
• Receipt
  Receipt containing result of transaction execution.
• ReceiptWithBloom
  Receipt with calculated bloom filter.
• Receipts
  Receipt containing result of transaction execution.
• Sealed
  A consensus hashable item, with its memoized hash.
• SidecarBuilder
  Build a BlobTransactionSidecar from an arbitrary amount of data.
• Signed
  A transaction with a signature and hash seal.
• SimpleCoder
  Simple coder that only uses the last 31 bytes of each blob. This is the default coder for the SidecarBuilder.

Enums

• BlobTransactionValidationErrorkzg
  An error that can occur when validating a BlobTransactionSidecar::validate.
• Eip658Value
  Captures the result of a transaction execution.
• EnvKzgSettingskzg
  KZG settings.
• ReceiptEnvelope
  Receipt envelope, as defined in EIP-2718.

Traits

• BlockHeader
  Trait for extracting specific Ethereum block data from a header
• Sealable
  Sealeable objects.
• SidecarCoder
  A strategy for coding and decoding data into sidecars.
• TxReceipt
  Receipt is the result of a transaction execution.

Type Aliases

• Blob
  A Blob serialized as 0x-prefixed hex string
• Bytes48
  A commitment/proof serialized as 0x-prefixed hex string