Merge pull request #12 from balancer-labs/tritium/gov-process

Updated Gov Process and more changes to multisig section.

docs/concepts/governance/README.md

@@ -5,7 +5,7 @@ title: Overview
 
 # Governance
 
-Various components of Balancer Governance are described in brief below.
+Various components of Balancer Governance are described in brief below.  Click on the headings for more details on each topic.
 
 ## [veBAL](./veBAL)
 
@@ -19,10 +19,19 @@ The BAL token is the primary component of veBAL. Due to the fact that veBAL allo
 
 Balancer Governors have the power to enable and modify Governable Protocol Fees. These can be collected from trading fees and flash loan fees and stored in the Vault. The Governors themselves also get to decide what becomes of these fees, and how to best spend them to support the health and progress of the protocol.
 
+## [Governance Process](./process.md)
+
+Changes to the Balancer Protocol and allocations of community funds are made through a governance process, which includes:  A proposal, a prepaird transaction payload for onchain execution via gnosis-safe, and a snapshot vote validating the proposal with a quorum that currently stands at at least 2 million veBAL voting.
+
+
 ## [Snapshot](./snapshot)
 
 Snapshot, a spinoff of Balancer, is an off-chain gasless multi-governance client with easy to verify and hard to contest results. Balancer Governance Votes take place on Snapshot.
 
 ## [Multisig](./multisig)
 
 To enact the off-chain votes on Snapshot, Balancer Protocol uses a Multisig to solidify these changes on-chain. Balancer’s Multisig signers are a diverse set of widely respected community members. The multisig does NOT have decision making power, as its role is to simply enact on-chain the decisions BAL holders make via off-chain voting.
+
+## [Emergency subDAO](./emergency)
+
+In order to protect veBAL from bad actors by killing gauges and pool factories, the emergency subdao was established with bounded authority to manage the protocol.

docs/concepts/governance/bal-token.md

@@ -6,12 +6,12 @@ order: 1
 
 ## Overview
 
-Balancer Governance Token \(BAL\) is the core token behind the Balancer protocol. Alignment between governance token holders and protocol stakeholders is crucial for successful decentralized governance, and BAL tokens are the vehicle to drive this alignment. [veBAL](/concepts/governance/vebal/) is an extension of BAL and is used for voting in decentralized governance.
+Balancer Governance Token \(BAL\) is the core token behind the Balancer protocol. Alignment between governance token holders and protocol stakeholders is crucial for successful decentralized governance, and BAL tokens are the vehicle to drive this alignment. [veBAL](./veBAL) is an extension of BAL and is used for voting in decentralized governance.
 
 ## Contract Address
 
 | Network  | BAL Token Address                                                                                                                                              |
