Struct polkadot_sdk_frame::prelude::frame_system::Pallet
pub struct Pallet<T>(/* private fields */);
Expand description
The Pallet
struct, the main type that implements traits and standalone
functions within the pallet.
Implementations§
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn remark(
_origin: <T as Config>::RuntimeOrigin,
remark: Vec<u8>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn remark( _origin: <T as Config>::RuntimeOrigin, remark: Vec<u8>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Make some on-chain remark.
Can be executed by every origin
.
pub fn set_heap_pages(
origin: <T as Config>::RuntimeOrigin,
pages: u64,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn set_heap_pages( origin: <T as Config>::RuntimeOrigin, pages: u64, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Set the number of pages in the WebAssembly environment’s heap.
pub fn set_code(
origin: <T as Config>::RuntimeOrigin,
code: Vec<u8>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn set_code( origin: <T as Config>::RuntimeOrigin, code: Vec<u8>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Set the new runtime code.
pub fn set_code_without_checks(
origin: <T as Config>::RuntimeOrigin,
code: Vec<u8>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn set_code_without_checks( origin: <T as Config>::RuntimeOrigin, code: Vec<u8>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Set the new runtime code without doing any checks of the given code
.
Note that runtime upgrades will not run if this is called with a not-increasing spec version!
pub fn set_storage(
origin: <T as Config>::RuntimeOrigin,
items: Vec<(Vec<u8>, Vec<u8>)>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn set_storage( origin: <T as Config>::RuntimeOrigin, items: Vec<(Vec<u8>, Vec<u8>)>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Set some items of storage.
pub fn kill_storage(
origin: <T as Config>::RuntimeOrigin,
keys: Vec<Vec<u8>>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn kill_storage( origin: <T as Config>::RuntimeOrigin, keys: Vec<Vec<u8>>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Kill some items from storage.
pub fn kill_prefix(
origin: <T as Config>::RuntimeOrigin,
prefix: Vec<u8>,
subkeys: u32,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn kill_prefix( origin: <T as Config>::RuntimeOrigin, prefix: Vec<u8>, subkeys: u32, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
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.
pub fn remark_with_event(
origin: <T as Config>::RuntimeOrigin,
remark: Vec<u8>,
) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
pub fn remark_with_event( origin: <T as Config>::RuntimeOrigin, remark: Vec<u8>, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Make some on-chain remark and emit event.
pub fn do_task( _origin: <T as Config>::RuntimeOrigin, task: <T as Config>::RuntimeTask, ) -> Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>
Authorize an upgrade to a given code_hash
for the runtime. The runtime can be supplied
later.
This call requires Root origin.
Authorize an upgrade to a given code_hash
for the runtime. The runtime can be supplied
later.
WARNING: This authorizes an upgrade that will take place without any safety checks, for
example that the spec name remains the same and that the version number increases. Not
recommended for normal use. Use authorize_upgrade
instead.
This call requires Root origin.
Provide the preimage (runtime binary) code
for an upgrade that has been authorized.
If the authorization required a version check, this call will ensure the spec name remains unchanged and that the spec version has increased.
Depending on the runtime’s OnSetCode
configuration, this function may directly apply
the new code
in the same block or attempt to schedule the upgrade.
All origins are allowed.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn account<KArg>(
k: KArg,
) -> AccountInfo<<T as Config>::Nonce, <T as Config>::AccountData>
pub fn account<KArg>( k: KArg, ) -> AccountInfo<<T as Config>::Nonce, <T as Config>::AccountData>
An auto-generated getter for Account
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn block_weight() -> PerDispatchClass<Weight>
pub fn block_weight() -> PerDispatchClass<Weight>
An auto-generated getter for BlockWeight
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn extrinsic_data<KArg>(k: KArg) -> Vec<u8> ⓘwhere
KArg: EncodeLike<u32>,
pub fn extrinsic_data<KArg>(k: KArg) -> Vec<u8> ⓘwhere
KArg: EncodeLike<u32>,
An auto-generated getter for ExtrinsicData
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn block_number() -> <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number
pub fn block_number() -> <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number
An auto-generated getter for Number
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn parent_hash() -> <T as Config>::Hash
pub fn parent_hash() -> <T as Config>::Hash
An auto-generated getter for ParentHash
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn event_count() -> u32
pub fn event_count() -> u32
An auto-generated getter for EventCount
.
§impl<T> Pallet<T>where
T: Config,
impl<T> Pallet<T>where
T: Config,
pub fn last_runtime_upgrade_spec_version() -> u32
pub fn last_runtime_upgrade_spec_version() -> u32
Returns the spec_version
of the last runtime upgrade.
This function is useful for writing guarded runtime migrations in the runtime. A runtime
migration can use the spec_version
to ensure that it isn’t applied twice. This works
similar as the storage version for pallets.
This functions returns the spec_version
of the last runtime upgrade while executing the
runtime migrations
on_runtime_upgrade
function. After all migrations are executed, this will return the spec_version
of the
current runtime until there is another runtime upgrade.
Example:
#[test]
fn last_runtime_upgrade_spec_version_usage() {
#[allow(dead_code)]
struct Migration;
impl OnRuntimeUpgrade for Migration {
fn on_runtime_upgrade() -> Weight {
// Ensure to compare the spec version against some static version to prevent applying
// the same migration multiple times.
//
// `1337` here is the spec version of the runtime running on chain. If there is maybe
// a runtime upgrade in the pipeline of being applied, you should use the spec version
// of this upgrade.
if System::last_runtime_upgrade_spec_version() > 1337 {
return Weight::zero()
}
// Do the migration.
Weight::zero()
}
}
}
pub fn account_exists(who: &<T as Config>::AccountId) -> bool
pub fn account_exists(who: &<T as Config>::AccountId) -> bool
Returns true if the given account exists.
pub fn update_code_in_storage(code: &[u8])
pub fn update_code_in_storage(code: &[u8])
Write code to the storage and emit related events and digest items.
Note this function almost never should be used directly. It is exposed
for OnSetCode
implementations that defer actual code being written to
the storage (for instance in case of parachains).
pub fn inherents_applied() -> bool
pub fn inherents_applied() -> bool
Whether all inherents have been applied.
pub fn note_inherents_applied()
pub fn note_inherents_applied()
Note that all inherents have been applied.
Should be called immediately after all inherents have been applied. Must be called at least once per block.
pub fn inc_ref(who: &<T as Config>::AccountId)
👎Deprecated: Use inc_consumers
instead
pub fn inc_ref(who: &<T as Config>::AccountId)
inc_consumers
insteadIncrement the reference counter on an account.
pub fn dec_ref(who: &<T as Config>::AccountId)
👎Deprecated: Use dec_consumers
instead
pub fn dec_ref(who: &<T as Config>::AccountId)
dec_consumers
insteadDecrement 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 as Config>::AccountId) -> u32
👎Deprecated: Use consumers
instead
pub fn refs(who: &<T as Config>::AccountId) -> u32
consumers
insteadThe number of outstanding references for the account who
.
pub fn allow_death(who: &<T as Config>::AccountId) -> bool
👎Deprecated: Use !is_provider_required
instead
pub fn allow_death(who: &<T as Config>::AccountId) -> bool
!is_provider_required
insteadTrue if the account has no outstanding references.
pub fn inc_providers(who: &<T as Config>::AccountId) -> IncRefStatus
pub fn inc_providers(who: &<T as Config>::AccountId) -> IncRefStatus
Increment the provider reference counter on an account.
pub fn dec_providers(
who: &<T as Config>::AccountId,
) -> Result<DecRefStatus, DispatchError>
pub fn dec_providers( who: &<T as Config>::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 as Config>::AccountId) -> IncRefStatus
pub fn inc_sufficients(who: &<T as Config>::AccountId) -> IncRefStatus
Increment the self-sufficient reference counter on an account.
pub fn dec_sufficients(who: &<T as Config>::AccountId) -> DecRefStatus
pub fn dec_sufficients(who: &<T as Config>::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 as Config>::AccountId) -> u32
pub fn providers(who: &<T as Config>::AccountId) -> u32
The number of outstanding provider references for the account who
.
pub fn sufficients(who: &<T as Config>::AccountId) -> u32
pub fn sufficients(who: &<T as Config>::AccountId) -> u32
The number of outstanding sufficient references for the account who
.
pub fn reference_count(who: &<T as Config>::AccountId) -> u32
pub fn reference_count(who: &<T as Config>::AccountId) -> u32
The number of outstanding provider and sufficient references for the account who
.
pub fn inc_consumers(
who: &<T as Config>::AccountId,
) -> Result<(), DispatchError>
pub fn inc_consumers( who: &<T as Config>::AccountId, ) -> Result<(), DispatchError>
Increment the reference counter on an account.
The account who
’s providers
must be non-zero and the current number of consumers must
be less than MaxConsumers::max_consumers()
or this will return an error.
pub fn inc_consumers_without_limit(
who: &<T as Config>::AccountId,
) -> Result<(), DispatchError>
pub fn inc_consumers_without_limit( who: &<T as Config>::AccountId, ) -> Result<(), DispatchError>
Increment the reference counter on an account, ignoring the MaxConsumers
limits.
The account who
’s providers
must be non-zero or this will return an error.
pub fn dec_consumers(who: &<T as Config>::AccountId)
pub fn dec_consumers(who: &<T as Config>::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 as Config>::AccountId) -> u32
pub fn consumers(who: &<T as Config>::AccountId) -> u32
The number of outstanding references for the account who
.
pub fn is_provider_required(who: &<T as Config>::AccountId) -> bool
pub fn is_provider_required(who: &<T as Config>::AccountId) -> bool
True if the account has some outstanding consumer references.
pub fn can_dec_provider(who: &<T as Config>::AccountId) -> bool
pub fn can_dec_provider(who: &<T as Config>::AccountId) -> bool
True if the account has no outstanding consumer references or more than one provider.
pub fn can_accrue_consumers(who: &<T as Config>::AccountId, amount: u32) -> bool
pub fn can_accrue_consumers(who: &<T as Config>::AccountId, amount: u32) -> bool
True if the account has at least one provider reference and adding amount
consumer
references would not take it above the the maximum.
pub fn can_inc_consumer(who: &<T as Config>::AccountId) -> bool
pub fn can_inc_consumer(who: &<T as Config>::AccountId) -> bool
True if the account has at least one provider reference and fewer consumer references than the maximum.
pub fn deposit_event(event: impl Into<<T as Config>::RuntimeEvent>)
pub fn deposit_event(event: impl Into<<T as Config>::RuntimeEvent>)
Deposits an event into this block’s event record.
NOTE: Events not registered at the genesis block and quietly omitted.
pub fn deposit_event_indexed(
topics: &[<T as Config>::Hash],
event: <T as Config>::RuntimeEvent,
)
pub fn deposit_event_indexed( topics: &[<T as Config>::Hash], event: <T as Config>::RuntimeEvent, )
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.
NOTE: Events not registered at the genesis block and quietly omitted.
pub fn extrinsic_index() -> Option<u32>
pub fn extrinsic_index() -> Option<u32>
Gets the index of extrinsic that is currently executing.
pub fn extrinsic_count() -> u32
pub fn extrinsic_count() -> u32
Gets extrinsics count.
pub fn all_extrinsics_len() -> u32
pub fn register_extra_weight_unchecked(weight: Weight, class: DispatchClass)
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 as Config>::Block as HeaderProvider>::HeaderT as Header>::Number,
parent_hash: &<T as Config>::Hash,
digest: &Digest,
)
pub fn initialize( number: &<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, parent_hash: &<T as Config>::Hash, digest: &Digest, )
Start the execution of a particular block.
pub fn finalize() -> <<T as Config>::Block as HeaderProvider>::HeaderT
pub fn finalize() -> <<T as Config>::Block as HeaderProvider>::HeaderT
Remove temporary “environment” entries in storage, compute the storage root and return the resulting header for this block.
pub fn deposit_log(item: DigestItem)
pub fn deposit_log(item: DigestItem)
Deposits a log and ensures it matches the block’s log data.
pub fn externalities() -> TestExternalities<Blake2Hasher>
pub fn externalities() -> TestExternalities<Blake2Hasher>
Get the basic externalities for this pallet, useful for tests.
pub fn events() -> Vec<EventRecord<<T as Config>::RuntimeEvent, <T as Config>::Hash>>
pub fn events() -> Vec<EventRecord<<T as Config>::RuntimeEvent, <T as Config>::Hash>>
Get the current events deposited by the runtime.
NOTE: This should only be used in tests. Reading events from the runtime can have a large impact on the PoV size of a block. Users should use alternative and well bounded storage items for any behavior like this.
NOTE: Events not registered at the genesis block and quietly omitted.
pub fn event_no_consensus(index: usize) -> Option<<T as Config>::RuntimeEvent>
pub fn event_no_consensus(index: usize) -> Option<<T as Config>::RuntimeEvent>
Get a single event at specified index.
Should only be called if you know what you are doing and outside of the runtime block execution else it can have a large impact on the PoV size of a block.
pub fn read_events_no_consensus() -> impl Iterator<Item = Box<EventRecord<<T as Config>::RuntimeEvent, <T as Config>::Hash>>>
pub fn read_events_no_consensus() -> impl Iterator<Item = Box<EventRecord<<T as Config>::RuntimeEvent, <T as Config>::Hash>>>
Get the current events deposited by the runtime.
Should only be called if you know what you are doing and outside of the runtime block execution else it can have a large impact on the PoV size of a block.
pub fn read_events_for_pallet<E>() -> Vec<E>
pub fn read_events_for_pallet<E>() -> Vec<E>
Read and return the events of a specific pallet, as denoted by E
.
This is useful for a pallet that wishes to read only the events it has deposited into
frame_system
using the standard fn deposit_event
.
pub fn set_block_number(
n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number,
)
pub fn set_block_number( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )
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)
pub fn set_extrinsic_index(extrinsic_index: u32)
Sets the index of extrinsic that is currently executing.
pub fn set_parent_hash(n: <T as Config>::Hash)
pub fn set_parent_hash(n: <T as Config>::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)
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()
pub fn reset_events()
Reset events.
This needs to be used in prior calling initialize
for each new block
to clear events from previous block.
pub fn assert_has_event(event: <T as Config>::RuntimeEvent)
pub fn assert_has_event(event: <T as Config>::RuntimeEvent)
Assert the given event
exists.
NOTE: Events not registered at the genesis block and quietly omitted.
pub fn assert_last_event(event: <T as Config>::RuntimeEvent)
pub fn assert_last_event(event: <T as Config>::RuntimeEvent)
Assert the last event equal to the given event
.
NOTE: Events not registered at the genesis block and quietly omitted.
pub fn runtime_version() -> RuntimeVersion
pub fn runtime_version() -> RuntimeVersion
Return the chain’s current runtime version.
pub fn account_nonce(
who: impl EncodeLike<<T as Config>::AccountId>,
) -> <T as Config>::Nonce
pub fn account_nonce( who: impl EncodeLike<<T as Config>::AccountId>, ) -> <T as Config>::Nonce
Retrieve the account transaction counter from storage.
pub fn inc_account_nonce(who: impl EncodeLike<<T as Config>::AccountId>)
pub fn inc_account_nonce(who: impl EncodeLike<<T as Config>::AccountId>)
Increment a particular account’s nonce by 1.
pub fn note_extrinsic(encoded_xt: Vec<u8>)
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: &Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>,
info: DispatchInfo,
)
pub fn note_applied_extrinsic( r: &Result<PostDispatchInfo, DispatchErrorWithPostInfo<PostDispatchInfo>>, info: DispatchInfo, )
To be called immediately after an extrinsic has been applied.
Emits an ExtrinsicSuccess
or ExtrinsicFailed
event depending on the outcome.
The emitted event contains the post-dispatch corrected weight including
the base-weight for its dispatch class.
pub fn note_finished_extrinsics()
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()
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 as Config>::AccountId,
_a: &mut AccountInfo<<T as Config>::Nonce, <T as Config>::AccountData>,
)
pub fn on_created_account( who: <T as Config>::AccountId, _a: &mut AccountInfo<<T as Config>::Nonce, <T as Config>::AccountData>, )
An account is being created.
pub fn can_set_code(code: &[u8]) -> Result<(), DispatchError>
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 instantiating 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.
To be called after any origin/privilege checks. Put the code upgrade authorization into storage and emit an event. Infallible.
Apply an authorized upgrade, performing any validation checks, and remove the authorization.
Whether or not the code is set directly depends on the OnSetCode
configuration of the
runtime.
Check that provided code
can be upgraded to. Namely, check that its hash matches an
existing authorization and that it meets the specification requirements of can_set_code
.
Trait Implementations§
§impl<T> BeforeAllRuntimeMigrations for Pallet<T>where
T: Config,
impl<T> BeforeAllRuntimeMigrations for Pallet<T>where
T: Config,
§fn before_all_runtime_migrations() -> Weight
fn before_all_runtime_migrations() -> Weight
§impl<T> BlockNumberProvider for Pallet<T>where
T: Config,
impl<T> BlockNumberProvider for Pallet<T>where
T: Config,
§type BlockNumber = <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number
type BlockNumber = <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number
BlockNumber
to provide.§fn current_block_number() -> <Pallet<T> as BlockNumberProvider>::BlockNumber
fn current_block_number() -> <Pallet<T> as BlockNumberProvider>::BlockNumber
§impl<T> GetStorageVersion for Pallet<T>where
T: Config,
impl<T> GetStorageVersion for Pallet<T>where
T: Config,
§fn in_code_storage_version() -> <Pallet<T> as GetStorageVersion>::InCodeStorageVersion
fn in_code_storage_version() -> <Pallet<T> as GetStorageVersion>::InCodeStorageVersion
storage_version
attribute, or
NoStorageVersionSet
if the attribute is missing.§fn on_chain_storage_version() -> StorageVersion
fn on_chain_storage_version() -> StorageVersion
§fn current_storage_version() -> Self::InCodeStorageVersion
fn current_storage_version() -> Self::InCodeStorageVersion
in_code_storage_version
and will be removed after March 2024.Self::current_storage_version
instead. Read more§impl<T> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> Hooks<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§fn integrity_test()
fn integrity_test()
§fn on_initialize(_n: BlockNumber) -> Weight
fn on_initialize(_n: BlockNumber) -> Weight
§fn on_finalize(_n: BlockNumber)
fn on_finalize(_n: BlockNumber)
§fn on_idle(_n: BlockNumber, _remaining_weight: Weight) -> Weight
fn on_idle(_n: BlockNumber, _remaining_weight: Weight) -> Weight
Hooks::on_finalize
). Read more§fn on_poll(_n: BlockNumber, _weight: &mut WeightMeter)
fn on_poll(_n: BlockNumber, _weight: &mut WeightMeter)
§fn on_runtime_upgrade() -> Weight
fn on_runtime_upgrade() -> Weight
Executive
pallet. Read more§fn try_state(_n: BlockNumber) -> Result<(), DispatchError>
fn try_state(_n: BlockNumber) -> Result<(), DispatchError>
§fn pre_upgrade() -> Result<Vec<u8>, DispatchError>
fn pre_upgrade() -> Result<Vec<u8>, DispatchError>
§fn post_upgrade(_state: Vec<u8>) -> Result<(), DispatchError>
fn post_upgrade(_state: Vec<u8>) -> Result<(), DispatchError>
§fn offchain_worker(_n: BlockNumber)
fn offchain_worker(_n: BlockNumber)
§impl<T> IntegrityTest for Pallet<T>where
T: Config,
impl<T> IntegrityTest for Pallet<T>where
T: Config,
§fn integrity_test()
fn integrity_test()
§impl<T> OffchainWorker<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> OffchainWorker<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§impl<T> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> OnFinalize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§fn on_finalize(
n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number,
)
fn on_finalize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, )
Hooks::on_finalize
.§impl<T> OnGenesis for Pallet<T>where
T: Config,
impl<T> OnGenesis for Pallet<T>where
T: Config,
§fn on_genesis()
fn on_genesis()
§impl<T> OnIdle<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> OnIdle<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§impl<T> OnInitialize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> OnInitialize<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§fn on_initialize(
n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number,
) -> Weight
fn on_initialize( n: <<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number, ) -> Weight
Hooks::on_initialize
.§impl<T> OnPoll<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> OnPoll<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§impl<T> OnRuntimeUpgrade for Pallet<T>where
T: Config,
impl<T> OnRuntimeUpgrade for Pallet<T>where
T: Config,
§fn on_runtime_upgrade() -> Weight
fn on_runtime_upgrade() -> Weight
§fn pre_upgrade() -> Result<Vec<u8>, DispatchError>
fn pre_upgrade() -> Result<Vec<u8>, DispatchError>
Hooks::pre_upgrade
.§fn post_upgrade(state: Vec<u8>) -> Result<(), DispatchError>
fn post_upgrade(state: Vec<u8>) -> Result<(), DispatchError>
Hooks::post_upgrade
.§impl<T> PalletInfoAccess for Pallet<T>where
T: Config,
impl<T> PalletInfoAccess for Pallet<T>where
T: Config,
§fn module_name() -> &'static str
fn module_name() -> &'static str
§fn crate_version() -> CrateVersion
fn crate_version() -> CrateVersion
§impl<T> PalletsInfoAccess for Pallet<T>where
T: Config,
impl<T> PalletsInfoAccess for Pallet<T>where
T: Config,
§impl<T> StorageInfoTrait for Pallet<T>where
T: Config,
impl<T> StorageInfoTrait for Pallet<T>where
T: Config,
fn storage_info() -> Vec<StorageInfo>
§impl<T> StoredMap<<T as Config>::AccountId, <T as Config>::AccountData> for Pallet<T>where
T: Config,
impl<T> StoredMap<<T as Config>::AccountId, <T as Config>::AccountData> for Pallet<T>where
T: Config,
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 as Config>::AccountId) -> <T as Config>::AccountData
fn get(k: &<T as Config>::AccountId) -> <T as Config>::AccountData
§fn try_mutate_exists<R, E>(
k: &<T as Config>::AccountId,
f: impl FnOnce(&mut Option<<T as Config>::AccountData>) -> Result<R, E>,
) -> Result<R, E>where
E: From<DispatchError>,
fn try_mutate_exists<R, E>(
k: &<T as Config>::AccountId,
f: impl FnOnce(&mut Option<<T as Config>::AccountData>) -> Result<R, E>,
) -> Result<R, E>where
E: From<DispatchError>,
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
.
f
will always be called with an option representing if the storage item exists (Some<V>
)
or if the storage item does not exist (None
), independent of the QueryType
.§impl<T> TryDecodeEntireStorage for Pallet<T>where
T: Config,
impl<T> TryDecodeEntireStorage for Pallet<T>where
T: Config,
§fn try_decode_entire_state() -> Result<usize, Vec<TryDecodeEntireStorageError>>
fn try_decode_entire_state() -> Result<usize, Vec<TryDecodeEntireStorageError>>
Ok(bytes_decoded)
if success.§impl<T> TryState<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
impl<T> TryState<<<<T as Config>::Block as HeaderProvider>::HeaderT as Header>::Number> for Pallet<T>where
T: Config,
§impl<T> ValidateUnsigned for Pallet<T>where
T: Config,
impl<T> ValidateUnsigned for Pallet<T>where
T: Config,
§fn validate_unsigned(
_source: TransactionSource,
call: &<Pallet<T> as ValidateUnsigned>::Call,
) -> Result<ValidTransaction, TransactionValidityError>
fn validate_unsigned( _source: TransactionSource, call: &<Pallet<T> as ValidateUnsigned>::Call, ) -> Result<ValidTransaction, TransactionValidityError>
§impl<T> WhitelistedStorageKeys for Pallet<T>where
T: Config,
impl<T> WhitelistedStorageKeys for Pallet<T>where
T: Config,
§fn whitelisted_storage_keys() -> Vec<TrackedStorageKey>
fn whitelisted_storage_keys() -> Vec<TrackedStorageKey>
Vec<TrackedStorageKey>
indicating the storage keys that
should be whitelisted during benchmarking. This means that those keys
will be excluded from the benchmarking performance calculation.impl<T> Eq for Pallet<T>
Auto Trait Implementations§
impl<T> Freeze for Pallet<T>
impl<T> RefUnwindSafe for Pallet<T>where
T: RefUnwindSafe,
impl<T> Send for Pallet<T>where
T: Send,
impl<T> Sync for Pallet<T>where
T: Sync,
impl<T> Unpin for Pallet<T>where
T: Unpin,
impl<T> UnwindSafe for Pallet<T>where
T: UnwindSafe,
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> CheckedConversion for T
impl<T> CheckedConversion for T
§fn checked_from<T>(t: T) -> Option<Self>where
Self: TryFrom<T>,
fn checked_from<T>(t: T) -> Option<Self>where
Self: TryFrom<T>,
§fn checked_into<T>(self) -> Option<T>where
Self: TryInto<T>,
fn checked_into<T>(self) -> Option<T>where
Self: TryInto<T>,
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)§impl<T> Conv for T
impl<T> Conv for T
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more§impl<Src, Dest> IntoTuple<Dest> for Srcwhere
Dest: FromTuple<Src>,
impl<Src, Dest> IntoTuple<Dest> for Srcwhere
Dest: FromTuple<Src>,
fn into_tuple(self) -> Dest
§impl<T, Outer> IsWrappedBy<Outer> for T
impl<T, Outer> IsWrappedBy<Outer> for T
§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> SaturatedConversion for T
impl<T> SaturatedConversion for T
§fn saturated_from<T>(t: T) -> Selfwhere
Self: UniqueSaturatedFrom<T>,
fn saturated_from<T>(t: T) -> Selfwhere
Self: UniqueSaturatedFrom<T>,
§fn saturated_into<T>(self) -> Twhere
Self: UniqueSaturatedInto<T>,
fn saturated_into<T>(self) -> Twhere
Self: UniqueSaturatedInto<T>,
T
. Read more§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
self
from the equivalent element of its
superset. Read more§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
self
is actually part of its subset T
(and can be converted to it).§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
self.to_subset
but without any property checks. Always succeeds.§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
self
to the equivalent element of its superset.§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T, U> TryIntoKey<U> for Twhere
U: TryFromKey<T>,
impl<T, U> TryIntoKey<U> for Twhere
U: TryFromKey<T>,
type Error = <U as TryFromKey<T>>::Error
fn try_into_key(self) -> Result<U, <U as TryFromKey<T>>::Error>
§impl<S, T> UncheckedInto<T> for Swhere
T: UncheckedFrom<S>,
impl<S, T> UncheckedInto<T> for Swhere
T: UncheckedFrom<S>,
§fn unchecked_into(self) -> T
fn unchecked_into(self) -> T
unchecked_from
.§impl<T, S> UniqueSaturatedInto<T> for S
impl<T, S> UniqueSaturatedInto<T> for S
§fn unique_saturated_into(self) -> T
fn unique_saturated_into(self) -> T
T
.