hardhatjs 2.22.15

package/types/runtime.d.ts

@@ -0,0 +1,167 @@
+import { Artifacts } from "./artifacts";
+import { HardhatConfig, HardhatUserConfig, NetworkConfig } from "./config";
+import { EIP1193Provider, EthereumProvider } from "./provider";
+/**
+ * This class is used to dynamically validate task's argument types.
+ */
+export interface ArgumentType<T> {
+    /**
+     * The type's name.
+     */
+    name: string;
+    /**
+     * Check if argument value is of type <T>.
+     *
+     * @param argName {string} argument's name - used for context in case of error.
+     * @param argumentValue - value to be validated
+     *
+     * @throws HH301 if value is not of type <t>
+     */
+    validate(argName: string, argumentValue: any): void;
+}
+/**
+ * This is a special case of ArgumentType.
+ *
+ * These types must have a human-friendly string representation, so that they
+ * can be used as command line arguments.
+ */
+export interface CLIArgumentType<T> extends ArgumentType<T> {
+    /**
+     * Parses strValue into T. This function MUST throw HH301 if it
+     * can parse the given value.
+     *
+     * @param argName argument's name - used for context in case of error.
+     * @param strValue argument's string value to be parsed.
+     */
+    parse(argName: string, strValue: string): T;
+}
+export interface ConfigurableTaskDefinition {
+    setDescription(description: string): this;
+    setAction(action: ActionType<TaskArguments>): this;
+    addParam<T>(name: string, description?: string, defaultValue?: T, type?: ArgumentType<T>, isOptional?: boolean): this;
+    addOptionalParam<T>(name: string, description?: string, defaultValue?: T, type?: ArgumentType<T>): this;
+    addPositionalParam<T>(name: string, description?: string, defaultValue?: T, type?: ArgumentType<T>, isOptional?: boolean): this;
+    addOptionalPositionalParam<T>(name: string, description?: string, defaultValue?: T, type?: ArgumentType<T>): this;
+    addVariadicPositionalParam<T>(name: string, description?: string, defaultValue?: T[], type?: ArgumentType<T>, isOptional?: boolean): this;
+    addOptionalVariadicPositionalParam<T>(name: string, description?: string, defaultValue?: T[], type?: ArgumentType<T>): this;
+    addFlag(name: string, description?: string): this;
+}
+declare function addTask<TaskArgumentsT extends TaskArguments>(name: string, description?: string, action?: ActionType<TaskArgumentsT>): ConfigurableTaskDefinition;
+declare function addTask<TaskArgumentsT extends TaskArguments>(name: string, action: ActionType<TaskArgumentsT>): ConfigurableTaskDefinition;
+type AddConfigurableTaskFunction = typeof addTask;
+export interface ConfigurableScopeDefinition {
+    setDescription(description: string): this;
+    task: AddConfigurableTaskFunction;
+    subtask: AddConfigurableTaskFunction;
+}
+export interface ParamDefinition<T> {
+    name: string;
+    defaultValue?: T;
+    type: ArgumentType<T>;
+    description?: string;
+    isOptional: boolean;
+    isFlag: boolean;
+    isVariadic: boolean;
+}
+export interface OptionalParamDefinition<T> extends ParamDefinition<T> {
+    defaultValue: T;
+    isOptional: true;
+}
+export interface CLIOptionalParamDefinition<T> extends OptionalParamDefinition<T> {
+    type: CLIArgumentType<T>;
+}
+export interface ParamDefinitionsMap {
+    [paramName: string]: ParamDefinition<any>;
+}
+export interface TaskDefinition extends ConfigurableTaskDefinition {
+    readonly scope?: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly action: ActionType<TaskArguments>;
+    readonly isSubtask: boolean;
+    readonly paramDefinitions: ParamDefinitionsMap;
+    readonly positionalParamDefinitions: Array<ParamDefinition<any>>;
+}
+export interface ScopeDefinition extends ConfigurableScopeDefinition {
+    readonly name: string;
+    readonly description?: string;
+    readonly tasks: TasksMap;
+}
+export type TaskIdentifier = string | {
+    scope?: string;
+    task: string;
+};
+/**
+ * @type TaskArguments {object-like} - the input arguments for a task.
+ *
+ * TaskArguments type is set to 'any' because it's interface is dynamic.
+ * It's impossible in TypeScript to statically specify a variadic
+ * number of fields and at the same time define specific types for\
+ * the argument values.
+ *
+ * For example, we could define:
+ * type TaskArguments = Record<string, any>;
+ *
+ * ...but then, we couldn't narrow the actual argument value's type in compile time,
+ * thus we have no other option than forcing it to be just 'any'.
+ */
+export type TaskArguments = any;
+export interface SubtaskArguments {
+    [subtaskName: string]: TaskArguments;
+}
+export interface RunSuperFunction<TaskArgumentsT extends TaskArguments> {
+    (taskArguments?: TaskArgumentsT, subtaskArguments?: SubtaskArguments): Promise<any>;
+    isDefined: boolean;
+}
+export type ActionType<TaskArgumentsT extends TaskArguments> = (taskArgs: TaskArgumentsT, env: HardhatRuntimeEnvironment, runSuper: RunSuperFunction<TaskArgumentsT>) => Promise<any>;
+export interface HardhatArguments {
+    network?: string;
+    showStackTraces: boolean;
+    version: boolean;
+    help: boolean;
+    emoji: boolean;
+    config?: string;
+    verbose: boolean;
+    maxMemory?: number;
+    tsconfig?: string;
+    flamegraph?: boolean;
+    typecheck?: boolean;
+}
+export type HardhatParamDefinitions = {
+    [param in keyof Required<HardhatArguments>]: CLIOptionalParamDefinition<HardhatArguments[param]>;
+};
+export interface TasksMap {
+    [name: string]: TaskDefinition;
+}
+export interface ScopesMap {
+    [scopeName: string]: ScopeDefinition;
+}
+export type RunTaskFunction = (taskIdentifier: TaskIdentifier, taskArguments?: TaskArguments, subtaskArguments?: SubtaskArguments) => Promise<any>;
+export interface HardhatRuntimeEnvironment {
+    readonly config: HardhatConfig;
+    readonly userConfig: HardhatUserConfig;
+    readonly hardhatArguments: HardhatArguments;
+    readonly tasks: TasksMap;
+    readonly scopes: ScopesMap;
+    readonly run: RunTaskFunction;
+    readonly network: Network;
+    readonly artifacts: Artifacts;
+    readonly version: string;
+}
+export interface Network {
+    name: string;
+    config: NetworkConfig;
+    provider: EthereumProvider;
+}
+/**
+ * A function that receives a HardhatRuntimeEnvironment and
+ * modify its properties or add new ones.
+ */
+export type EnvironmentExtender = (env: HardhatRuntimeEnvironment) => void;
+/**
+ * A function that receives a provider, crafts and returns a new one.
+ * Adding and modifying the current provider is preferred over ignoring it and returning a new instance.
+ */
+export type ProviderExtender = (provider: EIP1193Provider, config: HardhatConfig, network: string) => EIP1193Provider | Promise<EIP1193Provider>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/types/runtime.d.ts.map

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

