mega-evme 1.7.0

MegaETH executable EVM
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

//! `mega-evme` library.
//!
//! Holds all of the executable EVM logic for the `mega-evme` CLI. The binary
//! at `src/main.rs` is a thin wrapper that only parses arguments and
//! dispatches into this crate; integration tests in `tests/*.rs` link against
//! the library directly and exercise the public API the same way an external
//! consumer would.

/// Top-level CLI command parser and dispatch (`MainCmd`, `Commands`, `Error`).
pub mod cmd;
/// Shared building blocks: RPC provider/session, state, env, error, output
/// formatting, tracing, transaction utilities.
pub mod common;
/// Historical transaction replay command.
pub mod replay;
/// Arbitrary EVM bytecode execution command.
pub mod run;
/// Single-transaction execution command.
pub mod tx;

// Internal modules reach for `crate::ChainArgs`, `crate::EvmeState`, etc.;
// these re-exports keep those call sites working unchanged.
pub use cmd::*;
pub use common::*;

/// Install a thread panic hook that prints a custom backtrace and exits with a
/// non-zero status. Lets failing tests and CLI runs surface a useful trace
/// without relying on `RUST_BACKTRACE`.
pub fn set_thread_panic_hook() {
    use std::{
        backtrace::Backtrace,
        panic::{set_hook, take_hook},
        process::exit,
    };
    let orig_hook = take_hook();
    set_hook(Box::new(move |panic_info| {
        // Raw stderr rather than `tracing`: the subscriber may not be
        // installed yet when a panic fires during CLI startup.
        eprintln!("Custom backtrace: {}", Backtrace::capture());
        orig_hook(panic_info);
        exit(1);
    }));
}