feat: add governance-scripts package

pkg/governance-scripts/README.md

@@ -0,0 +1,17 @@
+# <img src="../../logo.svg" alt="Balancer" height="128px">
+
+# Balancer V3 Governance Scripts
+
+In order to manage the Balancer protocol, Balancer DAO must sometimes execute somewhat complex sets of actions which if executed incorrectly could result in governance losing control of key powers over the protocol, opening up vulnerabilities by granting powerful permissions improperly, etc.
+
+In order to prevent this, complex governance actions may be enacted through script contracts. These have a number of benefits over performing actions directly through the multisig wallet.
+
+- The contract can be easily tested prior to the execution on mainnet to ensure that it produces the correct result.
+- It's much simpler to verify the behavior of Solidity code matches the proposal specification relative to a series of raw function calls.
+- The contract may only be triggered once, ensuring that any powers granted to it can't be used in future for another purpose unilaterally.
+
+This package contains the source code for these script contracts to form a record of major technical actions Balancer DAO has taken.
+
+## Licensing
+
+[GNU General Public License Version 3 (GPL v3)](../../LICENSE).

pkg/governance-scripts/foundry.toml

@@ -0,0 +1,48 @@
+[profile.default]
+src = 'contracts'
+out = 'forge-artifacts'
+libs = ['node_modules']
+test = 'test/foundry'
+cache_path  = 'forge-cache'
+allow_paths = ['../', '../../node_modules/']
+ffi = true
+fs_permissions = [{ access = "read-write", path = ".forge-snapshots/"}]
+remappings = [
+    'vault/=../vault/',
+    'pool-weighted/=../pool-weighted/',
+    'solidity-utils/=../solidity-utils/',
+    'ds-test/=../../node_modules/forge-std/lib/ds-test/src/',
+    'forge-std/=../../node_modules/forge-std/src/',
+    '@openzeppelin/=../../node_modules/@openzeppelin/',
+    'permit2/=../../node_modules/permit2/',
+    '@balancer-labs/=../../node_modules/@balancer-labs/',
+    'forge-gas-snapshot/=../../node_modules/forge-gas-snapshot/src/'
+]
+optimizer = true
+optimizer_runs = 999
+solc_version = '0.8.26'
+auto_detect_solc = false
+evm_version = 'cancun'
+ignored_error_codes = [2394, 5574, 3860] # Transient storage, code size
+allow_internal_expect_revert = true
+
+[fuzz]
+runs = 10000
+max_test_rejects = 60000
+
+[profile.forkfuzz.fuzz]
+runs = 1000
+max_test_rejects = 60000
+
+[profile.coverage.fuzz]
+runs = 100
+max_test_rejects = 60000
+
+[profile.intense.fuzz]
+verbosity = 3
+runs = 100000
+max_test_rejects = 600000
+
+[rpc_endpoints]
+  mainnet = "${MAINNET_RPC_URL}"
+  sepolia = "${SEPOLIA_RPC_URL}"

pkg/governance-scripts/hardhat.config.ts

@@ -0,0 +1,20 @@
+import { HardhatUserConfig } from 'hardhat/config';
+import { hardhatBaseConfig } from '@balancer-labs/v3-common';
+
+import '@nomicfoundation/hardhat-toolbox';
+import '@nomicfoundation/hardhat-ethers';
+import '@typechain/hardhat';
+
+import 'hardhat-ignore-warnings';
+import 'hardhat-gas-reporter';
+import 'hardhat-contract-sizer';
+import { warnings } from '@balancer-labs/v3-common/hardhat-base-config';
+
+const config: HardhatUserConfig = {
+  solidity: {
+    compilers: hardhatBaseConfig.compilers,
+  },
+  warnings,
+};
+
+export default config;

pkg/governance-scripts/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@balancer-labs/v3-governance-scripts",
+  "version": "0.1.0",
+  "description": "V3 Governance Scripts",
+  "license": "GPL-3.0-only",
+  "homepage": "https://github.com/balancer-labs/balancer-v3-monorepo/tree/master/pkg/governance-scripts#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/balancer-labs/balancer-v3-monorepo.git",
+    "directory": "pkg/governance-scripts"
+  },
+  "bugs": {
+    "url": "https://github.com/balancer-labs/balancer-v3-monorepo/issues"
+  },
+  "files": [
+    "contracts/**/*"
+  ],
+  "scripts": {
+    "build": "yarn compile && rm -rf artifacts/build-info",
+    "compile": "hardhat compile",
+    "compile:watch": "nodemon --ext sol --exec yarn compile",
+    "lint": "yarn lint:solidity && yarn lint:typescript",
+    "lint:solidity": "npx prettier --check --plugin=prettier-plugin-solidity 'contracts/**/*.sol' || npx solhint 'contracts/**/*.sol'",
+    "lint:typescript": "NODE_NO_WARNINGS=1 eslint . --ext .ts --ignore-path ../../.eslintignore  --max-warnings 0",
+    "prettier": "npx prettier --write --plugin=prettier-plugin-solidity 'contracts/**/*.sol'",
+    "slither": "yarn compile --force && bash -c 'source ../../slither/bin/activate && slither --compile-force-framework hardhat --ignore-compile . --config-file ../../.slither.config.json'",
+    "slither:triage": "yarn compile && bash -c 'source ../../slither/bin/activate && slither --compile-force-framework hardhat --ignore-compile . --config-file ../../.slither.config.json --triage-mode'"
+  },
+  "devDependencies": {
+    "@balancer-labs/solidity-toolbox": "workspace:*",
+    "@types/lodash": "^4.14.186",
+    "@typescript-eslint/eslint-plugin": "^5.41.0",
+    "@typescript-eslint/parser": "^5.41.0",
+    "decimal.js": "^10.4.2",
+    "eslint": "^8.26.0",
+    "eslint-plugin-mocha-no-only": "^1.1.1",
+    "eslint-plugin-prettier": "^4.2.1",
+    "hardhat": "^2.21.0",
+    "lodash.frompairs": "^4.0.1",
+    "lodash.pick": "^4.4.0",
+    "lodash.range": "^3.2.0",
+    "lodash.times": "^4.3.2",
+    "lodash.zip": "^4.2.0",
+    "mocha": "^10.1.0",
+    "nodemon": "^2.0.20",
+    "solhint": "^3.4.1"
+  }
+}

pkg/governance-scripts/tsconfig.json

@@ -0,0 +1,6 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  }
+}