feat: updatable proposals

.github/workflows/storage.yml

@@ -16,7 +16,7 @@ jobs:
         uses: foundry-rs/foundry-toolchain@v1
         with:
           version: nightly
-  
+
       - name: "Inspect Storage Layout"
         continue-on-error: false
         id: storage-inspect-check

.prettierignore

@@ -0,0 +1,12 @@
+# Exclude Solidity files - formatted with forge fmt
+*.sol
+
+# Artifacts and build outputs
+dist/
+out/
+cache/
+artifacts/
+node_modules/
+
+# Git
+.git/

.prettierrc

@@ -1,14 +1,4 @@
 {
   "tabWidth": 2,
-  "printWidth": 100,
-  "overrides": [
-    {
-      "files": "*.sol",
-      "options": {
-        "printWidth": 150,
-        "tabWidth": 4,
-        "bracketSpacing": true
-      }
-    }
-  ]
+  "printWidth": 100
 }

.solhint.json

@@ -1,6 +1,29 @@
 {
-  "plugins": ["prettier"],
+  "extends": "solhint:recommended",
   "rules": {
-    "prettier/prettier": "error"
-  }
+    "func-visibility": ["warn", { "ignoreConstructors": true }],
+    "immutable-vars-naming": "off",
+    "var-name-mixedcase": "off",
+    "const-name-snakecase": "off",
+    "interface-starts-with-i": "off",
+    "function-max-lines": ["warn", 80],
+    "no-empty-blocks": "off",
+    "no-inline-assembly": "off",
+    "avoid-low-level-calls": "off",
+    "import-path-check": "off",
+    "no-global-import": "off",
+    "quotes": "off",
+    "func-name-mixedcase": "off",
+    "no-console": "off",
+    "state-visibility": "off",
+    "one-contract-per-file": "off",
+    "no-unused-import": "off",
+    "compiler-version": "off",
+    "gas-indexed-events": "off",
+    "gas-increment-by-one": "off",
+    "gas-strict-inequalities": "off",
+    "gas-calldata-parameters": "off",
+    "gas-small-strings": "off"
+  },
+  "excludedFiles": ["src/lib/**/*.sol"]
 }

.storage-layout

@@ -88,6 +88,16 @@
 | hasVoted                             | mapping(bytes32 => mapping(address => bool))        | 11   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
 |--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
 | delayedGovernanceExpirationTimestamp | uint256                                             | 12   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
+|--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
+| _proposalUpdatablePeriod             | uint48                                              | 13   | 0      | 6     | src/governance/governor/Governor.sol:Governor |
+|--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
+| proposeSigNonces                     | mapping(address => uint256)                         | 14   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
+|--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
+| proposalSigners                      | mapping(bytes32 => address[])                       | 15   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
+|--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
+| proposalUpdatePeriodEnds             | mapping(bytes32 => uint32)                          | 16   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
+|--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------|
+| proposalIdReplacedBy                 | mapping(bytes32 => bytes32)                         | 17   | 0      | 32    | src/governance/governor/Governor.sol:Governor |
 ╰--------------------------------------+-----------------------------------------------------+------+--------+-------+-----------------------------------------------╯
 
 

addresses/10.json

@@ -13,5 +13,6 @@
   "L2MigrationDeployer": "0x7D8Ea0D056f5B8443cdD8495D4e90FFCf0a8A354",
   "MerkleReserveMinter": "0x8DFEd5737cd21e25009A2a2CB56dca8EA618e5D3",
   "ERC721RedeemMinter": "0x6c8f15bad61cbb6339f16b334610db5e3f0701dc",
+  "MerklePropertyIPFS": "0xdEe7aa9B8d084541Fe2c71c52217Fbc2b14d922D",
   "ManagerOwner": "0x11Fd15eC87391c8d502b889E60f3130C156F93c8"
 }

addresses/11155111.json