-| :------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+|:---------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Ethereum | <span class="address-link">[0xba100000625a3754423978a60c9317c58a424e3d](https://etherscan.io/address/0xba100000625a3754423978a60c9317c58a424e3d)</span>        |
 | Polygon  | <span class="address-link">[0x9a71012b13ca4d3d0cdc72a177df3ef03b0e76a3](https://polygonscan.com/address/0x9a71012b13ca4d3d0cdc72a177df3ef03b0e76a3)</span>     |
 | Arbitrum | <span class="address-link">[0x040d1EdC9569d4Bab2D15287Dc5A4F10F56a56B8](https://arbiscan.io/address/0x040d1EdC9569d4Bab2D15287Dc5A4F10F56a56B8)</span>         |
@@ -100,13 +100,13 @@ This results in the following emissions schedule:
 
 This chart outlines the allocation amounts. More details below.
 
-| BAL Recipient/Fund                                                                                                                                                     | Original Allocation | State as of Feb 2023                         |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | -------------------------------------------- |
-| Community                                                                                                                                                              | 65M                 | 6M remain                                    |
-| Liquidity Providers(veBAL) - [allocated by community](https://snapshot.org/#/balancer.eth/proposal/0xc93aa02ea7153a53d124189567ba19aa28663c499cdbfa60fe9bf35bf574d2a7) | N/A                 | 47.5M From community fund allocated to veBAL |
-| Founders, Options, Advisors, Investors                                                                                                                                 | 25M                 | No Information Available                     |
-| Ecosystem Fund                                                                                                                                                         | 5M                  | Merged into Community Fund                   |
-| Fundraising Fund                                                                                                                                                       | 5M                  | Merged into Community Fund                   |
+| BAL Recipient/Fund                                                                                                                                                     | Original Allocation | State as of Feb 2023                          |
+|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------|:----------------------------------------------|
+| Community                                                                                                                                                              | 65M                 | 6M remain                                     |
+| Liquidity Providers(veBAL) - [allocated by community](https://snapshot.org/#/balancer.eth/proposal/0xc93aa02ea7153a53d124189567ba19aa28663c499cdbfa60fe9bf35bf574d2a7) | N/A                 | 47.5M From community fund allocated to veBAL  |
+| Founders, Options, Advisors, Investors                                                                                                                                 | 25M                 | No Information Available                      |
+| Ecosystem Fund                                                                                                                                                         | 5M                  | Merged into Community Fund                    |
+| Fundraising Fund                                                                                                                                                       | 5M                  | Merged into Community Fund                    |
 
 ::: chart BAL Token Distribution
 
@@ -160,8 +160,7 @@ Emissions to liquidty providers are decided by a combination of the emissions sc
 
 Note that as part of the veBAL conversion, the entire ecosystem fund was transferred into the [DAO multisig](https://etherscan.io/address/0x10A19e7eE7d7F8a52822f6817de8ea18204F2e4f)
 
-There are currently over 5 million BAL in community control. Additionally, at the time of ths writing some additional BAL
-is staked on Aave on Polygon. All community BAL is held in the DAO Multisig of the chain which they reside.
+There are currently over 5 million BAL in community control. Additionally, at the time of ths writing some additional BAL is staked on Aave on Polygon. All community BAL is held in the DAO Multisig of the chain which they reside.
 
 Original Ecosystem Fund: <span class="address-link">[0xb618F903ad1d00d6F7b92f5b0954DcdC056fC533](https://etherscan.io/address/0xb618F903ad1d00d6F7b92f5b0954DcdC056fC533)</span>
 

docs/concepts/governance/emergency.md

@@ -0,0 +1,45 @@
+# Emergency subDAO
+
+## Concept
+The [Emergency DAO](https://dao.curve.fi/emergencymembers) is an idea pioneered by Curve that empowers a small group to “kill” pools and gauges in the event of malicious activity and/or potential loss of funds. The Balancer emergency subDAO was established after the following [vote](https://vote.balancer.fi/#/proposal/0x63fab7ab9ef5b9579dabb82058b8ea309e39c766d435438b55fff8db7c1f69fd).
+
+## Members
+aThe Balancer Emergency subDAO is a 4-of-7 multisig with the following members as appointed by [this vote](https://forum.balancer.fi/t/form-the-emergency-subdao/3197):
+
+| Person     | Address                                       |
+|:-----------|:----------------------------------------------|
+| Solarcurve | `0x512fce9B07Ce64590849115EE6B32fd40eC0f5F3`  |     
+| Mike B     | `0xF01Cc7154e255D20489E091a5aEA10Bc136696a8`  |
+| Zekraken   | `0xafFC70b81D54F229A5F50ec07e2c76D2AAAD07Ae`  |
+| Zen Dragon | `0x7c2eA10D3e5922ba3bBBafa39Dc0677353D2AF17`  |
+| Markus     | `0x6bB4720473d4D7133f944785e5EE1A650C07f34e`  | 
+| Fernando   | `0xbbF0Ae5195444264364CA7eb7E3BB1971B4c3eCb`  |
+| Nico       | `0x815d654E930E840D0E0Ee1B18FFc8Fb4ddA4c6B3`  |
+
+## Multisigs
+The Balancer Emergency subDAO operates through the following multsigs which are authorized to kill gauges.
+
+| Gauge    | Address                                      |
+|:---------|:---------------------------------------------|
+| Ethereum | `0xA29F61256e948F3FB707b4b3B138C5cCb9EF9888` |
+| Polygon  | `0x3c58668054c299bE836a0bBB028Bee3aD4724846` |
+| Arbitrum | `0xf404C5a0c02397f0908A3524fc5eb84e68Bbe60D` |
+| Optimism | `0xd4c87b33afcE39F1E3F4aF1ce8fFFF7241d9128B` |
+
+## Specifications
+As per [this vote](https://forum.balancer.fi/t/form-the-emergency-subdao/3197)   
+
+| Call            | Contract(s)                                                                                      | Purpose                                                                                  |
+|:----------------|:-------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------|
+| killGauge       | Gauge contracts                                                                                  | To stop all distribution of BAL to a gauge.                                              | 
+| denylistToken   | [ProtocolFeeWithdrawer](https://etherscan.io/address/0x5ef4c5352882b10893b70DbcaA0C000965bd23c5) | Instructs the ProtocolFeeWithdrawer to blacklist fee collection of a specific token.     |
+
+As per [BIP-139](https://forum.balancer.fi/t/bip-139-update-emergency-subdao-permissions/4174)
+The Emergency DAO Multsigis are authorized to make the following calls to protocol contracts:
+
+| Call               | Contract(s)            | Purpose                                                                                                                               |
+|:-------------------|:-----------------------|:--------------------------------------------------------------------------------------------------------------------------------------|
+| enableRecoveryMode | Pool contracts         | for Pools to provide a simple way to exit pools proportionally at the cost of disabling protocol fees(swaps, joins, etc. still work). |
+| disable            | Pool factory contracts | to shutdown pool factories. This is to prevent further pools from being created, existing pools remain unaffected.                    |
+
+