reth_execution_types

Struct ExecutionOutcome

Source
pub struct ExecutionOutcome<T = Receipt> {
    pub bundle: BundleState,
    pub receipts: Receipts<T>,
    pub first_block: BlockNumber,
    pub requests: Vec<Requests>,
}
Expand description

Represents the outcome of block execution, including post-execution changes and reverts.

The ExecutionOutcome structure aggregates the state changes over an arbitrary number of blocks, capturing the resulting state, receipts, and requests following the execution.

Fields§

§bundle: BundleState

Bundle state with reverts.

§receipts: Receipts<T>

The collection of receipts. Outer vector stores receipts for each block sequentially. The inner vector stores receipts ordered by transaction number.

If receipt is None it means it is pruned.

§first_block: BlockNumber

First block of bundle state.

§requests: Vec<Requests>

The collection of EIP-7685 requests. Outer vector stores requests for each block sequentially. The inner vector stores requests ordered by transaction number.

A transaction may have zero or more requests, so the length of the inner vector is not guaranteed to be the same as the number of transactions.

Implementations§

Source§

impl<T> ExecutionOutcome<T>

Source

pub const fn new( bundle: BundleState, receipts: Receipts<T>, first_block: BlockNumber, requests: Vec<Requests>, ) -> Self

Creates a new ExecutionOutcome.

This constructor initializes a new ExecutionOutcome instance with the provided bundle state, receipts, first block number, and EIP-7685 requests.

Source

pub fn new_init( state_init: BundleStateInit, revert_init: RevertsInit, contracts_init: impl IntoIterator<Item = (B256, Bytecode)>, receipts: Receipts<T>, first_block: BlockNumber, requests: Vec<Requests>, ) -> Self

Creates a new ExecutionOutcome from initialization parameters.

This constructor initializes a new ExecutionOutcome instance using detailed initialization parameters.

Source

pub const fn state(&self) -> &BundleState

Return revm bundle state.

Source

pub fn state_mut(&mut self) -> &mut BundleState

Returns mutable revm bundle state.

Source

pub fn set_first_block(&mut self, first_block: BlockNumber)

Set first block.

Source

pub fn accounts_iter( &self, ) -> impl Iterator<Item = (Address, Option<&AccountInfo>)>

Return iterator over all accounts

Source

pub fn bundle_accounts_iter( &self, ) -> impl Iterator<Item = (Address, &BundleAccount)>

Return iterator over all [BundleAccount]s in the bundle

Source

pub fn account(&self, address: &Address) -> Option<Option<Account>>

Get account if account is known.

Source

pub fn storage(&self, address: &Address, storage_key: U256) -> Option<U256>

Get storage if value is known.

This means that depending on status we can potentially return U256::ZERO.

Source

pub fn bytecode(&self, code_hash: &B256) -> Option<Bytecode>

Return bytecode if known.

Source

pub fn hash_state_slow(&self) -> HashedPostState

Returns [HashedPostState] for this execution outcome. See [HashedPostState::from_bundle_state] for more info.

Source

pub fn block_number_to_index(&self, block_number: BlockNumber) -> Option<usize>

Transform block number to the index of block.

Source

pub fn generic_receipts_root_slow( &self, block_number: BlockNumber, f: impl FnOnce(&[&T]) -> B256, ) -> Option<B256>

Returns the receipt root for all recorded receipts. Note: this function calculated Bloom filters for every receipt and created merkle trees of receipt. This is a expensive operation.

Source

pub const fn receipts(&self) -> &Receipts<T>

Returns reference to receipts.

Source

pub fn receipts_mut(&mut self) -> &mut Receipts<T>

Returns mutable reference to receipts.

Source

pub fn receipts_by_block(&self, block_number: BlockNumber) -> &[Option<T>]

Return all block receipts

Source

pub fn is_empty(&self) -> bool

Is execution outcome empty.

Source

pub fn len(&self) -> usize

Number of blocks in the execution outcome.

Source

pub const fn first_block(&self) -> BlockNumber

Return first block of the execution outcome

Source

pub fn revert_to(&mut self, block_number: BlockNumber) -> bool

Revert the state to the given block number.

Returns false if the block number is not in the bundle state.

§Note

