Struct frame_system::limits::BlockWeights [−][src]
Block weight limits & base values configuration.
This object is responsible for defining weight limits and base weight values tracked during extrinsic execution.
Each block starts with base_block
weight being consumed right away. Next up the
on_initialize
pallet callbacks are invoked and their cost is added before any extrinsic
is executed. This cost is tracked as Mandatory
dispatch class.
max_block | ||
---|---|---|
# | ||
# | base_block | # |
NOM | NOM | |
_ Mandatory | ||
__ Operational | ||
___ Normal |
The remaining capacity can be used to dispatch extrinsics. Note that each dispatch class
is being tracked separately, but the sum can’t exceed max_block
(except for reserved
).
Below you can see a picture representing full block with 3 extrinsics (two Operational
and
one Normal
). Each class has it’s own limit max_total
, but also the sum cannot exceed
max_block
value.
– Mandatory
limit (unlimited)
| # | | |
| # | Ext3
| - - Operational
limit
|# | Ext2
|- - Normal
limit
| # | Ext1
| # |
| #| on_initialize
| ##|
| #| base_block
|###|
|NOM| |NOM|
It should be obvious now that it’s possible for one class to reach it’s limit (say Normal
),
while the block has still capacity to process more transactions (max_block
not reached,
Operational
transactions can still go in). Setting max_total
to None
disables the
per-class limit. This is generally highly recommended for Mandatory
dispatch class, while it
can be dangerous for Normal
class and should only be done with extra care and consideration.
Often it’s desirable for some class of transactions to be added to the block despite it being
full. For instance one might want to prevent high-priority Normal
transactions from pushing
out lower-priority Operational
transactions. In such cases you might add a reserved
capacity
for given class.
_
Ext8
- reserved
_/
| # | Ext7 | - -
Operationallimit |# |
Ext6 | | |# |
Ext5 |-# -
Normallimit |# |
Ext4 |## | | #|
on_initialize |###| | #|
base_block` |###|
|NOM| |NOM|
In the above example, Ext4-6
fill up the block almost up to max_block
. Ext7
would not fit
if there wasn’t the extra reserved
space for Operational
transactions. Note that max_total
limit applies to reserved
space as well (i.e. the sum of weights of Ext7
& Ext8
mustn’t
exceed it). Setting reserved
to None
allows the extrinsics to always get into the block up
to their max_total
limit. If max_total
is set to None
as well, all extrinsics witch
dispatchables of given class will always end up in the block (recommended for Mandatory
dispatch class).
As a consequence of reserved
space, total consumed block weight might exceed max_block
value, so this parameter should rather be thought of as “target block weight” than a hard limit.
Fields
base_block: Weight
Base weight of block execution.
max_block: Weight
Maximal total weight consumed by all kinds of extrinsics (without reserved
space).
per_class: PerDispatchClass<WeightsPerClass>
Weight limits for extrinsics of given dispatch class.
Implementations
impl BlockWeights
[src]
pub fn get(&self, class: DispatchClass) -> &WeightsPerClass
[src]
Get per-class weight settings.
pub fn validate(self) -> ValidationResult
[src]
Verifies correctness of this BlockWeights
object.
pub fn simple_max(block_weight: Weight) -> Self
[src]
Create new weights definition, with both Normal
and Operational
classes limited to given weight.
Note there is no reservation for Operational
class, so this constructor
is not suitable for production deployments.
pub fn with_sensible_defaults(
expected_block_weight: Weight,
normal_ratio: Perbill
) -> Self
[src]
expected_block_weight: Weight,
normal_ratio: Perbill
) -> Self
Create a sensible default weights system given only expected maximal block weight and the
ratio that Normal
extrinsics should occupy.
Assumptions:
- Average block initialization is assumed to be
10%
. Operational
transactions have reserved allowance (1.0 - normal_ratio
)
pub fn builder() -> BlockWeightsBuilder
[src]
Start constructing new BlockWeights
object.
By default all kinds except of Mandatory
extrinsics are disallowed.
Trait Implementations
impl Clone for BlockWeights
[src]
fn clone(&self) -> BlockWeights
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl Debug for BlockWeights
[src]
impl Decode for BlockWeights
[src]
fn decode<__CodecInputEdqy: Input>(
__codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>
[src]
__codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>
pub fn skip<I>(input: &mut I) -> Result<(), Error> where
I: Input,
[src]
I: Input,
pub fn encoded_fixed_size() -> Option<usize>
[src]
impl Default for BlockWeights
[src]
impl Encode for BlockWeights
[src]
fn encode_to<__CodecOutputEdqy: Output + ?Sized>(
&self,
__codec_dest_edqy: &mut __CodecOutputEdqy
)
[src]
&self,
__codec_dest_edqy: &mut __CodecOutputEdqy
)
pub fn size_hint(&self) -> usize
[src]
pub fn encode(&self) -> Vec<u8, Global>
[src]
pub fn using_encoded<R, F>(&self, f: F) -> R where
F: FnOnce(&[u8]) -> R,
[src]
F: FnOnce(&[u8]) -> R,
pub fn encoded_size(&self) -> usize
[src]
impl EncodeLike<BlockWeights> for BlockWeights
[src]
Auto Trait Implementations
impl RefUnwindSafe for BlockWeights
impl Send for BlockWeights
impl Sync for BlockWeights
impl Unpin for BlockWeights
impl UnwindSafe for BlockWeights
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> CheckedConversion for T
[src]
pub fn checked_from<T>(t: T) -> Option<Self> where
Self: TryFrom<T>,
[src]
Self: TryFrom<T>,
pub fn checked_into<T>(self) -> Option<T> where
Self: TryInto<T>,
[src]
Self: TryInto<T>,
impl<S> Codec for S where
S: Decode + Encode,
[src]
S: Decode + Encode,
impl<T> DecodeAll for T where
T: Decode,
[src]
T: Decode,
impl<T> DecodeLimit for T where
T: Decode,
[src]
T: Decode,
pub fn decode_all_with_depth_limit(limit: u32, input: &[u8]) -> Result<T, Error>
[src]
pub fn decode_with_depth_limit(limit: u32, input: &[u8]) -> Result<T, Error>
[src]
impl<T> DynClone for T where
T: Clone,
[src]
T: Clone,
pub fn __clone_box(&self, Private) -> *mut ()
[src]
impl<'_, '_, T> EncodeLike<&'_ &'_ T> for T where
T: Encode,
[src]
T: Encode,
impl<'_, T> EncodeLike<&'_ T> for T where
T: Encode,
[src]
T: Encode,
impl<'_, T> EncodeLike<&'_ mut T> for T where
T: Encode,
[src]
T: Encode,
impl<T> EncodeLike<Arc<T>> for T where
T: Encode,
[src]
T: Encode,
impl<T> EncodeLike<Box<T, Global>> for T where
T: Encode,
[src]
T: Encode,
impl<'a, T> EncodeLike<Cow<'a, T>> for T where
T: ToOwned + Encode,
[src]
T: ToOwned + Encode,
impl<T> EncodeLike<Rc<T>> for T where
T: Encode,
[src]
T: Encode,
impl<T> From<T> for T
[src]
impl<S> FullCodec for S where
S: Decode + FullEncode,
[src]
S: Decode + FullEncode,
impl<S> FullEncode for S where
S: Encode + EncodeLike<S>,
[src]
S: Encode + EncodeLike<S>,
impl<T> Hashable for T where
T: Codec,
[src]
T: Codec,
pub fn blake2_128(&self) -> [u8; 16]
[src]
pub fn blake2_256(&self) -> [u8; 32]
[src]
pub fn blake2_128_concat(&self) -> Vec<u8, Global>
[src]
pub fn twox_128(&self) -> [u8; 16]
[src]
pub fn twox_256(&self) -> [u8; 32]
[src]
pub fn twox_64_concat(&self) -> Vec<u8, Global>
[src]
pub fn identity(&self) -> Vec<u8, Global>
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> IsType<T> for T
[src]
pub fn from_ref(t: &T) -> &T
[src]
pub fn into_ref(&self) -> &T
[src]
pub fn from_mut(t: &mut T) -> &mut T
[src]
pub fn into_mut(&mut self) -> &mut T
[src]
impl<T, Outer> IsWrappedBy<Outer> for T where
T: From<Outer>,
Outer: AsRef<T> + AsMut<T> + From<T>,
[src]
T: From<Outer>,
Outer: AsRef<T> + AsMut<T> + From<T>,
pub fn from_ref(outer: &Outer) -> &T
[src]
Get a reference to the inner from the outer.
pub fn from_mut(outer: &mut Outer) -> &mut T
[src]
Get a mutable reference to the inner from the outer.
impl<T> KeyedVec for T where
T: Codec,
[src]
T: Codec,
impl<T> MaybeDebug for T where
T: Debug,
[src]
T: Debug,
impl<T> MaybeDebug for T where
T: Debug,
[src]
T: Debug,
impl<T> MaybeRefUnwindSafe for T where
T: RefUnwindSafe,
[src]
T: RefUnwindSafe,
impl<T> Same<T> for T
[src]
type Output = T
Should always be Self
impl<T> SaturatedConversion for T
[src]
pub fn saturated_from<T>(t: T) -> Self where
Self: UniqueSaturatedFrom<T>,
[src]
Self: UniqueSaturatedFrom<T>,
pub fn saturated_into<T>(self) -> T where
Self: UniqueSaturatedInto<T>,
[src]
Self: UniqueSaturatedInto<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<S, T> UncheckedInto<T> for S where
T: UncheckedFrom<S>,
[src]
T: UncheckedFrom<S>,
pub fn unchecked_into(self) -> T
[src]
impl<T, S> UniqueSaturatedInto<T> for S where
T: Bounded,
S: TryInto<T>,
[src]
T: Bounded,
S: TryInto<T>,
pub fn unique_saturated_into(self) -> T
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
[src]
V: MultiLane<T>,