@@ -1,15 +1,18 @@
 {
-  "BuilderRewardsRecipient": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95",
+  "BuilderRewardsRecipient": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905",
   "CrossDomainMessenger": "0x4200000000000000000000000000000000000007",
   "ProtocolRewards": "0x7777777F279eba3d3Ad8F4E708545291A6fDBA8B",
-  "Manager": "0x0ca90a96ac58f19b1f69f67103245c9263bc4bfc",
-  "ManagerImpl": "0xABdEdc8730410716DD0a5E54A89C85546A3458bA",
   "WETH": "0x7b79995e5f793a07bc00c21412e50ecae098e7f9",
-  "Auction": "0xca8F9A4805CCFfdCcfc5Bf7973302a0c01f4347b",
-  "Token": "0x44D9FD02e6d8d96ca9c2bBD26C232024977674C5",
-  "MetadataRenderer": "0xec23ce6407ef841adf52e7232d3df5a44cb38041",
-  "Treasury": "0x5daabe9382158c3f133b360a5f0b46ca5a7f6e86",
-  "Governor": "0xaa21AFD73e6Fd5f69C87A6839D0beEDEE075e9a3",
-  "ERC721RedeemMinter": "0xaefd4a9ea072abb12f043f5b2b2d845b7600c503",
-  "ManagerOwner": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95"
+  "Manager": "0xa398b4e56e9bb0f14d7ea32628fb707ecf061b0c",
+  "ManagerImpl": "0xd53daf44d6a23f0d5ea200bd078b234a4c7a7a15",
+  "Auction": "0x277ff1a467ec6d0cd7891826bb87b522f6ae7dbd",
+  "Token": "0x97573d46a0c81909705d1b9999870e0813379a75",
+  "MetadataRenderer": "0x9440b3e4f92c02773082caa6df8fd9c388f5ce55",
+  "Treasury": "0xe72bbf8961e6badc1ba9cc46d43f106a9baf3866",
+  "Governor": "0xb9d74524bfc6a2458209d707804c52df61675579",
+  "ERC721RedeemMinter": "0x9f43615c1e6c79dd96ebe82345093e05b9bd13e7",
+  "MerkleReserveMinter": "0x1f52a4ee61814c7fac6554024397d905ab364d6b",
+  "MigrationDeployer": "0xe9f386a728f5693a57bdb2674cf49021d70fd6f6",
+  "MerklePropertyIPFS": "0x9256fBF6Cf325dCE7fC99f28909fc990D9aC3c64",
+  "ManagerOwner": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905"
 }

addresses/11155420.json

@@ -1,17 +1,18 @@
 {
-  "BuilderRewardsRecipient": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95",
+  "BuilderRewardsRecipient": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905",
   "CrossDomainMessenger": "0x4200000000000000000000000000000000000007",
   "ProtocolRewards": "0x7777777F279eba3d3Ad8F4E708545291A6fDBA8B",
-  "Manager": "0x1004e43b540af4dfde2737c29893716817b0a1d7",
-  "ManagerImpl": "0x93f9d43a7bD751f8546A54785AE48D049dDd2697",
+  "Manager": "0x9c51aa40551b35ab16d410adef9659ed3bcd8bd6",
+  "ManagerImpl": "0xc05dafcc35f5087963ce2cb99ce2b6a5f116ab0b",
   "WETH": "0x7b79995e5f793a07bc00c21412e50ecae098e7f9",
-  "Auction": "0xaa21AFD73e6Fd5f69C87A6839D0beEDEE075e9a3",
-  "Token": "0xca8F9A4805CCFfdCcfc5Bf7973302a0c01f4347b",
-  "MetadataRenderer": "0xDA804D6e0Da967E2A7359Dd0777898f577A0B995",
-  "Treasury": "0x7abe363c6dd3a4dec6a3311681723f35740f69e7",
-  "Governor": "0xABdEdc8730410716DD0a5E54A89C85546A3458bA",
-  "L2MigrationDeployer": "0xF3a4ca161a88e26115d1C1DBcB8C4874E1786F42",
-  "MerkleReserveMinter": "0xDEDAA98037030060DD385Deb19Fa332DF79F43a8",
-  "ERC721RedeemMinter": "0xf4640751e7363a0572d4ba93a9b049b956b33c17",
-  "ManagerOwner": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95"
+  "Auction": "0x6a6ec19cdb30e74ea19a9e269d6ca0dbad92d4d1",
+  "Token": "0x0e7bbc0123f5a9d6526c44d58273a8889d6f35b0",
+  "MetadataRenderer": "0x3c383f54a0024e840eb479f15926164d8f00e0a4",
+  "Treasury": "0xdafeb89f713e25a02e4ec21a18e3757d7a76d19e",
+  "Governor": "0x6c8f15bad61cbb6339f16b334610db5e3f0701dc",
+  "L2MigrationDeployer": "0x44a08ee9d30bfd805407f5509210298c980de874",
+  "MerkleReserveMinter": "0x52c04330c9d38638b5d38e685f13ca744b84155b",
+  "ERC721RedeemMinter": "0xf22a734e7133cd323439bfde38ed749ddc42e09f",
+  "MerklePropertyIPFS": "0xbE9e39201Acf98c930A57e3153e7c7Bd41c1E051",
+  "ManagerOwner": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905"
 }

addresses/7777777.json

