Struct pallet_contracts::InstructionWeights

pub struct InstructionWeights<T: Config> {

    pub version: u32,
    pub i64const: u32,
    pub i64load: u32,
    pub i64store: u32,
    pub select: u32,
    pub if: u32,
    pub br: u32,
    pub br_if: u32,
    pub br_table: u32,
    pub br_table_per_entry: u32,
    pub call: u32,
    pub call_indirect: u32,
    pub call_indirect_per_param: u32,
    pub local_get: u32,
    pub local_set: u32,
    pub local_tee: u32,
    pub global_get: u32,
    pub global_set: u32,
    pub memory_current: u32,
    pub memory_grow: u32,
    pub i64clz: u32,
    pub i64ctz: u32,
    pub i64popcnt: u32,
    pub i64eqz: u32,
    pub i64extendsi32: u32,
    pub i64extendui32: u32,
    pub i32wrapi64: u32,
    pub i64eq: u32,
    pub i64ne: u32,
    pub i64lts: u32,
    pub i64ltu: u32,
    pub i64gts: u32,
    pub i64gtu: u32,
    pub i64les: u32,
    pub i64leu: u32,
    pub i64ges: u32,
    pub i64geu: u32,
    pub i64add: u32,
    pub i64sub: u32,
    pub i64mul: u32,
    pub i64divs: u32,
    pub i64divu: u32,
    pub i64rems: u32,
    pub i64remu: u32,
    pub i64and: u32,
    pub i64or: u32,
    pub i64xor: u32,
    pub i64shl: u32,
    pub i64shrs: u32,
    pub i64shru: u32,
    pub i64rotl: u32,
    pub i64rotr: u32,
    pub _phantom: PhantomData<T>,
}

Describes the weight for all categories of supported wasm instructions.

There there is one field for each wasm instruction that describes the weight to execute one instruction of that name. There are a few execptions:

1. If there is a i64 and a i32 variant of an instruction we use the weight of the former for both.
2. The following instructions are free of charge because they merely structure the wasm module and cannot be spammed without making the module invalid (and rejected): End, Unreachable, Return, Else
3. The following instructions cannot be benchmarked because they are removed by any real world execution engine as a preprocessing step and therefore don’t yield a meaningful benchmark result. However, in contrast to the instructions mentioned in 2. they can be spammed. We price them with the same weight as the “default” instruction (i64.const): Block, Loop, Nop
4. We price both i64.const and drop as InstructionWeights.i64const / 2. The reason for that is that we cannot benchmark either of them on its own but we need their individual values to derive (by subtraction) the weight of all other instructions that use them as supporting instructions. Supporting means mainly pushing arguments and dropping return values in order to maintain a valid module.

Fields

version: u32

Version of the instruction weights.

Note

Should be incremented whenever any instruction weight is changed. The reason is that changes to instruction weights require a re-instrumentation in order to apply the changes to an already deployed code. The re-instrumentation is triggered by comparing the version of the current schedule with the version the code was instrumented with. Changes usually happen when pallet_contracts is re-benchmarked.

Changes to other parts of the schedule should not increment the version in order to avoid unnecessary re-instrumentations.

i64const: u32

i64load: u32

i64store: u32

select: u32

if: u32

br: u32

br_if: u32

br_table: u32

br_table_per_entry: u32

call: u32

call_indirect: u32

call_indirect_per_param: u32

local_get: u32

local_set: u32

local_tee: u32

global_get: u32

global_set: u32

memory_current: u32

memory_grow: u32

i64clz: u32

i64ctz: u32

i64popcnt: u32

i64eqz: u32

i64extendsi32: u32

i64extendui32: u32

i32wrapi64: u32

i64eq: u32

i64ne: u32

i64lts: u32

i64ltu: u32

i64gts: u32

i64gtu: u32

i64les: u32

i64leu: u32

i64ges: u32

i64geu: u32

i64add: u32

i64sub: u32

i64mul: u32

i64divs: u32

i64divu: u32

i64rems: u32

i64remu: u32

i64and: u32

i64or: u32

i64xor: u32

i64shl: u32

i64shrs: u32

i64shru: u32

i64rotl: u32

i64rotr: u32

_phantom: PhantomData<T>

The type parameter is used in the default implementation.

Trait Implementations

impl<T: Clone + Config> Clone for InstructionWeights<T>

fn clone(&self) -> InstructionWeights<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Config> Debug for InstructionWeights<T>

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T: Config> Decode for InstructionWeights<T> where
    PhantomData<T>: Default, 

fn decode<__CodecInputEdqy: Input>(
    __codec_input_edqy: &mut __CodecInputEdqy
) -> Result<Self, Error>

Attempt to deserialise the value from input.

fn skip<I>(input: &mut I) -> Result<(), Error> where
    I: Input, 

Attempt to skip the encoded value from input.

fn encoded_fixed_size() -> Option<usize>

Returns the fixed encoded size of the type.

impl<T: Config> Default for InstructionWeights<T>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, T: Config> Deserialize<'de> for InstructionWeights<T>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<T: Config> Encode for InstructionWeights<T>

fn encode_to<__CodecOutputEdqy: Output + ?Sized>(
    &self,
    __codec_dest_edqy: &mut __CodecOutputEdqy
)

Convert self to a slice and append it to the destination.

fn size_hint(&self) -> usize

If possible give a hint of expected size of the encoding.

fn encode(&self) -> Vec<u8, Global>

Convert self to an owned vector.

fn using_encoded<R, F>(&self, f: F) -> R where
    F: FnOnce(&[u8]) -> R, 

Convert self to a slice and then invoke the given closure with it.

fn encoded_size(&self) -> usize

Calculates the encoded size.

impl<T: PartialEq + Config> PartialEq<InstructionWeights<T>> for InstructionWeights<T>

fn eq(&self, other: &InstructionWeights<T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &InstructionWeights<T>) -> bool

This method tests for !=.

impl<T: Config> Serialize for InstructionWeights<T>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl<T: Config> EncodeLike<InstructionWeights<T>> for InstructionWeights<T>

impl<T: Eq + Config> Eq for InstructionWeights<T>

impl<T: Config> StructuralEq for InstructionWeights<T>

impl<T: Config> StructuralPartialEq for InstructionWeights<T>