feat: Add ResponseStatusCodeError for handling 4xx and 5xx errors

- Introduced a new error type ResponseStatusCodeError to handle 4xx and 5xx HTTP response status codes. This is needed because we set throwOnError to true in all requests.
- ResponseStatusCodeError includes `statusCode`, `headers`, and `body` properties.

Author: schaable

v-next/hardhat-utils/src/errors/request.ts

@@ -32,3 +32,19 @@ export class ConnectionRefusedError extends CustomError {
     super(`Connection to ${sanitizeUrl(url)} was refused`, cause);
   }
 }
+
+export class ResponseStatusCodeError extends CustomError {
+  public readonly statusCode: number;
+  public readonly headers:
+    | string[]
+    | Record<string, string | string[] | undefined>
+    | null;
+  public readonly body: null | Record<string, any> | string;
+
+  constructor(url: string, cause: UndiciT.errors.ResponseStatusCodeError) {
+    super(`Received an unexpected status code from ${sanitizeUrl(url)}`, cause);
+    this.statusCode = cause.statusCode;
+    this.headers = cause.headers;
+    this.body = cause.body;
+  }
+}

v-next/hardhat-utils/src/internal/request.ts

@@ -34,7 +34,7 @@ export async function getBaseRequestOptions(
   signal?: EventEmitter | AbortSignal | undefined;
   dispatcher: UndiciT.Dispatcher;
   headers: Record<string, string>;
-  throwOnError: boolean;
+  throwOnError: true;
 }> {
   const { Dispatcher } = await import("undici");
   const dispatcher =

v-next/hardhat-utils/src/request.ts

@@ -13,6 +13,7 @@ import {
   DispatcherError,
   RequestTimeoutError,
   ConnectionRefusedError,
+  ResponseStatusCodeError,
 } from "./errors/request.js";
 import { move } from "./fs.js";
 import {
@@ -106,6 +107,11 @@ export async function getRequest(
       throw new RequestTimeoutError(url, e);
     }
 
+    if (e.code === "UND_ERR_RESPONSE_STATUS_CODE") {
+      ensureError<UndiciT.errors.ResponseStatusCodeError>(e);
+      throw new ResponseStatusCodeError(url, e);
+    }
+
     throw new RequestError(url, "GET", e);
   }
 }
@@ -160,6 +166,11 @@ export async function postJsonRequest(
       throw new RequestTimeoutError(url, e);
     }
 
+    if (e.code === "UND_ERR_RESPONSE_STATUS_CODE") {
+      ensureError<UndiciT.errors.ResponseStatusCodeError>(e);
+      throw new ResponseStatusCodeError(url, e);
+    }
+
     throw new RequestError(url, "POST", e);
   }
 }
@@ -215,6 +226,11 @@ export async function postFormRequest(
       throw new RequestTimeoutError(url, e);
     }
 
+    if (e.code === "UND_ERR_RESPONSE_STATUS_CODE") {
+      ensureError<UndiciT.errors.ResponseStatusCodeError>(e);
+      throw new ResponseStatusCodeError(url, e);
+    }
+
     throw new RequestError(url, "POST", e);
   }
 }
@@ -270,6 +286,11 @@ export async function download(
       throw new RequestTimeoutError(url, e);
     }
 
+    if (e.code === "UND_ERR_RESPONSE_STATUS_CODE") {
+      ensureError<UndiciT.errors.ResponseStatusCodeError>(e);
+      throw new ResponseStatusCodeError(url, e);
+    }
+
     throw new DownloadError(url, e);
   }
 }
@@ -373,9 +394,10 @@ export function isValidUrl(url: string): boolean {
 }
 
 export {
+  ConnectionRefusedError,
+  DispatcherError,
   DownloadError,
   RequestError,
-  DispatcherError,
   RequestTimeoutError,
-  ConnectionRefusedError,
+  ResponseStatusCodeError,
 } from "./errors/request.js";