hardhat 3.4.2 → 3.4.4

package/dist/src/internal/cli/telemetry/error-classification/classifier.js

@@ -0,0 +1,402 @@
+import { HardhatError, assertHardhatInvariant, } from "@nomicfoundation/hardhat-errors";
+import { DirectoryNotEmptyError, FileAlreadyExistsError, FileNotFoundError, FileSystemAccessError, InvalidFileFormatError, IsDirectoryError, NotADirectoryError, } from "@nomicfoundation/hardhat-utils/fs";
+import { PackageJsonNotFoundError, PackageJsonReadError, } from "@nomicfoundation/hardhat-utils/package";
+import { DispatcherError, RequestError, ResponseStatusCodeError, } from "@nomicfoundation/hardhat-utils/request";
+import { SubprocessFileNotFoundError, SubprocessPathIsDirectoryError, } from "@nomicfoundation/hardhat-utils/subprocess";
+import { EdrProviderStackTraceGenerationError, SolidityTestStackTraceGenerationError, } from "../../../builtin-plugins/network-manager/edr/stack-traces/stack-trace-generation-errors.js";
+import { ProviderError, UnknownError, } from "../../../builtin-plugins/network-manager/provider-errors.js";
+import { UsingHardhat2PluginError } from "../../../using-hardhat2-plugin-errors.js";
+import { getHookExecutionFrame, getTaskExecutionFrame, isConfigLoadingBoundaryFrame, isConsoleEvaluationBoundaryFrame, isEdrFrame, isFirstPartyPluginFrame, isHookHandlerBoundaryFrame, isMochaTestExecutionBoundaryFrame, isNodeTestExecutionBoundaryFrame, isRunningInsideHardhatMonorepo, isScriptExecutionBoundaryFrame, isTaskActionBoundaryFrame, isThirdPartyFrame, } from "./codebase-dependent-helpers.js";
+import { FrameOrigin, createErrorContext, getNodeErrorCode, hasErrorClassName, includesAny, } from "./helpers.js";
+/**
+ * Classifies the error based on a set of heuristics.
+ *
+ * This classification is later used to select different criteria to decide if
+ * the error should be reported or not, and in some cases, how to display it in
+ * the CLI.
+ *
+ * @param error The error to classify.
+ * @param ignoreDevelopmentTimeFilter If true, the classifier will ignore the
+ * development-time filter, which is used to exclude errors that happen during
+ * development of Hardhat itself. This is only meant to be used for testing.
+ * @returns The error category.
+ */
+export function classifyError(error, ignoreDevelopmentTimeFilter = false) {
+    const context = createErrorContext(error);
+    for (const matcher of ERROR_CATEGORY_MATCHERS) {
+        if (ignoreDevelopmentTimeFilter && matcher === isDevelopmentTimeError) {
+            continue;
+        }
+        const category = matcher(context);
+        if (category !== undefined) {
+            return category;
+        }
+    }
+    return ErrorCategory.UNEXPECTED_ERROR;
+}
+export var ErrorCategory;
+(function (ErrorCategory) {
+    ErrorCategory["CJS_TO_ESM_MIGRATION_ERROR"] = "CJS_TO_ESM_MIGRATION_ERROR";
+    ErrorCategory["HH2_TO_HH3_MIGRATION_ERROR"] = "HH2_TO_HH3_MIGRATION_ERROR";
+    ErrorCategory["TYPESCRIPT_SUPPORT_ERROR"] = "TYPESCRIPT_SUPPORT_ERROR";
+    ErrorCategory["DEVELOPMENT_TIME_ERROR"] = "DEVELOPMENT_TIME_ERROR";
+    ErrorCategory["HARDHAT_ERROR"] = "HARDHAT_ERROR";
+    ErrorCategory["CONFIG_LOADING_ERROR"] = "CONFIG_LOADING_ERROR";
+    ErrorCategory["CONSOLE_EVALUATION_ERROR"] = "CONSOLE_EVALUATION_ERROR";
+    ErrorCategory["SCRIPT_EXECUTION_ERROR"] = "SCRIPT_EXECUTION_ERROR";
+    ErrorCategory["NODE_TEST_EXECUTION_ERROR"] = "NODE_TEST_EXECUTION_ERROR";
+    ErrorCategory["MOCHA_TEST_EXECUTION_ERROR"] = "MOCHA_TEST_EXECUTION_ERROR";
+    ErrorCategory["TASK_ACTION_ERROR"] = "TASK_ACTION_ERROR";
+    ErrorCategory["PLUGIN_TASK_ACTION_ERROR"] = "PLUGIN_TASK_ACTION_ERROR";
+    ErrorCategory["USER_TASK_ACTION_ERROR"] = "USER_TASK_ACTION_ERROR";
+    ErrorCategory["PLUGIN_HOOK_HANDLER_ERROR"] = "PLUGIN_HOOK_HANDLER_ERROR";
+    ErrorCategory["PROVIDER_INTERACTION_ERROR"] = "PROVIDER_INTERACTION_ERROR";
+    ErrorCategory["EDR_ERROR"] = "EDR_ERROR";
+    ErrorCategory["NETWORK_INTERACTION_ERROR"] = "NETWORK_INTERACTION_ERROR";
+    ErrorCategory["RUNTIME_ENVIRONMENT_ERROR"] = "RUNTIME_ENVIRONMENT_ERROR";
+    ErrorCategory["FILESYSTEM_INTERACTION_ERROR"] = "FILESYSTEM_INTERACTION_ERROR";
+    ErrorCategory["UNEXPECTED_ERROR"] = "UNEXPECTED_ERROR";
+})(ErrorCategory || (ErrorCategory = {}));
+export const USER_CODE_BOUNDARY_FRAME_MATCHERS = {
+    [ErrorCategory.CONFIG_LOADING_ERROR]: isConfigLoadingBoundaryFrame,
+    [ErrorCategory.CONSOLE_EVALUATION_ERROR]: isConsoleEvaluationBoundaryFrame,
+    [ErrorCategory.SCRIPT_EXECUTION_ERROR]: isScriptExecutionBoundaryFrame,
+    [ErrorCategory.NODE_TEST_EXECUTION_ERROR]: isNodeTestExecutionBoundaryFrame,
+    [ErrorCategory.MOCHA_TEST_EXECUTION_ERROR]: isMochaTestExecutionBoundaryFrame,
+    [ErrorCategory.PLUGIN_TASK_ACTION_ERROR]: isTaskActionBoundaryFrame,
+    [ErrorCategory.USER_TASK_ACTION_ERROR]: isTaskActionBoundaryFrame,
+    [ErrorCategory.PLUGIN_HOOK_HANDLER_ERROR]: isHookHandlerBoundaryFrame,
+};
+// These are categories that only need the boundary check for classification
+const BOUNDARY_ONLY_ERROR_CATEGORIES = [
+    ErrorCategory.CONFIG_LOADING_ERROR,
+    ErrorCategory.SCRIPT_EXECUTION_ERROR,
+    ErrorCategory.NODE_TEST_EXECUTION_ERROR,
+    ErrorCategory.MOCHA_TEST_EXECUTION_ERROR,
+    ErrorCategory.CONSOLE_EVALUATION_ERROR,
+];
+// IMPORTANT: The order here matters, as the first matcher that returns a
+// category wins
+const ERROR_CATEGORY_MATCHERS = [
+    isDevelopmentTimeError,
+    isESMMigrationError,
+    isHH3MigrationError,
+    isTypescriptSupportError,
+    isHardhatError,
+    isProviderInteractionError,
+    isEdrError,
+    isNetworkInteractionError,
+    isRuntimeEnvironmentError,
+    isFilesystemInteractionError,
+    isTaskActionError,
+    isBoundaryOnlyError,
+    isPluginTaskActionError,
+    isUserTaskActionError,
+    isPluginHookHandlerError,
+];
+const ESM_MIGRATION_MARKERS = [
+    "is not defined in es module scope",
+    "cannot use import statement outside a module",
+];
+/**
+ * Classifies common CommonJS/ESM migration failures by matching standard Node
+ * runtime markers.
+ */
+function isESMMigrationError(context) {
+    for (const lowercaseMessage of context.lowercaseMessageByError.values()) {
+        if (includesAny(lowercaseMessage, ...ESM_MIGRATION_MARKERS) ||
+            /require\(\) of es module/.test(lowercaseMessage)) {
+            return ErrorCategory.CJS_TO_ESM_MIGRATION_ERROR;
+        }
+    }
+}
+const HH3_MIGRATION_MARKERS = [
+    "class extends value undefined is not a constructor or null",
+    "the requested module 'hardhat' does not provide an export named",
+    'the requested module "hardhat" does not provide an export named',
+    "the requested module 'hardhat/config' does not provide an export named",
+    'the requested module "hardhat/config" does not provide an export named',
+    "the requested module 'hardhat/plugins' does not provide an export named",
+    'the requested module "hardhat/plugins" does not provide an export named',
+    "the requested module 'hardhat/builtin-tasks/task-names' does not provide an export named",
+    'the requested module "hardhat/builtin-tasks/task-names" does not provide an export named',
+    "the requested module 'hardhat/types/runtime' does not provide an export named",
+    'the requested module "hardhat/types/runtime" does not provide an export named',
+];
+const HH2_PLUGIN_ERROR_MARKER = "you are trying to use a hardhat 2 plugin in a hardhat 3 project";
+/**
+ * Classifies Hardhat 2 to Hardhat 3 migration failures by checking for known
+ * migration error types and message patterns anywhere in the cause chain.
+ *
+ * This is temporary, and will be removed once the HH2 to HH3 migration by the
+ * community is in a solid state. The matcher is broad, but right now mostly
+ * correct.
+ */
+function isHH3MigrationError(context) {
+    if (context.errorChain.some((candidate) => hasErrorClassName(candidate, UsingHardhat2PluginError) ||
+        (context.lowercaseMessageByError.get(candidate) ?? "").includes(HH2_PLUGIN_ERROR_MARKER))) {
+        return ErrorCategory.HH2_TO_HH3_MIGRATION_ERROR;
+    }
+    for (const lowercaseMessage of context.lowercaseMessageByError.values()) {
+        if (includesAny(lowercaseMessage, ...HH3_MIGRATION_MARKERS)) {
+            return ErrorCategory.HH2_TO_HH3_MIGRATION_ERROR;
+        }
+    }
+    if (context.errorChain.some((candidate) => candidate.stack?.includes("@nomiclabs") === true)) {
+        return ErrorCategory.HH2_TO_HH3_MIGRATION_ERROR;
+    }
+}
+/**
+ * If Hardhat is being run from the monorepo, we don't report the error.
+ */
+function isDevelopmentTimeError(_context) {
+    if (isRunningInsideHardhatMonorepo()) {
+        return ErrorCategory.DEVELOPMENT_TIME_ERROR;
+    }
+    return undefined;
+}
+const TYPESCRIPT_SUPPORT_ERROR_CODES = new Set([
+    "ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX",
+    "ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING",
+    "ERR_NO_TYPESCRIPT",
+    "ERR_UNKNOWN_FILE_EXTENSION",
+]);
+/**
+ * Classifies Node.js TypeScript support failures by matching Node's stable
+ * error codes. ERR_UNKNOWN_FILE_EXTENSION also happens for non-TypeScript
+ * extensions, so require a TypeScript extension in that error's message.
+ */
+function isTypescriptSupportError(context) {
+    if (context.errorChain.some((candidate) => {
+        const code = getTypescriptSupportErrorCode(candidate);
+        if (code === undefined) {
+            return false;
+        }
+        return (code !== "ERR_UNKNOWN_FILE_EXTENSION" ||
+            includesAny(context.lowercaseMessageByError.get(candidate), ".ts", ".mts", ".cts"));
+    })) {
+        return ErrorCategory.TYPESCRIPT_SUPPORT_ERROR;
+    }
+}
+/**
+ * Classifies top-level HardhatError instances that were not captured by a more
+ * specific matcher earlier in the chain.
+ */
+function isHardhatError(context) {
+    if (HardhatError.isHardhatError(context.error)) {
+        return ErrorCategory.HARDHAT_ERROR;
+    }
+}
+function isBoundaryOnlyError(context) {
+    for (const category of BOUNDARY_ONLY_ERROR_CATEGORIES) {
+        const boundaryMatcher = USER_CODE_BOUNDARY_FRAME_MATCHERS[category];
+        if (context.allStackFrames.some(boundaryMatcher)) {
+            return category;
+        }
+    }
+}
+/**
+ * Classifies task-action failures routed through ResolvedTask when the nearest
+ * task-action frame belongs to first-party code.
+ */
+function isTaskActionError(context) {
+    const taskActionFrame = getTaskExecutionFrame(context.allStackFrames);
+    if (taskActionFrame !== undefined &&
+        isFirstPartyPluginFrame(taskActionFrame.location)) {
+        return ErrorCategory.TASK_ACTION_ERROR;
+    }
+}
+/**
+ * Classifies task-action failures routed through ResolvedTask when the nearest
+ * task-action frame belongs to a third-party plugin.
+ */
+function isPluginTaskActionError(context) {
+    const taskActionFrame = getTaskExecutionFrame(context.allStackFrames);
+    if (taskActionFrame !== undefined &&
+        isThirdPartyFrame(taskActionFrame.location)) {
+        return ErrorCategory.PLUGIN_TASK_ACTION_ERROR;
+    }
+}
+/**
+ * Classifies task-action failures routed through ResolvedTask when the nearest
+ * task-action frame belongs to user project code.
+ */
+function isUserTaskActionError(context) {
+    const taskActionFrame = getTaskExecutionFrame(context.allStackFrames);
+    if (taskActionFrame !== undefined &&
+        taskActionFrame.origin === FrameOrigin.USER_PROJECT) {
+        return ErrorCategory.USER_TASK_ACTION_ERROR;
+    }
+}
+/**
+ * Classifies hook execution failures routed through HookManager when the
+ * nearest hook-handler frame belongs to a third-party plugin.
+ */
+function isPluginHookHandlerError(context) {
+    const hookExecutionFrame = getHookExecutionFrame(context.allStackFrames);
+    if (hookExecutionFrame !== undefined &&
+        isThirdPartyFrame(hookExecutionFrame.location)) {
+        return ErrorCategory.PLUGIN_HOOK_HANDLER_ERROR;
+    }
+}
+const PROVIDER_INTERACTION_ERROR_WRAPPED_IN_UNKNOWN_EDR_ERROR_MARKERS = [
+    "unauthorized",
+    "rate limit",
+    "too many requests",
+    "historical state unavailable",
+];
+/**
+ * Classifies provider-facing failures, including Solidity errors, expected
+ * provider errors, and selected UnknownError cases with provider-like causes.
+ */
+function isProviderInteractionError(context) {
+    if (context.errorChain.some((candidate) => candidate.name === "SolidityError" ||
+        (ProviderError.isProviderError(candidate) &&
+            isUnknownEdrError(candidate, context) === false))) {
+        return ErrorCategory.PROVIDER_INTERACTION_ERROR;
+    }
+    if (isUnknownEdrError(context.errorChain[0], context) &&
+        context.errorChain[1] !== undefined &&
+        includesAny(context.lowercaseMessageByError.get(context.errorChain[1]), ...PROVIDER_INTERACTION_ERROR_WRAPPED_IN_UNKNOWN_EDR_ERROR_MARKERS)) {
+        return ErrorCategory.PROVIDER_INTERACTION_ERROR;
+    }
+}
+/**
+ * Classifies EDR-specific failures, including stack-trace generation errors
+ * and remaining UnknownError cases from the provider layer.
+ */
+function isEdrError(context) {
+    if (context.errorChain.some((candidate) => hasErrorClassName(candidate, EdrProviderStackTraceGenerationError) ||
+        hasErrorClassName(candidate, SolidityTestStackTraceGenerationError) ||
+        isUnknownEdrError(candidate, context))) {
+        return ErrorCategory.EDR_ERROR;
+    }
+}
+/**
+ * Classifies network-related failures by collapsing request setup, request
+ * transport, response status, and telemetry transport errors into one bucket.
+ */
+function isNetworkInteractionError(context) {
+    if (context.errorChain.some((candidate) => hasErrorClassName(candidate, ResponseStatusCodeError)) ||
+        context.errorChain.some((candidate) => hasErrorClassName(candidate, DispatcherError)) ||
+        context.errorChain.some((candidate) => hasErrorClassName(candidate, RequestError)) ||
+        (context.lowercaseMessageByError.get(context.error) ?? "").includes("fetch failed")) {
+        return ErrorCategory.NETWORK_INTERACTION_ERROR;
+    }
+}
+/**
+ * Classifies runtime-environment incompatibilities by matching a small set of
+ * capability-related error messages.
+ */
+function isRuntimeEnvironmentError(context) {
+    if (Array.from(context.lowercaseMessageByError.values()).some((message) => includesAny(message, "toreversed is not a function", "flatmap is not a function", "crypto is not defined"))) {
+        return ErrorCategory.RUNTIME_ENVIRONMENT_ERROR;
+    }
+}
+/**
+ * Classifies project-data and filesystem-related failures by matching a known
+ * filesystem/project-data error type or a raw Node.js filesystem error code
+ * anywhere in the cause chain.
+ */
+function isFilesystemInteractionError(context) {
+    if (context.errorChain.some((candidate) => isKnownFilesystemOrProjectDataError(candidate) ||
+        isNodeFilesystemError(candidate))) {
+        return ErrorCategory.FILESYSTEM_INTERACTION_ERROR;
+    }
+}
+function isUnknownEdrError(error, context) {
+    const errorIndex = context.errorChain.indexOf(error);
+    assertHardhatInvariant(errorIndex !== -1, "isUnknownEdrError must be called with an error from the error chain");
+    return (ProviderError.isProviderError(error) &&
+        (error.code === UnknownError.CODE || error.name === "UnknownError") &&
+        context.errorChain
+            .slice(errorIndex)
+            .some((candidate) => (context.stackFramesByError.get(candidate) ?? []).some(isEdrFrame)));
+}
+// This list should be kept up to date with hardhat-utils/fs errors
+const HARDHAT_UTILS_FILESYSTEM_ERROR_CLASSES = [
+    PackageJsonReadError,
+    PackageJsonNotFoundError,
+    InvalidFileFormatError,
+    FileNotFoundError,
+    IsDirectoryError,
+    NotADirectoryError,
+    FileAlreadyExistsError,
+    DirectoryNotEmptyError,
+];
+// This list should be kept up to date with hardhat-utils/subprocess errors
+const HARDHAT_UTILS_SUBPROCESS_ERROR_CLASSES = [
+    SubprocessFileNotFoundError,
+    SubprocessPathIsDirectoryError,
+];
+const NODE_FILESYSTEM_ERROR_CODES = new Set([
+    "EACCES",
+    "EAGAIN",
+    "EBADF",
+    "EBUSY",
+    "EEXIST",
+    "EFBIG",
+    "EINTR",
+    "EINVAL",
+    "EIO",
+    "EISDIR",
+    "ELOOP",
+    "EMFILE",
+    "ENAMETOOLONG",
+    "ENFILE",
+    "ENODEV",
+    "ENOENT",
+    "ENOSPC",
+    "ENOTDIR",
+    "ENOTEMPTY",
+    "ENOTSUP",
+    "ENXIO",
+    "EOPNOTSUPP",
+    "EOVERFLOW",
+    "EPERM",
+    "EROFS",
+    "ESPIPE",
+    "ETXTBSY",
+    "EXDEV",
+]);
+/**
+ * Returns `true` for any of the filesystem/project-data error classes the
+ * classifier knows about. This is the gate for the FILESYSTEM_INTERACTION_ERROR
+ * category.
+ */
+export function isKnownFilesystemOrProjectDataError(error) {
+    return (isHardhatUtilsFilesystemError(error) ||
+        isSubprocessFilesystemError(error) ||
+        hasErrorClassName(error, FileSystemAccessError));
+}
+/**
+ * Returns `true` for filesystem errors that callers commonly expect to surface
+ * during normal operation (e.g. missing files, format errors). Used by both
+ * the classifier (as part of the filesystem-interaction gate) and the filter
+ * (to drop these errors from reporting).
+ */
+export function isHardhatUtilsFilesystemError(error) {
+    return HARDHAT_UTILS_FILESYSTEM_ERROR_CLASSES.some((cls) => hasErrorClassName(error, cls));
+}
+/**
+ * Returns `true` for filesystem errors raised by the subprocess-spawning
+ * helpers. These are unexpected enough to be worth reporting on their own.
+ */
+export function isSubprocessFilesystemError(error) {
+    return HARDHAT_UTILS_SUBPROCESS_ERROR_CLASSES.some((cls) => hasErrorClassName(error, cls));
+}
+/**
+ * Returns `true` for the node errors with fs related codes.
+ */
+function isNodeFilesystemError(error) {
+    const code = getNodeErrorCode(error);
+    return code !== undefined && NODE_FILESYSTEM_ERROR_CODES.has(code);
+}
+function getTypescriptSupportErrorCode(error) {
+    if ("code" in error &&
+        typeof error.code === "string" &&
+        TYPESCRIPT_SUPPORT_ERROR_CODES.has(error.code)) {
+        return error.code;
+    }
+}
+//# sourceMappingURL=classifier.js.map

