use std::sync::Arc; use config::networks::Network; use ethers::prelude::{Address, U256}; use ethers::types::{Filter, Log, Transaction, TransactionReceipt, H256}; use common::types::BlockTag; use config::{CheckpointFallback, Config}; use consensus::{types::Header, ConsensusClient}; use execution::rpc::ExecutionRpc; use execution::types::{CallOpts, ExecutionBlock}; use log::{info, warn}; use tokio::spawn; use tokio::sync::RwLock; use tokio::time::sleep; use crate::database::{Database, FileDB}; use crate::node::Node; use crate::rpc::Rpc; pub struct Client { node: Arc>>, rpc: Option>, db: Option, fallback: Option, load_external_fallback: bool, } impl Client where R: ExecutionRpc { pub fn new(config: Config) -> eyre::Result { let config = Arc::new(config); let node = Node::new(config.clone())?; let node = Arc::new(RwLock::new(node)); let rpc = config .rpc_port .map(|port| Rpc::new(node.clone(), config.with_http, config.with_ws, port)); let data_dir = config.data_dir.clone(); let db = data_dir.map(FileDB::new); Ok(Client { node, rpc, db, fallback: config.fallback.clone(), load_external_fallback: config.load_external_fallback, }) } } impl Client { pub async fn start(&mut self) -> eyre::Result<()> { if let Some(rpc) = &mut self.rpc { // We can start both ws and http servers since they only run if enabled in the config. rpc.start_ws().await?; rpc.start_http().await?; } if self.node.write().await.sync().await.is_err() { warn!( "failed to sync consensus node with checkpoint: 0x{}", hex::encode(&self.node.read().await.config.checkpoint), ); let fallback = self.boot_from_fallback().await; if fallback.is_err() && self.load_external_fallback { self.boot_from_external_fallbacks().await? } else if fallback.is_err() { return Err(eyre::eyre!("Checkpoint is too old. Please update your checkpoint. Alternatively, set an explicit checkpoint fallback service url with the `-f` flag or use the configured external fallback services with `-l` (NOT RECOMMENED). See https://github.com/a16z/helios#additional-options for more information.")); } } let node = self.node.clone(); spawn(async move { loop { let res = node.write().await.advance().await; if let Err(err) = res { warn!("consensus error: {}", err); } let next_update = node.read().await.duration_until_next_update(); sleep(next_update).await; } }); Ok(()) } async fn boot_from_fallback(&self) -> eyre::Result<()> { if let Some(fallback) = &self.fallback { info!( "attempting to load checkpoint from fallback \"{}\"", fallback ); let checkpoint = CheckpointFallback::fetch_checkpoint_from_api(fallback) .await .map_err(|_| { eyre::eyre!("Failed to fetch checkpoint from fallback \"{}\"", fallback) })?; info!( "external fallbacks responded with checkpoint 0x{:?}", checkpoint ); // Try to sync again with the new checkpoint by reconstructing the consensus client // We fail fast here since the node is unrecoverable at this point let config = self.node.read().await.config.clone(); let consensus = ConsensusClient::new(&config.consensus_rpc, checkpoint.as_bytes(), config.clone())?; self.node.write().await.consensus = consensus; self.node.write().await.sync().await?; Ok(()) } else { Err(eyre::eyre!("no explicit fallback specified")) } } async fn boot_from_external_fallbacks(&self) -> eyre::Result<()> { info!("attempting to fetch checkpoint from external fallbacks..."); // Build the list of external checkpoint fallback services let list = CheckpointFallback::new() .build() .await .map_err(|_| eyre::eyre!("Failed to construct external checkpoint sync fallbacks"))?; let checkpoint = if self.node.read().await.config.chain.chain_id == 5 { list.fetch_latest_checkpoint(&Network::GOERLI) .await .map_err(|_| { eyre::eyre!("Failed to fetch latest goerli checkpoint from external fallbacks") })? } else { list.fetch_latest_checkpoint(&Network::MAINNET) .await .map_err(|_| { eyre::eyre!("Failed to fetch latest mainnet checkpoint from external fallbacks") })? }; info!( "external fallbacks responded with checkpoint {:?}", checkpoint ); // Try to sync again with the new checkpoint by reconstructing the consensus client // We fail fast here since the node is unrecoverable at this point let config = self.node.read().await.config.clone(); let consensus = ConsensusClient::new(&config.consensus_rpc, checkpoint.as_bytes(), config.clone())?; self.node.write().await.consensus = consensus; self.node.write().await.sync().await?; Ok(()) } pub async fn shutdown(&self) { let node = self.node.read().await; let checkpoint = if let Some(checkpoint) = node.get_last_checkpoint() { checkpoint } else { return; }; info!("saving last checkpoint hash"); let res = self.db.as_ref().map(|db| db.save_checkpoint(checkpoint)); if res.is_some() && res.unwrap().is_err() { warn!("checkpoint save failed"); } } pub async fn call(&self, opts: &CallOpts, block: BlockTag) -> eyre::Result> { self.node .read() .await .call(opts, block) .await .map_err(|err| err.into()) } pub async fn estimate_gas(&self, opts: &CallOpts) -> eyre::Result { self.node .read() .await .estimate_gas(opts) .await .map_err(|err| err.into()) } pub async fn get_balance(&self, address: &Address, block: BlockTag) -> eyre::Result { self.node.read().await.get_balance(address, block).await } pub async fn get_nonce(&self, address: &Address, block: BlockTag) -> eyre::Result { self.node.read().await.get_nonce(address, block).await } pub async fn get_code(&self, address: &Address, block: BlockTag) -> eyre::Result> { self.node.read().await.get_code(address, block).await } pub async fn get_storage_at(&self, address: &Address, slot: H256) -> eyre::Result { self.node.read().await.get_storage_at(address, slot).await } pub async fn send_raw_transaction(&self, bytes: &[u8]) -> eyre::Result { self.node.read().await.send_raw_transaction(bytes).await } pub async fn get_transaction_receipt( &self, tx_hash: &H256, ) -> eyre::Result> { self.node .read() .await .get_transaction_receipt(tx_hash) .await } pub async fn get_transaction_by_hash(&self, tx_hash: &H256) -> eyre::Result> { self.node .read() .await .get_transaction_by_hash(tx_hash) .await } pub async fn get_logs(&self, filter: &Filter) -> eyre::Result> { self.node.read().await.get_logs(filter).await } pub async fn get_gas_price(&self) -> eyre::Result { self.node.read().await.get_gas_price() } pub async fn get_priority_fee(&self) -> eyre::Result { self.node.read().await.get_priority_fee() } pub async fn get_block_number(&self) -> eyre::Result { self.node.read().await.get_block_number() } pub async fn get_block_by_number( &self, block: BlockTag, full_tx: bool, ) -> eyre::Result> { self.node .read() .await .get_block_by_number(block, full_tx) .await } pub async fn get_block_by_hash( &self, hash: &Vec, full_tx: bool, ) -> eyre::Result> { self.node .read() .await .get_block_by_hash(hash, full_tx) .await } pub async fn chain_id(&self) -> u64 { self.node.read().await.chain_id() } pub async fn get_header(&self) -> eyre::Result
{ self.node.read().await.get_header() } }