Struct frame_system::pallet::Pallet

pub struct Pallet<T>(_);

The pallet implementing the on-chain logic.

Implementations

impl<T: Config> Pallet<T>

pub fn fill_block(
    origin: OriginFor<T>,
    _ratio: Perbill
) -> DispatchResultWithPostInfo

A dispatch that will fill the block weight up to the given ratio.

pub fn remark(
    origin: OriginFor<T>,
    _remark: Vec<u8>
) -> DispatchResultWithPostInfo

Make some on-chain remark.

• O(1)

pub fn set_heap_pages(
    origin: OriginFor<T>,
    pages: u64
) -> DispatchResultWithPostInfo

Set the number of pages in the WebAssembly environment’s heap.

• O(1)
• 1 storage write.
• Base Weight: 1.405 µs
• 1 write to HEAP_PAGES

pub fn set_code(
    origin: OriginFor<T>,
    code: Vec<u8>
) -> DispatchResultWithPostInfo

Set the new runtime code.

• O(C + S) where C length of code and S complexity of can_set_code
• 1 storage write (codec O(C)).
• 1 call to can_set_code: O(S) (calls sp_io::misc::runtime_version which is expensive).
• 1 event. The weight of this function is dependent on the runtime, but generally this is very expensive. We will treat this as a full block.

pub fn set_code_without_checks(
    origin: OriginFor<T>,
    code: Vec<u8>
) -> DispatchResultWithPostInfo

Set the new runtime code without doing any checks of the given code.

• O(C) where C length of code
• 1 storage write (codec O(C)).
• 1 event. The weight of this function is dependent on the runtime. We will treat this as a full block. #

pub fn set_changes_trie_config(
    origin: OriginFor<T>,
    changes_trie_config: Option<ChangesTrieConfiguration>
) -> DispatchResultWithPostInfo

Set the new changes trie configuration.

• O(1)
• 1 storage write or delete (codec O(1)).
• 1 call to deposit_log: Uses append API, so O(1)
• Base Weight: 7.218 µs
• DB Weight:
  • Writes: Changes Trie, System Digest

pub fn set_storage(
    origin: OriginFor<T>,
    items: Vec<KeyValue>
) -> DispatchResultWithPostInfo

Set some items of storage.

• O(I) where I length of items
• I storage writes (O(1)).
• Base Weight: 0.568 * i µs
• Writes: Number of items

pub fn kill_storage(
    origin: OriginFor<T>,
    keys: Vec<Key>
) -> DispatchResultWithPostInfo

Kill some items from storage.

• O(IK) where I length of keys and K length of one key
• I storage deletions.
• Base Weight: .378 * i µs
• Writes: Number of items

pub fn kill_prefix(
    origin: OriginFor<T>,
    prefix: Key,
    _subkeys: u32
) -> DispatchResultWithPostInfo

Kill all storage items with a key that starts with the given prefix.

NOTE: We rely on the Root origin to provide us the number of subkeys under the prefix we are removing to accurately calculate the weight of this function.

• O(P) where P amount of keys with prefix prefix
• P storage deletions.
• Base Weight: 0.834 * P µs
• Writes: Number of subkeys + 1

pub fn remark_with_event(
    origin: OriginFor<T>,
    remark: Vec<u8>
) -> DispatchResultWithPostInfo

Make some on-chain remark and emit event.

• O(b) where b is the length of the remark.
• 1 event.

impl<T: Config> Pallet<T>

pub fn account<KArg>(k: KArg) -> AccountInfo<T::Index, T::AccountData> where
    KArg: EncodeLike<T::AccountId>, 

The full account information for a particular account ID.

impl<T: Config> Pallet<T>

pub fn block_weight() -> ConsumedWeight

The current weight for the block.

impl<T: Config> Pallet<T>

pub fn block_hash<KArg>(k: KArg) -> T::Hash where
    KArg: EncodeLike<T::BlockNumber>, 

Map of block numbers to block hashes.

impl<T: Config> Pallet<T>

pub fn extrinsic_data<KArg>(k: KArg) -> Vec<u8> where
    KArg: EncodeLike<u32>, 

Extrinsics data for the current block (maps an extrinsic’s index to its data).

impl<T: Config> Pallet<T>

pub fn block_number() -> T::BlockNumber

The current block number being processed. Set by execute_block.

impl<T: Config> Pallet<T>

