Struct evm_adapters::call_tracing::CallTraceArena

pub struct CallTraceArena {
    pub arena: Vec<CallTraceNode>,
    pub entry: usize,
}

An arena of CallTraceNodes

Fields

arena: Vec<CallTraceNode>

The arena of nodes

entry: usize

The entry index, denoting the first node’s index in the arena

Implementations

impl CallTraceArena

pub fn push_trace(&mut self, entry: usize, new_trace: &mut CallTrace)

Pushes a new trace into the arena, returning the trace that was passed in with updated values

pub fn update(&mut self, trace: CallTrace)

Updates the values in the calltrace held by the arena based on the passed in trace

pub fn update_identified<'a, S: Clone, E: Evm<S>>(
    &self,
    idx: usize,
    contracts: &BTreeMap<String, (Abi, Vec<u8>)>,
    identified_contracts: &mut BTreeMap<H160, (String, Abi)>,
    evm: &'a E
)

Updates identified_contracts for future use so that after an evm.reset_state(), we already know which contract corresponds to which address.

idx is the call arena index to start at. Generally this will be 0, but if you want to update a subset of the tree, you can pass in a different index

contracts are the known contracts of (name => (abi, runtime_code)). It is used to identify a deployed contract.

identified_contracts are the identified contract addresses built up from comparing deployed contracts against contracts

evm is the evm that we used so that we can grab deployed code if needed. A lot of times, the evm state is reset so we wont have any code but it can be useful if we want to pretty print right after a test.

pub fn update_children<'a, S: Clone, E: Evm<S>>(
    &self,
    idx: usize,
    contracts: &BTreeMap<String, (Abi, Vec<u8>)>,
    identified_contracts: &mut BTreeMap<H160, (String, Abi)>,
    evm: &'a E
)

Updates all children nodes by recursing into update_identified

pub fn pretty_print<'a, S: Clone, E: Evm<S>>(
    &self,
    idx: usize,
    contracts: &BTreeMap<String, (Abi, Vec<u8>)>,
    identified_contracts: &mut BTreeMap<H160, (String, Abi)>,
    evm: &'a E,
    left: &str
)

Pretty print a CallTraceArena

idx is the call arena index to start at. Generally this will be 0, but if you want to print a subset of the tree, you can pass in a different index

contracts are the known contracts of (name => (abi, runtime_code)). It is used to identify a deployed contract.

identified_contracts are the identified contract addresses built up from comparing deployed contracts against contracts

evm is the evm that we used so that we can grab deployed code if needed. A lot of times, the evm state is reset so we wont have any code but it can be useful if we want to pretty print right after a test.

For a user, left input should generally be "". Left is used recursively to build the tree print out structure and is built up as we recurse down the tree.

pub fn print_children_and_logs<'a, S: Clone, E: Evm<S>>(
    &self,
    node_idx: usize,
    abi: Option<&Abi>,
    contracts: &BTreeMap<String, (Abi, Vec<u8>)>,
    identified_contracts: &mut BTreeMap<H160, (String, Abi)>,
    evm: &'a E,
    left: &str
)

Prints child calls and logs in order

Trait Implementations

impl Clone for CallTraceArena

fn clone(&self) -> CallTraceArena

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CallTraceArena

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

Formats the value using the given formatter.

impl Default for CallTraceArena

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CallTraceArena

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

Deserialize this value from the given Serde deserializer.

impl Serialize for CallTraceArena

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

Serialize this value into the given Serde serializer.