chore: update minimal supported version of node to v20 (#6982)

galargh · web-flow · commit 14b3042ed113 · 2025-07-16T13:35:12.000+02:00
diff --git a/.changeset/sharp-views-scream.md b/.changeset/sharp-views-scream.md
@@ -0,0 +1,27 @@
+---
+"@nomicfoundation/hardhat-ignition-ethers": minor
+"@nomicfoundation/hardhat-network-helpers": minor
+"@nomicfoundation/hardhat-chai-matchers": minor
+"@nomicfoundation/ignition-core": minor
+"@nomicfoundation/hardhat-ignition-viem": minor
+"@nomicfoundation/hardhat-toolbox-viem": minor
+"@nomiclabs/hardhat-web3-legacy": minor
+"hardhat-shorthand": minor
+"@nomicfoundation/hardhat-ignition": minor
+"@nomiclabs/hardhat-truffle4": minor
+"@nomiclabs/hardhat-truffle5": minor
+"@nomicfoundation/hardhat-foundry": minor
+"@nomiclabs/hardhat-solhint": minor
+"@nomicfoundation/hardhat-toolbox": minor
+"@nomicfoundation/hardhat-web3-v4": minor
+"@nomicfoundation/hardhat-ethers": minor
+"@nomicfoundation/hardhat-ledger": minor
+"@nomicfoundation/hardhat-verify": minor
+"@nomiclabs/hardhat-solpp": minor
+"@nomiclabs/hardhat-vyper": minor
+"hardhat": minor
+"@nomicfoundation/hardhat-viem": minor
+"@nomiclabs/hardhat-web3": minor
+---
+
+Updated the minimal supported version of Node to v20 ([#6982](https://github.com/NomicFoundation/hardhat/pull/6982))
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -3,7 +3,7 @@
   "image": "mcr.microsoft.com/devcontainers/base:bullseye",
   "features": {
     "ghcr.io/devcontainers/features/node:1": {
-      "version": "18"
+      "version": "20"
     }
   },
   "postCreateCommand": "scripts/setup.sh",
diff --git a/.github/actions/setup-env/action.yml b/.github/actions/setup-env/action.yml
@@ -9,7 +9,7 @@ inputs:
   node-version:
     description: Version of node to install
     required: false
-    default: "18"
+    default: "20"
   cache-save:
     description: Whether to save the pnpm cache
     required: false
diff --git a/.github/workflows/hardhat-ci.yml b/.github/workflows/hardhat-ci.yml
@@ -30,7 +30,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
       - run: yq -p yaml -o json pnpm-lock.yaml | tee pnpm-lock.json
       - id: generate
         env:
diff --git a/.github/workflows/hardhat-core-ci.yml b/.github/workflows/hardhat-core-ci.yml
@@ -39,7 +39,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node: [18.15]
+        node: [20]
         os: ["macos-13", "ubuntu-latest", "windows-latest"]
     steps:
       - uses: actions/checkout@v4
@@ -77,7 +77,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        node: [18.15]
+        node: [20]
         os: ["macos-13", "ubuntu-latest", "windows-latest"]
     steps:
       - uses: actions/checkout@v4
@@ -111,6 +111,7 @@ jobs:
     name: Test different versions of @types/node
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
         # TODO: Currently there is no @types/node for Node 24,
         # include it when it is available.
diff --git a/.nvmrc b/.nvmrc
@@ -1 +1 @@
-18
+20
diff --git a/packages/hardhat-chai-matchers/package.json b/packages/hardhat-chai-matchers/package.json
@@ -45,7 +45,7 @@
     "@types/bn.js": "^5.1.0",
     "@types/chai": "^4.2.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "bignumber.js": "^9.0.2",
diff --git a/packages/hardhat-core/package.json b/packages/hardhat-core/package.json
@@ -69,7 +69,7 @@
     "@types/keccak": "^3.0.1",
     "@types/lodash": "^4.14.123",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/resolve": "^1.17.1",
     "@types/semver": "^6.0.2",
     "@types/sinon": "^9.0.8",
diff --git a/packages/hardhat-core/src/builtin-tasks/compile.ts b/packages/hardhat-core/src/builtin-tasks/compile.ts
@@ -163,14 +163,19 @@ subtask(TASK_COMPILE_SOLIDITY_READ_FILE)
           encoding: "utf8",
         });
       } catch (e) {
-        if (fsExtra.lstatSync(absolutePath).isDirectory()) {
-          throw new HardhatError(ERRORS.GENERAL.INVALID_READ_OF_DIRECTORY, {
-            absolutePath,
-          });
+        let err = e;
+        try {
+          if (fsExtra.lstatSync(absolutePath).isDirectory()) {
+            err = new HardhatError(ERRORS.GENERAL.INVALID_READ_OF_DIRECTORY, {
+              absolutePath,
+            });
+          }
+        } catch (_) {
+          // ignore
         }
 
         // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
-        throw e;
+        throw err;
       }
     }
   );
