[EPIC] Lido V3 Release

.env.example

@@ -1,6 +1,5 @@
 # RPC URL for a locally running node (Ganache, Anvil, Hardhat Network, etc.), used for scratch deployment and tests
 LOCAL_RPC_URL=http://localhost:8555
-
 LOCAL_LOCATOR_ADDRESS=
 LOCAL_AGENT_ADDRESS=
 LOCAL_VOTING_ADDRESS=
@@ -23,13 +22,13 @@ LOCAL_VALIDATOR_EXIT_DELAY_VERIFIER_ADDRESS=
 LOCAL_VALIDATORS_EXIT_BUS_ORACLE_ADDRESS=
 LOCAL_WITHDRAWAL_QUEUE_ADDRESS=
 LOCAL_WITHDRAWAL_VAULT_ADDRESS=
+LOCAL_STAKING_VAULT_FACTORY_ADDRESS=
+LOCAL_STAKING_VAULT_BEACON_ADDRESS=
+LOCAL_VALIDATOR_CONSOLIDATION_REQUESTS_ADDRESS=
 
-# RPC URL for a separate, non Hardhat Network node (Anvil, Infura, Alchemy, etc.)
-MAINNET_RPC_URL=http://localhost:8545
-
-# RPC URL for Hardhat Network forking, required for running tests on mainnet fork with tracing (Infura, Alchemy, etc.)
+# RPC URL for Hardhat Network forking, required for running tests on fork with tracing (Infura, Alchemy, etc.)
 # https://hardhat.org/hardhat-network/docs/guides/forking-other-networks#forking-other-networks
-FORK_RPC_URL=https://eth.drpc.org
+RPC_URL=https://eth.drpc.org
 
 # https://docs.lido.fi/deployed-contracts
 MAINNET_LOCATOR_ADDRESS=0xC1d0b3DE6792Bf6b4b37EccdcC24e45978Cfd2Eb
@@ -53,12 +52,27 @@ MAINNET_STAKING_ROUTER_ADDRESS=
 MAINNET_VALIDATORS_EXIT_BUS_ORACLE_ADDRESS=
 MAINNET_WITHDRAWAL_QUEUE_ADDRESS=
 MAINNET_WITHDRAWAL_VAULT_ADDRESS=
+MAINNET_STAKING_VAULT_FACTORY_ADDRESS=
+MAINNET_STAKING_VAULT_BEACON_ADDRESS=
+MAINNET_VALIDATOR_CONSOLIDATION_REQUESTS_ADDRESS=
+
+HOODI_LOCATOR_ADDRESS=0xe2EF9536DAAAEBFf5b1c130957AB3E80056b06D8
+HOODI_AGENT_ADDRESS=0x0534aA41907c9631fae990960bCC72d75fA7cfeD
+HOODI_VOTING_ADDRESS=0x49B3512c44891bef83F8967d075121Bd1b07a01B
+HOODI_EASY_TRACK_EXECUTOR_ADDRESS=0x79a20FD0FA36453B2F45eAbab19bfef43575Ba9E
+
+SEPOLIA_RPC_URL=
+HOODI_RPC_URL=
 
 # Scratch deployment via hardhat variables
 DEPLOYER=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
 GENESIS_TIME=1639659600
+SLOTS_PER_EPOCH=32
 GAS_PRIORITY_FEE=1
 GAS_MAX_FEE=100
 
 # Etherscan API key for verifying contracts
 ETHERSCAN_API_KEY=
+
+# Local devnet private key
+LOCAL_DEVNET_PK=0x0000000000000000000000000000000000000000000000000000000000000000

.github/workflows/coverage.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   coverage:
-    name: Hardhat
+    name: Hardhat / Unit Tests
     runs-on: ubuntu-latest
     env:
       NODE_OPTIONS: --max_old_space_size=6400
@@ -23,10 +23,6 @@ jobs:
       - name: Common setup
         uses: ./.github/workflows/setup
 
-      # Remove the integration tests from the test suite, as they require a mainnet fork to run properly
-      - name: Remove integration tests
-        run: rm -rf test/integration
-
       - name: Collect coverage
         run: yarn test:coverage
 

.github/workflows/linters.yml

@@ -44,3 +44,29 @@ jobs:
 
       - name: Run typescript types check
         run: yarn typecheck
