// This file is part of Substrate. // Copyright (C) 2021-2022 Parity Technologies (UK) Ltd. // SPDX-License-Identifier: Apache-2.0 // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #![cfg_attr(not(feature = "std"), no_std)] use codec::Encode; use frame_support::{traits::OneSessionHandler, Parameter}; use sp_runtime::{ generic::DigestItem, traits::{IsMember, Member}, RuntimeAppPublic, }; use sp_std::prelude::*; use beefy_primitives::{AuthorityIndex, ConsensusLog, ValidatorSet, BEEFY_ENGINE_ID}; #[cfg(test)] mod mock; #[cfg(test)] mod tests; pub use pallet::*; #[frame_support::pallet] pub mod pallet { use super::*; use frame_support::pallet_prelude::*; use frame_system::pallet_prelude::*; #[pallet::config] pub trait Config: frame_system::Config { /// Authority identifier type type BeefyId: Member + Parameter + RuntimeAppPublic + MaybeSerializeDeserialize; } #[pallet::pallet] #[pallet::without_storage_info] pub struct Pallet(PhantomData); #[pallet::hooks] impl Hooks> for Pallet {} #[pallet::call] impl Pallet {} /// The current authorities set #[pallet::storage] #[pallet::getter(fn authorities)] pub(super) type Authorities = StorageValue<_, Vec, ValueQuery>; /// The current validator set id #[pallet::storage] #[pallet::getter(fn validator_set_id)] pub(super) type ValidatorSetId = StorageValue<_, beefy_primitives::ValidatorSetId, ValueQuery>; /// Authorities set scheduled to be used with the next session #[pallet::storage] #[pallet::getter(fn next_authorities)] pub(super) type NextAuthorities = StorageValue<_, Vec, ValueQuery>; #[pallet::genesis_config] pub struct GenesisConfig { pub authorities: Vec, } #[cfg(feature = "std")] impl Default for GenesisConfig { fn default() -> Self { Self { authorities: Vec::new() } } } #[pallet::genesis_build] impl GenesisBuild for GenesisConfig { fn build(&self) { Pallet::::initialize_authorities(&self.authorities); } } } impl Pallet { /// Return the current active BEEFY validator set. pub fn validator_set() -> Option> { let validators: Vec = Self::authorities(); let id: beefy_primitives::ValidatorSetId = Self::validator_set_id(); ValidatorSet::::new(validators, id) } fn change_authorities(new: Vec, queued: Vec) { // Always issue a change if `session` says that the validators have changed. // Even if their session keys are the same as before, the underlying economic // identities have changed. Furthermore, the digest below is used to signal // BEEFY mandatory blocks. >::put(&new); let next_id = Self::validator_set_id() + 1u64; >::put(next_id); if let Some(validator_set) = ValidatorSet::::new(new, next_id) { let log = DigestItem::Consensus( BEEFY_ENGINE_ID, ConsensusLog::AuthoritiesChange(validator_set).encode(), ); >::deposit_log(log); } >::put(&queued); } fn initialize_authorities(authorities: &[T::BeefyId]) { if authorities.is_empty() { return } assert!(>::get().is_empty(), "Authorities are already initialized!"); >::put(authorities); >::put(0); // Like `pallet_session`, initialize the next validator set as well. >::put(authorities); } } impl sp_runtime::BoundToRuntimeAppPublic for Pallet { type Public = T::BeefyId; } impl OneSessionHandler for Pallet { type Key = T::BeefyId; fn on_genesis_session<'a, I: 'a>(validators: I) where I: Iterator, { let authorities = validators.map(|(_, k)| k).collect::>(); Self::initialize_authorities(&authorities); } fn on_new_session<'a, I: 'a>(changed: bool, validators: I, queued_validators: I) where I: Iterator, { if changed { let next_authorities = validators.map(|(_, k)| k).collect::>(); let next_queued_authorities = queued_validators.map(|(_, k)| k).collect::>(); Self::change_authorities(next_authorities, next_queued_authorities); } } fn on_disabled(i: u32) { let log = DigestItem::Consensus( BEEFY_ENGINE_ID, ConsensusLog::::OnDisabled(i as AuthorityIndex).encode(), ); >::deposit_log(log); } } impl IsMember for Pallet { fn is_member(authority_id: &T::BeefyId) -> bool { Self::authorities().iter().any(|id| id == authority_id) } }