reth_cli_commands/init_state/
mod.rs

1//! Command that initializes the node from a genesis file.
2
3use crate::common::{AccessRights, CliNodeTypes, Environment, EnvironmentArgs};
4use alloy_primitives::{B256, U256};
5use clap::Parser;
6use reth_chainspec::{EthChainSpec, EthereumHardforks};
7use reth_cli::chainspec::ChainSpecParser;
8use reth_db_common::init::init_from_state_dump;
9use reth_primitives::SealedHeader;
10use reth_provider::{
11    BlockNumReader, DatabaseProviderFactory, StaticFileProviderFactory, StaticFileWriter,
12};
13
14use std::{io::BufReader, path::PathBuf, str::FromStr};
15use tracing::info;
16
17pub mod without_evm;
18
19/// Initializes the database with the genesis block.
20#[derive(Debug, Parser)]
21pub struct InitStateCommand<C: ChainSpecParser> {
22    #[command(flatten)]
23    pub env: EnvironmentArgs<C>,
24
25    /// JSONL file with state dump.
26    ///
27    /// Must contain accounts in following format, additional account fields are ignored. Must
28    /// also contain { "root": \<state-root\> } as first line.
29    /// {
30    ///     "balance": "\<balance\>",
31    ///     "nonce": \<nonce\>,
32    ///     "code": "\<bytecode\>",
33    ///     "storage": {
34    ///         "\<key\>": "\<value\>",
35    ///         ..
36    ///     },
37    ///     "address": "\<address\>",
38    /// }
39    ///
40    /// Allows init at a non-genesis block. Caution! Blocks must be manually imported up until
41    /// and including the non-genesis block to init chain at. See 'import' command.
42    #[arg(value_name = "STATE_DUMP_FILE", verbatim_doc_comment)]
43    pub state: PathBuf,
44
45    /// Specifies whether to initialize the state without relying on EVM historical data.
46    ///
47    /// When enabled, and before inserting the state, it creates a dummy chain up to the last EVM
48    /// block specified. It then, appends the first block provided block.
49    ///
50    /// - **Note**: **Do not** import receipts and blocks beforehand, or this will fail or be
51    ///   ignored.
52    #[arg(long, default_value = "false")]
53    pub without_evm: bool,
54
55    /// Header file containing the header in an RLP encoded format.
56    #[arg(long, value_name = "HEADER_FILE", verbatim_doc_comment)]
57    pub header: Option<PathBuf>,
58
59    /// Total difficulty of the header.
60    #[arg(long, value_name = "TOTAL_DIFFICULTY", verbatim_doc_comment)]
61    pub total_difficulty: Option<String>,
62
63    /// Hash of the header.
64    #[arg(long, value_name = "HEADER_HASH", verbatim_doc_comment)]
65    pub header_hash: Option<String>,
66}
67
68impl<C: ChainSpecParser<ChainSpec: EthChainSpec + EthereumHardforks>> InitStateCommand<C> {
69    /// Execute the `init` command
70    pub async fn execute<N: CliNodeTypes<ChainSpec = C::ChainSpec>>(self) -> eyre::Result<()> {
71        info!(target: "reth::cli", "Reth init-state starting");
72
73        let Environment { config, provider_factory, .. } = self.env.init::<N>(AccessRights::RW)?;
74
75        let static_file_provider = provider_factory.static_file_provider();
76        let provider_rw = provider_factory.database_provider_rw()?;
77
78        if self.without_evm {
79            // ensure header, total difficulty and header hash are provided
80            let header = self.header.ok_or_else(|| eyre::eyre!("Header file must be provided"))?;
81            let header = without_evm::read_header_from_file(header)?;
82
83            let header_hash =
84                self.header_hash.ok_or_else(|| eyre::eyre!("Header hash must be provided"))?;
85            let header_hash = B256::from_str(&header_hash)?;
86
87            let total_difficulty = self
88                .total_difficulty
89                .ok_or_else(|| eyre::eyre!("Total difficulty must be provided"))?;
90            let total_difficulty = U256::from_str(&total_difficulty)?;
91
92            let last_block_number = provider_rw.last_block_number()?;
93
94            if last_block_number == 0 {
95                without_evm::setup_without_evm(
96                    &provider_rw,
97                    // &header,
98                    // header_hash,
99                    SealedHeader::new(header, header_hash),
100                    total_difficulty,
101                )?;
102
103                // SAFETY: it's safe to commit static files, since in the event of a crash, they
104                // will be unwinded according to database checkpoints.
105                //
106                // Necessary to commit, so the header is accessible to provider_rw and
107                // init_state_dump
108                static_file_provider.commit()?;
109            } else if last_block_number > 0 && last_block_number < header.number {
110                return Err(eyre::eyre!(
111                    "Data directory should be empty when calling init-state with --without-evm-history."
112                ));
113            }
114        }
115
116        info!(target: "reth::cli", "Initiating state dump");
117
118        let reader = BufReader::new(reth_fs_util::open(self.state)?);
119
120        let hash = init_from_state_dump(reader, &provider_rw, config.stages.etl)?;
121
122        provider_rw.commit()?;
123
124        info!(target: "reth::cli", hash = ?hash, "Genesis block written");
125        Ok(())
126    }
127}
reth_cli_commands/init_state/mod.rs

reth_cli_commands/init_state/
mod.rs
