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>
impl<T> ExecutionOutcome<T>
Sourcepub const fn new(
bundle: BundleState,
receipts: Receipts<T>,
first_block: BlockNumber,
requests: Vec<Requests>,
) -> Self
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.
Sourcepub 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
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.
Sourcepub fn set_first_block(&mut self, first_block: BlockNumber)
pub fn set_first_block(&mut self, first_block: BlockNumber)
Set first block.
Sourcepub fn accounts_iter(
&self,
) -> impl Iterator<Item = (Address, Option<&AccountInfo>)>
pub fn accounts_iter( &self, ) -> impl Iterator<Item = (Address, Option<&AccountInfo>)>
Return iterator over all accounts
Sourcepub fn bundle_accounts_iter(
&self,
) -> impl Iterator<Item = (Address, &BundleAccount)>
pub fn bundle_accounts_iter( &self, ) -> impl Iterator<Item = (Address, &BundleAccount)>
Return iterator over all [BundleAccount
]s in the bundle
Sourcepub fn account(&self, address: &Address) -> Option<Option<Account>>
pub fn account(&self, address: &Address) -> Option<Option<Account>>
Get account if account is known.
Sourcepub fn storage(&self, address: &Address, storage_key: U256) -> Option<U256>
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
.
Sourcepub fn hash_state_slow(&self) -> HashedPostState
pub fn hash_state_slow(&self) -> HashedPostState
Returns [HashedPostState
] for this execution outcome.
See [HashedPostState::from_bundle_state
] for more info.
Sourcepub fn block_number_to_index(&self, block_number: BlockNumber) -> Option<usize>
pub fn block_number_to_index(&self, block_number: BlockNumber) -> Option<usize>
Transform block number to the index of block.
Sourcepub fn logs(
&self,
block_number: BlockNumber,
) -> Option<impl Iterator<Item = &Log>>where
T: Receipt,
pub fn logs(
&self,
block_number: BlockNumber,
) -> Option<impl Iterator<Item = &Log>>where
T: Receipt,
Returns an iterator over all block logs.
Sourcepub fn block_logs_bloom(&self, block_number: BlockNumber) -> Option<Bloom>where
T: Receipt,
pub fn block_logs_bloom(&self, block_number: BlockNumber) -> Option<Bloom>where
T: Receipt,
Return blocks logs bloom
Sourcepub fn receipts_root_slow(&self, _block_number: BlockNumber) -> Option<B256>where
T: Receipt,
pub fn receipts_root_slow(&self, _block_number: BlockNumber) -> Option<B256>where
T: Receipt,
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.
Sourcepub fn generic_receipts_root_slow(
&self,
block_number: BlockNumber,
f: impl FnOnce(&[&T]) -> B256,
) -> Option<B256>
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.
Sourcepub fn receipts_mut(&mut self) -> &mut Receipts<T>
pub fn receipts_mut(&mut self) -> &mut Receipts<T>
Returns mutable reference to receipts.
Sourcepub fn receipts_by_block(&self, block_number: BlockNumber) -> &[Option<T>]
pub fn receipts_by_block(&self, block_number: BlockNumber) -> &[Option<T>]
Return all block receipts
Sourcepub const fn first_block(&self) -> BlockNumber
pub const fn first_block(&self) -> BlockNumber
Return first block of the execution outcome
Sourcepub fn revert_to(&mut self, block_number: BlockNumber) -> bool
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.
Sourcepub fn split_at(self, at: BlockNumber) -> (Option<Self>, Self)where
T: Clone,
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.
Sourcepub fn extend(&mut self, other: Self)
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.
Sourcepub fn prepend_state(&mut self, other: BundleState)
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.
Sourcepub fn with_receipts(self, receipts: Receipts<T>) -> Self
pub fn with_receipts(self, receipts: Receipts<T>) -> Self
Create a new instance with updated receipts.
Sourcepub fn with_requests(self, requests: Vec<Requests>) -> Self
pub fn with_requests(self, requests: Vec<Requests>) -> Self
Create a new instance with updated requests.
Sourcepub fn changed_accounts(&self) -> impl Iterator<Item = ChangedAccount> + '_
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.
Trait Implementations§
Source§impl<T: Clone> Clone for ExecutionOutcome<T>
impl<T: Clone> Clone for ExecutionOutcome<T>
Source§fn clone(&self) -> ExecutionOutcome<T>
fn clone(&self) -> ExecutionOutcome<T>
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl<T: Debug> Debug for ExecutionOutcome<T>
impl<T: Debug> Debug for ExecutionOutcome<T>
Source§impl<T: Default> Default for ExecutionOutcome<T>
impl<T: Default> Default for ExecutionOutcome<T>
Source§fn default() -> ExecutionOutcome<T>
fn default() -> ExecutionOutcome<T>
Source§impl<'de, T> Deserialize<'de> for ExecutionOutcome<T>where
T: Deserialize<'de>,
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>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
Source§impl<T> From<(BlockExecutionOutput<T>, u64)> for ExecutionOutcome<T>
impl<T> From<(BlockExecutionOutput<T>, u64)> for ExecutionOutcome<T>
Source§fn from(value: (BlockExecutionOutput<T>, BlockNumber)) -> Self
fn from(value: (BlockExecutionOutput<T>, BlockNumber)) -> Self
Source§impl<T: PartialEq> PartialEq for ExecutionOutcome<T>
impl<T: PartialEq> PartialEq for ExecutionOutcome<T>
Source§impl<T> Serialize for ExecutionOutcome<T>where
T: Serialize,
impl<T> Serialize for ExecutionOutcome<T>where
T: Serialize,
impl<T: Eq> Eq for ExecutionOutcome<T>
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> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Conv for T
impl<T> Conv for T
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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 Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
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) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
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
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
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
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
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
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.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
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.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
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<T> DeserializeOwned for Twhere
T: for<'de> Deserialize<'de>,
impl<T> MaybeDebug for Twhere
T: Debug,
impl<T> RpcObject for Twhere
T: RpcParam + RpcReturn,
impl<T> RpcParam for T
impl<T> RpcReturn for T
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