sync docs - #381
Open
godzillaba wants to merge 2 commits into
Open
Conversation
Update stale parameters to match current mainnet/constitution: - L2 core timelock delay 3 -> 8 days (overview, security-council-mgmt) - Non-emergency Security Council threshold 7-of-12 -> 9-of-12 (overview, security-council-mgmt, proposal_lifecycle_example) - Replace fixed 5%/3%-of-votable quorum description with the DVP (delegated voting power) model and its min/max clamps; rename the "5%"/"3%" governors to Core/Treasury (overview, gotchas) Also fix propMon output filename (proposalState.json) and scipts typos.
godzillaba
marked this pull request as ready for review
July 24, 2026 14:58
TucksonDev
approved these changes
Jul 28, 2026
TucksonDev
left a comment
TucksonDev
left a comment
Collaborator
There was a problem hiding this comment.
LGTM, with a few minor comments
|
|
||
| #### Quorum | ||
|
|
||
| Quorum is based on the total delegated voting power of $ARB (excluding tokens delegated to the exclude address). For each governor, quorum is a fraction of the delegated voting power, clamped between a fixed minimum and maximum: |
Collaborator
There was a problem hiding this comment.
We could maybe add that this is calculated based on the snapshot taken when the proposal is created.
|
|
||
| ## Proposal delays | ||
|
|
||
| All governance activities occur on Arbitrum One. Proposals are made there, as well as delegation and voting. A proposal made to the constitutional governor experiences enough delay to ensure that users can safely exit the chain before the proposal is executed, should they deem it malicious. |
Collaborator
There was a problem hiding this comment.
Should we include somewhere that non-constitutional proposals have a 3-day delay, but they don't do the roundtrip?
| #### Arbitrum One L2 Timelock | ||
|
|
||
| Proposals can be scheduled here by the 5% governor, or by a 7-of-12 agreement in the Security Council. This timelock enforces a 3-day delay before the proposal can then be executed by anybody. | ||
| Proposals can be scheduled here by the Core governor, or by a 9-of-12 agreement in the Security Council. This timelock enforces an 8-day delay before the proposal can then be executed by anybody. |
Collaborator
There was a problem hiding this comment.
2 things here:
- not sure if worth it, but maybe clarify that both sc multisig can create a proposal
- maybe add information about the Treasury Timelock too (only the Treasury Governor can propose, and it has a 3-day delay)
| | Contract | Receive proposals scheduled by | Timelock | | ||
| | -------- | ------------------------------ | ----------------- | | ||
| | Arb One L2 Timelock<br/>(Arb1TL) | the 5% governor / 7-12 in Security Council | 3 days | | ||
| | Arb One L2 Timelock<br/>(Arb1TL) | the Core governor / 9-12 in Security Council | 8 days | |
Collaborator
There was a problem hiding this comment.
Same here as the previous comment:
- Maybe specify that both sc multisigs can create proposal
- Add the Treasury timelock
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.