Skip to content
This repository has been archived by the owner on Oct 8, 2024. It is now read-only.

Latest commit

 

History

History
38 lines (27 loc) · 1.6 KB

README.md

File metadata and controls

38 lines (27 loc) · 1.6 KB
Raw

ESM

Build Status

Emergency Shutdown Module

Description

The ESM is a contract with the ability to call end.cage(), i.e. trigger an Emergency Shutdown (aka Global Settlement).

MKR holders join their funds, which are then immediately burnt. When the ESM's internal sum balance is equal to or greater than the min threshold, the ESM can be fired.

It is meant to be used by an MKR minority to thwart two types of attack:

  • malicious governance (if an address to de-authorize is supplied in the constructor)
  • critical bug

In the former case, the pledgers will have no expectation of recovering the funds (as that would require a malicious majority to pass the required vote), and their only option is to set up an alternative fork in which the majority's funds are slashed. An ESM configured to protect against malicious governance can also be used to protect against most critical bugs, unless there is a bug in the shutdown process that requires governance intervention to work around.

In the latter case, governance can choose to refund the ESM pledgers by minting new tokens.

If governance wants to disarm the ESM, it can do so by removing all of it's authorizations in the system and then by by calling cage() on this contract.

Invariants

  • fire can be called by anyone
  • fire can be called only once (enforced by end module)
  • fire requires sum to be >= min
  • join can only be called before fire (enforced by end module)
  • gems are burnt using the extra function burn after joining