Release

Polkadot SDK Stable 2412

lib.rs:

Safe Mode

Trigger for stopping all extrinsics outside of a specific whitelist.

Pallet API

See the pallet module for more information about the interfaces this pallet exposes, including its configuration trait, dispatchables, storage items, events, and errors.

Overview

Safe mode is entered via two paths (deposit or forced) until a set block number. The mode is exited when the block number is reached or a call to one of the exit extrinsics is made. A WhitelistedCalls configuration item contains all calls that can be executed while in safe mode.

Primary Features

• Entering safe mode can be via privileged origin or anyone who places a deposit.
• Origin configuration items are separated for privileged entering and exiting safe mode.
• A configurable duration sets the number of blocks after which the system will exit safe mode.
• Safe mode may be extended beyond the configured exit by additional calls.

Example

Configuration of call filters:

impl frame_system::Config for Runtime {
  // …
  type BaseCallFilter = InsideBoth<DefaultFilter, SafeMode>;
  // …
}

Entering safe mode with deposit:

Entering safe mode via privileged origin:

Exiting safe mode via privileged origin:

Low Level / Implementation Details

Use Cost

A storage value (EnteredUntil) is used to store the block safe mode will be exited on. Using the call filter will require a db read of that storage on the first extrinsic. The storage will be added to the overlay and incur low cost for all additional calls.