Feat: add script to merge all proposal actions

.gitignore

@@ -34,6 +34,7 @@ yarn-error.log*
 deployments
 deployed_contracts.json
 managementDAOTX.json
+packages/contracts/scripts/management-dao-proposal/files-to-merge/
 
 # generated
 generated

packages/contracts/deploy/new/40_finalize-management-dao/20_register-management-dao-on-dao-registry.ts

@@ -81,11 +81,16 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
 
   let metadataCIDPath = '0x';
 
+  if (!process.env.PUB_PINATA_JWT) {
+    throw new Error('PUB_PINATA_JWT is not set');
+  }
+
   if (!isLocal(hre.network)) {
     // Upload the metadata to IPFS
     metadataCIDPath = await uploadToPinata(
-      JSON.stringify(MANAGEMENT_DAO_METADATA, null, 2),
-      `management-dao-metadata`
+      MANAGEMENT_DAO_METADATA,
+      `management-dao-metadata`,
+      process.env.PUB_PINATA_JWT
     );
   }
 

packages/contracts/deploy/update/to_v1.4.0/01_Info.ts

@@ -0,0 +1,24 @@
+import {DeployFunction} from 'hardhat-deploy/types';
+import {HardhatRuntimeEnvironment} from 'hardhat/types';
+
+const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
+  console.log('\nInfo: Updating to version 1.4.0');
+
+  hre.proposalInfo = {
+    proposalTitle: 'Upgrade OSx Protocol to version 1.4.0',
+    proposalSummary:
+      'Upgrade OSx Protocol to version 1.4.0, and release Admin Plugin v1.2, Multisig v1.3 and TokenVoting v1.3',
+    proposalResources: [
+      {
+        name: 'audit report',
+        url: 'https://github.com/aragon/osx/tree/main/audits',
+      },
+    ],
+    // Adjust this values
+    proposalStartDate: 0,
+    proposalEndDate: 1741370400, // Date and time (GMT): Friday, 7 March 2025 18:00:00
+  };
+};
+export default func;
+func.tags = ['Info', 'v1.4.0'];
+func.dependencies = ['Env'];

packages/contracts/deploy/update/to_v1.4.0/10_DAOFactory.ts

@@ -52,7 +52,7 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
     to: managementDAOAddress,
     value: 0,
     data: calldata,
-    description: `Grant the <strong>REGISTER_DAO_PERMISSION_ID</strong> permission on the <strong>DAORegistry</strong> (<code>${daoRegistryAddress}</code>) to the new <strong>DAOFactory</strong> (<code>${deployResult.address}</code>).`,
+    description: `\n- Grant the **REGISTER_DAO_PERMISSION_ID** permission on the **DAORegistry** (\`${daoRegistryAddress}\`) to the new **DAOFactory** (\`${deployResult.address}\`).`,
   });
 };
 export default func;

packages/contracts/deploy/update/to_v1.4.0/20_PluginRepoFactory.ts

@@ -63,7 +63,7 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
     to: managementDAOAddress,
     value: 0,
     data: calldata,
-    description: `Moves the <strong>REGISTER_PLUGIN_REPO_PERMISSION</strong> permission on the <strong>PluginRepoRegistry</strong> (<code>${pluginRepoRegistryAddress}</code>) from the old <strong>PluginRepoFactory</strong> (<code>${previousPluginRepoFactoryAddress}</code>) to the new <strong>PluginRepoFactory</strong> (<code>${deployResult.address}</code>).`,
+    description: `\n- Moves the **REGISTER_PLUGIN_REPO_PERMISSION_ID** permission on the **PluginRepoRegistry** (\`${pluginRepoRegistryAddress}\`) from the old **PluginRepoFactory** (\`${previousPluginRepoFactoryAddress}\`) to the new **PluginRepoFactory** (\`${deployResult.address}\`).`,
   });
 };
 export default func;

packages/contracts/deploy/update/to_v1.4.0/31_DAORegistry.ts

@@ -47,7 +47,7 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
     to: upgradeTX.to,
     data: upgradeTX.data,
     value: 0,
-    description: `Upgrade the <strong>DaoRegistry </strong> (<code>${daoRegistryAddress}</code>) to the new <strong>implementation</strong> (<code>${result.address}</code>).`,
+    description: `\n- Upgrade the **DaoRegistry** (\`${daoRegistryAddress}\`) to the new **implementation** (\`${result.address}\`).`,
   });
 };
 export default func;

packages/contracts/deploy/update/to_v1.4.0/41_PluginRepoRegistry.ts

@@ -51,7 +51,7 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
     to: upgradeTX.to,
     data: upgradeTX.data,
     value: 0,
-    description: `Upgrade the <strong>PluginRepoRegistry </strong> (<code>${pluginRepoRegistryAddress}</code>) to the new <strong>implementation</strong> (<code>${result.address}</code>).`,
+    description: `\n- Upgrade the **PluginRepoRegistry** (\`${pluginRepoRegistryAddress}\`) to the new **implementation** (\`${result.address}\`).`,
   });
 };
 export default func;

packages/contracts/deploy/update/to_v1.4.0/90_ManagingDAO.ts

