Struct TracingConfig 

pub struct TracingConfig {
    pub state_overrides: Option<StateOverrideSet>,
}

Configuration specific to a tracing execution.

Passed as the last argument to the trace_call_with_config runtime API method. Contains optional overrides that affect how the traced execution is performed.

Backwards Compatibility

This type follows the same backwards compatibility strategy as DryRunConfig. SCALE is a non-self-describing format: fields are encoded sequentially with no names or delimiters. This type uses a custom Decode implementation that defaults missing trailing fields, and relies on sp_api’s use of Decode::decode (not decode_all) to silently discard trailing bytes that an old runtime does not recognize.

Constraints on fields

• New fields must be appended to the end. Inserting or reordering fields breaks the byte layout in both directions.
• New fields must implement Default so the custom Decode fallback can produce a sensible value when the field is absent from the input.

Constraints on runtime API placement

TracingConfig must be the last argument of any runtime API method that uses it. If it were placed before another argument, extra bytes from newly appended fields would shift the decoding offset and corrupt the subsequent argument.

Fields

state_overrides: Option<StateOverrideSet>

Optional state overrides to apply before executing the traced call. Each entry maps an account address to a set of fields (balance, nonce, code, storage) that should be temporarily replaced for the duration of the trace.

Implementations

impl TracingConfig

pub fn new() -> Self

Create a new TracingConfig with default values.

pub fn with_state_overrides( self, state_overrides: impl Into<Option<StateOverrideSet>>, ) -> Self

A builder method which consumes the object and sets the state overrides.

Trait Implementations

impl Clone for TracingConfig

fn clone(&self) -> TracingConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TracingConfig

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

Formats the value using the given formatter.

impl Decode for TracingConfig

A custom implementation of Decode to ensure forward and backward compatibility of the TracingConfig type.

Backwards Compatibility

Please review the documentation on TracingConfig for more information about how we manage and handle compatibility for this type and instructions on what you should do when adding a new field.

fn decode<I: Input>(input: &mut I) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn decode_into<I>( input: &mut I, dst: &mut MaybeUninit<Self>, ) -> Result<DecodeFinished, Error>

where I: Input,

Attempt to deserialize the value from input into a pre-allocated piece of memory.

fn skip<I>(input: &mut I) -> Result<(), Error>

where I: Input,

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl Default for TracingConfig

fn default() -> TracingConfig

Returns the “default value” for a type.

impl Encode for TracingConfig

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode_to<__CodecOutputEdqy: Output + ?Sized>( &self, __codec_dest_edqy: &mut __CodecOutputEdqy, )

Convert self to a slice and append it to the destination.

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

Convert self to an owned vector.

fn using_encoded<__CodecOutputReturn, __CodecUsingEncodedCallback: FnOnce(&[u8]) -> __CodecOutputReturn>( &self, f: __CodecUsingEncodedCallback, ) -> __CodecOutputReturn

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl TypeInfo for TracingConfig

type Identity = TracingConfig

The type identifying for which type info is provided.

fn type_info() -> Type

Returns the static type identifier for Self.

impl EncodeLike for TracingConfig