move economic security into it's own pallet (#596)

* move economic security into it's own pallet

* fix deny

* Update Cargo.toml, .github for the new crates

* Remove unused import

---------

Co-authored-by: Luke Parker <lukeparker5132@gmail.com>

.github/workflows/tests.yml

@@ -63,6 +63,11 @@ jobs:
  -p serai-dex-pallet \
  -p serai-validator-sets-primitives \
  -p serai-validator-sets-pallet \
+ -p serai-genesis-liquidity-primitives \
+ -p serai-genesis-liquidity-pallet \
+ -p serai-emissions-primitives \
+ -p serai-emissions-pallet \
+ -p serai-economic-security-pallet \
  -p serai-in-instructions-primitives \
  -p serai-in-instructions-pallet \
  -p serai-signals-primitives \

Cargo.toml

@@ -79,6 +79,14 @@ members = [
  "substrate/validator-sets/primitives",
  "substrate/validator-sets/pallet",
 
+ "substrate/genesis-liquidity/primitives",
+ "substrate/genesis-liquidity/pallet",
+
+ "substrate/emissions/primitives",
+ "substrate/emissions/pallet",
+
+ "substrate/economic-security/pallet",
+
  "substrate/in-instructions/primitives",
  "substrate/in-instructions/pallet",
 

deny.toml

@@ -56,6 +56,8 @@ exceptions = [
  { allow = ["AGPL-3.0"], name = "serai-genesis-liquidity-pallet" },
  { allow = ["AGPL-3.0"], name = "serai-emissions-pallet" },
 
+ { allow = ["AGPL-3.0"], name = "serai-economic-security-pallet" },
+
  { allow = ["AGPL-3.0"], name = "serai-in-instructions-pallet" },
 
  { allow = ["AGPL-3.0"], name = "serai-validator-sets-pallet" },

substrate/abi/src/economic_security.rs

@@ -0,0 +1,8 @@
+use serai_primitives::NetworkId;
+
+#[derive(Clone, PartialEq, Eq, Debug, scale::Encode, scale::Decode, scale_info::TypeInfo)]
+#[cfg_attr(feature = "borsh", derive(borsh::BorshSerialize, borsh::BorshDeserialize))]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+pub enum Event {
+ EconomicSecurityReached { network: NetworkId },
+}

substrate/abi/src/lib.rs

@@ -20,6 +20,8 @@ pub mod validator_sets;
 pub mod genesis_liquidity;
 pub mod emissions;
 
+pub mod economic_security;
+
 pub mod in_instructions;
 
 pub mod signals;
@@ -60,6 +62,7 @@ pub enum Event {
  ValidatorSets(validator_sets::Event),
  GenesisLiquidity(genesis_liquidity::Event),
  Emissions,
+ EconomicSecurity(economic_security::Event),
  InInstructions(in_instructions::Event),
  Signals(signals::Event),
  Babe,

substrate/economic-security/pallet/Cargo.toml

@@ -0,0 +1,48 @@
+[package]
+name = "serai-economic-security-pallet"
+version = "0.1.0"
+description = "Economic Security pallet for Serai"
+license = "AGPL-3.0-only"
+repository = "https://github.com/serai-dex/serai/tree/develop/substrate/economic-security/pallet"
+authors = ["Akil Demir <akildemir72@gmail.com>"]
+edition = "2021"
+rust-version = "1.77"
+
+[package.metadata.docs.rs]
+all-features = true
+rustdoc-args = ["--cfg", "docsrs"]
+
+[package.metadata.cargo-machete]
+ignored = ["scale", "scale-info"]
+
+[lints]
+workspace = true
+
+[dependencies]
+scale = { package = "parity-scale-codec", version = "3", default-features = false, features = ["derive"] }
+scale-info = { version = "2", default-features = false, features = ["derive"] }
+
+frame-system = { git = "https://github.com/serai-dex/substrate", default-features = false }
+frame-support = { git = "https://github.com/serai-dex/substrate", default-features = false }
+
+dex-pallet = { package = "serai-dex-pallet", path = "../../dex/pallet", default-features = false }
+coins-pallet = { package = "serai-coins-pallet", path = "../../coins/pallet", default-features = false }
+
+serai-primitives = { path = "../../primitives", default-features = false }
+
+[features]
+std = [
+ "scale/std",
+ "scale-info/std",
+
+ "frame-system/std",
+ "frame-support/std",
+
+ "dex-pallet/std",
+ "coins-pallet/std",
+
+ "serai-primitives/std",
+]
+try-runtime = [] # TODO
+
+default = ["std"]

substrate/economic-security/pallet/LICENSE

@@ -0,0 +1,15 @@
+AGPL-3.0-only license
+
+Copyright (c) 2024 Luke Parker
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License Version 3 as
+published by the Free Software Foundation.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <http://www.gnu.org/licenses/>.

substrate/economic-security/pallet/src/lib.rs

@@ -0,0 +1,53 @@
+#![cfg_attr(not(feature = "std"), no_std)]
+
+#[allow(clippy::cast_possible_truncation, clippy::no_effect_underscore_binding, clippy::empty_docs)]
+#[frame_support::pallet]
+pub mod pallet {
+ use frame_system::pallet_prelude::*;
+ use frame_support::pallet_prelude::*;
+
+ use dex_pallet::{Config as DexConfig, Pallet as Dex};
+ use coins_pallet::{Config as CoinsConfig, AllowMint};
+
+ use serai_primitives::*;
+
+ #[pallet::config]
+ pub trait Config: frame_system::Config + CoinsConfig + DexConfig {
+ type RuntimeEvent: From<Event<Self>> + IsType<<Self as frame_system::Config>::RuntimeEvent>;
+ }
+
+ #[pallet::event]
+ #[pallet::generate_deposit(fn deposit_event)]
+ pub enum Event<T: Config> {
+ EconomicSecurityReached { network: NetworkId },
+ }
+
+ #[pallet::pallet]
+ pub struct Pallet<T>(PhantomData<T>);
+
+ #[pallet::storage]
+ #[pallet::getter(fn economic_security_block)]
+ pub(crate) type EconomicSecurityBlock<T: Config> =
+ StorageMap<_, Identity, NetworkId, BlockNumberFor<T>, OptionQuery>;
+
+ #[pallet::hooks]
+ impl<T: Config> Hooks<BlockNumberFor<T>> for Pallet<T> {
+ fn on_initialize(n: BlockNumberFor<T>) -> Weight {
+ // we accept we reached economic security once we can mint smallest amount of a network's coin
+ for coin in COINS {
+ let existing = EconomicSecurityBlock::<T>::get(coin.network());
+ if existing.is_none() &&
+ Dex::<T>::security_oracle_value(coin).is_some() &&
+ <T as CoinsConfig>::AllowMint::is_allowed(&Balance { coin, amount: Amount(1) })
+ {
+ EconomicSecurityBlock::<T>::set(coin.network(), Some(n));
+ Self::deposit_event(Event::EconomicSecurityReached { network: coin.network() });
+ }
+ }
+
+ Weight::zero() // TODO
+ }
+ }
+}
+
+pub use pallet::*;

substrate/emissions/pallet/Cargo.toml

@@ -33,6 +33,8 @@ validator-sets-pallet = { package = "serai-validator-sets-pallet", path = "../..
 dex-pallet = { package = "serai-dex-pallet", path = "../../dex/pallet", default-features = false }
 genesis-liquidity-pallet = { package = "serai-genesis-liquidity-pallet", path = "../../genesis-liquidity/pallet", default-features = false }
 
+economic-security-pallet = { package = "serai-economic-security-pallet", path = "../../economic-security/pallet", default-features = false }
+
 serai-primitives = { path = "../../primitives", default-features = false }
 validator-sets-primitives = { package = "serai-validator-sets-primitives", path = "../../validator-sets/primitives", default-features = false }
 emissions-primitives = { package = "serai-emissions-primitives", path = "../primitives", default-features = false }
@@ -52,6 +54,8 @@ std = [
  "validator-sets-pallet/std",
  "dex-pallet/std",
  "genesis-liquidity-pallet/std",
+
+ "economic-security-pallet/std",
 
  "serai-primitives/std",
  "emissions-primitives/std",

substrate/emissions/pallet/src/lib.rs

@@ -10,12 +10,14 @@ pub mod pallet {
  use sp_std::{vec, vec::Vec, ops::Mul, collections::btree_map::BTreeMap};
  use sp_runtime;
 
- use coins_pallet::{Config as CoinsConfig, Pallet as Coins, AllowMint};
+ use coins_pallet::{Config as CoinsConfig, Pallet as Coins};
  use dex_pallet::{Config as DexConfig, Pallet as Dex};
 
  use validator_sets_pallet::{Pallet as ValidatorSets, Config as ValidatorSetsConfig};
  use genesis_liquidity_pallet::{Pallet as GenesisLiquidity, Config as GenesisLiquidityConfig};
 
+ use economic_security_pallet::{Config as EconomicSecurityConfig, Pallet as EconomicSecurity};
+
  use serai_primitives::*;
  use validator_sets_primitives::{MAX_KEY_SHARES_PER_SET, Session};
  pub use emissions_primitives as primitives;
@@ -28,6 +30,7 @@ pub mod pallet {
  + CoinsConfig
  + DexConfig
  + GenesisLiquidityConfig
+ + EconomicSecurityConfig
  {
  type RuntimeEvent: From<Event<Self>> + IsType<<Self as frame_system::Config>::RuntimeEvent>;
  }
@@ -76,12 +79,6 @@ pub mod pallet {
  #[pallet::getter(fn session)]
  pub type CurrentSession<T: Config> = StorageMap<_, Identity, NetworkId, u32, ValueQuery>;
 
- // TODO: Find a better place for this
- #[pallet::storage]
- #[pallet::getter(fn economic_security_reached)]
- pub(crate) type EconomicSecurityReached<T: Config> =
- StorageMap<_, Identity, NetworkId, bool, ValueQuery>;
-
  #[pallet::storage]
  pub(crate) type LastSwapVolume<T: Config> = StorageMap<_, Identity, Coin, u64, OptionQuery>;
 
@@ -95,33 +92,14 @@ pub mod pallet {
  }
  Participants::<T>::set(id, Some(participants.try_into().unwrap()));
  CurrentSession::<T>::set(id, 0);
- EconomicSecurityReached::<T>::set(id, false);
  }
  }
  }
 
  #[pallet::hooks]
  impl<T: Config> Hooks<BlockNumberFor<T>> for Pallet<T> {
  fn on_initialize(n: BlockNumberFor<T>) -> Weight {
- // we wait 1 extra block after genesis ended to see the changes. We only need this extra
- // block in dev&test networks where we start the chain with accounts that already has some
- // staked SRI. So when we check for ec-security pre-genesis we look like we are economically
- // secure. The reason for this although we only check for it once the genesis is complete(so
- // if the genesis complete we shouldn't be economically secure because the funds are not
- // enough) is because ValidatorSets pallet runs before the genesis pallet in runtime.
- // So ValidatorSets pallet sees the old state until next block.
- // TODO: revisit this when mainnet genesis validator stake code is done.
- let gcb = GenesisLiquidity::<T>::genesis_complete_block();
- let genesis_ended = gcb.is_some() && (n.saturated_into::<u64>() > gcb.unwrap());
-
- // we accept we reached economic security once we can mint smallest amount of a network's coin
- for coin in COINS {
- let check = genesis_ended && !Self::economic_security_reached(coin.network());
- if check && <T as CoinsConfig>::AllowMint::is_allowed(&Balance { coin, amount: Amount(1) })
- {
- EconomicSecurityReached::<T>::set(coin.network(), true);
- }
- }
+ let genesis_ended = GenesisLiquidity::<T>::genesis_complete_block().is_some();
 
  // check if we got a new session
  let mut session_changed = false;
@@ -341,7 +319,7 @@ pub mod pallet {
  continue;
  }
 
- if !Self::economic_security_reached(n) {
+ if EconomicSecurity::<T>::economic_security_block(n).is_none() {
  return true;
  }
  }
@@ -383,7 +361,7 @@ pub mod pallet {
  balance: Balance,
  ) -> DispatchResult {
  // check the network didn't reach the economic security yet
- if Self::economic_security_reached(network) {
+ if EconomicSecurity::<T>::economic_security_block(network).is_some() {
  Err(Error::<T>::NetworkHasEconomicSecurity)?;
  }
 

substrate/genesis-liquidity/pallet/Cargo.toml

@@ -33,6 +33,8 @@ dex-pallet = { package = "serai-dex-pallet", path = "../../dex/pallet", default-
 coins-pallet = { package = "serai-coins-pallet", path = "../../coins/pallet", default-features = false }
 validator-sets-pallet = { package = "serai-validator-sets-pallet", path = "../../validator-sets/pallet", default-features = false }
 
+economic-security-pallet = { package = "serai-economic-security-pallet", path = "../../economic-security/pallet", default-features = false }
+
 serai-primitives = { path = "../../primitives", default-features = false }
 genesis-liquidity-primitives = { package = "serai-genesis-liquidity-primitives", path = "../primitives", default-features = false }
 validator-sets-primitives = { package = "serai-validator-sets-primitives", path = "../../validator-sets/primitives", default-features = false }
@@ -53,6 +55,8 @@ std = [
  "dex-pallet/std",
  "validator-sets-pallet/std",
 
+ "economic-security-pallet/std",
+
  "serai-primitives/std",
  "genesis-liquidity-primitives/std",
  "validator-sets-primitives/std",