Migrate hardhat-upgrades plugin to use hardhat v3 (#1194)

Co-authored-by: Eric Lau <ericglau@outlook.com>

Author: afa7789

.eslintrc.js

@@ -1,7 +1,7 @@
 module.exports = {
   root: true,
   parserOptions: {
-    ecmaVersion: 2020,
+    ecmaVersion: 2022,
   },
   extends: ['eslint:recommended', 'plugin:prettier/recommended'],
   env: {
@@ -15,7 +15,13 @@ module.exports = {
     'unicorn/no-array-reduce': 'warn',
     'no-plusplus': ['warn', { allowForLoopAfterthoughts: true }],
   },
-  ignorePatterns: ['submodules'],
+  ignorePatterns: [
+    'submodules',
+    // ESLint 8.x doesn't support ES2025 import attributes syntax
+    // uses import attributes (import ... with { type: 'json' })
+    // which is valid ES2025 syntax but ESLint parser doesn't support it yet
+    'packages/plugin-hardhat/test/*.js',
+  ],
   overrides: [
     {
       files: ['*.ts'],
@@ -29,10 +35,14 @@ module.exports = {
       },
     },
     {
-      files: ['ava.config.js'],
+      files: ['ava.config.js', 'packages/plugin-hardhat/test/*.js', 'packages/plugin-hardhat/src/*.js'],
       parserOptions: {
+        ecmaVersion: 'latest',
         sourceType: 'module',
       },
+      rules: {
+        'no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+      },
     },
     {
       files: ['packages/plugin-truffle/**'],

.github/actions/setup/action.yml

@@ -5,9 +5,19 @@ runs:
   steps:
     - uses: actions/setup-node@v4
       with:
-        node-version: 20.x
+        node-version: 22.x
         cache: yarn
 
+    - name: Cache Hardhat solc compilers
+      uses: actions/cache@v4
+      with:
+        path: |
+          ~/.cache/hardhat/compilers-v3
+          ~/.cache/hardhat-nodejs/compilers-v3
+        key: hardhat-compilers-${{ runner.os }}-${{ hashFiles('**/package.json', '**/yarn.lock') }}
+        restore-keys: |
+          hardhat-compilers-${{ runner.os }}-
+
     - name: Install dependencies
       run: yarn --frozen-lockfile --prefer-offline
       shell: bash

.github/workflows/changeset.yml

@@ -22,6 +22,7 @@ jobs:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 #v4.2.2
         with:
           fetch-depth: 0 # Include history so Changesets finds merge-base
+          submodules: recursive
       - name: Set up environment
         uses: ./.github/actions/setup
       - name: Check changeset

.github/workflows/checks.yml

@@ -17,6 +17,8 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        submodules: recursive
 
     - name: Set up environment
       uses: ./.github/actions/setup
@@ -35,10 +37,16 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        submodules: recursive
 
     - name: Set up environment
       uses: ./.github/actions/setup
 
+    - name: Assert upgrades-core resolution (plugin-hardhat)
+      if: matrix.package == 'plugin-hardhat'
+      run: bash packages/plugin-hardhat/scripts/assert-upgrades-core-resolution.sh
+
     - name: Run tests
       run: yarn --cwd "packages/${{matrix.package}}" run test
 
@@ -47,10 +55,15 @@ jobs:
 
     steps:
     - uses: actions/checkout@v4
+      with:
+        submodules: recursive
 
     - name: Set up environment
       uses: ./.github/actions/setup
 
+    - name: Assert upgrades-core resolution
+      run: bash packages/plugin-hardhat/scripts/assert-upgrades-core-resolution.sh
+
     - name: Run coverage
       run: yarn coverage
 
@@ -114,4 +127,4 @@ jobs:
       if: steps.create_pull_request.outcome == 'failure'
       run: |
         git push origin --delete $BRANCH_NAME
-               
+               

.github/workflows/publish.yml

@@ -18,6 +18,7 @@ jobs:
         with:
           fetch-depth: 0 # To get all tags
           ref: ${{ github.ref }}
+          submodules: recursive
       - name: Set up environment
         uses: ./.github/actions/setup
       - name: Create Prepare Release PR or Publish

.github/workflows/version.yml

@@ -21,6 +21,7 @@ jobs:
         with:
           fetch-depth: 0 # To get all tags
           ref: ${{ github.ref }}
+          submodules: recursive
       - name: Set up environment
         uses: ./.github/actions/setup
       - name: Create Prepare Release PR

.node-version

@@ -1 +1 @@
-20
+22

README.md

@@ -5,6 +5,11 @@
 [![Checks](https://github.com/OpenZeppelin/openzeppelin-upgrades/actions/workflows/checks.yml/badge.svg)](https://github.com/OpenZeppelin/openzeppelin-upgrades/actions/workflows/checks.yml)
 [![License](https://img.shields.io/github/license/OpenZeppelin/openzeppelin-upgrades)](https://github.com/OpenZeppelin/openzeppelin-upgrades/blob/master/LICENSE)
 
+> [!NOTE]
+> This branch contains support for Hardhat 3. This version is still in testing. Do not use it to deploy or upgrade production deployments. For details and migration instructions, see:
+> - [Hardhat Upgrades for Hardhat 3](./packages/plugin-hardhat/README.md)
+> - [Hardhat 2 to 3 migration guide](./packages/plugin-hardhat/MIGRATION.md)
+
 **Integrate upgrades into your existing workflow.** Plugins for [Hardhat](https://hardhat.org/) and [Foundry](https://book.getfoundry.sh/) to deploy and manage upgradeable contracts on Ethereum.
 
 - Deploy upgradeable contracts.

package.json

@@ -22,7 +22,7 @@
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-prettier": "^5.0.0",
     "eslint-plugin-unicorn": "^51.0.0",
-    "ethers": "^6.8.1",
+    "ethers": "^6.14.0",
     "nyc": "^17.0.0",
     "prettier": "^3.0.0",
     "typescript": "^5.0.0",

packages/core/CHANGELOG.md

@@ -1,12 +1,17 @@
 # Changelog
 
+## 1.45.0-alpha.1 (2026-03-02)
+
+- Improve support for validating build-info files in CLI for Hardhat 3, Hardhat 2, and Foundry. ([#1194](https://github.com/OpenZeppelin/openzeppelin-upgrades/pull/1194))
+
+> **Note** ⚠️ This version is still in testing and should not be used in production.
+
 ## 1.45.0-alpha.0 (2026-01-20)
 
 - Support Hardhat 3 build-info file format for CLI validation ([#1203](https://github.com/OpenZeppelin/openzeppelin-upgrades/pull/1203)) 
 
 > **Note** ⚠️ This version is still in testing and should not be used in production.
 
-
 ## 1.44.2 (2025-11-03)
 
 - Add Celo Sepolia network to manifest file names. ([#1189](https://github.com/OpenZeppelin/openzeppelin-upgrades/pull/1189))