@@ -37,7 +37,7 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
     to: upgradeTX.to,
     data: upgradeTX.data,
     value: 0,
-    description: `Upgrade the <strong>management DAO</strong> (<code>${managementDAOAddress}</code>) to the new <strong>implementation</strong> (<code>${newDaoImplementation}</code>).`,
+    description: `\n- Upgrade the **management DAO** (\`${managementDAOAddress}\`) to the new **implementation** (\`${newDaoImplementation}\`).`,
   });
 };
 export default func;

packages/contracts/deploy/verification/99_conclude/00_save-contract-addresses.ts

@@ -43,11 +43,16 @@ const func: DeployFunction = async function (hre: HardhatRuntimeEnvironment) {
   }
 
   const storeInfo = {
+    proposalInfo: hre.proposalInfo,
     deployedContractAddresses,
     managementDAOActions: hre.managementDAOActions,
   };
 
-  await fs.writeFile('deployed_contracts.json', JSON.stringify(storeInfo));
+  await fs.writeFile(
+    'deployed_contracts.json',
+    JSON.stringify(storeInfo, null, 2),
+    'utf-8'
+  );
 };
 export default func;
 func.tags = ['New', 'Conclude', 'ConcludeEnd'];

packages/contracts/hardhat.config.ts

@@ -104,7 +104,12 @@ const config: HardhatUserConfig = {
       gasPrice: 80000000000,
       deploy: ENABLE_DEPLOY_TEST
         ? ['./deploy']
-        : ['./deploy/env', './deploy/new', './deploy/verification'],
+        : [
+            './deploy/env',
+            './deploy/new',
+            './deploy/verification',
+            './deploy/update',
+          ],
     },
     localhost: {
       deploy: ENABLE_DEPLOY_TEST

packages/contracts/package.json

@@ -32,7 +32,8 @@
     "prepublishOnly": "yarn build && yarn build:npm",
     "docgen": "hardhat docgen",
     "docs": "DOCS=true scripts/prepare-docs.sh",
-    "clean": "rm -rf artifacts cache deployments typechain"
+    "clean": "rm -rf artifacts cache deployments typechain",
+    "generate-proposal": "ts-node scripts/management-dao-proposal/generate-managing-dao-proposal-info.ts"
   },
   "repository": {
     "type": "git",
@@ -52,7 +53,7 @@
   },
   "devDependencies": {
     "@aragon/osx-commons-configs": "^0.8.0",
-    "@aragon/osx-commons-sdk": "^0.1.0",
+    "@aragon/osx-commons-sdk": "^0.2.0",
     "@aragon/osx-ethers-v1.2.0": "npm:@aragon/[email protected]",
     "@aragon/osx-v1.0.1": "npm:@aragon/[email protected]",
     "@aragon/osx-v1.3.0": "npm:@aragon/[email protected]",

packages/contracts/scripts/management-dao-proposal/README.md

@@ -0,0 +1,58 @@
+## Description
+
+This script merges the plugin proposal actions defined in the files inside the `files-to-merge` folder and the `deployed_contracts.json` file into the `merged-proposals.json` file.
+
+## How it works
+
+Before running this script, you need to deploy the plugins and the framework.
+
+To deploy the framework, run the deploy script in the `packages/contracts` folder:
+
+```
+yarn deploy --network <network> --tags <the tags>
+```
+
+For deploying version `1.4.0` on Sepolia, you can run:
+
+```
+yarn deploy --network sepolia --tags v1.4.0,VerifyEnd,ConcludeEnd
+```
+
+This will generate a `deployed_contracts.json` file in the `packages/contracts` folder that will be used by this script to merge proposal actions. The proposal information will be included (for more details, check the first deployment step in the `01_Info.ts` file). You can modify this information as needed (elements like the proposal end date might need modification).
+
+After deploying the framework, go to each plugin repository and run the deploy script:
+
+```
+yarn deploy --network <network> --tags <the tags>
+```
+
+For deploying and publishing a new version on Sepolia, you can run:
+
+```
+yarn deploy --network sepolia --tags NewVersion,Verification
+```
+
+This deployment will generate a `createVersionProposalData-network.json` file that you need to copy to the `./files-to-merge` folder.
+
+Once you have both the `deployed_contracts.json` file and the plugin deployment json files, you can run this script to merge the proposal actions:
+
+```
+yarn generate-proposal
+```
+
+This will generate two files in the `./generated` folder:
+
+- A `merged-proposals.json` file with all the proposal and deployment details
+- A `calldata.json` file with the proposal information and the raw calldata
+
+## Steps
+
+1. Deploy the framework
+2. Deploy the plugins
+3. Copy the deployment json files to the `./files-to-merge` folder
+4. Run the script to merge the proposal actions
+5. The `./generated` folder will be created with the `merged-proposals.json` file and the `calldata.json` file
+
+## Note
+
+To test the deployment and the generated calldata, you can check the tests in the `test/deploy/deployment-1.4.0.ts` file. It will attempt to create, approve, and execute the proposal with the calldata generated by this script. This file is specific for checking the deployment of version `1.4.0`; you might need to modify it for other versions. Also, note that the test is forking the network, so you might need to adjust the network name and the fork block number.