pub fn parent_hash() -> T::Hash

Hash of the previous block.

impl<T: Config> Pallet<T>

pub fn digest() -> DigestOf<T>

Digest of the current block, also part of the block header.

impl<T: Config> Pallet<T>

pub fn events() -> Vec<EventRecord<T::Event, T::Hash>>

Events deposited for the current block.

impl<T: Config> Pallet<T>

pub fn event_count() -> u32

The number of events in the Events<T> list.

impl<T: Config> Pallet<T>

pub fn event_topics<KArg>(k: KArg) -> Vec<(T::BlockNumber, u32)> where
    KArg: EncodeLike<T::Hash>, 

Mapping between a topic (represented by T::Hash) and a vector of indexes of events in the <Events<T>> list.

All topic vectors have deterministic storage locations depending on the topic. This allows light-clients to leverage the changes trie storage tracking mechanism and in case of changes fetch the list of events of interest.

The value has the type (T::BlockNumber, EventIndex) because if we used only just the EventIndex then in case if the topic has the same contents on the next block no notification will be triggered thus the event might be lost.

impl<T: Config> Pallet<T>

pub fn account_exists(who: &T::AccountId) -> bool

pub fn inc_ref(who: &T::AccountId)

👎 Deprecated:

Use inc_consumers instead

Increment the reference counter on an account.

pub fn dec_ref(who: &T::AccountId)

👎 Deprecated:

Use dec_consumers instead

Decrement the reference counter on an account. This MUST only be done once for every time you called inc_consumers on who.

pub fn refs(who: &T::AccountId) -> RefCount

👎 Deprecated:

Use consumers instead

The number of outstanding references for the account who.

pub fn allow_death(who: &T::AccountId) -> bool

👎 Deprecated:

Use !is_provider_required instead

True if the account has no outstanding references.

pub fn inc_providers(who: &T::AccountId) -> IncRefStatus

Increment the provider reference counter on an account.

pub fn dec_providers(who: &T::AccountId) -> Result<DecRefStatus, DispatchError>

Decrement the provider reference counter on an account.

This MUST only be done once for every time you called inc_providers on who.

pub fn inc_sufficients(who: &T::AccountId) -> IncRefStatus

Increment the self-sufficient reference counter on an account.

pub fn dec_sufficients(who: &T::AccountId) -> DecRefStatus

Decrement the sufficients reference counter on an account.

This MUST only be done once for every time you called inc_sufficients on who.

pub fn providers(who: &T::AccountId) -> RefCount

The number of outstanding provider references for the account who.

pub fn sufficients(who: &T::AccountId) -> RefCount

The number of outstanding sufficient references for the account who.

pub fn reference_count(who: &T::AccountId) -> RefCount

The number of outstanding provider and sufficient references for the account who.

pub fn inc_consumers(who: &T::AccountId) -> Result<(), DispatchError>

Increment the reference counter on an account.

The account who’s providers must be non-zero or this will return an error.

pub fn dec_consumers(who: &T::AccountId)

Decrement the reference counter on an account. This MUST only be done once for every time you called inc_consumers on who.

pub fn consumers(who: &T::AccountId) -> RefCount

The number of outstanding references for the account who.

pub fn is_provider_required(who: &T::AccountId) -> bool

True if the account has some outstanding consumer references.

pub fn can_dec_provider(who: &T::AccountId) -> bool

True if the account has no outstanding consumer references or more than one provider.

pub fn can_inc_consumer(who: &T::AccountId) -> bool

True if the account has at least one provider reference.

pub fn deposit_event(event: impl Into<T::Event>)

Deposits an event into this block’s event record.

pub fn deposit_event_indexed(topics: &[T::Hash], event: T::Event)

Deposits an event into this block’s event record adding this event to the corresponding topic indexes.

This will update storage entries that correspond to the specified topics. It is expected that light-clients could subscribe to this topics.

pub fn extrinsic_index() -> Option<u32>

Gets the index of extrinsic that is currently executing.

pub fn extrinsic_count() -> u32

Gets extrinsics count.

pub fn all_extrinsics_len() -> u32

pub fn register_extra_weight_unchecked(weight: Weight, class: DispatchClass)

Inform the system pallet of some additional weight that should be accounted for, in the current block.

