Struct RuntimeConfig 

pub struct RuntimeConfig {

    pub enabled: bool,
    pub thread_name: String,
    pub store: Option<Arc<dyn ArtifactStore>>,
    pub tuning: RuntimeTuning,
    pub dump_dir: Option<PathBuf>,
    pub debug_assertions: bool,
    pub single_error: bool,
    pub no_dedup: bool,
    pub no_dse: bool,
    pub gas_params: Option<GasParams>,
    pub host: HostConfig,
    pub aot: bool,
    pub jit_mode: JitMode,
    pub jit_helper_path: Option<PathBuf>,
    pub blocking: bool,
    pub on_compilation: Option<Arc<dyn Fn(CompilationEvent) + Sync + Send>>,
}

Available on crate feature jit only.

Runtime configuration.

Fields

enabled: bool

Whether compiled-code lookup is enabled.

Defaults to false (safe rollout default).

thread_name: String

Name for the backend thread.

Defaults to "evm2-jit-backend".

store: Option<Arc<dyn ArtifactStore>>

Artifact store for loading precompiled AOT artifacts.

None means no AOT preload—only JIT will populate the map (in later phases).

tuning: RuntimeTuning

Tuning knobs.

dump_dir: Option<PathBuf>

Base directory for compiler debug dumps.

When set, the compiler dumps IR, assembly, and bytecode for each compiled contract to {dump_dir}/{spec_id}/{code_hash}/.

Defaults to None (no dumps).

debug_assertions: bool

Enable debug assertions in compiled code.

When true, the compiler inserts runtime checks (e.g. stack bounds) that panic! on violation. Useful for diagnosing JIT correctness bugs.

Defaults to false.

single_error: bool

Collapse every JIT failure path to a single OutOfGas instruction result constant.

Failures (stack under/overflow, invalid jump, real OOG, invalid opcode, etc.) are semantically interchangeable for callers that only branch on success vs failure, so this lets LLVM DCE the per-failure-site materialization and the failure-block phi. Successful exits (STOP/RETURN/REVERT) keep their original codes.

This is a deliberate trade-off: the compiled function reports OutOfGas where the interpreter reports the real halt reason (for example, an invalid jump). Preserving the reasons (false) makes the JIT 4.0% larger, compile 10.7% more instructions, and execute 3.8% more instructions in total across the benchmarks (onchain_lm_v2 +4.3%).

Defaults to true.

no_dedup: bool

Disable the block deduplication pass.

When true, the dedup pass that merges identical basic blocks is skipped. Useful for isolating dedup-related JIT correctness bugs.

Defaults to false.

no_dse: bool

Disable the dead store elimination pass.

When true, DSE is skipped. Useful for debugging JIT correctness issues where DSE incorrectly eliminates live stack operations.

Defaults to false.

gas_params: Option<GasParams>

Custom gas parameters for compile-time gas folding.

Overrides the default gas schedule derived from spec_id when compiling bytecode. Useful for custom chains with non-standard gas costs (e.g. modified SSTORE, CREATE, or EXP costs).

When None, the compiler uses the evm2 spec gas schedule.

Defaults to None.

host: HostConfig

Host ABI used by in-process compiled code.

aot: bool

AOT mode: observed misses are promoted to AOT compilation instead of JIT.

Requires store to be set, and is incompatible with JitMode::OutOfProcess.

Defaults to false.

jit_mode: JitMode

Where JIT compilation work runs.

Defaults to JitMode::InProcess.

jit_helper_path: Option<PathBuf>

Helper executable used when jit_mode is JitMode::OutOfProcess.

When None, the runtime spawns the running executable and expects it to call super::maybe_run_jit_helper during startup.

Defaults to None.

blocking: bool

Blocking mode: every lookup synchronously JIT-compiles on miss.

When true, lookup() behaves like lookup_blocking(): if the compiled function is not already resident, the calling thread blocks until JIT compilation completes. This implies enabled = true, jit_hot_threshold = 0, and jit_max_bytecode_len = 0 (no size limit), so every non-empty frame is compiled.

A frame still runs on the interpreter when compilation fails, times out (sync_compile_timeout), is dropped because the pending-job cap or the worker pool is full, or the program is evicted before use. Each such frame is counted in interpreter_fallbacks.

Intended for debugging and testing only — not for production use.

Defaults to false.

on_compilation: Option<Arc<dyn Fn(CompilationEvent) + Sync + Send>>

Callback invoked after each compilation completes (success or failure).

Defaults to None.

Implementations

impl RuntimeConfig

pub fn with_env_overrides(self) -> Result<RuntimeConfig, Report>

Applies runtime environment overrides.

Recognized variables are EVM2_JIT_MODE, EVM2_JIT_HELPER_PATH, EVM2_JIT_HELPER_MEMORY_LIMIT_BYTES, and EVM2_JIT_HELPER_CPU_COUNT.

Trait Implementations

impl Clone for RuntimeConfig

fn clone(&self) -> RuntimeConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeConfig

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

Formats the value using the given formatter.

impl Default for RuntimeConfig

fn default() -> RuntimeConfig

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