Struct Sealed

pub struct Sealed<T> { /* private fields */ }

A consensus hashable item, with its memoized hash.

We do not implement any specific hashing algorithm here. Instead types implement the Sealable trait to provide define their own hash.

Implementations

impl<T> Sealed<T>

pub fn new(inner: T) -> Sealed<T>

where T: Sealable,

Seal the inner item.

pub fn new_ref(inner: &T) -> Sealed<&T>

where T: Sealable,

Seal the inner item, by reference.

pub fn new_with<F>(inner: T, f: F) -> Sealed<T>

where F: FnOnce(&T) -> FixedBytes<32>,

Seal the inner item with some function.

pub fn new_ref_with<F>(inner: &T, f: F) -> Sealed<&T>

where F: FnOnce(&T) -> FixedBytes<32>,

Seal a reference to the inner item with some function.

pub const fn new_unchecked(inner: T, seal: FixedBytes<32>) -> Sealed<T>

Instantiate without performing the hash. This should be used carefully.

pub const fn as_sealed_ref(&self) -> Sealed<&T>

Converts from &Sealed<T> to Sealed<&T>.

pub fn into_parts(self) -> (T, FixedBytes<32>)

Decompose into parts.

pub fn split(self) -> (T, FixedBytes<32>)

Decompose into parts. Alias for Self::into_parts.

pub fn clone_inner(&self) -> T

where T: Clone,

Clone the inner item.

pub const fn inner(&self) -> &T

Get the inner item.

pub const fn seal(&self) -> FixedBytes<32>

Get the hash.

pub const fn hash(&self) -> FixedBytes<32>

Get the hash.

pub const fn hash_ref(&self) -> &FixedBytes<32>

Get the hash.

pub fn into_inner(self) -> T

Unseal the inner item, discarding the hash.

pub fn unseal(self) -> T

Unseal the inner item, discarding the hash. Alias for Self::into_inner.

impl<T> Sealed<&T>

pub fn cloned(self) -> Sealed<T>

where T: Clone,

Maps a Sealed<&T> to a Sealed<T> by cloning the inner value.

Trait Implementations

impl<'a, T> Arbitrary<'a> for Sealed<T>

where T: for<'b> Arbitrary<'b> + Sealable,

fn arbitrary(u: &mut Unstructured<'a>) -> Result<Sealed<T>, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl<T> Arbitrary for Sealed<T>

where T: Arbitrary,

type Parameters = (<T as Arbitrary>::Parameters, <FixedBytes<32> as Arbitrary>::Parameters)

The type of parameters that arbitrary_with accepts for configuration of the generated Strategy. Parameters must implement Default.

type Strategy = Map<(<T as Arbitrary>::Strategy, <FixedBytes<32> as Arbitrary>::Strategy), fn((T, FixedBytes<32>)) -> Sealed<T>>

The type of Strategy used to generate values of type Self.

fn arbitrary_with( _top: <Sealed<T> as Arbitrary>::Parameters, ) -> <Sealed<T> as Arbitrary>::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self). The strategy is passed the arguments given in args.

fn arbitrary() -> Self::Strategy

Generates a Strategy for producing arbitrary values of type the implementing type (Self).

impl<T> AsRef<T> for Sealed<T>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Clone for Sealed<T>

where T: Clone,

fn clone(&self) -> Sealed<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T> Debug for Sealed<T>

where T: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<T> Decodable2718 for Sealed<T>

where T: Decodable2718 + Sealable,

fn extract_type_byte(buf: &mut &[u8]) -> Option<u8>

Extract the type byte from the buffer, if any. The type byte is the first byte, provided that first byte is 0x7f or lower.

fn typed_decode(ty: u8, buf: &mut &[u8]) -> Result<Sealed<T>, Eip2718Error>

Decode the appropriate variant, based on the type flag.

fn fallback_decode(buf: &mut &[u8]) -> Result<Sealed<T>, Eip2718Error>

Decode the default variant.

fn decode_2718(buf: &mut &[u8]) -> Result<Sealed<T>, Eip2718Error>

Decode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn network_decode(buf: &mut &[u8]) -> Result<Sealed<T>, Eip2718Error>

Decode an EIP-2718 transaction in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

fn decode_2718_exact(bytes: &[u8]) -> Result<Self, Eip2718Error>

Decode a transaction according to EIP-2718, ensuring no trailing bytes.

impl<T> Default for Sealed<T>

where T: Sealable + Default,

fn default() -> Sealed<T>

Returns the “default value” for a type.

impl<T> Deref for Sealed<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &<Sealed<T> as Deref>::Target

Dereferences the value.

impl<'de, T> Deserialize<'de> for Sealed<T>

where T: Deserialize<'de>,

fn deserialize<__D>( __deserializer: __D, ) -> Result<Sealed<T>, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Encodable2718 for Sealed<T>

where T: Encodable2718,

fn encode_2718_len(&self) -> usize

The length of the 2718 encoded envelope. This is the length of the type flag + the length of the inner encoding.

fn encode_2718(&self, out: &mut dyn BufMut)

Encode the transaction according to EIP-2718 rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn trie_hash(&self) -> FixedBytes<32>

Compute the hash as committed to in the MPT trie. This hash is used ONLY by the Ethereum merkle-patricia trie and associated proofs. Do not call this method unless you are building a full or light client.

fn type_flag(&self) -> Option<u8>

Return the type flag (if any).

fn encoded_2718(&self) -> Vec<u8>

Encode the transaction according to [EIP-2718] rules. First a 1-byte type flag in the range 0x0-0x7f, then the body of the transaction.

