use { crate::leader_schedule::LeaderSchedule, solana_runtime::bank::Bank, solana_sdk::{ clock::{Epoch, Slot, NUM_CONSECUTIVE_LEADER_SLOTS}, pubkey::Pubkey, }, std::collections::HashMap, }; /// Return the leader schedule for the given epoch. pub fn leader_schedule(epoch: Epoch, bank: &Bank) -> Option { bank.epoch_staked_nodes(epoch).map(|stakes| { let mut seed = [0u8; 32]; seed[0..8].copy_from_slice(&epoch.to_le_bytes()); let mut stakes: Vec<_> = stakes .iter() .map(|(pubkey, stake)| (*pubkey, *stake)) .collect(); sort_stakes(&mut stakes); LeaderSchedule::new( &stakes, seed, bank.get_slots_in_epoch(epoch), NUM_CONSECUTIVE_LEADER_SLOTS, ) }) } /// Map of leader base58 identity pubkeys to the slot indices relative to the first epoch slot pub type LeaderScheduleByIdentity = HashMap>; pub fn leader_schedule_by_identity<'a>( upcoming_leaders: impl Iterator, ) -> LeaderScheduleByIdentity { let mut leader_schedule_by_identity = HashMap::new(); for (slot_index, identity_pubkey) in upcoming_leaders { leader_schedule_by_identity .entry(identity_pubkey) .or_insert_with(Vec::new) .push(slot_index); } leader_schedule_by_identity .into_iter() .map(|(identity_pubkey, slot_indices)| (identity_pubkey.to_string(), slot_indices)) .collect() } /// Return the leader for the given slot. pub fn slot_leader_at(slot: Slot, bank: &Bank) -> Option { let (epoch, slot_index) = bank.get_epoch_and_slot_index(slot); leader_schedule(epoch, bank).map(|leader_schedule| leader_schedule[slot_index]) } // Returns the number of ticks remaining from the specified tick_height to the end of the // slot implied by the tick_height pub fn num_ticks_left_in_slot(bank: &Bank, tick_height: u64) -> u64 { bank.ticks_per_slot() - tick_height % bank.ticks_per_slot() } pub fn first_of_consecutive_leader_slots(slot: Slot) -> Slot { (slot / NUM_CONSECUTIVE_LEADER_SLOTS) * NUM_CONSECUTIVE_LEADER_SLOTS } fn sort_stakes(stakes: &mut Vec<(Pubkey, u64)>) { // Sort first by stake. If stakes are the same, sort by pubkey to ensure a // deterministic result. // Note: Use unstable sort, because we dedup right after to remove the equal elements. stakes.sort_unstable_by(|(l_pubkey, l_stake), (r_pubkey, r_stake)| { if r_stake == l_stake { r_pubkey.cmp(l_pubkey) } else { r_stake.cmp(l_stake) } }); // Now that it's sorted, we can do an O(n) dedup. stakes.dedup(); } #[cfg(test)] mod tests { use { super::*, solana_runtime::genesis_utils::{ bootstrap_validator_stake_lamports, create_genesis_config_with_leader, }, }; #[test] fn test_leader_schedule_via_bank() { let pubkey = solana_sdk::pubkey::new_rand(); let genesis_config = create_genesis_config_with_leader(0, &pubkey, bootstrap_validator_stake_lamports()) .genesis_config; let bank = Bank::new_for_tests(&genesis_config); let pubkeys_and_stakes: Vec<_> = bank .staked_nodes() .iter() .map(|(pubkey, stake)| (*pubkey, *stake)) .collect(); let seed = [0u8; 32]; let leader_schedule = LeaderSchedule::new( &pubkeys_and_stakes, seed, genesis_config.epoch_schedule.slots_per_epoch, NUM_CONSECUTIVE_LEADER_SLOTS, ); assert_eq!(leader_schedule[0], pubkey); assert_eq!(leader_schedule[1], pubkey); assert_eq!(leader_schedule[2], pubkey); } #[test] fn test_leader_scheduler1_basic() { let pubkey = solana_sdk::pubkey::new_rand(); let genesis_config = create_genesis_config_with_leader(42, &pubkey, bootstrap_validator_stake_lamports()) .genesis_config; let bank = Bank::new_for_tests(&genesis_config); assert_eq!(slot_leader_at(bank.slot(), &bank).unwrap(), pubkey); } #[test] fn test_sort_stakes_basic() { let pubkey0 = solana_sdk::pubkey::new_rand(); let pubkey1 = solana_sdk::pubkey::new_rand(); let mut stakes = vec![(pubkey0, 1), (pubkey1, 2)]; sort_stakes(&mut stakes); assert_eq!(stakes, vec![(pubkey1, 2), (pubkey0, 1)]); } #[test] fn test_sort_stakes_with_dup() { let pubkey0 = solana_sdk::pubkey::new_rand(); let pubkey1 = solana_sdk::pubkey::new_rand(); let mut stakes = vec![(pubkey0, 1), (pubkey1, 2), (pubkey0, 1)]; sort_stakes(&mut stakes); assert_eq!(stakes, vec![(pubkey1, 2), (pubkey0, 1)]); } #[test] fn test_sort_stakes_with_equal_stakes() { let pubkey0 = Pubkey::default(); let pubkey1 = solana_sdk::pubkey::new_rand(); let mut stakes = vec![(pubkey0, 1), (pubkey1, 1)]; sort_stakes(&mut stakes); assert_eq!(stakes, vec![(pubkey1, 1), (pubkey0, 1)]); } }