Skip to content

Commit

Permalink
update constitution and docs with new security council non emergency …
Browse files Browse the repository at this point in the history
…threshold (ArbitrumFoundation#762)

Co-authored-by: dzgoldman <[email protected]>
Co-authored-by: Patrick McCorry <[email protected]>
  • Loading branch information
3 people authored Jul 1, 2024
1 parent 80c98de commit 6f3c532
Show file tree
Hide file tree
Showing 6 changed files with 14 additions and 14 deletions.
10 changes: 5 additions & 5 deletions docs/dao-comprehension-check.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,8 @@ The Security Council shouldn't use its power to perform emergency actions except

- The Arbitrum DAO is able to modify the Security Council's powers or to eliminate the Security Council entirely through the submission, approval and implementation of a <a data-quicklook-from='constitutional-aip'>Constitutional AIP</a>.
- The Arbitrum DAO is able to curtail or eliminate the Security Council's power to perform emergency actions via approval and implementation of a Constitutional AIP.
- The Security Council may also approve and implement routine software upgrades, routine maintenance and other parameter adjustments in a non-emergency setting (such actions are referred to as "non-emergency actions"), which require a 7-of-12 approval in order to take effect.
- Equivalent "copies" of the Security Council multi-sig contracts (7-of-12, in the case of non-emergency actions, and 9-of-12, in the case of emergency actions) exist, one on Ethereum and another on each Arbitrum DAO-governed chain.
- The Security Council may also approve and implement routine software upgrades, routine maintenance and other parameter adjustments in a non-emergency setting (such actions are referred to as "non-emergency actions"), which require a 9-of-12 approval in order to take effect.
- Equivalent "copies" of the Security Council multi-sig contracts (9-of-12, in the case of non-emergency actions, and 9-of-12, in the case of emergency actions) exist, one on Ethereum and another on each Arbitrum DAO-governed chain.
- Any non-emergency action, after approval by the Security Council, will bypass Phases 1 to 3 of the AIP process and instead directly go through Phases 4 to 7 of the AIP process, to provide a delay before any non-emergency action is deployed. The Security Council may optionally specify additional delays before deployment.


Expand All @@ -57,7 +57,7 @@ Note that the Security Council may also approve and implement routine software u

#### What process should be followed to implement this change?

The process for proposing and implementing changes to the Constitution is as described in the Constitution itself. It involves submitting the proposal as an AIP, and then going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority (see: [Constitution](dao-constitution.md)) of votable tokens being voted in favor of the change. Changes to the Constitution must also be ratified by the Security Council with a 7-of-12 approval in order to take effect.
The process for proposing and implementing changes to the Constitution is as described in the Constitution itself. It involves submitting the proposal as an AIP, and then going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority (see: [Constitution](dao-constitution.md)) of votable tokens being voted in favor of the change. Changes to the Constitution must also be ratified by the Security Council with a 9-of-12 approval in order to take effect.


### Scenario 5: You want to become a member of the Security Council
Expand All @@ -70,7 +70,7 @@ The Security Council has 12 members, who are divided into two cohorts of 6 membe

#### What process should be followed to execute this upgrade?

The process for upgrading the Arbitrum One chain involves submitting a proposal as an AIP and going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority (see: [Constitution](dao-constitution.md)) of votable tokens being voted in favor of the change. The upgrade must also be approved by the Security Council with a 7-of-12 approval in order to take effect. The chain owner(s) will then perform the upgrade by updating the contract implementation of any of Arbitrum's core protocol [Transparent Upgradeable Proxy contracts](https://developer.arbitrum.io/useful-addresses), and adjusting system parameters (for example: through `setter` methods in the [ArbOwner precompile](https://github.com/OffchainLabs/nitro/blob/master/contracts/src/precompiles/ArbOwner.sol)).
The process for upgrading the Arbitrum One chain involves submitting a proposal as an AIP and going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority (see: [Constitution](dao-constitution.md)) of votable tokens being voted in favor of the change. The upgrade must also be approved by the Security Council with a 9-of-12 approval in order to take effect. The chain owner(s) will then perform the upgrade by updating the contract implementation of any of Arbitrum's core protocol [Transparent Upgradeable Proxy contracts](https://developer.arbitrum.io/useful-addresses), and adjusting system parameters (for example: through `setter` methods in the [ArbOwner precompile](https://github.com/OffchainLabs/nitro/blob/master/contracts/src/precompiles/ArbOwner.sol)).

It's important to note that the upgrade should be thoroughly tested and reviewed by the community and experts in the field before being proposed and implemented. Any upgrade should also be compliant with the applicable laws, in particular sanctions-related regulations.

Expand Down Expand Up @@ -108,7 +108,7 @@ While participating in governance is an important aspect of being a DAO member,

#### What's the process for proposing and implementing this change?

The process for proposing and implementing changes to the distribution of unclaimed airdropped $ARB tokens involves submitting a proposal as an AIP and going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority of votable tokens being voted in favor of the change. Additionally, the change must also be approved by the Security Council with a 7-of-12 approval in order to take effect. The distribution of unclaimed airdropped $ARB tokens should be thoroughly evaluated and reviewed by the community and experts in the field before being proposed and implemented.
The process for proposing and implementing changes to the distribution of unclaimed airdropped $ARB tokens involves submitting a proposal as an AIP and going through the same voting and delay phases as any other proposal. The proposal must pass with a supermajority of votable tokens being voted in favor of the change. Additionally, the change must also be approved by the Security Council with a 9-of-12 approval in order to take effect. The distribution of unclaimed airdropped $ARB tokens should be thoroughly evaluated and reviewed by the community and experts in the field before being proposed and implemented.


### Scenario 11: A governance proposal passes that you voted against.
Expand Down
8 changes: 4 additions & 4 deletions docs/deployment-addresses.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,10 +56,10 @@ _\*Note: the Token Distributor contract was [self-destructed](https://arbiscan.i

| Contract | Chain | Address |
| ----------------------------------- | -------- | ---------------------------------------------------------------------------------- |
| Security Council (Arb One, 9 of 12) | Arb One | <AEL address = {"0x423552c0F05baCCac5Bfa91C6dCF1dc53a0A1641"} chainID = {42161} /> |
| Security Council (Arb One, 7 of 12) | Arb One | <AEL address = {"0xADd68bCb0f66878aB9D37a447C7b9067C5dfa941"} chainID = {42161} /> |
| Security Council (L1, 9 of 12) | Ethereum | <AEL address = {"0xF06E95eF589D9c38af242a8AAee8375f14023F85"} chainID = {1} /> |
| Security Council (Nova, 9 of 12) | Nova | <AEL address = {"0xc232ee726E3C51B86778BB4dBe61C52cC07A60F3"} chainID = {42170} /> |
| Security Council (Arb One, emergency) | Arb One | <AEL address = {"0x423552c0F05baCCac5Bfa91C6dCF1dc53a0A1641"} chainID = {42161} /> |
| Security Council (Arb One, non emergency) | Arb One | <AEL address = {"0xADd68bCb0f66878aB9D37a447C7b9067C5dfa941"} chainID = {42161} /> |
| Security Council (L1, emergency) | Ethereum | <AEL address = {"0xF06E95eF589D9c38af242a8AAee8375f14023F85"} chainID = {1} /> |
| Security Council (Nova, emergency) | Nova | <AEL address = {"0xc232ee726E3C51B86778BB4dBe61C52cC07A60F3"} chainID = {42170} /> |

_Note: See ["Security Council Members"](./security-council-members) for addresses of the current members of the Security Council._

Expand Down
2 changes: 1 addition & 1 deletion docs/partials/_constitution-content-partial.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ the ArbitrumDAO took effect on the date upon which AIP-1 was posted, located at
<p>After performing any Emergency Action, the Security Council must issue a full transparency report (at an appropriate time after the security emergency has passed) to explain what was done and why such Emergency Action was justified.</p>
<p>The ArbitrumDAO is able to curtail or eliminate the Security Council&#39;s power to perform Emergency Actions via approval and implementation of a Constitutional AIP.</p>
<p><strong>Non-Emergency Actions</strong>:</p>
<p>The Security Council may also approve and implement routine software upgrades, routine maintenance and other parameter adjustments in a non-emergency setting (such actions, &quot;<strong>Non-Emergency Actions</strong>&quot;), which require a <strong>7-of-12</strong> approval in order to take effect. Any Non-Emergency Action, after approval by the Security Council, will bypass Phases 1 to 3 of the AIP process and instead directly go through Phases 4 to 7 of the AIP process, to provide a delay before any Non-Emergency Action is deployed. The Security Council may optionally specify additional delays before deployment.</p>
<p>The Security Council may also approve and implement routine software upgrades, routine maintenance and other parameter adjustments in a non-emergency setting (such actions, &quot;<strong>Non-Emergency Actions</strong>&quot;), which require a <strong>9-of-12</strong> approval in order to take effect. Any Non-Emergency Action, after approval by the Security Council, will bypass Phases 1 to 3 of the AIP process and instead directly go through Phases 4 to 7 of the AIP process, to provide a delay before any Non-Emergency Action is deployed. The Security Council may optionally specify additional delays before deployment.</p>
<p>The ArbitrumDAO is able to curtail or eliminate the Security Council&#39;s power to perform Non-Emergency Actions via approval and implementation of a Constitutional AIP.</p>
<h3 id="section-4-security-council-elections">Section 4: Security Council Elections</h3>
<p>The Security Council has 12 members, who are divided into two Cohorts of 6 members.</p>
Expand Down
2 changes: 1 addition & 1 deletion docs/partials/_faq-partial.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@

<p></p>

<p> <a href="/dao-glossary#nonemergency-action">Non-emergency action</a>s are routine actions taken by the Security Council, such as software upgrades and maintenance. They require signatures from 7 of 12 Security Council members. They take effect after a delay of at least 13 days, ensuring users can withdraw their funds prior to execution.</p>
<p> <a href="/dao-glossary#nonemergency-action">Non-emergency action</a>s are routine actions taken by the Security Council, such as software upgrades and maintenance. They require signatures from 9 of 12 Security Council members. They take effect after a delay of at least 13 days, ensuring users can withdraw their funds prior to execution.</p>

<p>Information about non-emergency actions is to be provided by the Security Council prior to the action being submitted on chain.</p>

Expand Down
4 changes: 2 additions & 2 deletions docs/state-of-progressive-decentralization.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,10 @@ Let's evaluate the current status of these components for both Arbitrum One and
### 1. Chain ownership

- **Description**: A chain's "owner" has the ability to change the protocol in various ways, including upgrading the core smart contracts, setting system parameters, and pausing the system.
- **Current status**: **Governed by Arbitrum DAO**. Chain ownership of both Arbitrum One and Arbitrum Nova is under the control of the Arbitrum governance system. The Arbitrum Decentralized Autonomous Organization (DAO), made up of <a data-quicklook-from='arb'>$ARB</a> token-holders and <a data-quicklook-from='delegate'>delegates</a>, can carry out chain-owner operations through governance votes. The <a data-quicklook-from='security-council'>Security Council </a> can also carry out chain-owner operations; it can act quickly through a 9 of 12 <a data-quicklook-from='multisignature-wallet'>multisig wallet</a>, but only in critical emergency situations. The Security Council can also act slowly through a 7 of 12 multisig wallet in non-emergency situations to carry out routine and minor upgrades, such as minor bug fixes. The members of the Security Council (split by cohort) are <a data-quicklook-from='security-council-election'>elected</a> every six months by the Arbitrum DAO.
- **Current status**: **Governed by Arbitrum DAO**. Chain ownership of both Arbitrum One and Arbitrum Nova is under the control of the Arbitrum governance system. The Arbitrum Decentralized Autonomous Organization (DAO), made up of <a data-quicklook-from='arb'>$ARB</a> token-holders and <a data-quicklook-from='delegate'>delegates</a>, can carry out chain-owner operations through governance votes. The <a data-quicklook-from='security-council'>Security Council </a> can also carry out chain-owner operations; it can act quickly through a 9 of 12 <a data-quicklook-from='multisignature-wallet'>multisig wallet</a>, but only in critical emergency situations. The Security Council can also act slowly through a 9 of 12 multisig wallet in non-emergency situations to carry out routine and minor upgrades, such as minor bug fixes. The members of the Security Council (split by cohort) are <a data-quicklook-from='security-council-election'>elected</a> every six months by the Arbitrum DAO.
- **Risks**:
- If 9 of the Security Council members are compromised or behave maliciously, the system and users' funds could be compromised.
- If a malicious proposal is successfully put through DAO governance, or if 7 of the Security Council members are compromised or behave maliciously, the system's safety could be compromised. In either of these cases, users will have several weeks to withdraw their funds back to Ethereum before the proposal takes effect.
- If a malicious proposal is successfully put through DAO governance, or if 9 of the Security Council members are compromised or behave maliciously, the system's safety could be compromised. In either of these cases, users will have several weeks to withdraw their funds back to Ethereum before the proposal takes effect.
- **Changes To Current Status**: The governance system currently has the ability to alter governance itself.

### 2. Validator ownership
Expand Down
2 changes: 1 addition & 1 deletion src/components/ConstitutionHash/constitutionHash.json
Original file line number Diff line number Diff line change
@@ -1 +1 @@
{"constitutionHash":"0xe794b7d0466ffd4a33321ea14c307b2de987c3229cf858727052a6f4b8a19cc1"}
{"constitutionHash":"0x7cc34e90dde73cfe0b4a041e79b5638e99f0d9547001e42b466c32a18ed6789d"}

0 comments on commit 6f3c532

Please sign in to comment.