NOTE: use with extra care; this function is made public only be used for certain pallets that need it. A runtime that does not have dynamic calls should never need this and should stick to static weights. A typical use case for this is inner calls or smart contract calls. Furthermore, it only makes sense to use this when it is presumably cheap to provide the argument weight; In other words, if this function is to be used to account for some unknown, user provided call’s weight, it would only make sense to use it if you are sure you can rapidly compute the weight of the inner call.

Even more dangerous is to note that this function does NOT take any action, if the new sum of block weight is more than the block weight limit. This is what the unchecked.

Another potential use-case could be for the on_initialize and on_finalize hooks.

pub fn initialize(
    number: &T::BlockNumber,
    parent_hash: &T::Hash,
    digest: &DigestOf<T>,
    kind: InitKind
)

Start the execution of a particular block.

pub fn finalize() -> T::Header

Remove temporary “environment” entries in storage, compute the storage root and return the resulting header for this block.

pub fn deposit_log(item: DigestItemOf<T>)

Deposits a log and ensures it matches the block’s log data.

• O(1)
• 1 storage write (codec O(1))

pub fn externalities() -> TestExternalities

Get the basic externalities for this pallet, useful for tests.

pub fn set_block_number(n: T::BlockNumber)

Set the block number to something in particular. Can be used as an alternative to initialize for tests that don’t need to bother with the other environment entries.

pub fn set_extrinsic_index(extrinsic_index: u32)

Sets the index of extrinsic that is currently executing.

pub fn set_parent_hash(n: T::Hash)

Set the parent hash number to something in particular. Can be used as an alternative to initialize for tests that don’t need to bother with the other environment entries.

pub fn set_block_consumed_resources(weight: Weight, len: usize)

Set the current block weight. This should only be used in some integration tests.

pub fn reset_events()

Reset events. Can be used as an alternative to initialize for tests that don’t need to bother with the other environment entries.

pub fn assert_has_event(event: T::Event)

Assert the given event exists.

pub fn assert_last_event(event: T::Event)

Assert the last event equal to the given event.

pub fn runtime_version() -> RuntimeVersion

Return the chain’s current runtime version.

pub fn account_nonce(who: impl EncodeLike<T::AccountId>) -> T::Index

Retrieve the account transaction counter from storage.

pub fn inc_account_nonce(who: impl EncodeLike<T::AccountId>)

Increment a particular account’s nonce by 1.

pub fn note_extrinsic(encoded_xt: Vec<u8>)

Note what the extrinsic data of the current extrinsic index is.

This is required to be called before applying an extrinsic. The data will used in Self::finalize to calculate the correct extrinsics root.

pub fn note_applied_extrinsic(
    r: &DispatchResultWithPostInfo,
    info: DispatchInfo
)

To be called immediately after an extrinsic has been applied.

pub fn note_finished_extrinsics()

To be called immediately after note_applied_extrinsic of the last extrinsic of the block has been called.

pub fn note_finished_initialize()

To be called immediately after finishing the initialization of the block (e.g., called on_initialize for all pallets).

pub fn on_created_account(
    who: T::AccountId,
    _a: &mut AccountInfo<T::Index, T::AccountData>
)

An account is being created.

pub fn can_set_code(code: &[u8]) -> Result<(), DispatchError>

Determine whether or not it is possible to update the code.

Checks the given code if it is a valid runtime wasm blob by instantianting it and extracting the runtime version of it. It checks that the runtime version of the old and new runtime has the same spec name and that the spec version is increasing.

Trait Implementations

impl<T: Config> BlockNumberProvider for Pallet<T>

type BlockNumber = <T as Config>::BlockNumber

Type of BlockNumber to provide.

fn current_block_number() -> Self::BlockNumber

Returns the current block number.

impl<T: Config> Callable<T> for Pallet<T>

type Call = Call<T>

impl<T> Clone for Pallet<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Pallet<T>

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

Formats the value using the given formatter.

impl<T: Config> GetStorageVersion for Pallet<T>

fn current_storage_version() -> StorageVersion

Returns the current storage version as supported by the pallet.

fn on_chain_storage_version() -> StorageVersion

Returns the on-chain storage version of the pallet as stored in the storage.

impl<T: Config> Hooks<<T as Config>::BlockNumber> for Pallet<T>

fn on_runtime_upgrade() -> Weight

Perform a module upgrade.

fn integrity_test()

Run integrity test.

fn on_finalize(_n: BlockNumber)