+
+  format:
+    name: Format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Common setup
+        uses: ./.github/workflows/setup
+
+      - name: Run format check
+        run: yarn format
+
+  validate-configs:
+    name: Validate Configs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Common setup
+        uses: ./.github/workflows/setup
+
+      - name: Validate configurations
+        run: yarn validate:configs

.github/workflows/tests-integration-hoodi.yml

@@ -0,0 +1,29 @@
+name: Integration Tests
+
+on: [push]
+
+jobs:
+  test_hardhat_integration_fork:
+    name: Hardhat / Hoodi
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    env:
+      NODE_OPTIONS: --max_old_space_size=7200
+      SKIP_GAS_REPORT: true
+      SKIP_CONTRACT_SIZE: true
+      SKIP_INTERFACES_CHECK: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Common setup
+        uses: ./.github/workflows/setup
+
+      - name: Run integration tests
+        run: yarn test:integration
+        env:
+          RPC_URL: "${{ secrets.HOODI_RPC_URL }}"
+          LOG_LEVEL: debug
+          NETWORK_STATE_FILE: deployed-hoodi.json
+          # TODO: enable csm integration tests later (CSM is deployed on hoodis)
+          INTEGRATION_WITH_CSM: "off"

.github/workflows/tests-integration-mainnet.yml

@@ -1,23 +1,26 @@
 name: Integration Tests
 
-on:
-  push:
-  schedule:
-    - cron: "0 10 */2 * *"
+on: [push]
 
 jobs:
   test_hardhat_integration_fork:
     name: Hardhat / Mainnet
     runs-on: ubuntu-latest
     timeout-minutes: 120
+    env:
+      NODE_OPTIONS: --max_old_space_size=7200
+      SKIP_GAS_REPORT: true
+      SKIP_CONTRACT_SIZE: true
+      SKIP_INTERFACES_CHECK: true
 
     services:
       hardhat-node:
-        image: ghcr.io/lidofinance/hardhat-node:2.24.3
+        image: ghcr.io/lidofinance/hardhat-node:2.26.0
         ports:
-          - 8545:8545
+          - 8555:8545
         env:
           ETH_RPC_URL: "${{ secrets.ETH_RPC_URL }}"
+          DONT_SET_CHAIN_ID: true
           HARDFORK: "prague"
 
     steps:
@@ -26,7 +29,34 @@ jobs:
       - name: Common setup
         uses: ./.github/workflows/setup
 
+      - name: Prepare network state file
+        run: cp deployed-mainnet.json deployed-mainnet-upgrade.json
+
+      - name: Deploy upgrade
+        run: yarn upgrade:deploy
+        env:
+          RPC_URL: http://localhost:8555
+          DEPLOYER: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266" # first acc of default mnemonic "test test ..."
+          GAS_PRIORITY_FEE: 1
+          GAS_MAX_FEE: 100
+          GAS_LIMIT: 30000000
+          NETWORK_STATE_FILE: deployed-mainnet-upgrade.json
+          UPGRADE_PARAMETERS_FILE: scripts/upgrade/upgrade-params-mainnet.toml
+
+      - name: Mock Aragon voting
+        run: yarn upgrade:mock-voting
+        env:
+          RPC_URL: http://localhost:8555
+          NETWORK_STATE_FILE: deployed-mainnet-upgrade.json
+
+      - name: Workaround for not updated state error when forking a fork
+        run: yarn hardhat --network local run --no-compile scripts/utils/mine.ts
+        env:
+          RPC_URL: http://localhost:8555
+
       - name: Run integration tests
-        run: yarn test:integration:fork:mainnet
+        run: yarn test:integration
         env:
-          RPC_URL: http://localhost:8545
+          RPC_URL: http://localhost:8555
+          LOG_LEVEL: debug
+          NETWORK_STATE_FILE: deployed-mainnet-upgrade.json

.github/workflows/tests-integration-scratch.yml

@@ -1,4 +1,4 @@
-name: Integration Tests
+name: Integration Tests Scratch
 
 on: [push]
 
@@ -7,10 +7,14 @@ jobs:
     name: Hardhat / Scratch
     runs-on: ubuntu-latest
     timeout-minutes: 120
+    env:
+      SKIP_GAS_REPORT: true
+      SKIP_CONTRACT_SIZE: true
+      SKIP_INTERFACES_CHECK: true
 
     services:
       hardhat-node:
