16 major breaking releases

19.0.0 Sep 26, 2024
18.0.0 Jul 18, 2024
17.0.0 Jul 12, 2024
16.0.0 Jun 24, 2024
0.0.0 Aug 31, 2023

#12 in #pause

Download history 2/week @ 2024-07-02 102/week @ 2024-07-09 116/week @ 2024-07-16 11/week @ 2024-07-23 11/week @ 2024-07-30 32/week @ 2024-08-06 66/week @ 2024-08-20 39/week @ 2024-08-27 22/week @ 2024-09-03 70/week @ 2024-09-10 102/week @ 2024-09-17 239/week @ 2024-09-24 158/week @ 2024-10-01 151/week @ 2024-10-08 100/week @ 2024-10-15

681 downloads per month
Used in polkadot-sdk

Apache-2.0

2MB
38K SLoC

Release

Polkadot SDK stable2409


lib.rs:

Transaction Pause

Allows dynamic, chain-state-based pausing and unpausing of specific extrinsics via call filters.

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

A dynamic call filter that can be controlled with extrinsics.

Pausing an extrinsic means that the extrinsic CANNOT be called again until it is unpaused. The exception is calls that use dispatch_bypass_filter, typically only with the root origin.

Primary Features

  • Calls that should never be paused can be added to a whitelist.
  • Separate origins are configurable for pausing and pausing.
  • Pausing is triggered using the string representation of the call.
  • Pauses can target a single extrinsic or an entire pallet.
  • Pauses can target future extrinsics or pallets.

Example

Configuration of call filters:

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

Pause specific all:

Unpause specific all:

Pause all calls in a pallet:

Low Level / Implementation Details

Use Cost

A storage map (PausedCalls) is used to store currently paused calls. Using the call filter will require a db read of that storage on each extrinsic.

Dependencies

~18–33MB
~551K SLoC