Network Halts

Interfaces should provide more feedback to the user what specifically is paused.

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.

Chain Halt Types

The three primary chain-level halts node operators use:

Chain-Specific Halts (Detailed)

1. Signing Halt - Allows inbound transactions but stops the signing of outbound transactions. Outbound transactions are queued. This is the least impactful halt.
   • Mimir setting: HALTSIGNING<CHAIN>, e.g., HALTSIGNINGETH
2. Liquidity Provider Pause - Addition and withdrawal of liquidity are suspended but swaps and other transactions are processed.
   • Mimir setting: PAUSELP<CHAIN>, e.g., PAUSELPBCH for BCH
3. 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.
   • Mimir setting: HALT<CHAIN>TRADING, e.g., HALTBCHTRADING for BCH
4. Chain Halt - Serious halt where transactions on that chain are no longer observed and THORNodes will not be synced to the chain tip, usually with their Bifrost offline. Resumption will require a majority of nodes syncing to the tip before trading can commence.
   • Mimir setting: HALT<CHAIN>CHAIN, e.g., HALTBCHCHAIN for BCH
5. Pool Deposit Pause - Suspends deposits into a specific Liquidity Pool.
   • Mimir setting: PAUSELPDEPOSIT-<ASSET>, e.g., PAUSELPDEPOSIT-BTC-BTC for BTC pool
6. Streaming Swap Pause - Pauses streaming swaps, affecting user slip protection.
   • Mimir setting: StreamingSwapPause

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.
• Global Chain Halt HaltChainGlobal = 1 Halts all external chains simultaneously. Single key that causes IsChainHalted() to return true for any chain. Does not set individual chain halt keys.

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.

Secured Asset Halt Management

1. Global Secured Asset Halt - Disables deposits and withdrawals of all secured assets across base and App Layers.
   1. Mimir setting is HaltSecuredGlobal, set to 1 to disable all operations.
2. Specific Secured Asset Deposit Halt - Disables deposits of secured assets in base and App Layer for the specified chain.
   1. Mimir setting is HaltSecuredDeposit-<CHAIN>, e.g., HaltSecuredDeposit-ETH = 1 disabled deposits for ETH-ETH and all ERC20 secured assets.
3. Specific Secured Asset Withdrawal Halt - Same as HaltSecuredDeposit-<CHAIN> except for Secured Asset Withdrawal.
   1. Mimir setting is HaltSecuredWithdraw-<CHAIN>, e.g., HaltSecuredWithdraw-ETH = 1 disables withdrawals for ETH-ETH and all ERC20 secured assets.

Smart Contract Halt Management

Smart contract halts control CosmWasm contract execution in the App Layer. These halts pause specific or all contract activities during vulnerabilities. Ordered by scope:

1. Global Smart Contract Halt - Disables all CosmWasm contract executions.
   • Mimir setting: HaltWasmGlobal, set to 1 to disable; 0 to enable.
2. Deployer Halt - Disables all contracts deployed by a specific address (last 6 characters).
   • Mimir setting: HaltWasmDeployer-<SUFFIX>, e.g., HaltWasmDeployer-abc123
3. Contract Code Halt - Disables all instances of a contract by its code checksum.
   • Mimir setting: HaltWasmCs-<CHECKSUM>, e.g., HaltWasmCs-4UMPB3...
4. Specific Contract Halt - Disables a single contract instance by address suffix (last 6 characters).
   • Mimir setting: HaltWasmContract-<SUFFIX>, e.g., HaltWasmContract-w58u9f

Oracle

• HaltOracle: Disables oracle price feeds used by smart contracts for lending and perps.

TCY Management

Claiming and Staking of $TCY can be enabled and disabled using flags.

• HaltTCYTrading: Halts all TCY trading/swaps.
• TCYClaimingSwapHalt: Disables RUNE-to-TCY swaps in the claiming module (default: 1, halted).
• TCYStakeDistributionHalt: Disables distribution of RUNE revenue to TCY stakers (default: 1, halted).
• TCYStakingHalt: Disables staking of TCY tokens (default: 1, halted).
• TCYUnstakingHalt: Disables unstaking of TCY tokens (default: 1, halted).
• TCYClaimingHalt: Disables claiming of TCY tokens for THORFi deposits (default: 1, halted).

Trade Accounts

Trade Accounts Pause TradeAccountsEnabled = 1 - Adding to and withdrawing from the Trade Account is enabled.

RUNEPool Halts

• RUNEPoolHaltDeposit: Disables RUNEPool deposits.
• RUNEPoolHaltWithdraw: Disables RUNEPool withdrawals.

Memoless Transactions

Memoless Halt HaltMemoless = 1 - Emergency halt that disables all memoless transaction functionality, including both registration of new reference memos and usage of existing ones. When enabled, transactions using reference memos will be rejected.

Node Operator Halts

These halts affect node operations rather than trading:

• PauseBond: Disables bonding.
• PauseUnbond: Disables unbonding.
• HaltRebond: Halts rebond operations.
• HaltOperatorRotate: Halts operator rotation during churn.

Monitoring Mimir Keys

curl https://thornode.thorchain.org/thorchain/mimir

• Integration: App Layer interfaces must poll Mimir settings to detect halts and adjust functionality
• Alerts: Subscribe to Dev Discord #interface-alerts channel for updates

Quick Reference Table

Chain Halts

Global Halts

Secured Assets

Smart Contracts (CosmWasm)

TCY

RUNEPool

Trade Accounts & Memoless

Node Operator