package/types/runtime.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=runtime.js.map

package/types/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/types/runtime.ts"],"names":[],"mappings":""}

package/utils/contract-names.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Returns a fully qualified name from a sourceName and contractName.
+ */
+export declare function getFullyQualifiedName(sourceName: string, contractName: string): string;
+/**
+ * Returns true if a name is fully qualified, and not just a bare contract name.
+ */
+export declare function isFullyQualifiedName(name: string): boolean;
+/**
+ * Parses a fully qualified name.
+ *
+ * @param fullyQualifiedName It MUST be a fully qualified name.
+ * @throws {HardhatError} If the name is not fully qualified.
+ */
+export declare function parseFullyQualifiedName(fullyQualifiedName: string): {
+    sourceName: string;
+    contractName: string;
+};
+/**
+ * Parses a name, which can be a bare contract name, or a fully qualified name.
+ */
+export declare function parseName(name: string): {
+    sourceName?: string;
+    contractName: string;
+};
+/**
+ * Returns the edit-distance between two given strings using Levenshtein distance.
+ *
+ * @param a First string being compared
+ * @param b Second string being compared
+ * @returns distance between the two strings (lower number == more similar)
+ * @see https://github.com/gustf/js-levenshtein
+ * @license MIT - https://github.com/gustf/js-levenshtein/blob/master/LICENSE
+ */
+export declare function findDistance(a: string, b: string): number;
+//# sourceMappingURL=contract-names.d.ts.map

