THORChain Dev Docs
Search…
Interface Management
Interfaces need to monitor and react to keep network paramaters.
There are levels of granularity the network has to control itself and chains in the event of issues. Interfaces need to monitor these settings and apply appropriate controls in their interfaces, inform users and prevent unsupported actions.
All activity is controlled within Mimir and needs to be observed by interfaces and acted upon. Also, see a description of Constants and Mimir.
Halt flags are Boolean. For clarity 0 = false, no issues and > 0 = true (usually 1), halt in effect.

Halt/ Pause Management

Each chain has granular control allowing each chain to be halted or resumed on a specific chain as required. Network-level halting is also possible.
  1. 1.
    Specific Chain Signing Halt - Allows inbound transactions but stops the signing of outbound transactions. Outbound transactions are queued. This is the least impactful halt.
    1. 1.
      Mimir setting is HALTSIGNING[Chain], e.g. HALTSIGNINGBNB
  2. 2.
    Specific Chain Liquidity Provider Pause - addition and withdrawal of liquidity are suspended but swaps and other transactions are processed.
    1. 1.
      Mimir setting is PAUSELP[Chain], e,g, PAUSELPBCHfor BCH
  3. 3.
    Specific Chain Trading Halt - Transactions on external chains are observed but not processed, only refunds are given. THORNode's Bifrost is running, nodes are synced to the tip therefore trading resumption can happen very quickly.
    1. 1.
      Mimir setting is HALT[Chain]TRADING, e,g, HALTBCHTRADINGfor BCH
  4. 4.
    Specific Chain Halt - Serious halt where transitions on that chain are no longer observed and THORNodes will not be synced to the chain tip, usually their Bifrost offline. Resumption will require a majority of nodes syncing to the tip before trading can commence.
    1. 1.
      Mimir setting is HALT[Chain]CHAIN, e,g, HALTBCHCHAIN for BCH.
Chain specific halts do occur and need to be monitored and reacted to when they occur. Users should not be able to send transactions via an interface when a halt is in effect.

Network Level Halts

Network Pause LP PAUSELP = 1 Addition and withdrawal of liquidity are suspended for all pools but swaps and other transactions are processed.
Network Trading Halt HALTTRADING = 1 will stop all trading for every connected chain. The THORChain blockchain will continue and native RUNE transactions will be processed.
There is no Network level chain halt setting as the THORChain Blockchain continually needs to produce blocks.
A chain halt is possible in which case Mimir or Midgard will not return data. This can happen if the chain suffers consensus failure or more than 1/3 of nodes are switched off. If this occurs the Dev Discord Server #interface-alerts will issue alerts.
While very rare, a network level halt is possible and should be monitored for.

Synth Management

Synths minting and redeeming can be enabled and disabled using flags. There is also a Synth mint limit. The setting are:
  • MINTSYNTHS controls minting
  • BURNSYNTHS controls Synth Burning
  • MAXSYNTHPERASSETDEPTH - controls the asset depth limit for each pool

ILP Management

ILP is managed by the integer setting FULLIMPLOSSPROTECTIONBLOCKS. If it = 0, it is disabled.