Struct FoldedStackTraceBuilder

pub struct FoldedStackTraceBuilder {
    traces: Vec<TraceEntry>,
    exits: usize,
}

Helps to translate a function enter-exit flow into a folded stack trace.

Example:

function top() { child_a(); child_b() } // consumes 500 gas
function child_a() {} // consumes 100 gas
function child_b() {} // consumes 200 gas

For execution of the top function looks like:

1. enter top
2. enter child_a
3. exit child_a
4. enter child_b
5. exit child_b
6. exit top

The translated folded stack trace lines look like:

1. top
2. top;child_a
3. top;child_b

Including the gas consumed by the function by itself.

1. top 200 // 500 - 100 - 200
2. top;child_a 100
3. top;child_b 200

Fields

traces: Vec<TraceEntry>

Trace entries.

exits: usize

Number of exits to be done before entering a new function.

Implementations

impl FoldedStackTraceBuilder

pub fn enter(&mut self, label: String, gas: i64)

Enter execution of a function call that consumes gas.

pub fn exit(&mut self)

Exit execution of a function call.

pub fn build(self) -> Vec<String>

Returns folded stack trace.

fn build_without_subtraction(&mut self) -> Vec<String>

Internal method to build the folded stack trace without subtracting gas consumed by the children function calls.

fn subtract_children(&mut self)

Subtracts gas consumed by the children function calls from the parent function calls.

Trait Implementations

impl Debug for FoldedStackTraceBuilder

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

Formats the value using the given formatter.

impl Default for FoldedStackTraceBuilder

fn default() -> FoldedStackTraceBuilder

Returns the “default value” for a type.

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: 32 bytes