//! Support for customizing the node use crate::{ args::{ DatabaseArgs, DatadirArgs, DebugArgs, DevArgs, NetworkArgs, PayloadBuilderArgs, PruningArgs, RpcServerArgs, TxPoolArgs, }, dirs::{ChainPath, DataDirPath}, utils::get_single_header, }; use reth_chainspec::{ChainSpec, MAINNET}; use reth_config::config::PruneConfig; use reth_db_api::database::Database; use reth_network_p2p::headers::client::HeadersClient; use reth_primitives::{ revm_primitives::EnvKzgSettings, BlockHashOrNumber, BlockNumber, Head, SealedHeader, B256, }; use reth_provider::{BlockHashReader, HeaderProvider, ProviderFactory, StageCheckpointReader}; use reth_stages_types::StageId; use reth_storage_errors::provider::ProviderResult; use std::{net::SocketAddr, path::PathBuf, sync::Arc}; use tracing::*; /// This includes all necessary configuration to launch the node. /// The individual configuration options can be overwritten before launching the node. /// /// # Example /// ```rust /// # use reth_node_core::{ /// # node_config::NodeConfig, /// # args::RpcServerArgs, /// # }; /// # use reth_rpc_server_types::RpcModuleSelection; /// # use tokio::runtime::Handle; /// /// async fn t() { /// // create the builder /// let builder = NodeConfig::default(); /// /// // configure the rpc apis /// let mut rpc = RpcServerArgs::default().with_http().with_ws(); /// rpc.http_api = Some(RpcModuleSelection::All); /// let builder = builder.with_rpc(rpc); /// } /// ``` /// /// This can also be used to launch a node with a temporary test database. This can be done with /// the [`NodeConfig::test`] method. /// /// # Example /// ```rust /// # use reth_node_core::{ /// # node_config::NodeConfig, /// # args::RpcServerArgs, /// # }; /// # use reth_rpc_server_types::RpcModuleSelection; /// # use tokio::runtime::Handle; /// /// async fn t() { /// // create the builder with a test database, using the `test` method /// let builder = NodeConfig::test(); /// /// // configure the rpc apis /// let mut rpc = RpcServerArgs::default().with_http().with_ws(); /// rpc.http_api = Some(RpcModuleSelection::All); /// let builder = builder.with_rpc(rpc); /// } /// ``` #[derive(Debug, Clone)] pub struct NodeConfig { /// All data directory related arguments pub datadir: DatadirArgs, /// The path to the configuration file to use. pub config: Option, /// The chain this node is running. /// /// Possible values are either a built-in chain or the path to a chain specification file. pub chain: Arc, /// Enable Prometheus metrics. /// /// The metrics will be served at the given interface and port. pub metrics: Option, /// Add a new instance of a node. /// /// Configures the ports of the node to avoid conflicts with the defaults. /// This is useful for running multiple nodes on the same machine. /// /// Max number of instances is 200. It is chosen in a way so that it's not possible to have /// port numbers that conflict with each other. /// /// Changes to the following port numbers: /// - `DISCOVERY_PORT`: default + `instance` - 1 /// - `DISCOVERY_V5_PORT`: default + `instance` - 1 /// - `AUTH_PORT`: default + `instance` * 100 - 100 /// - `HTTP_RPC_PORT`: default - `instance` + 1 /// - `WS_RPC_PORT`: default + `instance` * 2 - 2 pub instance: u16, /// All networking related arguments pub network: NetworkArgs, /// All rpc related arguments pub rpc: RpcServerArgs, /// All txpool related arguments with --txpool prefix pub txpool: TxPoolArgs, /// All payload builder related arguments pub builder: PayloadBuilderArgs, /// All debug related arguments with --debug prefix pub debug: DebugArgs, /// All database related arguments pub db: DatabaseArgs, /// All dev related arguments with --dev prefix pub dev: DevArgs, /// All pruning related arguments pub pruning: PruningArgs, } impl NodeConfig { /// Creates a testing [`NodeConfig`], causing the database to be launched ephemerally. pub fn test() -> Self { Self::default() // set all ports to zero by default for test instances .with_unused_ports() } /// Sets --dev mode for the node. /// /// In addition to setting the `--dev` flag, this also: /// - disables discovery in [`NetworkArgs`]. pub const fn dev(mut self) -> Self { self.dev.dev = true; self.network.discovery.disable_discovery = true; self } /// Sets --dev mode for the node [`NodeConfig::dev`], if `dev` is true. pub const fn set_dev(self, dev: bool) -> Self { if dev { self.dev() } else { self } } /// Set the data directory args for the node pub fn with_datadir_args(mut self, datadir_args: DatadirArgs) -> Self { self.datadir = datadir_args; self } /// Set the config file for the node pub fn with_config(mut self, config: impl Into) -> Self { self.config = Some(config.into()); self } /// Set the [`ChainSpec`] for the node pub fn with_chain(mut self, chain: impl Into>) -> Self { self.chain = chain.into(); self } /// Set the metrics address for the node pub const fn with_metrics(mut self, metrics: SocketAddr) -> Self { self.metrics = Some(metrics); self } /// Set the instance for the node pub const fn with_instance(mut self, instance: u16) -> Self { self.instance = instance; self } /// Set the network args for the node pub fn with_network(mut self, network: NetworkArgs) -> Self { self.network = network; self } /// Set the rpc args for the node pub fn with_rpc(mut self, rpc: RpcServerArgs) -> Self { self.rpc = rpc; self } /// Set the txpool args for the node pub fn with_txpool(mut self, txpool: TxPoolArgs) -> Self { self.txpool = txpool; self } /// Set the builder args for the node pub fn with_payload_builder(mut self, builder: PayloadBuilderArgs) -> Self { self.builder = builder; self } /// Set the debug args for the node pub fn with_debug(mut self, debug: DebugArgs) -> Self { self.debug = debug; self } /// Set the database args for the node pub const fn with_db(mut self, db: DatabaseArgs) -> Self { self.db = db; self } /// Set the dev args for the node pub const fn with_dev(mut self, dev: DevArgs) -> Self { self.dev = dev; self } /// Set the pruning args for the node pub const fn with_pruning(mut self, pruning: PruningArgs) -> Self { self.pruning = pruning; self } /// Returns pruning configuration. pub fn prune_config(&self) -> Option { self.pruning.prune_config(&self.chain) } /// Returns the max block that the node should run to, looking it up from the network if /// necessary pub async fn max_block( &self, network_client: Client, provider: Provider, ) -> eyre::Result> where Provider: HeaderProvider, Client: HeadersClient, { let max_block = if let Some(block) = self.debug.max_block { Some(block) } else if let Some(tip) = self.debug.tip { Some(self.lookup_or_fetch_tip(provider, network_client, tip).await?) } else { None }; Ok(max_block) } /// Loads '`EnvKzgSettings::Default`' pub const fn kzg_settings(&self) -> eyre::Result { Ok(EnvKzgSettings::Default) } /// Fetches the head block from the database. /// /// If the database is empty, returns the genesis block. pub fn lookup_head(&self, factory: ProviderFactory) -> ProviderResult { let provider = factory.provider()?; let head = provider.get_stage_checkpoint(StageId::Finish)?.unwrap_or_default().block_number; let header = provider .header_by_number(head)? .expect("the header for the latest block is missing, database is corrupt"); let total_difficulty = provider .header_td_by_number(head)? .expect("the total difficulty for the latest block is missing, database is corrupt"); let hash = provider .block_hash(head)? .expect("the hash for the latest block is missing, database is corrupt"); Ok(Head { number: head, hash, difficulty: header.difficulty, total_difficulty, timestamp: header.timestamp, }) } /// Attempt to look up the block number for the tip hash in the database. /// If it doesn't exist, download the header and return the block number. /// /// NOTE: The download is attempted with infinite retries. pub async fn lookup_or_fetch_tip( &self, provider: Provider, client: Client, tip: B256, ) -> ProviderResult where Provider: HeaderProvider, Client: HeadersClient, { let header = provider.header_by_hash_or_number(tip.into())?; // try to look up the header in the database if let Some(header) = header { info!(target: "reth::cli", ?tip, "Successfully looked up tip block in the database"); return Ok(header.number) } Ok(self.fetch_tip_from_network(client, tip.into()).await.number) } /// Attempt to look up the block with the given number and return the header. /// /// NOTE: The download is attempted with infinite retries. pub async fn fetch_tip_from_network( &self, client: Client, tip: BlockHashOrNumber, ) -> SealedHeader where Client: HeadersClient, { info!(target: "reth::cli", ?tip, "Fetching tip block from the network."); let mut fetch_failures = 0; loop { match get_single_header(&client, tip).await { Ok(tip_header) => { info!(target: "reth::cli", ?tip, "Successfully fetched tip"); return tip_header } Err(error) => { fetch_failures += 1; if fetch_failures % 20 == 0 { error!(target: "reth::cli", ?fetch_failures, %error, "Failed to fetch the tip. Retrying..."); } } } } } /// Change rpc port numbers based on the instance number, using the inner /// [`RpcServerArgs::adjust_instance_ports`] method. pub fn adjust_instance_ports(&mut self) { self.rpc.adjust_instance_ports(self.instance); self.network.adjust_instance_ports(self.instance); } /// Sets networking and RPC ports to zero, causing the OS to choose random unused ports when /// sockets are bound. pub fn with_unused_ports(mut self) -> Self { self.rpc = self.rpc.with_unused_ports(); self.network = self.network.with_unused_ports(); self } /// Resolve the final datadir path. pub fn datadir(&self) -> ChainPath { self.datadir.clone().resolve_datadir(self.chain.chain) } } impl Default for NodeConfig { fn default() -> Self { Self { config: None, chain: MAINNET.clone(), metrics: None, instance: 1, network: NetworkArgs::default(), rpc: RpcServerArgs::default(), txpool: TxPoolArgs::default(), builder: PayloadBuilderArgs::default(), debug: DebugArgs::default(), db: DatabaseArgs::default(), dev: DevArgs::default(), pruning: PruningArgs::default(), datadir: DatadirArgs::default(), } } }