pub use crate::beacon_chain::{ BEACON_CHAIN_DB_KEY, ETH1_CACHE_DB_KEY, FORK_CHOICE_DB_KEY, OP_POOL_DB_KEY, }; pub use crate::persisted_beacon_chain::PersistedBeaconChain; use crate::{ builder::{BeaconChainBuilder, Witness}, eth1_chain::CachingEth1Backend, events::NullEventHandler, AttestationProcessingOutcome, BeaconChain, BeaconChainTypes, BlockProcessingOutcome, StateSkipConfig, }; use genesis::interop_genesis_state; use rayon::prelude::*; use sloggers::{null::NullLoggerBuilder, Build}; use slot_clock::TestingSlotClock; use state_processing::per_slot_processing; use std::borrow::Cow; use std::sync::Arc; use std::time::Duration; use store::{ migrate::{BlockingMigrator, NullMigrator}, DiskStore, MemoryStore, Migrate, Store, }; use tempfile::{tempdir, TempDir}; use types::{ AggregateSignature, Attestation, BeaconState, ChainSpec, Domain, EthSpec, Hash256, Keypair, SecretKey, Signature, SignedBeaconBlock, SignedRoot, Slot, }; pub use types::test_utils::generate_deterministic_keypairs; // 4th September 2019 pub const HARNESS_GENESIS_TIME: u64 = 1_567_552_690; // This parameter is required by a builder but not used because we use the `TestingSlotClock`. pub const HARNESS_SLOT_TIME: Duration = Duration::from_secs(1); pub type BaseHarnessType = Witness< TStore, TStoreMigrator, TestingSlotClock, CachingEth1Backend, TEthSpec, NullEventHandler, >; pub type HarnessType = BaseHarnessType, NullMigrator, E>; pub type DiskHarnessType = BaseHarnessType, BlockingMigrator>, E>; /// Indicates how the `BeaconChainHarness` should produce blocks. #[derive(Clone, Copy, Debug)] pub enum BlockStrategy { /// Produce blocks upon the canonical head (normal case). OnCanonicalHead, /// Ignore the canonical head and produce blocks upon the block at the given slot. /// /// Useful for simulating forks. ForkCanonicalChainAt { /// The slot of the parent of the first block produced. previous_slot: Slot, /// The slot of the first block produced (must be higher than `previous_slot`. first_slot: Slot, }, } /// Indicates how the `BeaconChainHarness` should produce attestations. #[derive(Clone, Debug)] pub enum AttestationStrategy { /// All validators attest to whichever block the `BeaconChainHarness` has produced. AllValidators, /// Only the given validators should attest. All others should fail to produce attestations. SomeValidators(Vec), } /// A testing harness which can instantiate a `BeaconChain` and populate it with blocks and /// attestations. /// /// Used for testing. pub struct BeaconChainHarness { pub chain: BeaconChain, pub keypairs: Vec, pub spec: ChainSpec, pub data_dir: TempDir, } impl BeaconChainHarness> { /// Instantiate a new harness with `validator_count` initial validators. pub fn new(eth_spec_instance: E, keypairs: Vec) -> Self { let data_dir = tempdir().expect("should create temporary data_dir"); let spec = E::default_spec(); let log = NullLoggerBuilder.build().expect("logger should build"); let chain = BeaconChainBuilder::new(eth_spec_instance) .logger(log.clone()) .custom_spec(spec.clone()) .store(Arc::new(MemoryStore::open())) .store_migrator(NullMigrator) .data_dir(data_dir.path().to_path_buf()) .genesis_state( interop_genesis_state::(&keypairs, HARNESS_GENESIS_TIME, &spec) .expect("should generate interop state"), ) .expect("should build state using recent genesis") .dummy_eth1_backend() .expect("should build dummy backend") .null_event_handler() .testing_slot_clock(HARNESS_SLOT_TIME) .expect("should configure testing slot clock") .reduced_tree_fork_choice() .expect("should add fork choice to builder") .build() .expect("should build"); Self { spec: chain.spec.clone(), chain, keypairs, data_dir, } } } impl BeaconChainHarness> { /// Instantiate a new harness with `validator_count` initial validators. pub fn new_with_disk_store( eth_spec_instance: E, store: Arc>, keypairs: Vec, ) -> Self { let data_dir = tempdir().expect("should create temporary data_dir"); let spec = E::default_spec(); let log = NullLoggerBuilder.build().expect("logger should build"); let chain = BeaconChainBuilder::new(eth_spec_instance) .logger(log.clone()) .custom_spec(spec.clone()) .store(store.clone()) .store_migrator( as Migrate<_, E>>::new(store)) .data_dir(data_dir.path().to_path_buf()) .genesis_state( interop_genesis_state::(&keypairs, HARNESS_GENESIS_TIME, &spec) .expect("should generate interop state"), ) .expect("should build state using recent genesis") .dummy_eth1_backend() .expect("should build dummy backend") .null_event_handler() .testing_slot_clock(HARNESS_SLOT_TIME) .expect("should configure testing slot clock") .reduced_tree_fork_choice() .expect("should add fork choice to builder") .build() .expect("should build"); Self { spec: chain.spec.clone(), chain, keypairs, data_dir, } } /// Instantiate a new harness with `validator_count` initial validators. pub fn resume_from_disk_store( eth_spec_instance: E, store: Arc>, keypairs: Vec, data_dir: TempDir, ) -> Self { let spec = E::default_spec(); let log = NullLoggerBuilder.build().expect("logger should build"); let chain = BeaconChainBuilder::new(eth_spec_instance) .logger(log.clone()) .custom_spec(spec) .store(store.clone()) .store_migrator( as Migrate<_, E>>::new(store)) .data_dir(data_dir.path().to_path_buf()) .resume_from_db() .expect("should resume beacon chain from db") .dummy_eth1_backend() .expect("should build dummy backend") .null_event_handler() .testing_slot_clock(Duration::from_secs(1)) .expect("should configure testing slot clock") .reduced_tree_fork_choice() .expect("should add fork choice to builder") .build() .expect("should build"); Self { spec: chain.spec.clone(), chain, keypairs, data_dir, } } } impl BeaconChainHarness> where S: Store, M: Migrate, E: EthSpec, { /// Advance the slot of the `BeaconChain`. /// /// Does not produce blocks or attestations. pub fn advance_slot(&self) { self.chain.slot_clock.advance_slot(); } /// Extend the `BeaconChain` with some blocks and attestations. Returns the root of the /// last-produced block (the head of the chain). /// /// Chain will be extended by `num_blocks` blocks. /// /// The `block_strategy` dictates where the new blocks will be placed. /// /// The `attestation_strategy` dictates which validators will attest to the newly created /// blocks. pub fn extend_chain( &self, num_blocks: usize, block_strategy: BlockStrategy, attestation_strategy: AttestationStrategy, ) -> Hash256 { let mut state = { // Determine the slot for the first block (or skipped block). let state_slot = match block_strategy { BlockStrategy::OnCanonicalHead => { self.chain.slot().expect("should have a slot") - 1 } BlockStrategy::ForkCanonicalChainAt { previous_slot, .. } => previous_slot, }; self.chain .state_at_slot(state_slot, StateSkipConfig::WithStateRoots) .expect("should find state for slot") }; // Determine the first slot where a block should be built. let mut slot = match block_strategy { BlockStrategy::OnCanonicalHead => self.chain.slot().expect("should have a slot"), BlockStrategy::ForkCanonicalChainAt { first_slot, .. } => first_slot, }; let mut head_block_root = None; for _ in 0..num_blocks { while self.chain.slot().expect("should have a slot") < slot { self.advance_slot(); } let (block, new_state) = self.build_block(state.clone(), slot, block_strategy); let outcome = self .chain .process_block(block) .expect("should not error during block processing"); self.chain.fork_choice().expect("should find head"); if let BlockProcessingOutcome::Processed { block_root } = outcome { head_block_root = Some(block_root); self.add_free_attestations(&attestation_strategy, &new_state, block_root, slot); } else { panic!("block should be successfully processed: {:?}", outcome); } state = new_state; slot += 1; } head_block_root.expect("did not produce any blocks") } /// Returns a newly created block, signed by the proposer for the given slot. fn build_block( &self, mut state: BeaconState, slot: Slot, block_strategy: BlockStrategy, ) -> (SignedBeaconBlock, BeaconState) { if slot < state.slot { panic!("produce slot cannot be prior to the state slot"); } while state.slot < slot { per_slot_processing(&mut state, None, &self.spec) .expect("should be able to advance state to slot"); } state .build_all_caches(&self.spec) .expect("should build caches"); let proposer_index = match block_strategy { BlockStrategy::OnCanonicalHead => self .chain .block_proposer(slot) .expect("should get block proposer from chain"), _ => state .get_beacon_proposer_index(slot, &self.spec) .expect("should get block proposer from state"), }; let sk = &self.keypairs[proposer_index].sk; let fork = &state.fork.clone(); let randao_reveal = { let epoch = slot.epoch(E::slots_per_epoch()); let domain = self.spec .get_domain(epoch, Domain::Randao, fork, state.genesis_validators_root); let message = epoch.signing_root(domain); Signature::new(message.as_bytes(), sk) }; let (block, state) = self .chain .produce_block_on_state(state, slot, randao_reveal) .expect("should produce block"); let signed_block = block.sign(sk, &state.fork, state.genesis_validators_root, &self.spec); (signed_block, state) } /// Adds attestations to the `BeaconChain` operations pool and fork choice. /// /// The `attestation_strategy` dictates which validators should attest. fn add_free_attestations( &self, attestation_strategy: &AttestationStrategy, state: &BeaconState, head_block_root: Hash256, head_block_slot: Slot, ) { self.get_free_attestations( attestation_strategy, state, head_block_root, head_block_slot, ) .into_iter() .for_each(|attestation| { match self .chain .process_attestation(attestation) .expect("should not error during attestation processing") { // PastEpoch can occur if we fork over several epochs AttestationProcessingOutcome::Processed | AttestationProcessingOutcome::PastEpoch { .. } => (), other => panic!("did not successfully process attestation: {:?}", other), } }); } /// Generates a `Vec` for some attestation strategy and head_block. pub fn get_free_attestations( &self, attestation_strategy: &AttestationStrategy, state: &BeaconState, head_block_root: Hash256, head_block_slot: Slot, ) -> Vec> { let spec = &self.spec; let fork = &state.fork; let attesting_validators: Vec = match attestation_strategy { AttestationStrategy::AllValidators => (0..self.keypairs.len()).collect(), AttestationStrategy::SomeValidators(vec) => vec.clone(), }; let mut attestations = vec![]; state .get_beacon_committees_at_slot(state.slot) .expect("should get committees") .iter() .for_each(|bc| { let mut local_attestations: Vec> = bc .committee .par_iter() .enumerate() .filter_map(|(i, validator_index)| { // Note: searching this array is worst-case `O(n)`. A hashset could be a better // alternative. if attesting_validators.contains(validator_index) { let mut attestation = self .chain .produce_attestation_for_block( head_block_slot, bc.index, head_block_root, Cow::Borrowed(state), ) .expect("should produce attestation"); attestation .aggregation_bits .set(i, true) .expect("should be able to set aggregation bits"); attestation.signature = { let domain = spec.get_domain( attestation.data.target.epoch, Domain::BeaconAttester, fork, state.genesis_validators_root, ); let message = attestation.data.signing_root(domain); let mut agg_sig = AggregateSignature::new(); agg_sig.add(&Signature::new( message.as_bytes(), self.get_sk(*validator_index), )); agg_sig }; Some(attestation) } else { None } }) .collect(); attestations.append(&mut local_attestations); }); attestations } /// Creates two forks: /// /// - The "honest" fork: created by the `honest_validators` who have built `honest_fork_blocks` /// on the head /// - The "faulty" fork: created by the `faulty_validators` who skipped a slot and /// then built `faulty_fork_blocks`. /// /// Returns `(honest_head, faulty_head)`, the roots of the blocks at the top of each chain. pub fn generate_two_forks_by_skipping_a_block( &self, honest_validators: &[usize], faulty_validators: &[usize], honest_fork_blocks: usize, faulty_fork_blocks: usize, ) -> (Hash256, Hash256) { let initial_head_slot = self .chain .head() .expect("should get head") .beacon_block .slot(); // Move to the next slot so we may produce some more blocks on the head. self.advance_slot(); // Extend the chain with blocks where only honest validators agree. let honest_head = self.extend_chain( honest_fork_blocks, BlockStrategy::OnCanonicalHead, AttestationStrategy::SomeValidators(honest_validators.to_vec()), ); // Go back to the last block where all agreed, and build blocks upon it where only faulty nodes // agree. let faulty_head = self.extend_chain( faulty_fork_blocks, BlockStrategy::ForkCanonicalChainAt { previous_slot: initial_head_slot, // `initial_head_slot + 2` means one slot is skipped. first_slot: initial_head_slot + 2, }, AttestationStrategy::SomeValidators(faulty_validators.to_vec()), ); assert!(honest_head != faulty_head, "forks should be distinct"); (honest_head, faulty_head) } /// Returns the secret key for the given validator index. fn get_sk(&self, validator_index: usize) -> &SecretKey { &self.keypairs[validator_index].sk } }