@nomicfoundation/hardhat-utils 3.0.0-next.0

package/dist/src/error.js

@@ -0,0 +1,97 @@
+/**
+ * Abstract custom error class, which inherits from the built-in Error class,
+ * making sure that the standard errror properties are set, and the stack trace
+ * is not polluted with the custom error class' code.
+ *
+ * This class supports the `cause` property, which can be used to pass the
+ * original error that caused the custom error to be thrown. Note that it needs
+ * to be an instance of the built-in Error class, or a subclass of it. See `ensureError`
+ * for a convinient way of using it.
+ *
+ * @example
+ * ```ts
+ * class MyCustomError extends CustomError {
+ * }
+ *
+ * try {
+ *   mayThrow();
+ * } catch (error) {
+ *   ensureError(error);
+ *   throw new MyCustomError('Something went wrong', error);
+ * }
+ * ```
+ */
+export class CustomError extends Error {
+    stack;
+    constructor(message, cause) {
+        super(message, cause !== undefined ? { cause } : undefined);
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+/**
+ * Ensures that the provided value is an instance of an error.
+ *
+ * @example
+ * This function is meant to be used in a catch block to ensure that you caught the right error.
+ *
+ * ```ts
+ * // Ensuring that you got an Error
+ * try {
+ *   mayThrow();
+ * } catch (error) {
+ *   ensureError(error);
+ *   console.err(error.message);
+ * }
+ *
+ * // Ensuring that you got a specific error
+ * try {
+ *   mayThrow();
+ * } catch (error) {
+ *   ensureError(error, MyError);
+ *   console.err(error.myMessage());
+ * }
+ * ```
+ *
+ * @param thrown The value to check.
+ * @param ErrorType The error type to check against.
+ * @throws The value if its not an instance of the specified error type.
+ */
+export function ensureError(thrown, ErrorType) {
+    if (ErrorType === undefined) {
+        if (thrown instanceof Error) {
+            return;
+        }
+        throw thrown;
+    }
+    if (thrown instanceof ErrorType) {
+        return;
+    }
+    throw thrown;
+}
+/**
+ * Throws an error for an unreachable code path. This function is typically
+ * used in a default case of a switch statement where all possible values of
+ * the switched variable should be handled in other cases. If the default case
+ * is reached, it means that an unexpected value was encountered, so an error
+ * is thrown.
+ *
+ * Note: The `@typescript-eslint/switch-exhaustiveness-check` rule checks for
+ * exhaustiveness in switch statements by comparing the types of the switch
+ * expression and the case clauses. However, it only works with union types and
+ * enum types. If you're switching on the result of the `typeof` operator or
+ * any other expression that doesn't return a union type or an enum type, this
+ * rule cannot enforce exhaustiveness. In such cases, you can use this function
+ * in the default case to ensure that an error is thrown if an unexpected value
+ * is encountered.
+ *
+ * @param _value The unexpected value. This parameter is unused and is only for
+ * the purpose of type checking.
+ * @param error The error to throw.
+ * @returns This function never returns normally. It always throws an error.
+ * @throws Will throw an error when called.
+ */
+export function unreachable(_value, error) {
+    throw error;
+}
+//# sourceMappingURL=error.js.map

package/dist/src/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAgB,WAAY,SAAQ,KAAK;IAC7B,KAAK,CAAU;IAE/B,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,WAAW,CACzB,MAAe,EACf,SAA0C;IAE1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,MAAM,YAAY,KAAK,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,MAAM,CAAC;IACf,CAAC;IAED,IAAI,MAAM,YAAY,SAAS,EAAE,CAAC;QAChC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CAAC,MAAa,EAAE,KAAY;IACrD,MAAM,KAAK,CAAC;AACd,CAAC"}

package/dist/src/errors/bytecode.d.ts

@@ -0,0 +1,18 @@
+import type { LibraryAddresses, LibraryLink } from "../internal/bytecode.js";
+import { CustomError } from "../error.js";
+export declare class InvalidLibraryAddressError extends CustomError {
+    constructor(libraries: LibraryAddresses);
+}
+export declare class AmbiguousLibraryNameError extends CustomError {
+    constructor(libraries: Record<string, LibraryLink[]>);
+}
+export declare class UnnecessaryLibraryError extends CustomError {
+    constructor(libraries: string[]);
+}
+export declare class OverlappingLibrariesError extends CustomError {
+    constructor(libraries: string[]);
+}
+export declare class MissingLibrariesError extends CustomError {
+    constructor(libraries: string[]);
+}
+//# sourceMappingURL=bytecode.d.ts.map

package/dist/src/errors/bytecode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytecode.d.ts","sourceRoot":"","sources":["../../../src/errors/bytecode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,0BAA2B,SAAQ,WAAW;gBAC7C,SAAS,EAAE,gBAAgB;CAUxC;AAED,qBAAa,yBAA0B,SAAQ,WAAW;gBAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;CAerD;AAED,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,SAAS,EAAE,MAAM,EAAE;CAUhC;AAED,qBAAa,yBAA0B,SAAQ,WAAW;gBAC5C,SAAS,EAAE,MAAM,EAAE;CAUhC;AAED,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,SAAS,EAAE,MAAM,EAAE;CAYhC"}

package/dist/src/errors/bytecode.js

@@ -0,0 +1,59 @@
+import { CustomError } from "../error.js";
+export class InvalidLibraryAddressError extends CustomError {
+    constructor(libraries) {
+        const formattedLibraries = Object.entries(libraries)
+            .map(([libraryName, address]) => `\t* "${libraryName}": "${address}"`)
+            .join("\n");
+        super(`The following libraries have invalid addresses:
+${formattedLibraries}
+
+Please provide valid Ethereum addresses for these libraries.`);
+    }
+}
+export class AmbiguousLibraryNameError extends CustomError {
+    constructor(libraries) {
+        const formattedLibraries = Object.entries(libraries)
+            .map(([providedLibraryName, matchingLibraries]) => `\t* "${providedLibraryName}":\n${matchingLibraries
+            .map(({ libraryFqn }) => `\t\t* "${libraryFqn}"`)
+            .join("\n")}`)
+            .join("\n");
+        super(`The following libraries may resolve to multiple libraries:
+${formattedLibraries}
+
+Please provide the fully qualified name for these libraries.`);
+    }
+}
+export class UnnecessaryLibraryError extends CustomError {
+    constructor(libraries) {
+        const formattedLibraries = libraries
+            .map((libraryName) => `\t* "${libraryName}"`)
+            .join("\n");
+        super(`The following libraries are not referenced by the contract:
+${formattedLibraries}
+
+Please provide only the libraries that are needed.`);
+    }
+}
+export class OverlappingLibrariesError extends CustomError {
+    constructor(libraries) {
+        const formattedLibraries = libraries
+            .map((libraryFqn) => `\t* "${libraryFqn}"`)
+            .join("\n");
+        super(`The following libraries are provided more than once:
+${formattedLibraries}
+
+Please ensure that each library is provided only once, either by its name or its fully qualified name.`);
+    }
+}
+export class MissingLibrariesError extends CustomError {
+    constructor(libraries) {
+        const formattedLibraries = libraries
+            .map((libraryFqn) => `\t* "${libraryFqn}"`)
+            .join("\n");
+        super(`The following libraries are missing:
+${formattedLibraries}
+
+Please provide all the required libraries.`);
+    }
+}
+//# sourceMappingURL=bytecode.js.map

package/dist/src/errors/bytecode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytecode.js","sourceRoot":"","sources":["../../../src/errors/bytecode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,0BAA2B,SAAQ,WAAW;IACzD,YAAY,SAA2B;QACrC,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,QAAQ,WAAW,OAAO,OAAO,GAAG,CAAC;aACrE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,KAAK,CAAC;EACR,kBAAkB;;6DAEyC,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IACxD,YAAY,SAAwC;QAClD,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;aACjD,GAAG,CACF,CAAC,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,EAAE,EAAE,CAC3C,QAAQ,mBAAmB,OAAO,iBAAiB;aAChD,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,UAAU,GAAG,CAAC;aAChD,IAAI,CAAC,IAAI,CAAC,EAAE,CAClB;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,KAAK,CAAC;EACR,kBAAkB;;6DAEyC,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,WAAW;IACtD,YAAY,SAAmB;QAC7B,MAAM,kBAAkB,GAAG,SAAS;aACjC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,QAAQ,WAAW,GAAG,CAAC;aAC5C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,KAAK,CAAC;EACR,kBAAkB;;mDAE+B,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IACxD,YAAY,SAAmB;QAC7B,MAAM,kBAAkB,GAAG,SAAS;aACjC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,UAAU,GAAG,CAAC;aAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,KAAK,CAAC;EACR,kBAAkB;;uGAEmF,CAAC,CAAC;IACvG,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,WAAW;IACpD,YAAY,SAAmB;QAC7B,MAAM,kBAAkB,GAAG,SAAS;aACjC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,UAAU,GAAG,CAAC;aAC1C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,KAAK,CACH;EACJ,kBAAkB;;2CAEuB,CACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/src/errors/fs.d.ts

@@ -0,0 +1,25 @@
+import { CustomError } from "../error.js";
+export declare class FileSystemAccessError extends CustomError {
+}
+export declare class FileNotFoundError extends CustomError {
+    constructor(filePath: string, cause?: Error);
+}
+export declare class FileAlreadyExistsError extends CustomError {
+    constructor(filePath: string, cause?: Error);
+}
+export declare class InvalidFileFormatError extends CustomError {
+    constructor(filePath: string, cause: Error);
+}
+export declare class JsonSerializationError extends CustomError {
+    constructor(filePath: string, cause: Error);
+}
+export declare class NotADirectoryError extends CustomError {
+    constructor(filePath: string, cause: Error);
+}
+export declare class IsDirectoryError extends CustomError {
+    constructor(filePath: string, cause: Error);
+}
+export declare class DirectoryNotEmptyError extends CustomError {
+    constructor(filePath: string, cause: Error);
+}
+//# sourceMappingURL=fs.d.ts.map

package/dist/src/errors/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/errors/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,qBAAa,qBAAsB,SAAQ,WAAW;CAAG;AAEzD,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG5C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG5C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG3C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG3C;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG3C;AAED,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG3C;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAG3C"}

package/dist/src/errors/fs.js

@@ -0,0 +1,41 @@
+import { CustomError } from "../error.js";
+// We use this error to encapsulate any other error possibly thrown by node's
+// fs apis, as sometimes their errors don't have stack traces.
+export class FileSystemAccessError extends CustomError {
+}
+export class FileNotFoundError extends CustomError {
+    constructor(filePath, cause) {
+        super(`File ${filePath} not found`, cause);
+    }
+}
+export class FileAlreadyExistsError extends CustomError {
+    constructor(filePath, cause) {
+        super(`File ${filePath} already exists`, cause);
+    }
+}
+export class InvalidFileFormatError extends CustomError {
+    constructor(filePath, cause) {
+        super(`Invalid file format: ${filePath}`, cause);
+    }
+}
+export class JsonSerializationError extends CustomError {
+    constructor(filePath, cause) {
+        super(`Error serializing JSON file ${filePath}`, cause);
+    }
+}
+export class NotADirectoryError extends CustomError {
+    constructor(filePath, cause) {
+        super(`Path ${filePath} is not a directory`, cause);
+    }
+}
+export class IsDirectoryError extends CustomError {
+    constructor(filePath, cause) {
+        super(`Path ${filePath} is a directory`, cause);
+    }
+}
+export class DirectoryNotEmptyError extends CustomError {
+    constructor(filePath, cause) {
+        super(`Directory ${filePath} is not empty`, cause);
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/errors/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/errors/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,6EAA6E;AAC7E,8DAA8D;AAC9D,MAAM,OAAO,qBAAsB,SAAQ,WAAW;CAAG;AAEzD,MAAM,OAAO,iBAAkB,SAAQ,WAAW;IAChD,YAAY,QAAgB,EAAE,KAAa;QACzC,KAAK,CAAC,QAAQ,QAAQ,YAAY,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,QAAgB,EAAE,KAAa;QACzC,KAAK,CAAC,QAAQ,QAAQ,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,QAAgB,EAAE,KAAY;QACxC,KAAK,CAAC,wBAAwB,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,QAAgB,EAAE,KAAY;QACxC,KAAK,CAAC,+BAA+B,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACjD,YAAY,QAAgB,EAAE,KAAY;QACxC,KAAK,CAAC,QAAQ,QAAQ,qBAAqB,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,YAAY,QAAgB,EAAE,KAAY;QACxC,KAAK,CAAC,QAAQ,QAAQ,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,WAAW;IACrD,YAAY,QAAgB,EAAE,KAAY;QACxC,KAAK,CAAC,aAAa,QAAQ,eAAe,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/src/errors/package.d.ts

@@ -0,0 +1,8 @@
+import { CustomError } from "../error.js";
+export declare class PackageJsonNotFoundError extends CustomError {
+    constructor(filePathOrUrl: string, cause?: Error);
+}
+export declare class PackageJsonReadError extends CustomError {
+    constructor(packageJsonPath: string, cause?: Error);
+}
+//# sourceMappingURL=package.d.ts.map

package/dist/src/errors/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/errors/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAGjD;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,eAAe,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAGnD"}

package/dist/src/errors/package.js

@@ -0,0 +1,12 @@
+import { CustomError } from "../error.js";
+export class PackageJsonNotFoundError extends CustomError {
+    constructor(filePathOrUrl, cause) {
+        super(`No package.json found for ${filePathOrUrl}`, cause);
+    }
+}
+export class PackageJsonReadError extends CustomError {
+    constructor(packageJsonPath, cause) {
+        super(`Failed to read package.json at ${packageJsonPath}`, cause);
+    }
+}
+//# sourceMappingURL=package.js.map

package/dist/src/errors/package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/errors/package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,wBAAyB,SAAQ,WAAW;IACvD,YAAY,aAAqB,EAAE,KAAa;QAC9C,KAAK,CAAC,6BAA6B,aAAa,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,eAAuB,EAAE,KAAa;QAChD,KAAK,CAAC,kCAAkC,eAAe,EAAE,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/src/errors/request.d.ts

@@ -0,0 +1,25 @@
+import type UndiciT from "undici";
+import { CustomError } from "../error.js";
+export declare class RequestError extends CustomError {
+    constructor(url: string, type: UndiciT.Dispatcher.HttpMethod, cause?: Error);
+}
+export declare class DownloadError extends CustomError {
+    constructor(url: string, cause?: Error);
+}
+export declare class DispatcherError extends CustomError {
+    constructor(message: string, cause?: Error);
+}
+export declare class RequestTimeoutError extends CustomError {
+    constructor(url: string, cause?: Error);
+}
+export declare class ConnectionRefusedError extends CustomError {
+    constructor(url: string, cause?: Error);
+}
+export declare class ResponseStatusCodeError extends CustomError {
+    #private;
+    readonly statusCode: number;
+    readonly headers: string[] | Record<string, string | string[] | undefined> | null;
+    readonly body: null | Record<string, any> | string;
+    constructor(url: string, cause: Error);
+}
+//# sourceMappingURL=request.d.ts.map

package/dist/src/errors/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/errors/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,QAAQ,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,KAAK;CAG5E;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAGvC;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAGvC;AAED,qBAAa,sBAAuB,SAAQ,WAAW;gBACzC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAGvC;AAED,qBAAa,uBAAwB,SAAQ,WAAW;;IACtD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EACnB,MAAM,EAAE,GACR,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC7C,IAAI,CAAC;IACT,SAAgB,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;gBAE9C,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAuCtC"}

package/dist/src/errors/request.js

@@ -0,0 +1,64 @@
+import { CustomError } from "../error.js";
+import { sanitizeUrl } from "../internal/request.js";
+import { isObject } from "../lang.js";
+export class RequestError extends CustomError {
+    constructor(url, type, cause) {
+        super(`Failed to make ${type} request to ${sanitizeUrl(url)}`, cause);
+    }
+}
+export class DownloadError extends CustomError {
+    constructor(url, cause) {
+        super(`Failed to download file from ${sanitizeUrl(url)}`, cause);
+    }
+}
+export class DispatcherError extends CustomError {
+    constructor(message, cause) {
+        super(`Failed to create dispatcher: ${message}`, cause);
+    }
+}
+export class RequestTimeoutError extends CustomError {
+    constructor(url, cause) {
+        super(`Request to ${sanitizeUrl(url)} timed out`, cause);
+    }
+}
+export class ConnectionRefusedError extends CustomError {
+    constructor(url, cause) {
+        super(`Connection to ${sanitizeUrl(url)} was refused`, cause);
+    }
+}
+export class ResponseStatusCodeError extends CustomError {
+    statusCode;
+    headers;
+    body;
+    constructor(url, cause) {
+        super(`Received an unexpected status code from ${sanitizeUrl(url)}`, cause);
+        this.statusCode =
+            "statusCode" in cause && typeof cause.statusCode === "number"
+                ? cause.statusCode
+                : -1;
+        this.headers = this.#extractHeaders(cause);
+        this.body = "body" in cause && isObject(cause.body) ? cause.body : null;
+    }
+    #extractHeaders(cause) {
+        if ("headers" in cause) {
+            const headers = cause.headers;
+            if (Array.isArray(headers)) {
+                return headers;
+            }
+            else if (this.#isValidHeaders(headers)) {
+                return headers;
+            }
+        }
+        return null;
+    }
+    #isValidHeaders(headers) {
+        if (!isObject(headers)) {
+            return false;
+        }
+        return Object.values(headers).every((header) => typeof header === "string" ||
+            (Array.isArray(header) &&
+                header.every((item) => typeof item === "string")) ||
+            header === undefined);
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/src/errors/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/errors/request.ts"],"names":[],"mappings":"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"}

package/dist/src/errors/subprocess.d.ts

@@ -0,0 +1,8 @@
+import { CustomError } from "../error.js";
+export declare class SubprocessFileNotFoundError extends CustomError {
+    constructor(filePath: string);
+}
+export declare class SubprocessPathIsDirectoryError extends CustomError {
+    constructor(path: string);
+}
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/src/errors/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../../src/errors/subprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,2BAA4B,SAAQ,WAAW;gBAC9C,QAAQ,EAAE,MAAM;CAK7B;AAED,qBAAa,8BAA+B,SAAQ,WAAW;gBACjD,IAAI,EAAE,MAAM;CAKzB"}

package/dist/src/errors/subprocess.js

@@ -0,0 +1,12 @@
+import { CustomError } from "../error.js";
+export class SubprocessFileNotFoundError extends CustomError {
+    constructor(filePath) {
+        super(`Cannot find the subprocess file to execute, invalid file path: ${filePath}`);
+    }
+}
+export class SubprocessPathIsDirectoryError extends CustomError {
+    constructor(path) {
+        super(`The provided path is a directory, only files are accepted. Path: ${path}`);
+    }
+}
+//# sourceMappingURL=subprocess.js.map

package/dist/src/errors/subprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.js","sourceRoot":"","sources":["../../../src/errors/subprocess.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,OAAO,2BAA4B,SAAQ,WAAW;IAC1D,YAAY,QAAgB;QAC1B,KAAK,CACH,kEAAkE,QAAQ,EAAE,CAC7E,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,8BAA+B,SAAQ,WAAW;IAC7D,YAAY,IAAY;QACtB,KAAK,CACH,oEAAoE,IAAI,EAAE,CAC3E,CAAC;IACJ,CAAC;CACF"}

package/dist/src/eth.d.ts

@@ -0,0 +1,56 @@
+import type { PrefixedHexString } from "./hex.js";
+/**
+ * Checks if a value is an Ethereum address.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum address, false otherwise.
+ */
+export declare function isAddress(value: unknown): value is PrefixedHexString;
+/**
+ * Checks if a value is an Ethereum address and if the checksum is valid.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum address with a valid checksum, false otherwise.
+ */
+export declare function isValidChecksumAddress(value: unknown): Promise<boolean>;
+/**
+ * Checks if a value is an Ethereum hash.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum hash, false otherwise.
+ */
+export declare function isHash(value: unknown): value is PrefixedHexString;
+/**
+ * Converts a number to a hexadecimal string with a length of 32 bytes.
+ *
+ * @param value The number to convert.
+ * @returns The hexadecimal representation of the number padded to 32 bytes.
+ * @throws InvalidParameterError If the input is not a safe integer or is negative.
+ */
+export declare function toEvmWord(value: bigint | number): PrefixedHexString;
+/**
+ * Generates a pseudo-random sequence of hash bytes.
+ *
+ * @returns A pseudo-random sequence of hash bytes.
+ */
+export declare function generateHashBytes(): Promise<Uint8Array>;
+/**
+ * Generates a pseudo-random hash.
+ *
+ * @returns A pseudo-random hash.
+ */
+export declare function randomHash(): Promise<PrefixedHexString>;
+/**
+ * Generates a pseudo-random sequence of hash bytes that can be used as an
+ * address.
+ *
+ * @returns A pseudo-random sequence of hash bytes.
+ */
+export declare function generateAddressBytes(): Promise<Uint8Array>;
+/**
+ * Generates a pseudo-random address.
+ *
+ * @returns A pseudo-random address.
+ */
+export declare function randomAddress(): Promise<PrefixedHexString>;
+//# sourceMappingURL=eth.d.ts.map

package/dist/src/eth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eth.d.ts","sourceRoot":"","sources":["../../src/eth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AASlD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEpE;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAEnE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAG7D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAG7D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAIhE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAGhE"}

package/dist/src/eth.js

@@ -0,0 +1,78 @@
+import { bytesToHexString, numberToHexString, setLengthLeft } from "./hex.js";
+import { getAddressGenerator, getHashGenerator, isValidChecksum, } from "./internal/eth.js";
+/**
+ * Checks if a value is an Ethereum address.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum address, false otherwise.
+ */
+export function isAddress(value) {
+    return typeof value === "string" && /^0x[0-9a-f]{40}$/i.test(value);
+}
+/**
+ * Checks if a value is an Ethereum address and if the checksum is valid.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum address with a valid checksum, false otherwise.
+ */
+export async function isValidChecksumAddress(value) {
+    return isAddress(value) && isValidChecksum(value);
+}
+/**
+ * Checks if a value is an Ethereum hash.
+ *
+ * @param value The value to check.
+ * @returns True if the value is an Ethereum hash, false otherwise.
+ */
+export function isHash(value) {
+    return typeof value === "string" && /^0x[0-9a-f]{64}$/i.test(value);
+}
+/**
+ * Converts a number to a hexadecimal string with a length of 32 bytes.
+ *
+ * @param value The number to convert.
+ * @returns The hexadecimal representation of the number padded to 32 bytes.
+ * @throws InvalidParameterError If the input is not a safe integer or is negative.
+ */
+export function toEvmWord(value) {
+    return setLengthLeft(numberToHexString(value), 64);
+}
+/**
+ * Generates a pseudo-random sequence of hash bytes.
+ *
+ * @returns A pseudo-random sequence of hash bytes.
+ */
+export async function generateHashBytes() {
+    const hashGenerator = await getHashGenerator();
+    return hashGenerator.next();
+}
+/**
+ * Generates a pseudo-random hash.
+ *
+ * @returns A pseudo-random hash.
+ */
+export async function randomHash() {
+    const hashBytes = await generateHashBytes();
+    return bytesToHexString(hashBytes);
+}
+/**
+ * Generates a pseudo-random sequence of hash bytes that can be used as an
+ * address.
+ *
+ * @returns A pseudo-random sequence of hash bytes.
+ */
+export async function generateAddressBytes() {
+    const addressGenerator = await getAddressGenerator();
+    const hashBytes = await addressGenerator.next();
+    return hashBytes.slice(0, 20);
+}
+/**
+ * Generates a pseudo-random address.
+ *
+ * @returns A pseudo-random address.
+ */
+export async function randomAddress() {
+    const addressBytes = await generateAddressBytes();
+    return bytesToHexString(addressBytes);
+}
+//# sourceMappingURL=eth.js.map

package/dist/src/eth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eth.js","sourceRoot":"","sources":["../../src/eth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAc;IACzD,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,OAAO,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,aAAa,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC/C,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,SAAS,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAC5C,OAAO,gBAAgB,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,gBAAgB,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAChD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,YAAY,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAClD,OAAO,gBAAgB,CAAC,YAAY,CAAC,CAAC;AACxC,CAAC"}