package/dist/src/internal/cli/telemetry/error-classification/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/error-classification/classifier.ts"],"names":[],"mappings":"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"}

package/dist/src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file This file has a set of helpers that depend on the codebase. They
+ * inspect the stack frames to look for known folders, files, or function names.
+ *
+ * As such, they are somewhat fragile and need to be periodically reevaluated,
+ * especially after large refactors to Hardhat's core.
+ */
+import { type StackFrame } from "./helpers.js";
+/**
+ * Returns true when this package is being executed from the Hardhat monorepo
+ * source tree instead of from an installed `node_modules/hardhat` package.
+ */
+export declare function isRunningInsideHardhatMonorepo(): boolean;
+/**
+ * Matches the Hardhat frame that imports the user's config file.
+ */
+export declare function isConfigLoadingBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the builtin console task frame that evaluates user input.
+ */
+export declare function isConsoleEvaluationBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the builtin run task frame that executes a user script.
+ */
+export declare function isScriptExecutionBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the node:test runner task frame that executes user tests.
+ */
+export declare function isNodeTestExecutionBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the Mocha runner task frame that executes user tests.
+ */
+export declare function isMochaTestExecutionBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the resolved-task frame that calls into a task action.
+ */
+export declare function isTaskActionBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Matches the hook-manager frame that calls into hook handlers.
+ */
+export declare function isHookHandlerBoundaryFrame(frame: StackFrame): boolean;
+/**
+ * Finds the task action frame immediately above the resolved-task boundary.
+ */
+export declare function getTaskExecutionFrame(frames: StackFrame[]): StackFrame | undefined;
+/**
+ * Finds the hook handler frame immediately above the hook-manager boundary.
+ */
+export declare function getHookExecutionFrame(frames: StackFrame[]): StackFrame | undefined;
+/**
+ * Returns true for stack locations owned by packages outside Hardhat.
+ */
+export declare function isThirdPartyFrame(location: string): boolean;
+/**
+ * Returns true for stack locations owned by Hardhat or first-party packages.
+ */
+export declare function isFirstPartyPluginFrame(location: string): boolean;
+/**
+ * Returns true when the error stack appears to come from workspace
+ * initialization.
+ */
+export declare function isWorkspaceInitFilesystemFrame(error: Error): boolean;
+/**
+ * Returns true for stack frames owned by EDR provider or stack-trace code.
+ */
+export declare function isEdrFrame(frame: StackFrame): boolean;
+//# sourceMappingURL=codebase-dependent-helpers.d.ts.map

