Crate frame::prelude::frame_system

frame_system’s parent crate, which is mandatory in all pallets build with this crate.

Conveniently, the keyword frame_system is in scope as one uses use frame::prelude::*

System Pallet

The System pallet provides low-level access to core types and cross-cutting utilities. It acts as the base layer for other pallets to interact with the Substrate framework components.

• Config

Overview

The System pallet defines the core data types used in a Substrate runtime. It also provides several utility functions (see Pallet) for other FRAME pallets.

In addition, it manages the storage items for extrinsics data, indexes, event records, and digest items, among other things that support the execution of the current block.

It also handles low-level tasks like depositing logs, basic set up and take down of temporary storage entries, and access to previous block hashes.

Interface

Dispatchable Functions

The System pallet does not implement any dispatchable functions.

Public Functions

See the Pallet struct for details of publicly available functions.

Signed Extensions

The System pallet defines the following extensions:

• CheckWeight: Checks the weight and length of the block and ensure that it does not exceed the limits.
• CheckNonce: Checks the nonce of the transaction. Contains a single payload of type T::Nonce.
• CheckEra: Checks the era of the transaction. Contains a single payload of type Era.
• CheckGenesis: Checks the provided genesis hash of the transaction. Must be a part of the signed payload of the transaction.
• CheckSpecVersion: Checks that the runtime version is the same as the one used to sign the transaction.
• CheckTxVersion: Checks that the transaction version is the same as the one used to sign the transaction.

Lookup the runtime aggregator file (e.g. node/runtime) to see the full list of signed extensions included in a chain.

Modules

• limits
  Block resource limits configuration structures.
• migrations
  Migrate the reference counting state.
• mocking
  Provide types to help defining a mock environment when testing pallets.
• offchain
  Module helpers for off-chain calls.
• pallet
  The pallet module in each FRAME pallet hosts the most important items needed to construct this pallet.
• pallet_prelude
  Prelude to be used alongside pallet macro, for ease of use.
• weights
  Autogenerated weights for frame_system

Structs

• AccountInfo
  Information of an account.
• ChainContext
• CheckEra
  Check for transaction mortality.
• CheckGenesis
  Genesis hash check to provide replay protection between different networks.
• CheckMortality
  Check for transaction mortality.
• CheckNonZeroSender
  Check to ensure that the sender is not the zero address.
• CheckNonce
  Nonce check and increment to give replay protection for transactions.
• CheckSpecVersion
  Ensure the runtime version registered in the transaction is the same as at present.
• CheckTxVersion
  Ensure the transaction version registered in the transaction is the same as at present.
• CheckWeight
  Block resource (weight) limit check.
• Consumer
  Event handler which registers a consumer when created.
• EnsureNever
  Always fail.
• EnsureNone
  Ensure the origin is None. i.e. unsigned transaction.
• EnsureRoot
  Ensure the origin is Root.
• EnsureRootWithSuccess
  Ensure the origin is Root and return the provided Success value.
• EnsureSigned
  Ensure the origin is any Signed origin.
• EnsureSignedBy
  Ensure the origin is Signed origin from the given AccountId.
• EnsureWithSuccess
  Ensure the origin is provided Ensure origin and return the provided Success value.
• EventRecord
  Record of an event happening.
• GenesisConfig
  Can be used to configure the genesis state of this pallet.
• LastRuntimeUpgradeInfo
  Stores the spec_version and spec_name of when the last runtime upgrade happened.
• Pallet
  The Pallet struct, the main type that implements traits and standalone functions within the pallet.
• Provider
  Event handler which registers a provider when created.
• SelfSufficient
  Event handler which registers a self-sufficient when created.

Enums

• Call
  Contains a variant per dispatchable extrinsic that this pallet has.
• DecRefStatus
  Some resultant status relevant to decrementing a provider/self-sufficient reference.
• Error
  Error for the System pallet
• Event
  Event for the System pallet.
• IncRefStatus
  Some resultant status relevant to incrementing a provider/self-sufficient reference.
• Phase
  A phase of a block’s execution.
• RawOrigin
  Origin for the System pallet.
• RefStatus
  Reference status; can be either referenced or unreferenced.

Traits

• Config
  Configuration trait of this pallet.
• ConsumerLimits
  Numeric limits over the ability to add a consumer ref using inc_consumers.
• DefaultConfig
  Based on Config. Auto-generated by #[pallet::config(with_default)]. Can be used in tandem with #[register_default_config] and #[derive_impl] to derive test config traits based on existing pallet config traits in a safe and developer-friendly way.
• SetCode
  Do something when we should be setting the code.
• WeightInfo
  Weight functions needed for frame_system.

Functions

• ensure_none
  Ensure that the origin o represents an unsigned extrinsic. Returns Ok or an Err otherwise.
• ensure_root
  Ensure that the origin o represents the root. Returns Ok or an Err otherwise.
• ensure_signed
  Ensure that the origin o represents a signed extrinsic (i.e. transaction). Returns Ok with the account that signed the extrinsic or an Err otherwise.
• ensure_signed_or_root
  Ensure that the origin o represents either a signed extrinsic (i.e. transaction) or the root. Returns Ok with the account that signed the extrinsic, None if it was root, or an Err otherwise.
• extrinsics_data_root
  Compute the trie root of a list of extrinsics.
• extrinsics_root
  Compute the trie root of a list of extrinsics.
• split_inner
  Split an option into two constituent options, as defined by a splitter function.
• unique
  Returns a 32 byte datum which is guaranteed to be universally unique. entropy is provided as a facility to reduce the potential for precalculating results.

Type Definitions

• Account
  The full account information for a particular account ID.
• BlockHash
  Map of block numbers to block hashes.
• ConsumedWeight
  An object to track the currently used extrinsic weight in a block.
• Key
• KeyValue
• LastRuntimeUpgrade
  Stores the spec_version and spec_name of when the last runtime upgrade happened.
• ModuleDeprecated
  Type alias to Pallet, to be used by construct_runtime.
• Origin
  Exposed trait-generic origin type.
• RefCount
  Type used to encode the number of references an account has.