Struct MastForestParams 

pub struct MastForestParams {
    pub decorators: u32,
    pub blocks: RangeInclusive<usize>,
    pub max_joins: usize,
    pub max_splits: usize,
    pub max_loops: usize,
    pub max_calls: usize,
    pub max_syscalls: usize,
    pub max_externals: usize,
    pub max_dyns: usize,
}

Parameters for generating MastForest instances

Execution Compatibility

Generated forests will only be executable if certain node types are excluded:

• Syscalls: Require matching kernel procedures. Set max_syscalls = 0 for executable forests.
• Externals: Use random digests that won’t match valid procedures. Set max_externals = 0 for executable forests.
• Dyn nodes: Leave junk on the stack and cannot execute properly. Set max_dyns = 0 for executable forests.

The default parameters create executable forests by setting all three of the above to 0.

Non-executable Forests

If you want to generate forests for testing assembly or parsing without execution:

• Set max_syscalls > 0 to include syscall nodes
• Set max_externals > 0 to include external nodes
• Set max_dyns > 0 to include dynamic nodes

These forests are useful for testing MAST structure and serialization but will fail during execution.

Fields

decorators: u32

Number of decorators to generate

blocks: RangeInclusive<usize>

Range of number of blocks to generate

max_joins: usize

Maximum number of join nodes to generate

max_splits: usize

Maximum number of split nodes to generate

max_loops: usize

Maximum number of loop nodes to generate

max_calls: usize

Maximum number of call nodes to generate

max_syscalls: usize

Maximum number of syscall nodes to generate

Warning: Syscalls require a properly configured kernel with matching procedure hashes. Generated syscalls use random procedure digests and will not execute without providing a matching kernel. Set to 0 for executable forests.

max_externals: usize

Maximum number of external nodes to generate

Warning: External nodes use random digests that won’t correspond to valid procedures. Any program with external nodes will fail to execute. Set to 0 for executable forests.

max_dyns: usize

Maximum number of dyn/dyncall nodes to generate

Warning: Dyn nodes leave junk on the stack and cannot execute properly. These nodes are primarily for testing MAST structure, not execution. Set to 0 for executable forests.

Trait Implementations

impl Clone for MastForestParams

fn clone(&self) -> MastForestParams

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MastForestParams

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

Formats the value using the given formatter.

impl Default for MastForestParams

fn default() -> Self

Returns the “default value” for a type.