Add file in hh-utils to handle hardhat configuration paths

v-next/hardhat-utils/package.json

@@ -21,6 +21,7 @@
     "./error": "./dist/src/error.js",
     "./eth": "./dist/src/eth.js",
     "./fs": "./dist/src/fs.js",
+    "./global-dir": "./dist/src/global-dir.js",
     "./hex": "./dist/src/hex.js",
     "./lang": "./dist/src/lang.js",
     "./number": "./dist/src/number.js",
@@ -74,6 +75,7 @@
     "typescript-eslint": "7.7.1"
   },
   "dependencies": {
+    "env-paths": "^2.2.0",
     "fast-equals": "^5.0.1",
     "keccak": "^3.0.4",
     "rfdc": "^1.3.1",

v-next/hardhat-utils/src/global-dir.ts

@@ -0,0 +1,17 @@
+import { ensureDir } from "./fs.js";
+
+/**
+ *  Returns the path to the hardhat configuration directory.
+ *
+ * @returns The path to the hardhat configuration directory.
+ */
+export async function getConfigDir(): Promise<string> {
+  const { config } = await generatePaths();
+  await ensureDir(config);
+  return config;
+}
+
+async function generatePaths(packageName = "hardhat") {
+  const { default: envPaths } = await import("env-paths");
+  return envPaths(packageName);
+}

v-next/hardhat-utils/test/global-dir.ts

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import { getConfigDir } from "../src/global-dir.js";
+
+describe("global-dir", () => {
+  describe("getGlobalDir", () => {
+    it("should return the path to the configuration directory with default name 'hardhat'", async () => {
+      const { default: envPaths } = await import("env-paths");
+      const expectedPath = envPaths("hardhat").config;
+
+      assert.equal(await getConfigDir(), expectedPath);
+    });
+  });
+});