reth/commands/debug_cmd/
mod.rs

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
44
45
46
47
48
49
50
51
52
53
54
//! `reth debug` command. Collection of various debugging routines.

use clap::{Parser, Subcommand};
use reth_chainspec::ChainSpec;
use reth_cli::chainspec::ChainSpecParser;
use reth_cli_runner::CliContext;
use reth_node_api::NodeTypesWithEngine;
use reth_node_ethereum::EthEngineTypes;

mod build_block;
mod execution;
mod in_memory_merkle;
mod merkle;
mod replay_engine;

/// `reth debug` command
#[derive(Debug, Parser)]
pub struct Command<C: ChainSpecParser> {
    #[command(subcommand)]
    command: Subcommands<C>,
}

/// `reth debug` subcommands
#[derive(Subcommand, Debug)]
pub enum Subcommands<C: ChainSpecParser> {
    /// Debug the roundtrip execution of blocks as well as the generated data.
    Execution(execution::Command<C>),
    /// Debug the clean & incremental state root calculations.
    Merkle(merkle::Command<C>),
    /// Debug in-memory state root calculation.
    InMemoryMerkle(in_memory_merkle::Command<C>),
    /// Debug block building.
    BuildBlock(build_block::Command<C>),
    /// Debug engine API by replaying stored messages.
    ReplayEngine(replay_engine::Command<C>),
}

impl<C: ChainSpecParser<ChainSpec = ChainSpec>> Command<C> {
    /// Execute `debug` command
    pub async fn execute<
        N: NodeTypesWithEngine<Engine = EthEngineTypes, ChainSpec = C::ChainSpec>,
    >(
        self,
        ctx: CliContext,
    ) -> eyre::Result<()> {
        match self.command {
            Subcommands::Execution(command) => command.execute::<N>(ctx).await,
            Subcommands::Merkle(command) => command.execute::<N>(ctx).await,
            Subcommands::InMemoryMerkle(command) => command.execute::<N>(ctx).await,
            Subcommands::BuildBlock(command) => command.execute::<N>(ctx).await,
            Subcommands::ReplayEngine(command) => command.execute::<N>(ctx).await,
        }
    }
}