package/utils/contract-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-names.d.ts","sourceRoot":"","sources":["../src/utils/contract-names.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,kBAAkB,EAAE,MAAM,GAAG;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAUA;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAWA;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAqGzD"}

package/utils/contract-names.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findDistance = exports.parseName = exports.parseFullyQualifiedName = exports.isFullyQualifiedName = exports.getFullyQualifiedName = void 0;
+const errors_1 = require("../internal/core/errors");
+const errors_list_1 = require("../internal/core/errors-list");
+/**
+ * Returns a fully qualified name from a sourceName and contractName.
+ */
+function getFullyQualifiedName(sourceName, contractName) {
+    return `${sourceName}:${contractName}`;
+}
+exports.getFullyQualifiedName = getFullyQualifiedName;
+/**
+ * Returns true if a name is fully qualified, and not just a bare contract name.
+ */
+function isFullyQualifiedName(name) {
+    return name.includes(":");
+}
+exports.isFullyQualifiedName = isFullyQualifiedName;
+/**
+ * Parses a fully qualified name.
+ *
+ * @param fullyQualifiedName It MUST be a fully qualified name.
+ * @throws {HardhatError} If the name is not fully qualified.
+ */
+function parseFullyQualifiedName(fullyQualifiedName) {
+    const { sourceName, contractName } = parseName(fullyQualifiedName);
+    if (sourceName === undefined) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.CONTRACT_NAMES.INVALID_FULLY_QUALIFIED_NAME, {
+            name: fullyQualifiedName,
+        });
+    }
+    return { sourceName, contractName };
+}
+exports.parseFullyQualifiedName = parseFullyQualifiedName;
+/**
+ * Parses a name, which can be a bare contract name, or a fully qualified name.
+ */
+function parseName(name) {
+    const parts = name.split(":");
+    if (parts.length === 1) {
+        return { contractName: parts[0] };
+    }
+    const contractName = parts[parts.length - 1];
+    const sourceName = parts.slice(0, parts.length - 1).join(":");
+    return { sourceName, contractName };
+}
+exports.parseName = parseName;
+/**
+ * Returns the edit-distance between two given strings using Levenshtein distance.
+ *
+ * @param a First string being compared
+ * @param b Second string being compared
+ * @returns distance between the two strings (lower number == more similar)
+ * @see https://github.com/gustf/js-levenshtein
+ * @license MIT - https://github.com/gustf/js-levenshtein/blob/master/LICENSE
+ */
+function findDistance(a, b) {
+    function _min(_d0, _d1, _d2, _bx, _ay) {
+        return _d0 < _d1 || _d2 < _d1
+            ? _d0 > _d2
+                ? _d2 + 1
+                : _d0 + 1
+            : _bx === _ay
+                ? _d1
+                : _d1 + 1;
+    }
+    if (a === b) {
+        return 0;
+    }
+    if (a.length > b.length) {
+        [a, b] = [b, a];
+    }
+    let la = a.length;
+    let lb = b.length;
+    while (la > 0 && a.charCodeAt(la - 1) === b.charCodeAt(lb - 1)) {
+        la--;
+        lb--;
+    }
+    let offset = 0;
+    while (offset < la && a.charCodeAt(offset) === b.charCodeAt(offset)) {
+        offset++;
+    }
+    la -= offset;
+    lb -= offset;
+    if (la === 0 || lb < 3) {
+        return lb;
+    }
+    let x = 0;
+    let y;
+    let d0;
+    let d1;
+    let d2;
+    let d3;
+    let dd = 0; // typescript gets angry if we don't assign here
+    let dy;
+    let ay;
+    let bx0;
+    let bx1;
+    let bx2;
+    let bx3;
+    const vector = [];
+    for (y = 0; y < la; y++) {
+        vector.push(y + 1);
+        vector.push(a.charCodeAt(offset + y));
+    }
+    const len = vector.length - 1;
+    for (; x < lb - 3;) {
+        bx0 = b.charCodeAt(offset + (d0 = x));
+        bx1 = b.charCodeAt(offset + (d1 = x + 1));
+        bx2 = b.charCodeAt(offset + (d2 = x + 2));
+        bx3 = b.charCodeAt(offset + (d3 = x + 3));
+        dd = x += 4;
+        for (y = 0; y < len; y += 2) {
+            dy = vector[y];
+            ay = vector[y + 1];
+            d0 = _min(dy, d0, d1, bx0, ay);
+            d1 = _min(d0, d1, d2, bx1, ay);
+            d2 = _min(d1, d2, d3, bx2, ay);
+            dd = _min(d2, d3, dd, bx3, ay);
+            vector[y] = dd;
+            d3 = d2;
+            d2 = d1;
+            d1 = d0;
+            d0 = dy;
+        }
+    }
+    for (; x < lb;) {
+        bx0 = b.charCodeAt(offset + (d0 = x));
+        dd = ++x;
+        for (y = 0; y < len; y += 2) {
+            dy = vector[y];
+            vector[y] = dd = _min(dy, d0, dd, bx0, vector[y + 1]);
+            d0 = dy;
+        }
+    }
+    return dd;
+}
+exports.findDistance = findDistance;
+//# sourceMappingURL=contract-names.js.map