-        image: ghcr.io/lidofinance/hardhat-node:2.24.3-scratch
+        image: ghcr.io/lidofinance/hardhat-node:2.26.0-scratch
         ports:
           - 8555:8545
 
@@ -33,13 +37,12 @@ jobs:
           GAS_PRIORITY_FEE: 1
           GAS_MAX_FEE: 100
           NETWORK_STATE_FILE: "deployed-local.json"
-          NETWORK_STATE_DEFAULTS_FILE: "scripts/scratch/deployed-testnet-defaults.json"
+          NETWORK_STATE_DEFAULTS_FILE: "scripts/defaults/testnet-defaults.json"
 
       - name: Finalize scratch deployment
         run: yarn hardhat --network local run --no-compile scripts/utils/mine.ts
 
       - name: Run integration tests
         run: yarn test:integration:fork:local
         env:
-          LOG_LEVEL: "debug"
           INTEGRATION_WITH_CSM: "off"

.github/workflows/tests-integration-upgrade-template.yml

@@ -0,0 +1,29 @@
+name: Integration Test (Upgrade)
+
+on: [push]
+
+jobs:
+  test_hardhat_integration_fork_template:
+    name: Hardhat / Mainnet
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    env:
+      SKIP_GAS_REPORT: true
+      SKIP_CONTRACT_SIZE: true
+      SKIP_INTERFACES_CHECK: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Common setup
+        uses: ./.github/workflows/setup
+
+      - name: Prepare network state file
+        run: cp deployed-mainnet.json deployed-mainnet-upgrade.json
+
+      - name: Run Upgrade Template Integration Tests
+        run: yarn test:integration:upgrade-template
+        env:
+          RPC_URL: "${{ secrets.ETH_RPC_URL }}"
+          UPGRADE_PARAMETERS_FILE: scripts/upgrade/upgrade-params-mainnet.toml
+          GAS_LIMIT: 30000000

.github/workflows/verify-state-hoodi.yml

@@ -0,0 +1,39 @@
+name: Verify State On Hoodi
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - "feat/ci-hoodi-state"
+  schedule:
+    - cron: "0 0 * * *" # runs every day at midnight UTC
+
+jobs:
+  run_state_mate:
+    name: Run state-mate on hoodi
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    env:
+      STATE_MATE_BRANCH: "feat/v3-hoodi"
+      HOODI_REMOTE_RPC_URL: "https://hoodi.drpc.org"
+
+    steps:
+      - name: Checkout state-mate
+        uses: actions/checkout@v4
+        with:
+          repository: lidofinance/state-mate
+          ref: ${{ env.STATE_MATE_BRANCH }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: yarn install
+
+      - name: Run state-mate
+        run: yarn start configs/hoodi/lidov3-testnet.yaml

.gitignore

@@ -2,9 +2,11 @@
 .yarn/
 .vscode/
 .cursor/
+.claude/
 
 node_modules/
 coverage/
+state-mate/
 
 coverage.json
 
@@ -25,6 +27,7 @@ lib/abi/*.json
 .env
 accounts.json
 deployed-local.json
+deployed-local-devnet.json
 deployed-hardhat.json
 deployed-local-devnet.json
 deployed-mainnet-upgrade.json

.husky/pre-commit

@@ -1 +1,3 @@
+yarn compile
 yarn lint-staged
+yarn typecheck

.nvmrc

@@ -1 +1 @@
-20.12
+22.15

.solcover.js

@@ -11,5 +11,9 @@ module.exports = {
     // Skip contracts that are tested by Foundry tests
     "common/lib", // 100% covered by test/common/*.t.sol
     "0.8.9/lib/UnstructuredStorage.sol", // 100% covered by test/0.8.9/unstructuredStorage.t.sol
+    "openzeppelin",
+    "testnet",
+    "upgrade",
   ],
+  irMinimum: true,
 };

.solhintignore

@@ -1,2 +1,9 @@
-contracts/Migrations.sol
-contracts/0.6.11/deposit_contract.sol
+contracts/openzeppelin/
+contracts/0.8.9/utils/access/AccessControl.sol
+contracts/0.8.9/utils/access/AccessControlEnumerable.sol
+
+contracts/0.4.24/template/
+contracts/0.6.11/deposit_contract.sol
+contracts/0.6.12/
+contracts/0.8.9/WithdrawalsManagerProxy.sol
+contracts/0.8.9/LidoExecutionLayerRewardsVault.sol