use crate::{ cli::{ build_balance_message, check_account_for_fee, CliCommand, CliCommandInfo, CliConfig, CliError, ProcessResult, }, display::println_name_value, }; use chrono::{DateTime, NaiveDateTime, SecondsFormat, Utc}; use clap::{value_t, value_t_or_exit, App, Arg, ArgMatches, SubCommand}; use console::{style, Emoji}; use indicatif::{ProgressBar, ProgressStyle}; use solana_clap_utils::{input_parsers::*, input_validators::*, keypair::signer_from_path}; use solana_client::{ pubsub_client::{PubsubClient, SlotInfoMessage}, rpc_client::RpcClient, rpc_response::RpcVoteAccountInfo, }; use solana_remote_wallet::remote_wallet::RemoteWalletManager; use solana_sdk::{ account_utils::StateMut, clock::{self, Slot}, commitment_config::CommitmentConfig, epoch_schedule::Epoch, hash::Hash, message::Message, native_token::lamports_to_sol, pubkey::Pubkey, signature::{Keypair, Signer}, system_instruction, transaction::Transaction, }; use std::{ collections::{HashMap, VecDeque}, net::SocketAddr, sync::{ atomic::{AtomicBool, Ordering}, Arc, }, thread::sleep, time::{Duration, Instant}, }; static CHECK_MARK: Emoji = Emoji("✅ ", ""); static CROSS_MARK: Emoji = Emoji("❌ ", ""); static WARNING: Emoji = Emoji("⚠️", "!"); pub trait ClusterQuerySubCommands { fn cluster_query_subcommands(self) -> Self; } impl ClusterQuerySubCommands for App<'_, '_> { fn cluster_query_subcommands(self) -> Self { self.subcommand( SubCommand::with_name("catchup") .about("Wait for a validator to catch up to the cluster") .arg( pubkey!(Arg::with_name("node_pubkey") .index(1) .value_name("VALIDATOR_PUBKEY") .required(true), "Identity pubkey of the validator"), ) .arg( Arg::with_name("node_json_rpc_url") .index(2) .value_name("URL") .takes_value(true) .validator(is_url) .help("JSON RPC URL for validator, which is useful for validators with a private RPC service") ), ) .subcommand( SubCommand::with_name("cluster-version") .about("Get the version of the cluster entrypoint"), ) .subcommand(SubCommand::with_name("fees").about("Display current cluster fees")) .subcommand(SubCommand::with_name("block-time") .about("Get estimated production time of a block") .alias("get-block-time") .arg( Arg::with_name("slot") .index(1) .takes_value(true) .value_name("SLOT") .required(true) .help("Slot number of the block to query") ) ) .subcommand(SubCommand::with_name("leader-schedule").about("Display leader schedule")) .subcommand( SubCommand::with_name("epoch-info") .about("Get information about the current epoch") .alias("get-epoch-info") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return information at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("genesis-hash") .about("Get the genesis hash") .alias("get-genesis-hash") ) .subcommand( SubCommand::with_name("slot").about("Get current slot") .alias("get-slot") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return slot at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("epoch").about("Get current epoch") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return epoch at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("total-supply").about("Get total number of SOL") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return count at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("transaction-count").about("Get current transaction count") .alias("get-transaction-count") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return count at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("ping") .about("Submit transactions sequentially") .arg( Arg::with_name("interval") .short("i") .long("interval") .value_name("SECONDS") .takes_value(true) .default_value("2") .help("Wait interval seconds between submitting the next transaction"), ) .arg( Arg::with_name("count") .short("c") .long("count") .value_name("NUMBER") .takes_value(true) .help("Stop after submitting count transactions"), ) .arg( Arg::with_name("lamports") .long("lamports") .value_name("NUMBER") .takes_value(true) .default_value("1") .validator(is_amount) .help("Number of lamports to transfer for each transaction"), ) .arg( Arg::with_name("timeout") .short("t") .long("timeout") .value_name("SECONDS") .takes_value(true) .default_value("15") .help("Wait up to timeout seconds for transaction confirmation"), ) .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Wait until the transaction is confirmed at maximum-lockout commitment level", ), ), ) .subcommand( SubCommand::with_name("live-slots") .about("Show information about the current slot progression"), ) .subcommand( SubCommand::with_name("block-production") .about("Show information about block production") .alias("show-block-production") .arg( Arg::with_name("epoch") .long("epoch") .takes_value(true) .help("Epoch to show block production for [default: current epoch]"), ) .arg( Arg::with_name("slot_limit") .long("slot-limit") .takes_value(true) .help("Limit results to this many slots from the end of the epoch [default: full epoch]"), ), ) .subcommand( SubCommand::with_name("gossip") .about("Show the current gossip network nodes") .alias("show-gossip") ) .subcommand( SubCommand::with_name("stakes") .about("Show stake account information") .arg( pubkey!(Arg::with_name("vote_account_pubkeys") .index(1) .value_name("VOTE_ACCOUNT_PUBKEYS") .multiple(true), "Only show stake accounts delegated to the provided vote accounts. "), ) .arg( Arg::with_name("lamports") .long("lamports") .takes_value(false) .help("Display balance in lamports instead of SOL"), ), ) .subcommand( SubCommand::with_name("validators") .about("Show summary information about the current validators") .alias("show-validators") .arg( Arg::with_name("confirmed") .long("confirmed") .takes_value(false) .help( "Return information at maximum-lockout commitment level", ), ) .arg( Arg::with_name("lamports") .long("lamports") .takes_value(false) .help("Display balance in lamports instead of SOL"), ), ) } } pub fn parse_catchup( matches: &ArgMatches<'_>, wallet_manager: Option<&Arc>, ) -> Result { let node_pubkey = pubkey_of_signer(matches, "node_pubkey", wallet_manager)?.unwrap(); let node_json_rpc_url = value_t!(matches, "node_json_rpc_url", String).ok(); Ok(CliCommandInfo { command: CliCommand::Catchup { node_pubkey, node_json_rpc_url, }, signers: vec![], }) } pub fn parse_cluster_ping( matches: &ArgMatches<'_>, default_signer_path: &str, wallet_manager: Option<&Arc>, ) -> Result { let lamports = value_t_or_exit!(matches, "lamports", u64); let interval = Duration::from_secs(value_t_or_exit!(matches, "interval", u64)); let count = if matches.is_present("count") { Some(value_t_or_exit!(matches, "count", u64)) } else { None }; let timeout = Duration::from_secs(value_t_or_exit!(matches, "timeout", u64)); let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::Ping { lamports, interval, count, timeout, commitment_config, }, signers: vec![signer_from_path( matches, default_signer_path, "keypair", wallet_manager, )?], }) } pub fn parse_get_block_time(matches: &ArgMatches<'_>) -> Result { let slot = value_t_or_exit!(matches, "slot", u64); Ok(CliCommandInfo { command: CliCommand::GetBlockTime { slot }, signers: vec![], }) } pub fn parse_get_epoch_info(matches: &ArgMatches<'_>) -> Result { let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::GetEpochInfo { commitment_config }, signers: vec![], }) } pub fn parse_get_slot(matches: &ArgMatches<'_>) -> Result { let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::GetSlot { commitment_config }, signers: vec![], }) } pub fn parse_get_epoch(matches: &ArgMatches<'_>) -> Result { let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::GetEpoch { commitment_config }, signers: vec![], }) } pub fn parse_total_supply(matches: &ArgMatches<'_>) -> Result { let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::TotalSupply { commitment_config }, signers: vec![], }) } pub fn parse_get_transaction_count(matches: &ArgMatches<'_>) -> Result { let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::GetTransactionCount { commitment_config }, signers: vec![], }) } pub fn parse_show_stakes( matches: &ArgMatches<'_>, wallet_manager: Option<&Arc>, ) -> Result { let use_lamports_unit = matches.is_present("lamports"); let vote_account_pubkeys = pubkeys_of_multiple_signers(matches, "vote_account_pubkeys", wallet_manager)?; Ok(CliCommandInfo { command: CliCommand::ShowStakes { use_lamports_unit, vote_account_pubkeys, }, signers: vec![], }) } pub fn parse_show_validators(matches: &ArgMatches<'_>) -> Result { let use_lamports_unit = matches.is_present("lamports"); let commitment_config = if matches.is_present("confirmed") { CommitmentConfig::default() } else { CommitmentConfig::recent() }; Ok(CliCommandInfo { command: CliCommand::ShowValidators { use_lamports_unit, commitment_config, }, signers: vec![], }) } /// Creates a new process bar for processing that will take an unknown amount of time fn new_spinner_progress_bar() -> ProgressBar { let progress_bar = ProgressBar::new(42); progress_bar .set_style(ProgressStyle::default_spinner().template("{spinner:.green} {wide_msg}")); progress_bar.enable_steady_tick(100); progress_bar } pub fn process_catchup( rpc_client: &RpcClient, node_pubkey: &Pubkey, node_json_rpc_url: &Option, ) -> ProcessResult { let sleep_interval = 5; let progress_bar = new_spinner_progress_bar(); progress_bar.set_message("Connecting..."); let node_client = if let Some(node_json_rpc_url) = node_json_rpc_url { RpcClient::new(node_json_rpc_url.to_string()) } else { let rpc_addr = loop { let cluster_nodes = rpc_client.get_cluster_nodes()?; if let Some(contact_info) = cluster_nodes .iter() .find(|contact_info| contact_info.pubkey == node_pubkey.to_string()) { if let Some(rpc_addr) = contact_info.rpc { break rpc_addr; } progress_bar.set_message(&format!("RPC service not found for {}", node_pubkey)); } else { progress_bar.set_message(&format!( "Contact information not found for {}", node_pubkey )); } sleep(Duration::from_secs(sleep_interval as u64)); }; RpcClient::new_socket(rpc_addr) }; let reported_node_pubkey = node_client.get_identity()?; if reported_node_pubkey != *node_pubkey { return Err(format!( "The identity reported by node RPC URL does not match. Expected: {:?}. Reported: {:?}", node_pubkey, reported_node_pubkey ) .into()); } if rpc_client.get_identity()? == *node_pubkey { return Err("Both RPC URLs reference the same node, unable to monitor for catchup. Try a different --url".into()); } let mut previous_rpc_slot = std::u64::MAX; let mut previous_slot_distance = 0; loop { let rpc_slot = rpc_client.get_slot_with_commitment(CommitmentConfig::recent())?; let node_slot = node_client.get_slot_with_commitment(CommitmentConfig::recent())?; if node_slot > std::cmp::min(previous_rpc_slot, rpc_slot) { progress_bar.finish_and_clear(); return Ok(format!( "{} has caught up (us:{} them:{})", node_pubkey, node_slot, rpc_slot, )); } let slot_distance = rpc_slot as i64 - node_slot as i64; progress_bar.set_message(&format!( "Validator is {} slots away (us:{} them:{}){}", slot_distance, node_slot, rpc_slot, if previous_rpc_slot == std::u64::MAX { "".to_string() } else { let slots_per_second = (previous_slot_distance - slot_distance) as f64 / f64::from(sleep_interval); format!( " and {} at {:.1} slots/second", if slots_per_second < 0.0 { "falling behind" } else { "gaining" }, slots_per_second, ) } )); sleep(Duration::from_secs(sleep_interval as u64)); previous_rpc_slot = rpc_slot; previous_slot_distance = slot_distance; } } pub fn process_cluster_version(rpc_client: &RpcClient) -> ProcessResult { let remote_version = rpc_client.get_version()?; Ok(remote_version.solana_core) } pub fn process_fees(rpc_client: &RpcClient) -> ProcessResult { let (recent_blockhash, fee_calculator) = rpc_client.get_recent_blockhash()?; Ok(format!( "blockhash: {}\nlamports per signature: {}", recent_blockhash, fee_calculator.lamports_per_signature )) } pub fn process_leader_schedule(rpc_client: &RpcClient) -> ProcessResult { let epoch_info = rpc_client.get_epoch_info()?; let first_slot_in_epoch = epoch_info.absolute_slot - epoch_info.slot_index; let leader_schedule = rpc_client.get_leader_schedule(Some(first_slot_in_epoch))?; if leader_schedule.is_none() { return Err(format!( "Unable to fetch leader schedule for slot {}", first_slot_in_epoch ) .into()); } let leader_schedule = leader_schedule.unwrap(); let mut leader_per_slot_index = Vec::new(); for (pubkey, leader_slots) in leader_schedule.iter() { for slot_index in leader_slots.iter() { if *slot_index >= leader_per_slot_index.len() { leader_per_slot_index.resize(*slot_index + 1, "?"); } leader_per_slot_index[*slot_index] = pubkey; } } for (slot_index, leader) in leader_per_slot_index.iter().enumerate() { println!( " {:<15} {:<44}", first_slot_in_epoch + slot_index as u64, leader ); } Ok("".to_string()) } pub fn process_get_block_time(rpc_client: &RpcClient, slot: Slot) -> ProcessResult { let timestamp = rpc_client.get_block_time(slot)?; let result = format!( "{} (UnixTimestamp: {})", DateTime::::from_utc(NaiveDateTime::from_timestamp(timestamp, 0), Utc) .to_rfc3339_opts(SecondsFormat::Secs, true), timestamp ); Ok(result) } fn slot_to_human_time(slot: Slot) -> String { humantime::format_duration(Duration::from_secs( slot * clock::DEFAULT_TICKS_PER_SLOT / clock::DEFAULT_TICKS_PER_SECOND, )) .to_string() } pub fn process_get_epoch_info( rpc_client: &RpcClient, commitment_config: CommitmentConfig, ) -> ProcessResult { let epoch_info = rpc_client.get_epoch_info_with_commitment(commitment_config.clone())?; println!(); println_name_value("Slot:", &epoch_info.absolute_slot.to_string()); println_name_value("Epoch:", &epoch_info.epoch.to_string()); let start_slot = epoch_info.absolute_slot - epoch_info.slot_index; let end_slot = start_slot + epoch_info.slots_in_epoch; println_name_value( "Epoch Slot Range:", &format!("[{}..{})", start_slot, end_slot), ); println_name_value( "Epoch Completed Percent:", &format!( "{:>3.3}%", epoch_info.slot_index as f64 / epoch_info.slots_in_epoch as f64 * 100_f64 ), ); let remaining_slots_in_epoch = epoch_info.slots_in_epoch - epoch_info.slot_index; println_name_value( "Epoch Completed Slots:", &format!( "{}/{} ({} remaining)", epoch_info.slot_index, epoch_info.slots_in_epoch, remaining_slots_in_epoch ), ); println_name_value( "Epoch Completed Time:", &format!( "{}/{} ({} remaining)", slot_to_human_time(epoch_info.slot_index), slot_to_human_time(epoch_info.slots_in_epoch), slot_to_human_time(remaining_slots_in_epoch) ), ); Ok("".to_string()) } pub fn process_get_genesis_hash(rpc_client: &RpcClient) -> ProcessResult { let genesis_hash = rpc_client.get_genesis_hash()?; Ok(genesis_hash.to_string()) } pub fn process_get_slot( rpc_client: &RpcClient, commitment_config: CommitmentConfig, ) -> ProcessResult { let slot = rpc_client.get_slot_with_commitment(commitment_config.clone())?; Ok(slot.to_string()) } pub fn process_get_epoch( rpc_client: &RpcClient, commitment_config: CommitmentConfig, ) -> ProcessResult { let epoch_info = rpc_client.get_epoch_info_with_commitment(commitment_config.clone())?; Ok(epoch_info.epoch.to_string()) } pub fn parse_show_block_production(matches: &ArgMatches<'_>) -> Result { let epoch = value_t!(matches, "epoch", Epoch).ok(); let slot_limit = value_t!(matches, "slot_limit", u64).ok(); Ok(CliCommandInfo { command: CliCommand::ShowBlockProduction { epoch, slot_limit }, signers: vec![], }) } pub fn process_show_block_production( rpc_client: &RpcClient, config: &CliConfig, epoch: Option, slot_limit: Option, ) -> ProcessResult { let epoch_schedule = rpc_client.get_epoch_schedule()?; let epoch_info = rpc_client.get_epoch_info_with_commitment(CommitmentConfig::max())?; let epoch = epoch.unwrap_or(epoch_info.epoch); if epoch > epoch_info.epoch { return Err(format!("Epoch {} is in the future", epoch).into()); } let minimum_ledger_slot = rpc_client.minimum_ledger_slot()?; let first_slot_in_epoch = epoch_schedule.get_first_slot_in_epoch(epoch); let end_slot = std::cmp::min( epoch_info.absolute_slot, epoch_schedule.get_last_slot_in_epoch(epoch), ); let mut start_slot = if let Some(slot_limit) = slot_limit { std::cmp::max(end_slot.saturating_sub(slot_limit), first_slot_in_epoch) } else { first_slot_in_epoch }; if minimum_ledger_slot > end_slot { return Err(format!( "Ledger data not available for slots {} to {} (minimum ledger slot is {})", start_slot, end_slot, minimum_ledger_slot ) .into()); } if minimum_ledger_slot > start_slot { println!( "\n{}", style(format!( "Note: Requested start slot was {} but minimum ledger slot is {}", start_slot, minimum_ledger_slot )) .italic(), ); start_slot = minimum_ledger_slot; } let progress_bar = new_spinner_progress_bar(); progress_bar.set_message(&format!( "Fetching confirmed blocks between slots {} and {}...", start_slot, end_slot )); let confirmed_blocks = rpc_client.get_confirmed_blocks(start_slot, Some(end_slot))?; let start_slot_index = (start_slot - first_slot_in_epoch) as usize; let end_slot_index = (end_slot - first_slot_in_epoch) as usize; let total_slots = end_slot_index - start_slot_index + 1; let total_blocks = confirmed_blocks.len(); assert!(total_blocks <= total_slots); let total_slots_skipped = total_slots - total_blocks; let mut leader_slot_count = HashMap::new(); let mut leader_skipped_slots = HashMap::new(); progress_bar.set_message(&format!("Fetching leader schedule for epoch {}...", epoch)); let leader_schedule = rpc_client .get_leader_schedule_with_commitment(Some(start_slot), CommitmentConfig::max())?; if leader_schedule.is_none() { return Err(format!("Unable to fetch leader schedule for slot {}", start_slot).into()); } let leader_schedule = leader_schedule.unwrap(); let mut leader_per_slot_index = Vec::new(); leader_per_slot_index.resize(total_slots, "?"); for (pubkey, leader_slots) in leader_schedule.iter() { for slot_index in leader_slots.iter() { if *slot_index >= start_slot_index && *slot_index <= end_slot_index { leader_per_slot_index[*slot_index - start_slot_index] = pubkey; } } } progress_bar.set_message(&format!( "Processing {} slots containing {} blocks and {} empty slots...", total_slots, total_blocks, total_slots_skipped )); let mut confirmed_blocks_index = 0; let mut individual_slot_status = vec![]; for (slot_index, leader) in leader_per_slot_index.iter().enumerate() { let slot = start_slot + slot_index as u64; let slot_count = leader_slot_count.entry(leader).or_insert(0); *slot_count += 1; let skipped_slots = leader_skipped_slots.entry(leader).or_insert(0); loop { if confirmed_blocks_index < confirmed_blocks.len() { let slot_of_next_confirmed_block = confirmed_blocks[confirmed_blocks_index]; if slot_of_next_confirmed_block < slot { confirmed_blocks_index += 1; continue; } if slot_of_next_confirmed_block == slot { individual_slot_status .push(style(format!(" {:<15} {:<44}", slot, leader)).to_string()); break; } } *skipped_slots += 1; individual_slot_status.push( style(format!(" {:<15} {:<44} SKIPPED", slot, leader)) .red() .to_string(), ); break; } } progress_bar.finish_and_clear(); println!( "\n{}", style(format!( " {:<44} {:>15} {:>15} {:>15} {:>23}", "Identity Pubkey", "Leader Slots", "Blocks Produced", "Skipped Slots", "Skipped Slot Percentage", )) .bold() ); let mut table = vec![]; for (leader, leader_slots) in leader_slot_count.iter() { let skipped_slots = leader_skipped_slots.get(leader).unwrap(); let blocks_produced = leader_slots - skipped_slots; table.push(format!( " {:<44} {:>15} {:>15} {:>15} {:>22.2}%", leader, leader_slots, blocks_produced, skipped_slots, *skipped_slots as f64 / *leader_slots as f64 * 100. )); } table.sort(); println!( "{}\n\n {:<44} {:>15} {:>15} {:>15} {:>22.2}%", table.join("\n"), format!("Epoch {} total:", epoch), total_slots, total_blocks, total_slots_skipped, total_slots_skipped as f64 / total_slots as f64 * 100. ); println!( " (using data from {} slots: {} to {})", total_slots, start_slot, end_slot ); if config.verbose { println!( "\n\n{}\n{}", style(format!(" {:<15} {:<44}", "Slot", "Identity Pubkey")).bold(), individual_slot_status.join("\n") ); } Ok("".to_string()) } pub fn process_total_supply( rpc_client: &RpcClient, commitment_config: CommitmentConfig, ) -> ProcessResult { let total_supply = rpc_client.total_supply_with_commitment(commitment_config.clone())?; Ok(format!("{} SOL", lamports_to_sol(total_supply))) } pub fn process_get_transaction_count( rpc_client: &RpcClient, commitment_config: CommitmentConfig, ) -> ProcessResult { let transaction_count = rpc_client.get_transaction_count_with_commitment(commitment_config.clone())?; Ok(transaction_count.to_string()) } pub fn process_ping( rpc_client: &RpcClient, config: &CliConfig, lamports: u64, interval: &Duration, count: &Option, timeout: &Duration, commitment_config: CommitmentConfig, ) -> ProcessResult { let to = Keypair::new().pubkey(); println_name_value("Source Account:", &config.signers[0].pubkey().to_string()); println_name_value("Destination Account:", &to.to_string()); println!(); let (signal_sender, signal_receiver) = std::sync::mpsc::channel(); ctrlc::set_handler(move || { let _ = signal_sender.send(()); }) .expect("Error setting Ctrl-C handler"); let mut last_blockhash = Hash::default(); let mut submit_count = 0; let mut confirmed_count = 0; let mut confirmation_time: VecDeque = VecDeque::with_capacity(1024); 'mainloop: for seq in 0..count.unwrap_or(std::u64::MAX) { let (recent_blockhash, fee_calculator) = rpc_client.get_new_blockhash(&last_blockhash)?; last_blockhash = recent_blockhash; let ix = system_instruction::transfer(&config.signers[0].pubkey(), &to, lamports); let message = Message::new(&[ix]); let mut transaction = Transaction::new_unsigned(message); transaction.try_sign(&config.signers, recent_blockhash)?; check_account_for_fee( rpc_client, &config.signers[0].pubkey(), &fee_calculator, &transaction.message, )?; match rpc_client.send_transaction(&transaction) { Ok(signature) => { let transaction_sent = Instant::now(); loop { let signature_status = rpc_client.get_signature_status_with_commitment( &signature, commitment_config.clone(), )?; let elapsed_time = Instant::now().duration_since(transaction_sent); if let Some(transaction_status) = signature_status { match transaction_status { Ok(()) => { let elapsed_time_millis = elapsed_time.as_millis() as u64; confirmation_time.push_back(elapsed_time_millis); println!( "{}{} lamport(s) transferred: seq={:<3} time={:>4}ms signature={}", CHECK_MARK, lamports, seq, elapsed_time_millis, signature ); confirmed_count += 1; } Err(err) => { println!( "{}Transaction failed: seq={:<3} error={:?} signature={}", CROSS_MARK, seq, err, signature ); } } break; } if elapsed_time >= *timeout { println!( "{}Confirmation timeout: seq={:<3} signature={}", CROSS_MARK, seq, signature ); break; } // Sleep for half a slot if signal_receiver .recv_timeout(Duration::from_millis( 500 * clock::DEFAULT_TICKS_PER_SLOT / clock::DEFAULT_TICKS_PER_SECOND, )) .is_ok() { break 'mainloop; } } } Err(err) => { println!( "{}Submit failed: seq={:<3} error={:?}", CROSS_MARK, seq, err ); } } submit_count += 1; if signal_receiver.recv_timeout(*interval).is_ok() { break 'mainloop; } } println!(); println!("--- transaction statistics ---"); println!( "{} transactions submitted, {} transactions confirmed, {:.1}% transaction loss", submit_count, confirmed_count, (100. - f64::from(confirmed_count) / f64::from(submit_count) * 100.) ); if !confirmation_time.is_empty() { let samples: Vec = confirmation_time.iter().map(|t| *t as f64).collect(); let dist = criterion_stats::Distribution::from(samples.into_boxed_slice()); let mean = dist.mean(); println!( "confirmation min/mean/max/stddev = {:.0}/{:.0}/{:.0}/{:.0} ms", dist.min(), mean, dist.max(), dist.std_dev(Some(mean)) ); } Ok("".to_string()) } pub fn process_live_slots(url: &str) -> ProcessResult { let exit = Arc::new(AtomicBool::new(false)); // Disable Ctrl+C handler as sometimes the PubsubClient shutdown can stall. Also it doesn't // really matter that the shutdown is clean because the process is terminating. /* let exit_clone = exit.clone(); ctrlc::set_handler(move || { exit_clone.store(true, Ordering::Relaxed); })?; */ let mut current: Option = None; let mut message = "".to_string(); let slot_progress = new_spinner_progress_bar(); slot_progress.set_message("Connecting..."); let (mut client, receiver) = PubsubClient::slot_subscribe(url)?; slot_progress.set_message("Connected."); let spacer = "|"; slot_progress.println(spacer); let mut last_root = std::u64::MAX; let mut last_root_update = Instant::now(); let mut slots_per_second = std::f64::NAN; loop { if exit.load(Ordering::Relaxed) { eprintln!("{}", message); client.shutdown().unwrap(); break; } match receiver.recv() { Ok(new_info) => { if last_root == std::u64::MAX { last_root = new_info.root; last_root_update = Instant::now(); } if last_root_update.elapsed().as_secs() >= 5 { let root = new_info.root; slots_per_second = (root - last_root) as f64 / last_root_update.elapsed().as_secs() as f64; last_root_update = Instant::now(); last_root = root; } message = if slots_per_second.is_nan() { format!("{:?}", new_info) } else { format!( "{:?} | root slot advancing at {:.2} slots/second", new_info, slots_per_second ) } .to_owned(); slot_progress.set_message(&message); if let Some(previous) = current { let slot_delta: i64 = new_info.slot as i64 - previous.slot as i64; let root_delta: i64 = new_info.root as i64 - previous.root as i64; // // if slot has advanced out of step with the root, we detect // a mismatch and output the slot information // if slot_delta != root_delta { let prev_root = format!( "|<--- {} <- … <- {} <- {} (prev)", previous.root, previous.parent, previous.slot ); slot_progress.println(&prev_root); let new_root = format!( "| '- {} <- … <- {} <- {} (next)", new_info.root, new_info.parent, new_info.slot ); slot_progress.println(prev_root); slot_progress.println(new_root); slot_progress.println(spacer); } } current = Some(new_info); } Err(err) => { eprintln!("disconnected: {}", err); break; } } } Ok("".to_string()) } pub fn process_show_gossip(rpc_client: &RpcClient) -> ProcessResult { let cluster_nodes = rpc_client.get_cluster_nodes()?; fn format_port(addr: Option) -> String { addr.map(|addr| addr.port().to_string()) .unwrap_or_else(|| "none".to_string()) } let s: Vec<_> = cluster_nodes .iter() .map(|node| { format!( "{:15} | {:44} | {:6} | {:5} | {:5}", node.gossip .map(|addr| addr.ip().to_string()) .unwrap_or_else(|| "none".to_string()), node.pubkey, format_port(node.gossip), format_port(node.tpu), format_port(node.rpc), ) }) .collect(); Ok(format!( "IP Address | Node identifier \ | Gossip | TPU | RPC\n\ ----------------+----------------------------------------------+\ --------+-------+-------\n\ {}\n\ Nodes: {}", s.join("\n"), s.len(), )) } pub fn process_show_stakes( rpc_client: &RpcClient, use_lamports_unit: bool, vote_account_pubkeys: Option<&[Pubkey]>, ) -> ProcessResult { use crate::stake::print_stake_state; use solana_stake_program::stake_state::StakeState; let progress_bar = new_spinner_progress_bar(); progress_bar.set_message("Fetching stake accounts..."); let all_stake_accounts = rpc_client.get_program_accounts(&solana_stake_program::id())?; progress_bar.finish_and_clear(); for (stake_pubkey, stake_account) in all_stake_accounts { if let Ok(stake_state) = stake_account.state() { match stake_state { StakeState::Initialized(_) => { if vote_account_pubkeys.is_none() { println!("\nstake pubkey: {}", stake_pubkey); print_stake_state(stake_account.lamports, &stake_state, use_lamports_unit); } } StakeState::Stake(_, stake) => { if vote_account_pubkeys.is_none() || vote_account_pubkeys .unwrap() .contains(&stake.delegation.voter_pubkey) { println!("\nstake pubkey: {}", stake_pubkey); print_stake_state(stake_account.lamports, &stake_state, use_lamports_unit); } } _ => {} } } } Ok("".to_string()) } pub fn process_show_validators( rpc_client: &RpcClient, use_lamports_unit: bool, commitment_config: CommitmentConfig, ) -> ProcessResult { let epoch_info = rpc_client.get_epoch_info_with_commitment(commitment_config)?; let vote_accounts = rpc_client.get_vote_accounts_with_commitment(commitment_config)?; let total_active_stake = vote_accounts .current .iter() .chain(vote_accounts.delinquent.iter()) .fold(0, |acc, vote_account| acc + vote_account.activated_stake) as f64; let total_deliquent_stake = vote_accounts .delinquent .iter() .fold(0, |acc, vote_account| acc + vote_account.activated_stake) as f64; let total_current_stake = total_active_stake - total_deliquent_stake; println_name_value( "Active Stake:", &build_balance_message(total_active_stake as u64, use_lamports_unit, true), ); if total_deliquent_stake > 0. { println_name_value( "Current Stake:", &format!( "{} ({:0.2}%)", &build_balance_message(total_current_stake as u64, use_lamports_unit, true), 100. * total_current_stake / total_active_stake ), ); println_name_value( "Delinquent Stake:", &format!( "{} ({:0.2}%)", &build_balance_message(total_deliquent_stake as u64, use_lamports_unit, true), 100. * total_deliquent_stake / total_active_stake ), ); } println!(); println!( "{}", style(format!( " {:<44} {:<44} {} {} {} {:>7} {}", "Identity Pubkey", "Vote Account Pubkey", "Commission", "Last Vote", "Root Block", "Credits", "Active Stake", )) .bold() ); fn print_vote_account( vote_account: RpcVoteAccountInfo, current_epoch: Epoch, total_active_stake: f64, use_lamports_unit: bool, delinquent: bool, ) { fn non_zero_or_dash(v: u64) -> String { if v == 0 { "-".into() } else { format!("{}", v) } } println!( "{} {:<44} {:<44} {:>9}% {:>8} {:>10} {:>7} {}", if delinquent { WARNING.to_string() } else { " ".to_string() }, vote_account.node_pubkey, vote_account.vote_pubkey, vote_account.commission, non_zero_or_dash(vote_account.last_vote), non_zero_or_dash(vote_account.root_slot), vote_account .epoch_credits .iter() .find_map(|(epoch, credits, _)| if *epoch == current_epoch { Some(*credits) } else { None }) .unwrap_or(0), if vote_account.activated_stake > 0 { format!( "{} ({:.2}%)", build_balance_message(vote_account.activated_stake, use_lamports_unit, true), 100. * vote_account.activated_stake as f64 / total_active_stake ) } else { "-".into() }, ); } for vote_account in vote_accounts.current.into_iter() { print_vote_account( vote_account, epoch_info.epoch, total_active_stake, use_lamports_unit, false, ); } for vote_account in vote_accounts.delinquent.into_iter() { print_vote_account( vote_account, epoch_info.epoch, total_active_stake, use_lamports_unit, true, ); } Ok("".to_string()) } #[cfg(test)] mod tests { use super::*; use crate::cli::{app, parse_command}; use solana_sdk::signature::{write_keypair, Keypair}; use tempfile::NamedTempFile; fn make_tmp_file() -> (String, NamedTempFile) { let tmp_file = NamedTempFile::new().unwrap(); (String::from(tmp_file.path().to_str().unwrap()), tmp_file) } #[test] fn test_parse_command() { let test_commands = app("test", "desc", "version"); let default_keypair = Keypair::new(); let (default_keypair_file, mut tmp_file) = make_tmp_file(); write_keypair(&default_keypair, tmp_file.as_file_mut()).unwrap(); let test_cluster_version = test_commands .clone() .get_matches_from(vec!["test", "cluster-version"]); assert_eq!( parse_command(&test_cluster_version, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::ClusterVersion, signers: vec![], } ); let test_fees = test_commands.clone().get_matches_from(vec!["test", "fees"]); assert_eq!( parse_command(&test_fees, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::Fees, signers: vec![], } ); let slot = 100; let test_get_block_time = test_commands .clone() .get_matches_from(vec!["test", "block-time", &slot.to_string()]); assert_eq!( parse_command(&test_get_block_time, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetBlockTime { slot }, signers: vec![], } ); let test_get_epoch_info = test_commands .clone() .get_matches_from(vec!["test", "epoch-info"]); assert_eq!( parse_command(&test_get_epoch_info, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetEpochInfo { commitment_config: CommitmentConfig::recent(), }, signers: vec![], } ); let test_get_genesis_hash = test_commands .clone() .get_matches_from(vec!["test", "genesis-hash"]); assert_eq!( parse_command(&test_get_genesis_hash, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetGenesisHash, signers: vec![], } ); let test_get_slot = test_commands.clone().get_matches_from(vec!["test", "slot"]); assert_eq!( parse_command(&test_get_slot, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetSlot { commitment_config: CommitmentConfig::recent(), }, signers: vec![], } ); let test_get_epoch = test_commands .clone() .get_matches_from(vec!["test", "epoch"]); assert_eq!( parse_command(&test_get_epoch, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetEpoch { commitment_config: CommitmentConfig::recent(), }, signers: vec![], } ); let test_total_supply = test_commands .clone() .get_matches_from(vec!["test", "total-supply"]); assert_eq!( parse_command(&test_total_supply, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::TotalSupply { commitment_config: CommitmentConfig::recent(), }, signers: vec![], } ); let test_transaction_count = test_commands .clone() .get_matches_from(vec!["test", "transaction-count"]); assert_eq!( parse_command(&test_transaction_count, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::GetTransactionCount { commitment_config: CommitmentConfig::recent(), }, signers: vec![], } ); let test_ping = test_commands.clone().get_matches_from(vec![ "test", "ping", "-i", "1", "-c", "2", "-t", "3", "--confirmed", ]); assert_eq!( parse_command(&test_ping, &default_keypair_file, None).unwrap(), CliCommandInfo { command: CliCommand::Ping { lamports: 1, interval: Duration::from_secs(1), count: Some(2), timeout: Duration::from_secs(3), commitment_config: CommitmentConfig::default(), }, signers: vec![default_keypair.into()], } ); } }