Skip to content

Commit fe18c1f

Browse files
authored
safe-mode & tx-pause integration (#720)
* `safe-mode` & `tx-pause` concepts explained * safe-mode & tx-pause extrinsics added to technical committee * extra spaces removed * all technical committee to exit safe mode on Astar * Astar parameters TBD
1 parent fba6584 commit fe18c1f

File tree

2 files changed

+33
-1
lines changed

2 files changed

+33
-1
lines changed

docs/learn/governance/index.md

+31-1
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ To avoid duplicating the [official Polkadot Gov v1 documentation](https://wiki.p
6262
* The `Main Council` can **cancel** an ongoing referendum if it considers it harmful. This is an _emergency_ action only.
6363
* The `Technical Committee` can **fast-track** an external proposal in case of an emergency situation. This allows instant upgrade of the proposal into a referendum, and setting of the voting & enactment period to arbitrarily short durations.
6464
* The `Technical Committee` can **cancel** a public proposal if it considers it to be harmful for the network.
65-
* Any `Technical Committee` can **vet** an external proposal made by the `Main Council`, postponing it temporarily.
65+
* Any `Technical Committee` can **veto** an external proposal made by the `Main Council`, postponing it temporarily.
6666

6767
## Actors
6868

@@ -98,6 +98,10 @@ The `Technical Committee` can:
9898
* instant fast tracking requires unanimous agreement, and allows setting of the voting & enactment period to arbitrarily short periods (for emergency situations)
9999
* cancel a public proposal (not a referendum!) in case the committee considers it harmful, requires 2/3 majority agreement
100100
* enable or disable _maintenance_ mode on the **dApp staking** pallet, requires 2/3 majority agreement
101+
* enable or disable emergency maintenance functions on the Astar Network, requiring 2/3 majority agreement, such as
102+
* the _maintenance_ mode on the **dApp staking**, or
103+
* pausing/unpausing specific compromised transactions, or
104+
* entering/exiting **Safe Mode** for the entire chain.
101105

102106
Any `Technical Committee` **member** can **veto** an external proposal made by the `Main Council`.
103107

@@ -240,3 +244,29 @@ These parameters are related to the _dApp staking_ logic.
240244
| dApp Register Origin | 1/2 Community Council | 2/3 Community Council |
241245
| dApp Unregister Origin | 4/5 Community Council | 4/5 Community Council |
242246
| Community Council Staking Operations | 1/2 Community Council | 2/3 Community Council |
247+
248+
### Emergency Maintenance Pallets
249+
250+
#### Safe Mode
251+
252+
The **SafeMode** pallet introduces an emergency STOP mechanism for the chain, restricting operations to a predefined set of permitted calls (only system calls). This mechanism is especially useful during chain anomalies or attacks. The `Technical Committee` can force-enter or exit _Safe Mode_. The _dApp staking_ maintenance mode is triggered when entering/exiting **Safe Mode**.
253+
254+
These parameters are related to the _Safe Mode_ logic.
255+
256+
| Parameter Name | Shibuya | Astar |
257+
| --------------------------------------- | ------------------------ | ------------------------ |
258+
| Enter Duration | 4 hours | TBD |
259+
| Extend Duration | 2 hours | TBD |
260+
| Force Enter Origin | 1/2 Technical Committee | TBD |
261+
| Force Exit Origin | 2/3 Technical Committee | TBD |
262+
263+
#### Tx Pause
264+
265+
The **TxPause** pallet provides the ability to pause specific transaction calls dynamically. This feature is useful for mitigating issues with specific modules or calls without halting the entire chain. The `Technical Committee` can pause and resume individual calls dynamically as needed.
266+
267+
These parameters are related to the _Tx Pause_ logic.
268+
269+
| Parameter Name | Shibuya | Astar |
270+
| --------------------------------------- | ------------------------ | ------------------------ |
271+
| Pause Origin | 1/2 Technical Committee | TBD |
272+
| Unpause Origin | 1/2 Technical Committee | TBD |

docs/learn/governance/technical_guide.md

+2
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,8 @@ The _pallet-collective-proxy_ is a special pallet that allows calls to be made o
6565
* `Democracy->cancelProposal` - cancels a public proposal
6666
* `Democracy->vetoExternal` - vetoes an external proposal
6767
* `DappStaking->maintenanceMode` - enable or disable maintenance mode
68+
* `SafeMode->forceEnter/forceExit` - enables/disables **Safe Mode** for the chain
69+
* `TxPause->pause/unpause` - pauses/unpauses specific transactions
6870

6971
### Community Council
7072

0 commit comments

Comments
 (0)