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 aot: bool,
    pub jit_mode: JitMode,
    pub jit_helper_path: Option<PathBuf>,
    pub blocking: bool,
    pub on_compilation: Option<Arc<dyn Fn(CompilationEvent) + Send + Sync>>,
}

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 "revmc-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 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.

Useful for benchmarking the cost of failure-result materialization.

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 GasParams::new_spec(spec_id).

Defaults to None.

aot: bool

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

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 std::env::current_exe() 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 and never falls back to the interpreter.

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 and jit_hot_threshold = 0.

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

Defaults to false.

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

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

Defaults to None.

Implementations

impl RuntimeConfig

pub fn with_env_overrides(self) -> Result<Self>

Applies runtime environment overrides.

Recognized variables are REVMC_JIT_MODE, REVMC_JIT_HELPER_PATH, REVMC_JIT_HELPER_MEMORY_LIMIT_BYTES, and REVMC_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

Formats the value using the given formatter.

impl Default for RuntimeConfig

fn default() -> Self

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