The block is being finalized. Implement to have something happen.

fn on_idle(_n: BlockNumber, _remaining_weight: u64) -> u64

This will be run when the block is being finalized (before on_finalize). Implement to have something happen using the remaining weight. Will not fire if the remaining weight is 0. Return the weight used, the hook will subtract it from current weight used and pass the result to the next on_idle hook if it exists.

fn on_initialize(_n: BlockNumber) -> u64

The block is being initialized. Implement to have something happen.

fn pre_upgrade() -> Result<(), &'static str>

Execute some pre-checks prior to a runtime upgrade.

fn post_upgrade() -> Result<(), &'static str>

Execute some post-checks after a runtime upgrade.

fn offchain_worker(_n: BlockNumber)

Implementing this function on a module allows you to perform long-running tasks that make (by default) validators generate transactions that feed results of those long-running computations back on chain.

impl<T: Config> IntegrityTest for Pallet<T>

fn integrity_test()

Run integrity test.

impl<T: Config> ModuleErrorMetadata for Pallet<T>

fn metadata() -> &'static [ErrorMetadata]

impl<T: Config> OffchainWorker<<T as Config>::BlockNumber> for Pallet<T>

fn offchain_worker(n: <T as Config>::BlockNumber)

This function is being called after every block import (when fully synced).

impl<T: Config> OnFinalize<<T as Config>::BlockNumber> for Pallet<T>

fn on_finalize(n: <T as Config>::BlockNumber)

The block is being finalized. Implement to have something happen.

impl<T: Config> OnGenesis for Pallet<T>

fn on_genesis()

Something that should happen at genesis.

impl<T: Config> OnIdle<<T as Config>::BlockNumber> for Pallet<T>

fn on_idle(n: <T as Config>::BlockNumber, remaining_weight: Weight) -> Weight

The block is being finalized. Implement to have something happen in case there is leftover weight. Check the passed remaining_weight to make sure it is high enough to allow for your pallet’s extra computation.

impl<T: Config> OnInitialize<<T as Config>::BlockNumber> for Pallet<T>

fn on_initialize(n: <T as Config>::BlockNumber) -> Weight

The block is being initialized. Implement to have something happen.

impl<T: Config> OnRuntimeUpgrade for Pallet<T>

fn on_runtime_upgrade() -> Weight

Perform a module upgrade.

fn pre_upgrade() -> Result<(), &'static str>

Execute some pre-checks prior to a runtime upgrade.

fn post_upgrade() -> Result<(), &'static str>

Execute some post-checks after a runtime upgrade.

impl<T: Config> PalletInfoAccess for Pallet<T>

fn index() -> usize

Index of the pallet as configured in the runtime.

fn name() -> &'static str

Name of the pallet as configured in the runtime.

impl<T> PartialEq<Pallet<T>> for Pallet<T>

fn eq(&self, other: &Self) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: Config> StorageInfoTrait for Pallet<T>

fn storage_info() -> Vec<StorageInfo>

impl<T: Config> StoredMap<<T as Config>::AccountId, <T as Config>::AccountData> for Pallet<T>

Implement StoredMap for a simple single-item, provide-when-not-default system. This works fine for storing a single item which allows the account to continue existing as long as it’s not empty/default.

Anything more complex will need more sophisticated logic.

fn get(k: &T::AccountId) -> T::AccountData

Get the item, or its default if it doesn’t yet exist; we make no distinction between the two.

fn try_mutate_exists<R, E: From<DispatchError>>(
    k: &T::AccountId,
    f: impl FnOnce(&mut Option<T::AccountData>) -> Result<R, E>
) -> Result<R, E>

Maybe mutate the item only if an Ok value is returned from f. Do nothing if an Err is returned. It is removed or reset to default value if it has been mutated to None

fn mutate<R>(k: &K, f: impl FnOnce(&mut T) -> R) -> Result<R, DispatchError>

Mutate the item.

fn mutate_exists<R>(
    k: &K,
    f: impl FnOnce(&mut Option<T>) -> R
) -> Result<R, DispatchError>

Mutate the item, removing or resetting to default value if it has been mutated to None.

fn insert(k: &K, t: T) -> Result<(), DispatchError>

Set the item to something new.

fn remove(k: &K) -> Result<(), DispatchError>

Remove the item or otherwise replace it with its default value; we don’t care which.

impl<T> Eq for Pallet<T>