use crate::blocktree::{create_new_tmp_ledger, tmp_copy_blocktree}; use crate::client::mk_client; use crate::cluster_info::{Node, NodeInfo}; use crate::fullnode::{Fullnode, FullnodeConfig}; use crate::gossip_service::discover; use crate::service::Service; use crate::thin_client::retry_get_balance; use crate::thin_client::ThinClient; use solana_sdk::genesis_block::GenesisBlock; use solana_sdk::pubkey::Pubkey; use solana_sdk::signature::{Keypair, KeypairUtil}; use solana_sdk::system_transaction::SystemTransaction; use solana_vote_api::vote_state::VoteState; use solana_vote_api::vote_transaction::VoteTransaction; use std::fs::remove_dir_all; use std::io::{Error, ErrorKind, Result}; use std::sync::Arc; pub struct LocalCluster { /// Keypair with funding to particpiate in the network pub funding_keypair: Keypair, /// Entry point from which the rest of the network can be discovered pub entry_point_info: NodeInfo, fullnodes: Vec, ledger_paths: Vec, } impl LocalCluster { pub fn new(num_nodes: usize, cluster_lamports: u64, lamports_per_node: u64) -> Self { Self::new_with_config( num_nodes, cluster_lamports, lamports_per_node, &FullnodeConfig::default(), ) } pub fn new_with_config( num_nodes: usize, cluster_lamports: u64, lamports_per_node: u64, fullnode_config: &FullnodeConfig, ) -> Self { let leader_keypair = Arc::new(Keypair::new()); let leader_pubkey = leader_keypair.pubkey(); let leader_node = Node::new_localhost_with_pubkey(leader_keypair.pubkey()); let (genesis_block, mint_keypair) = GenesisBlock::new_with_leader(cluster_lamports, leader_pubkey, lamports_per_node); let (genesis_ledger_path, _blockhash) = create_new_tmp_ledger!(&genesis_block); let leader_ledger_path = tmp_copy_blocktree!(&genesis_ledger_path); let mut ledger_paths = vec![]; ledger_paths.push(genesis_ledger_path.clone()); ledger_paths.push(leader_ledger_path.clone()); let voting_keypair = Keypair::new(); let leader_node_info = leader_node.info.clone(); let leader_server = Fullnode::new( leader_node, &leader_keypair, &leader_ledger_path, voting_keypair, None, fullnode_config, ); let mut fullnodes = vec![leader_server]; let mut client = mk_client(&leader_node_info); for _ in 0..(num_nodes - 1) { let validator_keypair = Arc::new(Keypair::new()); let voting_keypair = Keypair::new(); let validator_pubkey = validator_keypair.pubkey(); let validator_node = Node::new_localhost_with_pubkey(validator_keypair.pubkey()); let ledger_path = tmp_copy_blocktree!(&genesis_ledger_path); ledger_paths.push(ledger_path.clone()); // Send each validator some tokens to vote let validator_balance = Self::transfer( &mut client, &mint_keypair, &validator_pubkey, lamports_per_node, ); info!( "validator {} balance {}", validator_pubkey, validator_balance ); Self::create_and_fund_vote_account( &mut client, &voting_keypair, &validator_keypair, 1, ) .unwrap(); let validator_server = Fullnode::new( validator_node, &validator_keypair, &ledger_path, voting_keypair, Some(&leader_node_info), fullnode_config, ); fullnodes.push(validator_server); } discover(&leader_node_info, num_nodes); Self { funding_keypair: mint_keypair, entry_point_info: leader_node_info, fullnodes, ledger_paths, } } pub fn exit(&self) { for node in &self.fullnodes { node.exit(); } } pub fn close(&mut self) { self.exit(); while let Some(node) = self.fullnodes.pop() { node.join().unwrap(); } for path in &self.ledger_paths { remove_dir_all(path).unwrap(); } } fn transfer( client: &mut ThinClient, source_keypair: &Keypair, dest_pubkey: &Pubkey, lamports: u64, ) -> u64 { trace!("getting leader blockhash"); let blockhash = client.get_recent_blockhash(); let mut tx = SystemTransaction::new_account(&source_keypair, *dest_pubkey, lamports, blockhash, 0); info!( "executing transfer of {} from {} to {}", lamports, source_keypair.pubkey(), *dest_pubkey ); client .retry_transfer(&source_keypair, &mut tx, 5) .expect("client transfer"); retry_get_balance(client, dest_pubkey, Some(lamports)).expect("get balance") } fn create_and_fund_vote_account( client: &mut ThinClient, vote_account: &Keypair, from_account: &Arc, amount: u64, ) -> Result<()> { let vote_account_pubkey = vote_account.pubkey(); let delegate_id = from_account.pubkey(); // Create the vote account if necessary if client.poll_get_balance(&vote_account_pubkey).unwrap_or(0) == 0 { // 1) Create vote account let mut transaction = VoteTransaction::new_account( from_account, vote_account_pubkey, client.get_recent_blockhash(), amount, 1, ); client .retry_transfer(&from_account, &mut transaction, 5) .expect("client transfer"); retry_get_balance(client, &vote_account_pubkey, Some(amount)).expect("get balance"); // 2) Set delegate for new vote account let mut transaction = VoteTransaction::delegate_vote_account( vote_account, client.get_recent_blockhash(), delegate_id, 1, ); client .retry_transfer(&from_account, &mut transaction, 5) .expect("client transfer"); } info!("Checking for vote account registration"); let vote_account_user_data = client.get_account_userdata(&vote_account_pubkey); if let Ok(Some(vote_account_user_data)) = vote_account_user_data { if let Ok(vote_state) = VoteState::deserialize(&vote_account_user_data) { if vote_state.delegate_id == delegate_id { return Ok(()); } } } Err(Error::new( ErrorKind::Other, "expected successful vote account registration", )) } } impl Drop for LocalCluster { fn drop(&mut self) { self.close() } } #[cfg(test)] mod test { use super::*; use crate::rpc::JsonRpcConfig; #[test] fn test_local_cluster_start_and_exit() { solana_logger::setup(); let cluster = LocalCluster::new(1, 100, 3); drop(cluster) } #[test] fn test_local_cluster_start_and_exit_with_config() { solana_logger::setup(); let mut fullnode_exit = FullnodeConfig::default(); fullnode_exit.rpc_config = JsonRpcConfig::TestOnlyAllowRpcFullnodeExit; let cluster = LocalCluster::new_with_config(1, 100, 3, &fullnode_exit); drop(cluster) } }