@@ -12,5 +12,6 @@
   "Governor": "0x9af9f31bae469c13528b458e007a7ea965bd14bb",
   "L2MigrationDeployer": "0x7D8Ea0D056f5B8443cdD8495D4e90FFCf0a8A354",
   "MerkleReserveMinter": "0x8DFEd5737cd21e25009A2a2CB56dca8EA618e5D3",
+  "MerklePropertyIPFS": "0xdEe7aa9B8d084541Fe2c71c52217Fbc2b14d922D",
   "ManagerOwner": "0x617F7021235Bba2C3E6b8Ae7996d0EFAE9fEDC13"
 }

addresses/8453.json

@@ -13,5 +13,6 @@
   "L2MigrationDeployer": "0x8ef7b563Ff9F4A1f2d294845000cDf782d9afd7c",
   "MerkleReserveMinter": "0x7D8Ea0D056f5B8443cdD8495D4e90FFCf0a8A354",
   "ERC721RedeemMinter": "0x57b9f2c192bbfa5cabc79a683435990fea665861",
+  "MerklePropertyIPFS": "0x83A9B0aaC8d38A7C8cCbbE8Ee8B103610BD8A790",
   "ManagerOwner": "0x0358962c89f33840fc67cDb2767dcC5f784AD7Bf"
 }

addresses/84532.json

@@ -1,17 +1,18 @@
 {
-  "BuilderRewardsRecipient": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95",
+  "BuilderRewardsRecipient": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905",
   "CrossDomainMessenger": "0x4200000000000000000000000000000000000007",
   "ProtocolRewards": "0x7777777F279eba3d3Ad8F4E708545291A6fDBA8B",
-  "Manager": "0x550c326d688fd51ae65ac6a2d48749e631023a03",
-  "ManagerImpl": "0xf896daA9E7CdCa767202D2f9699e7A30B22F6087",
+  "Manager": "0x18333832015473c5aa48ccb782070fe20b95622c",
+  "ManagerImpl": "0xe17cd59546e599a44dc64864e6896be0c352f427",
   "WETH": "0x7b79995e5f793a07bc00c21412e50ecae098e7f9",
-  "Auction": "0xEe970F19eD4960234e75ee8d3A42c98cA65B5c34",
-  "Token": "0xec23Ce6407Ef841aDf52e7232d3dF5A44cB38041",
-  "MetadataRenderer": "0x0b3a22e5c5824d9d227986f76190f504c0906ad6",
-  "Treasury": "0x047b1e00eb4726afc57d559f851146e84e31d1dc",
-  "Governor": "0x5DaabE9382158C3F133B360a5F0b46cA5a7f6E86",
-  "L2MigrationDeployer": "0x1e57Cad7C22042BD765011d0F2eb36606Fe12C3F",
-  "MerkleReserveMinter": "0x7AbE363C6DD3a4dEC6a3311681723f35740f69E7",
-  "ERC721RedeemMinter": "0x6bf60ab271007f519c094b902c6083d86efc9f2f",
-  "ManagerOwner": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95"
+  "Auction": "0xbfae6d756ae39e5cfa72479fa069dc002d396695",
+  "Token": "0xeb07510a368590d87ea007967cab24c29c5a52aa",
+  "MetadataRenderer": "0x140e9aeaa36da5db7eeaf1ec165a02b81e722328",
+  "Treasury": "0x1720987582f06d93efac80f1ff06a2465a1e6907",
+  "Governor": "0xe3939258b93c98b6d9116be9f0257c1e8dce2001",
+  "L2MigrationDeployer": "0xff82604fddae9bdae59bd5bc62d5d265870302ec",
+  "MerkleReserveMinter": "0xaef554284606f9479a040b1181966826c99029bc",
+  "ERC721RedeemMinter": "0x04098e0531ed22bddf83ff76af5fe5b3dd3744a5",
+  "MerklePropertyIPFS": "0xaDDB7f43ED60863e44e7C7435960b13bcA703B06",
+  "ManagerOwner": "0x19a8eb80c1483CEAA1278B16C5D5eF0104F85905"
 }

addresses/999999999.json

@@ -12,5 +12,6 @@
   "Governor": "0x5daabe9382158c3f133b360a5f0b46ca5a7f6e86",
   "L2MigrationDeployer": "0x1e57Cad7C22042BD765011d0F2eb36606Fe12C3F",
   "MerkleReserveMinter": "0x7AbE363C6DD3a4dEC6a3311681723f35740f69E7",
+  "MerklePropertyIPFS": "0xC521f85613985b7E417FCcd5b348F64263D79397",
   "ManagerOwner": "0x7498e6e471f31e869f038D8DBffbDFdf650c3F95"
 }

