// Copyright (C) Parity Technologies (UK) Ltd. and Dijital Kurdistan Tech Institute // This file is part of Parity Bridges Common. // Parity Bridges Common is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // Parity Bridges Common 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 General Public License for more details. // You should have received a copy of the GNU General Public License // along with Parity Bridges Common. If not, see . //! Primitives of all Pezcumulus-based bridge hubs. #![warn(missing_docs)] #![cfg_attr(not(feature = "std"), no_std)] pub use pezbp_pezkuwi_core::{ AccountId, AccountInfoStorageMapKeyProvider, AccountPublic, Balance, BlockNumber, Hash, Hasher, Hashing, Header, Nonce, Perbill, Signature, SignedBlock, UncheckedExtrinsic, EXTRA_STORAGE_PROOF_SIZE, TX_EXTRA_BYTES, }; pub use teyrchains_common::{ AVERAGE_ON_INITIALIZE_RATIO, MAXIMUM_BLOCK_WEIGHT, MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING, NORMAL_DISPATCH_RATIO, SLOT_DURATION, }; use pezbp_messages::*; use pezbp_pezkuwi_core::SuffixedCommonTransactionExtension; use pezbp_runtime::extensions::{ BridgeRejectObsoleteHeadersAndMessages, RefundBridgedTeyrchainMessagesSchema, }; use pezframe_support::{ dispatch::DispatchClass, parameter_types, pezsp_runtime::{MultiAddress, MultiSigner}, weights::constants, }; use pezframe_system::limits; use pezsp_std::time::Duration; /// Average block time for Pezcumulus-based teyrchains pub const AVERAGE_BLOCK_INTERVAL: Duration = Duration::from_millis(SLOT_DURATION); /// Maximal asset hub header size. pub const MAX_ASSET_HUB_HEADER_SIZE: u32 = 4_096; /// Maximal bridge hub header size. pub const MAX_BRIDGE_HUB_HEADER_SIZE: u32 = 4_096; parameter_types! { /// Size limit of the Pezcumulus-based bridge hub blocks. pub BlockLength: limits::BlockLength = limits::BlockLength::max_with_normal_ratio( 5 * 1024 * 1024, NORMAL_DISPATCH_RATIO, ); /// Importing a block with 0 Extrinsics. pub const BlockExecutionWeight: Weight = Weight::from_parts(constants::WEIGHT_REF_TIME_PER_NANOS, 0) .saturating_mul(5_000_000); /// Executing a NO-OP `System::remarks` Extrinsic. pub const ExtrinsicBaseWeight: Weight = Weight::from_parts(constants::WEIGHT_REF_TIME_PER_NANOS, 0) .saturating_mul(125_000); /// Weight limit of the Pezcumulus-based bridge hub blocks. pub BlockWeights: limits::BlockWeights = limits::BlockWeights::builder() .base_block(BlockExecutionWeight::get()) .for_class(DispatchClass::all(), |weights| { weights.base_extrinsic = ExtrinsicBaseWeight::get(); }) .for_class(DispatchClass::Normal, |weights| { weights.max_total = Some(NORMAL_DISPATCH_RATIO * MAXIMUM_BLOCK_WEIGHT); }) .for_class(DispatchClass::Operational, |weights| { weights.max_total = Some(MAXIMUM_BLOCK_WEIGHT); // Operational transactions have an extra reserved space, so that they // are included even if block reached `MAXIMUM_BLOCK_WEIGHT`. weights.reserved = Some( MAXIMUM_BLOCK_WEIGHT - NORMAL_DISPATCH_RATIO * MAXIMUM_BLOCK_WEIGHT, ); }) .avg_block_initialization(AVERAGE_ON_INITIALIZE_RATIO) .build_or_panic(); /// Weight limit of the Pezcumulus-based bridge hub blocks when async backing is enabled. pub BlockWeightsForAsyncBacking: limits::BlockWeights = limits::BlockWeights::builder() .base_block(BlockExecutionWeight::get()) .for_class(DispatchClass::all(), |weights| { weights.base_extrinsic = ExtrinsicBaseWeight::get(); }) .for_class(DispatchClass::Normal, |weights| { weights.max_total = Some(NORMAL_DISPATCH_RATIO * MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING); }) .for_class(DispatchClass::Operational, |weights| { weights.max_total = Some(MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING); // Operational transactions have an extra reserved space, so that they // are included even if block reached `MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING`. weights.reserved = Some( MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING - NORMAL_DISPATCH_RATIO * MAXIMUM_BLOCK_WEIGHT_FOR_ASYNC_BACKING, ); }) .avg_block_initialization(AVERAGE_ON_INITIALIZE_RATIO) .build_or_panic(); } /// Public key of the chain account that may be used to verify signatures. pub type AccountSigner = MultiSigner; /// The address format for describing accounts. pub type Address = MultiAddress; // Note about selecting values of two following constants: // // Normal transactions have limit of 75% of 1/2 second weight for Pezcumulus teyrchains. Let's keep // some reserve for the rest of stuff there => let's select values that fit in 50% of maximal limit. // // Using current constants, the limit would be: // // `75% * WEIGHT_REF_TIME_PER_SECOND * 1 / 2 * 50% = 0.75 * 1_000_000_000_000 / 2 * 0.5 = // 187_500_000_000` // // According to (preliminary) weights of messages pezpallet, cost of additional message is zero and // the cost of additional relayer is `8_000_000 + db read + db write`. Let's say we want no more // than 4096 unconfirmed messages (no any scientific justification for that - it just looks large // enough). And then we can't have more than 4096 relayers. E.g. for 1024 relayers is (using // `RocksDbWeight`): // // `1024 * (8_000_000 + db read + db write) = 1024 * (8_000_000 + 25_000_000 + 100_000_000) = // 136_192_000_000` // // So 1024 looks like good approximation for the number of relayers. If something is wrong in those // assumptions, or something will change, it shall be caught by the // `ensure_able_to_receive_confirmation` test. /// Maximal number of unrewarded relayer entries at inbound lane for Pezcumulus-based teyrchains. /// Note: this value is security-relevant, decreasing it should not be done without careful /// analysis (like the one above). pub const MAX_UNREWARDED_RELAYERS_IN_CONFIRMATION_TX: MessageNonce = 1024; /// Maximal number of unconfirmed messages at inbound lane for Pezcumulus-based teyrchains. /// Note: this value is security-relevant, decreasing it should not be done without careful /// analysis (like the one above). pub const MAX_UNCONFIRMED_MESSAGES_IN_CONFIRMATION_TX: MessageNonce = 4096; /// Signed extension that is used by all bridge hubs. pub type TransactionExtension = SuffixedCommonTransactionExtension<( BridgeRejectObsoleteHeadersAndMessages, RefundBridgedTeyrchainMessagesSchema, )>;