The provided block number will stay inside the bundle state.

Source

pub fn split_at(self, at: BlockNumber) -> (Option<Self>, Self)
where T: Clone,

Splits the block range state at a given block number. Returns two split states ([..at], [at..]). The plain state of the 2nd bundle state will contain extra changes that were made in state transitions belonging to the lower state.

§Panics

If the target block number is not included in the state block range.

Source

pub fn extend(&mut self, other: Self)

Extend one state from another

For state this is very sensitive operation and should be used only when we know that other state was build on top of this one. In most cases this would be true.

Source

pub fn prepend_state(&mut self, other: BundleState)

Prepends present the state with the given BundleState. It adds changes from the given state but does not override any existing changes.

Reverts and receipts are not updated.

Source

pub fn with_receipts(self, receipts: Receipts<T>) -> Self

Create a new instance with updated receipts.

Source

pub fn with_requests(self, requests: Vec<Requests>) -> Self

Create a new instance with updated requests.

Source

pub fn changed_accounts(&self) -> impl Iterator<Item = ChangedAccount> + '_

Returns an iterator over all changed accounts from the ExecutionOutcome.

This method filters the accounts to return only those that have undergone changes and maps them into ChangedAccount instances, which include the address, nonce, and balance.

Source§

impl<T: Receipt> ExecutionOutcome<T>

Source

pub fn logs( &self, block_number: BlockNumber, ) -> Option<impl Iterator<Item = &Log>>

Returns an iterator over all block logs.

Source

pub fn block_logs_bloom(&self, block_number: BlockNumber) -> Option<Bloom>

Return blocks logs bloom

Source

pub fn receipts_root_slow(&self, _block_number: BlockNumber) -> Option<B256>
where T: ReceiptExt,

Returns the receipt root for all recorded receipts. Note: this function calculated Bloom filters for every receipt and created merkle trees of receipt. This is a expensive operation.

Trait Implementations§

Source§

impl<T: Clone> Clone for ExecutionOutcome<T>

Source§

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

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Debug> Debug for ExecutionOutcome<T>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: Default> Default for ExecutionOutcome<T>

Source§

fn default() -> ExecutionOutcome<T>

Returns the “default value” for a type. Read more
Source§

impl<'de, T> Deserialize<'de> for ExecutionOutcome<T>
where T: Deserialize<'de>,

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl<T> From<(BlockExecutionOutput<T>, u64)> for ExecutionOutcome<T>

Source§

fn from(value: (BlockExecutionOutput<T>, BlockNumber)) -> Self

Converts to this type from the input type.
Source§

impl<T: PartialEq> PartialEq for ExecutionOutcome<T>

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl<T> Serialize for ExecutionOutcome<T>
where T: Serialize,

Source§

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

Serialize this value into the given Serde serializer. Read more
Source§

impl<T: Eq> Eq for ExecutionOutcome<T>

Source§

impl<T> StructuralPartialEq for ExecutionOutcome<T>

Auto Trait Implementations§

§

impl<T> Freeze for ExecutionOutcome<T>

§

impl<T> RefUnwindSafe for ExecutionOutcome<T>
where T: RefUnwindSafe,

§

impl<T> Send for ExecutionOutcome<T>
where T: Send,

§

impl<T> Sync for ExecutionOutcome<T>
where T: Sync,

§

impl<T> Unpin for ExecutionOutcome<T>
where T: Unpin,

§

impl<T> UnwindSafe for ExecutionOutcome<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit #126799)
Performs copy-assignment from self to dst. Read more
§

impl<T> Conv for T

§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
§

impl<T> FmtForward for T

§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pipe for T
where T: ?Sized,

§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> Tap for T

§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
§

impl<T> TryConv for T

§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

§

impl<T> MaybeDebug for T
where T: Debug,

§

impl<T> MaybeSerde for T
where T: Serialize + for<'de> Deserialize<'de>,

§

impl<T> RpcObject for T
where T: RpcParam + RpcReturn,

§

impl<T> RpcParam for T
where T: Serialize + Clone + Debug + Send + Sync + Unpin,

§

impl<T> RpcReturn for T
where T: DeserializeOwned + Debug + Send + Sync + Unpin + 'static,

Layout§

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 176 bytes