deploys/10.merkle_property.txt

@@ -0,0 +1,4 @@
+MerklePropertyImpl: 0x8ef7b563ff9f4a1f2d294845000cdf782d9afd7c
+MerklePropertyImpl: 0x8ef7b563ff9f4a1f2d294845000cdf782d9afd7c
+MerklePropertyImpl: 0x8ef7b563ff9f4a1f2d294845000cdf782d9afd7c
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d

deploys/11155111.merkle_property.txt

@@ -0,0 +1 @@
+MerklePropertyImpl: 0x9256fbf6cf325dce7fc99f28909fc990d9ac3c64

deploys/11155111.version3_new.txt

@@ -0,0 +1,10 @@
+Manager: 0xda794be173d0896c53c3619927d0920b32b66c78
+Token implementation: 0xaa44f1e917c74a0cabc922d0ca74d32afcfb3955
+Metadata Renderer implementation: 0xb8b93fd334e7bb42756ff06c67c078188c25ad0e
+Auction implementation: 0x435f23cfab79f6bc27b3a22f320d35bda1e551fc
+Treasury implementation: 0x0cd65d8121eac1637569d5fafad3250bf0d0917f
+Governor implementation: 0x7007734ab043db25700ea4a20e5cd14e1b77ab03
+Manager implementation: 0xe658b53bcb14934b389d09ca2b5a629f88bfb8b8
+Merkle Reserve Minter: 0xe38df9fb44d5b255b47766c1437361ac0e9627ff
+ERC721 Redeem Minter: 0x04a45469ba2ae0f09ba33aeafecd3bed064781d5
+Migration Deployer: 0xecc5a26d8687ae3c45e9d9f2653cb77d6f675e78

deploys/11155111.version3_upgrade.txt

@@ -0,0 +1,4 @@
+Old Governor implementation: 0x4b518201bda0ce0df7ca6cc9572d941390bc91a0
+New Governor implementation: 0xb9d74524bfc6a2458209d707804c52df61675579
+Old Manager implementation: 0x6ac5e821e2c13d58df5b14fd4270901cabc72ad1
+New Manager implementation: 0xd53daf44d6a23f0d5ea200bd078b234a4c7a7a15

deploys/11155420.merkle_property.txt

@@ -0,0 +1,4 @@
+MerklePropertyImpl: 0x381846d1933d00b4a9d239d9f0759e72e1009b22
+MerklePropertyImpl: 0xcfbf7cc52fa1e9ba540b4700b1e28a3e7a18f106
+MerklePropertyImpl: 0x40ca5d9f4169c304c2eb25832ea73771f2b6ba25
+MerklePropertyImpl: 0xbe9e39201acf98c930a57e3153e7c7bd41c1e051

deploys/11155420.version3_new.txt

@@ -0,0 +1,10 @@
+Manager: 0xda794be173d0896c53c3619927d0920b32b66c78
+Token implementation: 0x57b9f2c192bbfa5cabc79a683435990fea665861
+Metadata Renderer implementation: 0x3d5dd2988cfe8fce1bea2911bc5e38e1c3bd63bd
+Auction implementation: 0x831ad619022ed27f8d384dd2367007eec27e0f93
+Treasury implementation: 0xd77c38a5d1efe9a95c285220a71b0d7ac1171c82
+Governor implementation: 0x41ae40716f45d965973d8e11cf85ad7515b4bfaa
+Manager implementation: 0xe2259ef361514324ed091d92d44b3e20be615624
+Merkle Reserve Minter: 0xe38df9fb44d5b255b47766c1437361ac0e9627ff
+ERC721 Redeem Minter: 0x04a45469ba2ae0f09ba33aeafecd3bed064781d5
+Migration Deployer: 0xecc5a26d8687ae3c45e9d9f2653cb77d6f675e78

deploys/11155420.version3_upgrade.txt

@@ -0,0 +1,4 @@
+Old Governor implementation: 0x01a9ea5de8c2ef7b325b97bb69952c51d268d4b9
+New Governor implementation: 0x6c8f15bad61cbb6339f16b334610db5e3f0701dc
+Old Manager implementation: 0x2a1878b672ca7b258c9fb741bc7c85cd1249e7cf
+New Manager implementation: 0xc05dafcc35f5087963ce2cb99ce2b6a5f116ab0b

deploys/7777777.merkle_property.txt

@@ -0,0 +1,5 @@
+MerklePropertyImpl: 0x8ef7b563ff9f4a1f2d294845000cdf782d9afd7c
+MerklePropertyImpl: 0x8ef7b563ff9f4a1f2d294845000cdf782d9afd7c
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d