fn seal(self) -> Sealed<Self>

Seal the encodable, by encoding and hashing it.

fn into_encoded(self) -> WithEncoded<Self>

A convenience function that encodes the value in the 2718 format and wraps it in a WithEncoded wrapper.

fn network_len(&self) -> usize

The length of the 2718 encoded envelope in network format. This is the length of the header + the length of the type flag and inner encoding.

fn network_encode(&self, out: &mut dyn BufMut)

Encode in the network format. The network format is used ONLY by the Ethereum p2p protocol. Do not call this method unless you are building a p2p protocol client.

impl<T> Hash for Sealed<T>

where T: Hash,

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq for Sealed<T>

where T: PartialEq,

fn eq(&self, other: &Sealed<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Serialize for Sealed<T>

where T: Serialize,

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> SignerRecoverable for Sealed<T>

where T: SignerRecoverable,

fn recover_signer(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash.

fn recover_signer_unchecked(&self) -> Result<Address, RecoveryError>

Recover signer from signature and hash without ensuring that the signature has a low s value.

fn recover_unchecked_with_buf( &self, buf: &mut Vec<u8>, ) -> Result<Address, RecoveryError>

Same as SignerRecoverable::recover_signer_unchecked but receives a buffer to operate on for encoding. This is useful during batch recovery of historical transactions to avoid allocating a new buffer for each transaction.

fn try_into_recovered(self) -> Result<Recovered<Self>, RecoveryError>

where Self: Sized,

Recover the signer via SignerRecoverable::recover_signer and returns a Recovered<Self>

fn try_into_recovered_unchecked(self) -> Result<Recovered<Self>, RecoveryError>

where Self: Sized,

Recover the signer via SignerRecoverable::recover_signer_unchecked and returns a Recovered<&Self>

fn try_to_recovered_ref(&self) -> Result<Recovered<&Self>, RecoveryError>

Recover the signer via SignerRecoverable::recover_signer and returns a Recovered<&Self>

fn try_to_recovered_ref_unchecked( &self, ) -> Result<Recovered<&Self>, RecoveryError>

Recover the signer via SignerRecoverable::recover_signer_unchecked and returns a Recovered<&Self>

impl<T: Transaction> Transaction for Sealed<T>

fn chain_id(&self) -> Option<u64>

Get chain_id.

fn nonce(&self) -> u64

Get nonce.

fn gas_limit(&self) -> u64

Get gas_limit.

fn gas_price(&self) -> Option<u128>

Get gas_price.

fn max_fee_per_gas(&self) -> u128

For dynamic fee transactions returns the maximum fee per gas the caller is willing to pay.

fn max_priority_fee_per_gas(&self) -> Option<u128>

For dynamic fee transactions returns the Priority fee the caller is paying to the block author.

fn max_fee_per_blob_gas(&self) -> Option<u128>

Max fee per blob gas for EIP-4844 transaction.

fn priority_fee_or_price(&self) -> u128

Return the max priority fee per gas if the transaction is a dynamic fee transaction, and otherwise return the gas price.

fn effective_gas_price(&self, base_fee: Option<u64>) -> u128

Returns the effective gas price for the given base fee.

fn is_dynamic_fee(&self) -> bool

Returns true if the transaction supports dynamic fees.

fn kind(&self) -> TxKind

Returns the transaction kind.

fn is_create(&self) -> bool

Returns true if the transaction is a contract creation. We don’t provide a default implementation via kind as it copies the 21-byte TxKind for this simple check. A proper implementation shouldn’t allocate.

fn value(&self) -> U256

Get value.

fn input(&self) -> &Bytes

Get data.

fn access_list(&self) -> Option<&AccessList>

Returns the EIP-2930 access_list for the particular transaction type. Returns None for older transaction types.

fn blob_versioned_hashes(&self) -> Option<&[B256]>

Blob versioned hashes for eip4844 transaction. For previous transaction types this is None.

fn authorization_list(&self) -> Option<&[SignedAuthorization]>

Returns the SignedAuthorization list of the transaction.

fn effective_tip_per_gas(&self, base_fee: u64) -> Option<u128>

Returns the effective tip for this transaction.

fn to(&self) -> Option<Address>

Get the transaction’s address of the contract that will be called, or the address that will receive the transfer.

fn function_selector(&self) -> Option<&Selector>

Returns the first 4bytes of the calldata for a function call.

fn blob_count(&self) -> Option<u64>

Returns the number of blobs of this transaction.

fn blob_gas_used(&self) -> Option<u64>

Returns the total gas for all blobs in this transaction.

fn authorization_count(&self) -> Option<u64>

Returns the number of blobs of SignedAuthorization in this transactions

impl<T> Typed2718 for Sealed<T>

where T: Typed2718,

fn ty(&self) -> u8

Returns the EIP-2718 type flag.

fn is_type(&self, ty: u8) -> bool

Returns true if the type matches the given type.

fn is_legacy(&self) -> bool

Returns true if the type is a legacy transaction.

fn is_eip2930(&self) -> bool

Returns true if the type is an EIP-2930 transaction.

fn is_eip1559(&self) -> bool

Returns true if the type is an EIP-1559 transaction.

fn is_eip4844(&self) -> bool

Returns true if the type is an EIP-4844 transaction.

fn is_eip7702(&self) -> bool

Returns true if the type is an EIP-7702 transaction.

impl<T> Copy for Sealed<T>

where T: Copy,

impl<T> Eq for Sealed<T>

where T: Eq,

impl<T> StructuralPartialEq for Sealed<T>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.