package/dist/src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-dependent-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,cAAc,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CAIxD;AAYD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAK3E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKzE;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAK3E;AAED;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAK5E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAKpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAUrE;AASD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAAE,GACnB,UAAU,GAAG,SAAS,CAgBxB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAAE,GACnB,UAAU,GAAG,SAAS,CAexB;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMjE;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMrD"}

package/dist/src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.js

@@ -0,0 +1,140 @@
+/**
+ * @file This file has a set of helpers that depend on the codebase. They
+ * inspect the stack frames to look for known folders, files, or function names.
+ *
+ * As such, they are somewhat fragile and need to be periodically reevaluated,
+ * especially after large refactors to Hardhat's core.
+ */
+import { includesAny } from "./helpers.js";
+/**
+ * Returns true when this package is being executed from the Hardhat monorepo
+ * source tree instead of from an installed `node_modules/hardhat` package.
+ */
+export function isRunningInsideHardhatMonorepo() {
+    // If this file is in `/packages/hardhat/`, as opposed to
+    // `node_modules/hardhat/`, then we're running inside the monorepo.
+    return import.meta.url.includes("/packages/hardhat/");
+}
+// ---------------------------------------------------------------------------
+// Boundary frame predicates
+//
+// These identify the first-party frames that mark the boundary between
+// Hardhat-controlled code and the user/plugin code that ultimately ran. Both
+// the classifier (to assign a category) and the filter (to find the frame
+// above the boundary) need to agree on what those frames look like, so they
+// share a single definition here.
+// ---------------------------------------------------------------------------
+/**
+ * Matches the Hardhat frame that imports the user's config file.
+ */
+export function isConfigLoadingBoundaryFrame(frame) {
+    return (frame.location.includes("internal/config-loading.") &&
+        frame.functionName?.includes("importUserConfig") === true);
+}
+/**
+ * Matches the builtin console task frame that evaluates user input.
+ */
+export function isConsoleEvaluationBoundaryFrame(frame) {
+    return (frame.location.includes("/internal/builtin-plugins/console/task-action.") &&
+        frame.functionName?.includes("consoleAction") === true);
+}
+/**
+ * Matches the builtin run task frame that executes a user script.
+ */
+export function isScriptExecutionBoundaryFrame(frame) {
+    return (frame.location.includes("/internal/builtin-plugins/run/task-action.") &&
+        frame.functionName?.includes("runScriptWithHardhat") === true);
+}
+/**
+ * Matches the node:test runner task frame that executes user tests.
+ */
+export function isNodeTestExecutionBoundaryFrame(frame) {
+    return (frame.location.includes("/hardhat-node-test-runner/src/task-action.") &&
+        frame.functionName?.includes("testWithHardhat") === true);
+}
+/**
+ * Matches the Mocha runner task frame that executes user tests.
+ */
+export function isMochaTestExecutionBoundaryFrame(frame) {
+    return (frame.location.includes("/hardhat-mocha/src/task-action.") &&
+        frame.functionName?.includes("testWithHardhat") === true);
+}
+/**
+ * Matches the resolved-task frame that calls into a task action.
+ */
+export function isTaskActionBoundaryFrame(frame) {
+    return (frame.location.includes("/internal/core/tasks/resolved-task.") &&
+        frame.functionName?.includes(".run") === true);
+}
+/**
+ * Matches the hook-manager frame that calls into hook handlers.
+ */
+export function isHookHandlerBoundaryFrame(frame) {
+    return (frame.location.includes("/internal/core/hook-manager.") &&
+        includesAny(frame.functionName, ".runHandlerChain", ".runSequentialHandlers", ".runParallelHandlers"));
+}
+// ---------------------------------------------------------------------------
+// Execution frame finders
+//
+// These locate the stack frame that identifies who the actual task action or
+// hook handler is, relative to the boundary frame.
+// ---------------------------------------------------------------------------
+/**
+ * Finds the task action frame immediately above the resolved-task boundary.
+ */
+export function getTaskExecutionFrame(frames) {
+    const resolvedTaskRunIndex = frames.findIndex(isTaskActionBoundaryFrame);
+    if (resolvedTaskRunIndex === -1) {
+        return;
+    }
+    // The frames between `task.run` calls may include other resolved-task.ts
+    // helpers; we want the last frame that does not belong to that file.
+    return frames
+        .slice(0, resolvedTaskRunIndex)
+        .findLast((frame) => frame.location.includes("/internal/core/tasks/resolved-task.") ===
+        false);
+}
+/**
+ * Finds the hook handler frame immediately above the hook-manager boundary.
+ */
+export function getHookExecutionFrame(frames) {
+    const hookManagerIndex = frames.findIndex(isHookHandlerBoundaryFrame);
+    if (hookManagerIndex === -1) {
+        return;
+    }
+    // The frames between hook-manager calls may include other hook-manager
+    // helpers; we want the last frame that does not belong to that file.
+    return frames
+        .slice(0, hookManagerIndex)
+        .findLast((frame) => frame.location.includes("/internal/core/hook-manager.") === false);
+}
+// ---------------------------------------------------------------------------
+// Frame origin / ownership helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns true for stack locations owned by packages outside Hardhat.
+ */
+export function isThirdPartyFrame(location) {
+    return (location.includes("/node_modules/") &&
+        isFirstPartyPluginFrame(location) === false);
+}
+/**
+ * Returns true for stack locations owned by Hardhat or first-party packages.
+ */
+export function isFirstPartyPluginFrame(location) {
+    return includesAny(location, "/node_modules/hardhat/", "/node_modules/@nomicfoundation/");
+}
+/**
+ * Returns true when the error stack appears to come from workspace
+ * initialization.
+ */
+export function isWorkspaceInitFilesystemFrame(error) {
+    return error.stack?.includes("/internal/cli/init") ?? false;
+}
+/**
+ * Returns true for stack frames owned by EDR provider or stack-trace code.
+ */
+export function isEdrFrame(frame) {
+    return includesAny(frame.location, "/builtin-plugins/network-manager/edr/", "/edr-provider.");
+}
+//# sourceMappingURL=codebase-dependent-helpers.js.map

package/dist/src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-dependent-helpers.js","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/error-classification/codebase-dependent-helpers.ts"],"names":[],"mappings":"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"}

package/dist/src/internal/cli/telemetry/error-classification/filter.d.ts

@@ -0,0 +1,15 @@
+import { ErrorCategory } from "./classifier.js";
+/**
+ * Decides if an error should be reported to Sentry or not, based on the
+ * category returned by `classifyError(error)`.
+ *
+ * This first version intentionally uses a permissive policy: it drops clear
+ * noise, reports categories that are likely to be Hardhat bugs, and only uses a
+ * simple stack-shape heuristic for errors coming from user/plugin execution.
+ *
+ * @param error The error.
+ * @param category The result of calling `classifyError(error)`.
+ * @returns `true` if the error should be reported.
+ */
+export declare function shouldBeReported(error: Error, category: ErrorCategory): boolean;
+//# sourceMappingURL=filter.d.ts.map

package/dist/src/internal/cli/telemetry/error-classification/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../../../../../src/internal/cli/telemetry/error-classification/filter.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EAEd,MAAM,iBAAiB,CAAC;AAGzB;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,aAAa,GACtB,OAAO,CA0BT"}