deploys/8453.merkle_property.txt

@@ -0,0 +1,4 @@
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d
+MerklePropertyImpl: 0xdee7aa9b8d084541fe2c71c52217fbc2b14d922d
+MerklePropertyImpl: 0x83a9b0aac8d38a7c8ccbbe8ee8b103610bd8a790
+MerklePropertyImpl: 0x83a9b0aac8d38a7c8ccbbe8ee8b103610bd8a790

deploys/84532.merkle_property.txt

@@ -0,0 +1,7 @@
+MerklePropertyImpl: 0xf888b57b0cf99052dcd55d021f8bd0c916374a84
+MerklePropertyImpl: 0xf888b57b0cf99052dcd55d021f8bd0c916374a84
+MerklePropertyImpl: 0xf888b57b0cf99052dcd55d021f8bd0c916374a84
+MerklePropertyImpl: 0xc860f823128b875d9f77beff88dd3670946e9559
+MerklePropertyImpl: 0x38dd983c9c11253f070977f2ba90404e71f1630f
+MerklePropertyImpl: 0x4e5979fc762c3b1bb63c6fc467141ef2bf2140ba
+MerklePropertyImpl: 0xaddb7f43ed60863e44e7c7435960b13bca703b06

deploys/84532.version3_new.txt

@@ -0,0 +1,10 @@
+Manager: 0xda794be173d0896c53c3619927d0920b32b66c78
+Token implementation: 0x83145b13ab4ce1eab7709c9b96289ae67202d562
+Metadata Renderer implementation: 0xa3dde129224a42e56220c9f656c172898a687021
+Auction implementation: 0xdbda608b8a01217a881ec80e2d31484ff6a1ab5a
+Treasury implementation: 0x9e371ebf57d4ae5b3b7713b2da77648b70773fe0
+Governor implementation: 0x1ffda0c3c745084b797be8c99dd22907c834b869
+Manager implementation: 0x46afb99adc41fd52299dc267bc18665c5bc003e4
+Merkle Reserve Minter: 0xe38df9fb44d5b255b47766c1437361ac0e9627ff
+ERC721 Redeem Minter: 0x04a45469ba2ae0f09ba33aeafecd3bed064781d5
+Migration Deployer: 0xecc5a26d8687ae3c45e9d9f2653cb77d6f675e78

deploys/84532.version3_upgrade.txt

@@ -0,0 +1,4 @@
+Old Governor implementation: 0x1acc84a21c481aed147dd4ef1cce630a3a1a59ee
+New Governor implementation: 0xe3939258b93c98b6d9116be9f0257c1e8dce2001
+Old Manager implementation: 0x06c41b7c3f366a00d4fd2b980e40375487b2e3d8
+New Manager implementation: 0xe17cd59546e599a44dc64864e6896be0c352f427

deploys/999999999.merkle_property.txt

@@ -0,0 +1,4 @@
+MerklePropertyImpl: 0xf888b57b0cf99052dcd55d021f8bd0c916374a84
+MerklePropertyImpl: 0xa22c6aafac2008143f5c183d042da58f9b7bddf4
+MerklePropertyImpl: 0xba2540870b5f93915d6fe7310a6fd9daad8f9acd
+MerklePropertyImpl: 0xc521f85613985b7e417fccd5b348f64263d79397

docs/README.md

@@ -1,5 +1,8 @@
 # Deployment Docs
 
 - [`deployment-workflows`](./deployment-workflows.md): Main deployment command reference from `package.json`, supported networks, env requirements, and manager owner sync usage.
-- [`mainnet-v2-upgrade-runbook`](./mainnet-v2-upgrade-runbook.md): Mainnet v2 rollout guide for implementation deployment, manager update/registration pipeline, and DAO upgrade execution.
+- [`upgrade-runbook`](./upgrade-runbook.md): Chain-agnostic rollout guide for implementation deployment, manager update/registration pipeline, and DAO upgrade execution.
 - [`manager-ownership-runbook`](./manager-ownership-runbook.md): Manager ownership transfer guide (governance or multisig), verification steps, and JSON manifest tracking fields.
+- [`governor-architecture`](./governor-architecture.md): Governor feature design for signed proposals, updatable lifecycle, storage model, and EAS hybrid boundary.
+- [`governor-audit-readiness`](./governor-audit-readiness.md): Security invariants, upgrade/storage checks, user-flow test coverage, and rollout checklist.
+- [`governor-proposal-lifecycle`](./governor-proposal-lifecycle.md): End-to-end proposal state machine and timing reference with query map, defaults, and update permissions.