feat: port the node task to hardhat v3

v-next/hardhat-errors/src/descriptors.ts

@@ -85,6 +85,7 @@ export const ERROR_CATEGORIES: {
   },
   SOLIDITY: { min: 1200, max: 1299, websiteTitle: "Solidity errors" },
   VIEM: { min: 1300, max: 1399, websiteTitle: "Hardhat-viem errors" },
+  NODE: { min: 1400, max: 1499, websiteTitle: "Hardhat node errors" },
 };
 
 export const ERRORS = {
@@ -135,7 +136,7 @@ Please double check whether you have multiple versions of the same plugin instal
     ENV_VAR_NOT_FOUND: {
       number: 7,
       messageTemplate: `Configuration Variable '{name}' not found.
-     
+
 You can define it using a plugin like hardhat-keystore, or set it as an environment variable.`,
       websiteTitle: "Configuration variable not found",
       websiteDescription: `A configuration variable was expected to be set as an environment variable, but it wasn't.`,
@@ -1224,4 +1225,13 @@ Please check Hardhat's output for more details.`,
         "The deployment transaction was mined but its receipt doesn't contain a contract address.",
     },
   },
+  NODE: {
+    INVALID_NETWORK_TYPE: {
+      number: 1400,
+      messageTemplate:
+        "The provided node network type {networkType} for network {networkName} is not recognized, only `edr` is supported.",
+      websiteTitle: "Invalid node network type",
+      websiteDescription: `The node only supports the 'edr' network type.`,
+    },
+  },
 } as const;

v-next/hardhat/package.json

@@ -68,6 +68,7 @@
     "@types/debug": "^4.1.4",
     "@types/node": "^20.14.9",
     "@types/semver": "^7.5.8",
+    "@types/ws": "^8.5.13",
     "@typescript-eslint/eslint-plugin": "^7.7.1",
     "@typescript-eslint/parser": "^7.7.1",
     "eslint": "8.57.0",
@@ -96,9 +97,11 @@
     "ethereum-cryptography": "^2.2.1",
     "micro-eth-signer": "^0.12.0",
     "p-map": "^7.0.2",
+    "raw-body": "^2.4.1",
     "semver": "^7.6.3",
     "solc": "^0.8.27",
     "tsx": "^4.11.0",
+    "ws": "^8.18.0",
     "zod": "^3.23.8"
   }
 }

v-next/hardhat/src/internal/builtin-plugins/index.ts

@@ -4,6 +4,7 @@ import artifacts from "./artifacts/index.js";
 import clean from "./clean/index.js";
 import console from "./console/index.js";
 import networkManager from "./network-manager/index.js";
+import node from "./node/index.js";
 import run from "./run/index.js";
 import solidity from "./solidity/index.js";
 import solidityTest from "./solidity-test/index.js";
@@ -19,6 +20,7 @@ export type * from "./network-manager/index.js";
 export type * from "./clean/index.js";
 export type * from "./console/index.js";
 export type * from "./run/index.js";
+export type * from "./node/index.js";
 
 // This array should be kept in order, respecting the dependencies between the
 // plugins.
@@ -31,4 +33,5 @@ export const builtinPlugins: HardhatPlugin[] = [
   clean,
   console,
   run,
+  node,
 ];

v-next/hardhat/src/internal/builtin-plugins/network-manager/json-rpc.ts

@@ -3,6 +3,7 @@ import type {
   JsonRpcRequest,
   JsonRpcResponse,
   RequestArguments,
+  SuccessfulJsonRpcResponse,
 } from "../../../types/providers.js";
 
 import { HardhatError } from "@ignored/hardhat-vnext-errors";
@@ -56,6 +57,30 @@ export function parseJsonRpcResponse(
   }
 }
 
+export function isJsonRpcRequest(payload: unknown): payload is JsonRpcRequest {
+  if (!isObject(payload)) {
+    return false;
+  }
+
+  if (payload.jsonrpc !== "2.0") {
+    return false;
+  }
+
+  if (typeof payload.id !== "number" && typeof payload.id !== "string") {
+    return false;
+  }
+
+  if (typeof payload.method !== "string") {
+    return false;
+  }
+
+  if (payload.params !== undefined && !Array.isArray(payload.params)) {
+    return false;
+  }
+
+  return true;
+}
+
 export function isJsonRpcResponse(
   payload: unknown,
 ): payload is JsonRpcResponse {
@@ -96,6 +121,12 @@ export function isJsonRpcResponse(
   return true;
 }
 
+export function isSuccessfulJsonRpcResponse(
+  payload: JsonRpcResponse,
+): payload is SuccessfulJsonRpcResponse {
+  return "result" in payload;
+}
+
 export function isFailedJsonRpcResponse(
   payload: JsonRpcResponse,
 ): payload is FailedJsonRpcResponse {