diff --git a/packages/hardhat-core/src/internal/cli/constants.ts b/packages/hardhat-core/src/internal/cli/constants.ts
@@ -1,7 +1 @@
-// TODO: Remove 18 on June 30, 2025
-export const SUPPORTED_NODE_VERSIONS = [
-  "^18.0.0",
-  "^20.0.0",
-  "^22.0.0",
-  "^24.0.0",
-];
+export const SUPPORTED_NODE_VERSIONS = ["^20.0.0", "^22.0.0", "^24.0.0"];
diff --git a/packages/hardhat-core/src/internal/cli/project-creation.ts b/packages/hardhat-core/src/internal/cli/project-creation.ts
@@ -81,7 +81,7 @@ const TYPESCRIPT_DEPENDENCIES: Dependencies = {};
 const TYPESCRIPT_PEER_DEPENDENCIES: Dependencies = {
   "@types/chai": "^4.2.0",
   "@types/mocha": ">=9.1.0",
-  "@types/node": ">=18.0.0",
+  "@types/node": ">=20.0.0",
   "ts-node": ">=8.0.0",
   typescript: ">=4.5.0",
 };
diff --git a/packages/hardhat-core/src/internal/core/config/config-loading.ts b/packages/hardhat-core/src/internal/core/config/config-loading.ts
@@ -34,9 +34,13 @@ export function importCsjOrEsModule(filePath: string): any {
     // The kind of error we get in these cases depends on the Node.js version.
     const node20Heuristic = e.code === "ERR_REQUIRE_ESM";
     // Also works for node v24
+    const lines = e.message.split("\n");
+    const message = lines.length > 0 ? lines[0] : "";
     const node22Heuristic =
-      e.message === "module is not defined" ||
-      e.message === "require is not defined";
+      message === "module is not defined" ||
+      message === "require is not defined" ||
+      message === "module is not defined in ES module scope" ||
+      message === "require is not defined in ES module scope";
     if (node20Heuristic || node22Heuristic) {
       throw new HardhatError(
         ERRORS.GENERAL.ESM_PROJECT_WITHOUT_CJS_CONFIG,
diff --git a/packages/hardhat-core/test/builtin-tasks/compile.ts b/packages/hardhat-core/test/builtin-tasks/compile.ts
@@ -223,12 +223,18 @@ describe("compile task", function () {
 
       it("should throw an error because the file does not exist", async function () {
         const absolutePath = `${__dirname}/../fixture-projects/${folderName}/contracts/file.sol`;
+        const expectedPath =
+          process.platform === "win32"
+            ? `${fsExtra.realpathSync(
+                path.dirname(absolutePath)
+              )}\\${path.basename(absolutePath)}`
+            : absolutePath;
 
         await expect(
           this.env.run(TASK_COMPILE_SOLIDITY_READ_FILE, { absolutePath })
         )
           .to.be.rejectedWith(
-            `ENOENT: no such file or directory, lstat '${absolutePath}'`
+            `ENOENT: no such file or directory, open '${expectedPath}'`
           )
           .and.eventually.have.property("name", "Error"); // Default js error
       });
diff --git a/packages/hardhat-core/test/internal/cli/is-node-version-to-warn-on.ts b/packages/hardhat-core/test/internal/cli/is-node-version-to-warn-on.ts
@@ -3,9 +3,6 @@ import { isNodeVersionToWarnOn } from "../../../src/internal/cli/is-node-version
 
 describe("isNodeVersionToWarnOn", function () {
   it("Should not warn on supported versions", function () {
-    assert.isFalse(isNodeVersionToWarnOn("v18.0.0"));
-    assert.isFalse(isNodeVersionToWarnOn("v18.20.3"));
-
     assert.isFalse(isNodeVersionToWarnOn("v20.0.0"));
     assert.isFalse(isNodeVersionToWarnOn("v20.14.0"));
 
@@ -39,6 +36,9 @@ describe("isNodeVersionToWarnOn", function () {
 
     assert(isNodeVersionToWarnOn("v16.0.0"));
     assert(isNodeVersionToWarnOn("v16.20.20"));
+
+    assert(isNodeVersionToWarnOn("v18.0.0"));
+    assert(isNodeVersionToWarnOn("v18.20.3"));
   });
 
   it("Should warn on odd number releases", function () {
diff --git a/packages/hardhat-ethers/package.json b/packages/hardhat-ethers/package.json
@@ -50,7 +50,7 @@
     "@types/debug": "^4.1.4",
     "@types/lodash.isequal": "^4.5.6",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-foundry/package.json b/packages/hardhat-foundry/package.json
@@ -37,7 +37,7 @@
     "@nomicfoundation/eslint-plugin-slow-imports": "workspace:^",
     "@types/chai": "^4.2.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-ignition-core/package.json b/packages/hardhat-ignition-core/package.json
@@ -56,7 +56,7 @@
     "@types/debug": "^4.1.7",
     "@types/fs-extra": "^9.0.13",
     "@types/mocha": "9.1.1",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/ndjson": "2.0.1",
     "@types/lodash": "^4.14.123",
     "@typescript-eslint/eslint-plugin": "^5.57.1",
diff --git a/packages/hardhat-ignition-ethers/package.json b/packages/hardhat-ignition-ethers/package.json
@@ -41,7 +41,7 @@
     "@types/chai": "^4.2.22",
     "@types/chai-as-promised": "^7.1.4",
     "@types/mocha": "9.1.1",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^10.0.13",
     "@typescript-eslint/eslint-plugin": "^5.57.1",
     "@typescript-eslint/experimental-utils": "^5.62.0",
diff --git a/packages/hardhat-ignition-viem/package.json b/packages/hardhat-ignition-viem/package.json
@@ -42,7 +42,7 @@
     "@types/chai": "^4.2.22",
     "@types/chai-as-promised": "^7.1.4",
     "@types/mocha": "9.1.1",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^10.0.13",
     "@typescript-eslint/eslint-plugin": "^5.57.1",
     "@typescript-eslint/experimental-utils": "^5.62.0",
diff --git a/packages/hardhat-ignition/package.json b/packages/hardhat-ignition/package.json
@@ -57,7 +57,7 @@
     "@types/debug": "^4.1.7",
     "@types/fs-extra": "^9.0.13",
     "@types/mocha": "9.1.1",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/prompts": "^2.4.2",
     "@types/sinon": "^10.0.13",
     "@typescript-eslint/eslint-plugin": "^5.57.1",
diff --git a/packages/hardhat-ledger/package.json b/packages/hardhat-ledger/package.json
@@ -54,7 +54,7 @@
     "@types/chai": "^4.2.0",
     "@types/fs-extra": "^5.1.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-network-helpers/package.json b/packages/hardhat-network-helpers/package.json
@@ -46,7 +46,7 @@
     "@types/chai": "^4.2.0",
     "@types/chai-as-promised": "^7.1.3",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-shorthand/package.json b/packages/hardhat-shorthand/package.json
@@ -40,7 +40,7 @@
     "@types/debug": "^4.1.4",
     "@types/fs-extra": "^5.1.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/semver": "^6.0.2",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-solhint/package.json b/packages/hardhat-solhint/package.json
@@ -43,7 +43,7 @@
     "@types/chai": "^4.2.0",
     "@types/fs-extra": "^5.1.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-solpp/package.json b/packages/hardhat-solpp/package.json
@@ -44,7 +44,7 @@
     "@types/chai": "^4.2.0",
     "@types/fs-extra": "^5.1.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-toolbox-viem/package.json b/packages/hardhat-toolbox-viem/package.json
@@ -52,7 +52,7 @@
     "@types/chai": "^4.2.0",
     "@types/chai-as-promised": "^7.1.6",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
@@ -79,7 +79,7 @@
     "@types/chai": "^4.2.0",
     "@types/chai-as-promised": "^7.1.6",
     "@types/mocha": ">=9.1.0",
-    "@types/node": ">=18.0.0",
+    "@types/node": ">=20.0.0",
     "chai": "^4.2.0",
     "hardhat": "workspace:^2.11.0",
     "hardhat-gas-reporter": "^2.3.0",
diff --git a/packages/hardhat-toolbox/package.json b/packages/hardhat-toolbox/package.json
@@ -50,7 +50,7 @@
     "@typechain/hardhat": "^9.0.0",
     "@types/chai": "^4.2.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.4.1",
@@ -80,7 +80,7 @@
     "@typechain/hardhat": "^9.0.0",
     "@types/chai": "^4.2.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": ">=18.0.0",
+    "@types/node": ">=20.0.0",
     "chai": "^4.2.0",
     "ethers": "^6.14.0",
     "hardhat": "workspace:^2.11.0",
diff --git a/packages/hardhat-truffle4/package.json b/packages/hardhat-truffle4/package.json
@@ -47,7 +47,7 @@
     "@types/fs-extra": "^5.1.0",
     "@types/glob": "^7.1.1",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-truffle5/package.json b/packages/hardhat-truffle5/package.json
@@ -47,7 +47,7 @@
     "@types/fs-extra": "^5.1.0",
     "@types/glob": "^7.1.1",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-verify/package.json b/packages/hardhat-verify/package.json
@@ -58,7 +58,7 @@
     "@types/debug": "^4.1.4",
     "@types/lodash.clonedeep": "^4.5.7",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/semver": "^6.0.2",
     "@types/sinon": "^9.0.8",
     "@types/sinon-chai": "^3.2.9",
diff --git a/packages/hardhat-viem/package.json b/packages/hardhat-viem/package.json
@@ -46,7 +46,7 @@
     "@types/lodash": "^4.14.123",
     "@types/lodash.memoize": "^4.1.7",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/sinon": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-vyper/package.json b/packages/hardhat-vyper/package.json
@@ -48,7 +48,7 @@
     "@types/fs-extra": "^5.1.0",
     "@types/lodash": "^4.14.123",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@types/semver": "^6.0.2",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
diff --git a/packages/hardhat-web3-legacy/package.json b/packages/hardhat-web3-legacy/package.json
@@ -38,7 +38,7 @@
     "@nomicfoundation/eslint-plugin-slow-imports": "workspace:^",
     "@types/chai": "^4.2.0",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-web3-v4/package.json b/packages/hardhat-web3-v4/package.json
@@ -38,7 +38,7 @@
     "@types/chai": "^4.2.0",
     "@types/chai-as-promised": "^7.1.3",
     "@types/mocha": ">=9.1.0",
-    "@types/node": "^18.0.0",
+    "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "5.61.0",
     "@typescript-eslint/parser": "5.61.0",
     "chai": "^4.2.0",
diff --git a/packages/hardhat-web3/package.json b/packages/hardhat-web3/package.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`"image": "mcr.microsoft.com/devcontainers/base:bullseye",`
`4`	`4`	`"features": {`
`5`	`5`	`"ghcr.io/devcontainers/features/node:1": {`
`6`		`- "version": "18"`
	`6`	`+ "version": "20"`
`7`	`7`	`}`
`8`	`8`	`},`
`9`	`9`	`"postCreateCommand": "scripts/setup.sh",`