package/utils/contract-names.js.map

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

package/utils/remappings.d.ts

@@ -0,0 +1,2 @@
+export declare function applyRemappings(remappings: Record<string, string>, sourceName: string): string;
+//# sourceMappingURL=remappings.d.ts.map

package/utils/remappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remappings.d.ts","sourceRoot":"","sources":["../src/utils/remappings.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,UAAU,EAAE,MAAM,GACjB,MAAM,CAaR"}

package/utils/remappings.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyRemappings = void 0;
+function applyRemappings(remappings, sourceName) {
+    const selectedRemapping = { from: "", to: "" };
+    for (const [from, to] of Object.entries(remappings)) {
+        if (sourceName.startsWith(from) &&
+            from.length >= selectedRemapping.from.length) {
+            [selectedRemapping.from, selectedRemapping.to] = [from, to];
+        }
+    }
+    return sourceName.replace(selectedRemapping.from, selectedRemapping.to);
+}
+exports.applyRemappings = applyRemappings;
+//# sourceMappingURL=remappings.js.map

package/utils/remappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remappings.js","sourceRoot":"","sources":["../src/utils/remappings.ts"],"names":[],"mappings":";;;AAAA,SAAgB,eAAe,CAC7B,UAAkC,EAClC,UAAkB;IAElB,MAAM,iBAAiB,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;QACnD,IACE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3B,IAAI,CAAC,MAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAC5C;YACA,CAAC,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;SAC7D;KACF;IAED,OAAO,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAhBD,0CAgBC"}

package/utils/source-names.d.ts

@@ -0,0 +1,60 @@
+/**
+ * This function validates the source name's format.
+ *
+ * It throws if the format is invalid.
+ * If it doesn't throw all you know is that the format is valid.
+ */
+export declare function validateSourceNameFormat(sourceName: string): void;
+/**
+ * This function returns true if the sourceName is, potentially, from a local
+ * file. It doesn't validate that the file actually exists.
+ *
+ * The source name must be in a valid format.
+ */
+export declare function isLocalSourceName(projectRoot: string, sourceName: string): Promise<boolean>;
+/**
+ * Validates that a source name exists, starting from `fromDir`, and has the
+ * right casing.
+ *
+ * The source name must be in a valid format.
+ */
+export declare function validateSourceNameExistenceAndCasing(fromDir: string, sourceName: string): Promise<void>;
+/**
+ * Returns the source name of an existing local file's absolute path.
+ *
+ * Throws is the file doesn't exist, it's not inside the project, or belongs
+ * to a library.
+ */
+export declare function localPathToSourceName(projectRoot: string, localFileAbsolutePath: string): Promise<string>;
+/**
+ * This function takes a valid local source name and returns its path. The
+ * source name doesn't need to point to an existing file.
+ */
+export declare function localSourceNameToPath(projectRoot: string, sourceName: string): string;
+/**
+ * Normalizes the source name, for example, by replacing `a/./b` with `a/b`.
+ *
+ * The sourceName param doesn't have to be a valid source name. It can,
+ * for example, be denormalized.
+ */
+export declare function normalizeSourceName(sourceName: string): string;
+/**
+ * This function returns true if the sourceName is a unix absolute path or a
+ * platform-dependent one.
+ *
+ * This function is used instead of just `path.isAbsolute` to ensure that
+ * source names never start with `/`, even on Windows.
+ */
+export declare function isAbsolutePathSourceName(sourceName: string): boolean;
+/**
+ * This function replaces backslashes (\\) with slashes (/).
+ *
+ * Note that a source name must not contain backslashes.
+ */
+export declare function replaceBackslashes(str: string): string;
+/**
+ * This function returns true if the sourceName contains the current package's name
+ * as a substring
+ */
+export declare function includesOwnPackageName(sourceName: string): Promise<boolean>;
+//# sourceMappingURL=source-names.d.ts.map

package/utils/source-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-names.d.ts","sourceRoot":"","sources":["../src/utils/source-names.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,QAmC1D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA4BlB;AAED;;;;;GAKG;AACH,wBAAsB,oCAAoC,CACxD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,iBAUnB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEpE;AAWD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUtD;AAqCD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAMlB"}

package/utils/source-names.js

@@ -0,0 +1,201 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.includesOwnPackageName = exports.replaceBackslashes = exports.isAbsolutePathSourceName = exports.normalizeSourceName = exports.localSourceNameToPath = exports.localPathToSourceName = exports.validateSourceNameExistenceAndCasing = exports.isLocalSourceName = exports.validateSourceNameFormat = void 0;
+const path_1 = __importDefault(require("path"));
+const errors_1 = require("../internal/core/errors");
+const errors_list_1 = require("../internal/core/errors-list");
+const fs_utils_1 = require("../internal/util/fs-utils");
+const packageInfo_1 = require("../internal/util/packageInfo");
+const NODE_MODULES = "node_modules";
+/**
+ * This function validates the source name's format.
+ *
+ * It throws if the format is invalid.
+ * If it doesn't throw all you know is that the format is valid.
+ */
+function validateSourceNameFormat(sourceName) {
+    if (isAbsolutePathSourceName(sourceName)) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.INVALID_SOURCE_NAME_ABSOLUTE_PATH, {
+            name: sourceName,
+        });
+    }
+    if (isExplicitRelativePath(sourceName)) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.INVALID_SOURCE_NAME_RELATIVE_PATH, {
+            name: sourceName,
+        });
+    }
+    // We check this before normalizing so we are sure that the difference
+    // comes from slash vs backslash
+    if (replaceBackslashes(sourceName) !== sourceName) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.INVALID_SOURCE_NAME_BACKSLASHES, {
+            name: sourceName,
+        });
+    }
+    if (normalizeSourceName(sourceName) !== sourceName) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.INVALID_SOURCE_NOT_NORMALIZED, {
+            name: sourceName,
+        });
+    }
+}
+exports.validateSourceNameFormat = validateSourceNameFormat;
+/**
+ * This function returns true if the sourceName is, potentially, from a local
+ * file. It doesn't validate that the file actually exists.
+ *
+ * The source name must be in a valid format.
+ */
+async function isLocalSourceName(projectRoot, sourceName) {
+    // Note that we consider "hardhat/console.sol" as a special case here.
+    // This lets someone have a "hardhat" directory within their project without
+    // it impacting their use of `console.log`.
+    // See issue https://github.com/nomiclabs/hardhat/issues/998
+    if (sourceName.includes(NODE_MODULES) ||
+        sourceName === "hardhat/console.sol") {
+        return false;
+    }
+    const slashIndex = sourceName.indexOf("/");
+    const firstDirOrFileName = slashIndex !== -1 ? sourceName.substring(0, slashIndex) : sourceName;
+    try {
+        await (0, fs_utils_1.getFileTrueCase)(projectRoot, firstDirOrFileName);
+    }
+    catch (error) {
+        if (error instanceof fs_utils_1.FileNotFoundError) {
+            return false;
+        }
+        // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+        throw error;
+    }
+    return true;
+}
+exports.isLocalSourceName = isLocalSourceName;
+/**
+ * Validates that a source name exists, starting from `fromDir`, and has the
+ * right casing.
+ *
+ * The source name must be in a valid format.
+ */
+async function validateSourceNameExistenceAndCasing(fromDir, sourceName) {
+    const trueCaseSourceName = await getSourceNameTrueCase(fromDir, sourceName);
+    if (trueCaseSourceName !== sourceName) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.WRONG_CASING, {
+            incorrect: sourceName,
+            correct: trueCaseSourceName,
+        });
+    }
+}
+exports.validateSourceNameExistenceAndCasing = validateSourceNameExistenceAndCasing;
+/**
+ * Returns the source name of an existing local file's absolute path.
+ *
+ * Throws is the file doesn't exist, it's not inside the project, or belongs
+ * to a library.
+ */
+async function localPathToSourceName(projectRoot, localFileAbsolutePath) {
+    const relativePath = path_1.default.relative(projectRoot, localFileAbsolutePath);
+    const normalized = normalizeSourceName(relativePath);
+    if (normalized.startsWith("..")) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.EXTERNAL_AS_LOCAL, {
+            path: localFileAbsolutePath,
+        });
+    }
+    if (normalized.includes(NODE_MODULES)) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.NODE_MODULES_AS_LOCAL, {
+            path: localFileAbsolutePath,
+        });
+    }
+    return getSourceNameTrueCase(projectRoot, relativePath);
+}
+exports.localPathToSourceName = localPathToSourceName;
+/**
+ * This function takes a valid local source name and returns its path. The
+ * source name doesn't need to point to an existing file.
+ */
+function localSourceNameToPath(projectRoot, sourceName) {
+    return path_1.default.join(projectRoot, sourceName);
+}
+exports.localSourceNameToPath = localSourceNameToPath;
+/**
+ * Normalizes the source name, for example, by replacing `a/./b` with `a/b`.
+ *
+ * The sourceName param doesn't have to be a valid source name. It can,
+ * for example, be denormalized.
+ */
+function normalizeSourceName(sourceName) {
+    return replaceBackslashes(path_1.default.normalize(sourceName));
+}
+exports.normalizeSourceName = normalizeSourceName;
+/**
+ * This function returns true if the sourceName is a unix absolute path or a
+ * platform-dependent one.
+ *
+ * This function is used instead of just `path.isAbsolute` to ensure that
+ * source names never start with `/`, even on Windows.
+ */
+function isAbsolutePathSourceName(sourceName) {
+    return path_1.default.isAbsolute(sourceName) || sourceName.startsWith("/");
+}
+exports.isAbsolutePathSourceName = isAbsolutePathSourceName;
+/**
+ * This function returns true if the sourceName is a unix path that is based on
+ * the current directory `./`.
+ */
+function isExplicitRelativePath(sourceName) {
+    const [base] = sourceName.split("/", 1);
+    return base === "." || base === "..";
+}
+/**
+ * This function replaces backslashes (\\) with slashes (/).
+ *
+ * Note that a source name must not contain backslashes.
+ */
+function replaceBackslashes(str) {
+    // Based in the npm module slash
+    const isExtendedLengthPath = /^\\\\\?\\/.test(str);
+    const hasNonAscii = /[^\u0000-\u0080]+/.test(str);
+    if (isExtendedLengthPath || hasNonAscii) {
+        return str;
+    }
+    return str.replace(/\\/g, "/");
+}
+exports.replaceBackslashes = replaceBackslashes;
+function slashesToPathSeparator(str) {
+    if (path_1.default.sep === "/") {
+        return str;
+    }
+    return str.replace(/\//g, path_1.default.sep);
+}
+/**
+ * Returns the true casing of `p` as a relative path from `fromDir`. Throws if
+ * `p` doesn't exist. `p` MUST be in source name format.
+ */
+async function getSourceNameTrueCase(fromDir, p) {
+    try {
+        const realCase = await (0, fs_utils_1.getFileTrueCase)(fromDir, slashesToPathSeparator(p));
+        return normalizeSourceName(realCase);
+    }
+    catch (error) {
+        if (error instanceof fs_utils_1.FileNotFoundError) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.SOURCE_NAMES.FILE_NOT_FOUND, {
+                name: p,
+            }, error);
+        }
+        // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+        throw error;
+    }
+}
+/**
+ * This function returns true if the sourceName contains the current package's name
+ * as a substring
+ */
+async function includesOwnPackageName(sourceName) {
+    const packageName = await (0, packageInfo_1.getPackageName)(sourceName);
+    if (packageName !== "") {
+        return sourceName.startsWith(`${packageName}/`);
+    }
+    return false;
+}
+exports.includesOwnPackageName = includesOwnPackageName;
+//# sourceMappingURL=source-names.js.map