hardhatjs 2.22.15

package/internal/core/runtime-environment.js

@@ -0,0 +1,317 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Environment = void 0;
+const debug_1 = __importDefault(require("debug"));
+const artifacts_1 = require("../artifacts");
+const packageInfo_1 = require("../util/packageInfo");
+const config_loading_1 = require("./config/config-loading");
+const errors_1 = require("./errors");
+const errors_list_1 = require("./errors-list");
+const construction_1 = require("./providers/construction");
+const lazy_initialization_1 = require("./providers/lazy-initialization");
+const task_definitions_1 = require("./tasks/task-definitions");
+const task_profiling_1 = require("./task-profiling");
+const util_1 = require("./tasks/util");
+const log = (0, debug_1.default)("hardhat:core:hre");
+class Environment {
+    /**
+     * Initializes the Hardhat Runtime Environment and the given
+     * extender functions.
+     *
+     * @remarks The extenders' execution order is given by the order
+     * of the requires in the hardhat's config file and its plugins.
+     *
+     * @param config The hardhat's config object.
+     * @param hardhatArguments The parsed hardhat's arguments.
+     * @param tasks A map of tasks.
+     * @param scopes A map of scopes.
+     * @param environmentExtenders A list of environment extenders.
+     * @param providerExtenders A list of provider extenders.
+     */
+    constructor(config, hardhatArguments, tasks, scopes, environmentExtenders = [], userConfig = {}, providerExtenders = []) {
+        this.config = config;
+        this.hardhatArguments = hardhatArguments;
+        this.tasks = tasks;
+        this.scopes = scopes;
+        this.userConfig = userConfig;
+        this.version = (0, packageInfo_1.getHardhatVersion)();
+        /**
+         * Executes the task with the given name.
+         *
+         * @param taskIdentifier The task or scoped task to be executed.
+         * @param taskArguments A map of task's arguments.
+         * @param subtaskArguments A map of subtasks to their arguments.
+         *
+         * @throws a HH303 if there aren't any defined tasks with the given name.
+         * @returns a promise with the task's execution result.
+         */
+        this.run = async (taskIdentifier, taskArguments = {}, subtaskArguments = {}, callerTaskProfile) => {
+            const { scope, task } = (0, util_1.parseTaskIdentifier)(taskIdentifier);
+            let taskDefinition;
+            if (scope === undefined) {
+                taskDefinition = this.tasks[task];
+                log("Running task %s", task);
+            }
+            else {
+                const scopeDefinition = this.scopes[scope];
+                if (scopeDefinition === undefined) {
+                    throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPE, {
+                        scope,
+                    });
+                }
+                taskDefinition = scopeDefinition.tasks?.[task];
+                log("Running scoped task %s %s", scope, task);
+            }
+            if (taskDefinition === undefined) {
+                if (scope !== undefined) {
+                    throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPED_TASK, {
+                        scope,
+                        task,
+                    });
+                }
+                throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
+                    task,
+                });
+            }
+            const resolvedTaskArguments = this._resolveValidTaskArguments(taskDefinition, taskArguments, subtaskArguments);
+            let taskProfile;
+            if (this.hardhatArguments.flamegraph === true) {
+                taskProfile = (0, task_profiling_1.createTaskProfile)(task);
+                if (callerTaskProfile !== undefined) {
+                    callerTaskProfile.children.push(taskProfile);
+                }
+                else {
+                    this.entryTaskProfile = taskProfile;
+                }
+            }
+            try {
+                return await this._runTaskDefinition(taskDefinition, resolvedTaskArguments, subtaskArguments, taskProfile);
+            }
+            catch (e) {
+                (0, config_loading_1.analyzeModuleNotFoundError)(e, this.config.paths.configFile);
+                // eslint-disable-next-line @nomicfoundation/hardhat-internal-rules/only-hardhat-error
+                throw e;
+            }
+            finally {
+                if (taskProfile !== undefined) {
+                    (0, task_profiling_1.completeTaskProfile)(taskProfile);
+                }
+            }
+        };
+        log("Creating HardhatRuntimeEnvironment");
+        const networkName = hardhatArguments.network !== undefined
+            ? hardhatArguments.network
+            : config.defaultNetwork;
+        const networkConfig = config.networks[networkName];
+        if (networkConfig === undefined) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.NETWORK.CONFIG_NOT_FOUND, {
+                network: networkName,
+            });
+        }
+        this.artifacts = new artifacts_1.Artifacts(config.paths.artifacts);
+        const provider = new lazy_initialization_1.LazyInitializationProviderAdapter(async () => {
+            log(`Creating provider for network ${networkName}`);
+            return (0, construction_1.createProvider)(config, networkName, this.artifacts, providerExtenders);
+        });
+        this.network = {
+            name: networkName,
+            config: networkConfig,
+            provider,
+        };
+        this._environmentExtenders = environmentExtenders;
+        environmentExtenders.forEach((extender) => extender(this));
+    }
+    /**
+     * Injects the properties of `this` (the Hardhat Runtime Environment) into the global scope.
+     *
+     * @param blacklist a list of property names that won't be injected.
+     *
+     * @returns a function that restores the previous environment.
+     */
+    injectToGlobal(blacklist = Environment._BLACKLISTED_PROPERTIES) {
+        const globalAsAny = global;
+        const previousValues = {};
+        const previousHre = globalAsAny.hre;
+        globalAsAny.hre = this;
+        for (const [key, value] of Object.entries(this)) {
+            if (blacklist.includes(key)) {
+                continue;
+            }
+            previousValues[key] = globalAsAny[key];
+            globalAsAny[key] = value;
+        }
+        return () => {
+            for (const [key, _] of Object.entries(this)) {
+                if (blacklist.includes(key)) {
+                    continue;
+                }
+                globalAsAny.hre = previousHre;
+                globalAsAny[key] = previousValues[key];
+            }
+        };
+    }
+    /**
+     * @param taskProfile Undefined if we aren't computing task profiles
+     * @private
+     */
+    async _runTaskDefinition(taskDefinition, taskArguments, subtaskArguments, taskProfile) {
+        let runSuperFunction;
+        if (taskDefinition instanceof task_definitions_1.OverriddenTaskDefinition) {
+            runSuperFunction = async (_taskArguments = taskArguments, _subtaskArguments = subtaskArguments) => {
+                log("Running %s's super", taskDefinition.name);
+                if (taskProfile === undefined) {
+                    return this._runTaskDefinition(taskDefinition.parentTaskDefinition, _taskArguments, _subtaskArguments);
+                }
+                const parentTaskProfile = (0, task_profiling_1.createParentTaskProfile)(taskProfile);
+                taskProfile.children.push(parentTaskProfile);
+                try {
+                    return await this._runTaskDefinition(taskDefinition.parentTaskDefinition, _taskArguments, _subtaskArguments, parentTaskProfile);
+                }
+                finally {
+                    (0, task_profiling_1.completeTaskProfile)(parentTaskProfile);
+                }
+            };
+            runSuperFunction.isDefined = true;
+        }
+        else {
+            runSuperFunction = async () => {
+                throw new errors_1.HardhatError(errors_list_1.ERRORS.TASK_DEFINITIONS.RUNSUPER_NOT_AVAILABLE, {
+                    taskName: taskDefinition.name,
+                });
+            };
+            runSuperFunction.isDefined = false;
+        }
+        const runSuper = runSuperFunction;
+        const globalAsAny = global;
+        const previousRunSuper = globalAsAny.runSuper;
+        globalAsAny.runSuper = runSuper;
+        // We create a proxied version of `this`, as we want to keep track of the
+        // `subtaskArguments` and `taskProfile` through `run` invocations. This
+        // way we keep track of callers's data, even when tasks are run in parallel.
+        const proxiedHre = new Proxy(this, {
+            get(target, p, receiver) {
+                if (p === "run") {
+                    return (_name, _taskArguments, _subtaskArguments) => target.run(_name, _taskArguments, { ..._subtaskArguments, ...subtaskArguments }, // parent subtask args take precedence
+                    taskProfile);
+                }
+                return Reflect.get(target, p, receiver);
+            },
+        });
+        if (this.hardhatArguments.flamegraph === true) {
+            // We modify the `this` again to add  a few utility methods.
+            proxiedHre.adhocProfile = async (_name, f) => {
+                const adhocProfile = (0, task_profiling_1.createTaskProfile)(_name);
+                taskProfile.children.push(adhocProfile);
+                try {
+                    return await f();
+                }
+                finally {
+                    (0, task_profiling_1.completeTaskProfile)(adhocProfile);
+                }
+            };
+            proxiedHre.adhocProfileSync = (_name, f) => {
+                const adhocProfile = (0, task_profiling_1.createTaskProfile)(_name);
+                taskProfile.children.push(adhocProfile);
+                try {
+                    return f();
+                }
+                finally {
+                    (0, task_profiling_1.completeTaskProfile)(adhocProfile);
+                }
+            };
+        }
+        const uninjectFromGlobal = proxiedHre.injectToGlobal();
+        try {
+            return await taskDefinition.action(taskArguments, proxiedHre, runSuper);
+        }
+        finally {
+            uninjectFromGlobal();
+            globalAsAny.runSuper = previousRunSuper;
+        }
+    }
+    /**
+     * Check that task arguments are within TaskDefinition defined params constraints.
+     * Also, populate missing, non-mandatory arguments with default param values (if any).
+     *
+     * @private
+     * @throws HardhatError if any of the following are true:
+     *  > a required argument is missing
+     *  > an argument's value's type doesn't match the defined param type
+     *
+     * @param taskDefinition
+     * @param taskArguments
+     * @returns resolvedTaskArguments
+     */
+    _resolveValidTaskArguments(taskDefinition, taskArguments, subtaskArguments) {
+        const { name: taskName, paramDefinitions, positionalParamDefinitions, } = taskDefinition;
+        const nonPositionalParamDefinitions = Object.values(paramDefinitions);
+        // gather all task param definitions
+        const allTaskParamDefinitions = [
+            ...nonPositionalParamDefinitions,
+            ...positionalParamDefinitions,
+        ];
+        const resolvedArguments = {};
+        for (const paramDefinition of allTaskParamDefinitions) {
+            const paramName = paramDefinition.name;
+            const argumentValue = subtaskArguments[taskName]?.[paramName] ?? taskArguments[paramName];
+            const resolvedArgumentValue = this._resolveArgument(paramDefinition, argumentValue, taskDefinition.name);
+            if (resolvedArgumentValue !== undefined) {
+                resolvedArguments[paramName] = resolvedArgumentValue;
+            }
+        }
+        // We keep the args in taskArguments that were not resolved
+        return { ...taskArguments, ...resolvedArguments };
+    }
+    /**
+     * Resolves an argument according to a ParamDefinition rules.
+     *
+     * @param paramDefinition
+     * @param argumentValue
+     * @private
+     */
+    _resolveArgument(paramDefinition, argumentValue, taskName) {
+        const { name, isOptional, defaultValue } = paramDefinition;
+        if (argumentValue === undefined) {
+            if (isOptional) {
+                // undefined & optional argument -> return defaultValue
+                return defaultValue;
+            }
+            // undefined & mandatory argument -> error
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.MISSING_TASK_ARGUMENT, {
+                param: name,
+                task: taskName,
+            });
+        }
+        // arg was present -> validate type, if applicable
+        this._checkTypeValidation(paramDefinition, argumentValue);
+        return argumentValue;
+    }
+    /**
+     * Checks if value is valid for the specified param definition.
+     *
+     * @param paramDefinition {ParamDefinition} - the param definition for validation
+     * @param argumentValue - the value to be validated
+     * @private
+     * @throws HH301 if value is not valid for the param type
+     */
+    _checkTypeValidation(paramDefinition, argumentValue) {
+        const { name: paramName, type, isVariadic } = paramDefinition;
+        // in case of variadic param, argValue is an array and the type validation must pass for all values.
+        // otherwise, it's a single value that is to be validated
+        const argumentValueContainer = isVariadic ? argumentValue : [argumentValue];
+        for (const value of argumentValueContainer) {
+            type.validate(paramName, value);
+        }
+    }
+}
+Environment._BLACKLISTED_PROPERTIES = [
+    "injectToGlobal",
+    "entryTaskProfile",
+    "_runTaskDefinition",
+    "_extenders",
+];
+exports.Environment = Environment;
+//# sourceMappingURL=runtime-environment.js.map

package/internal/core/runtime-environment.js.map

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

package/internal/core/task-profiling.d.ts

@@ -0,0 +1,18 @@
+export interface TaskProfile {
+    name: string;
+    start: bigint;
+    end?: bigint;
+    children: TaskProfile[];
+    parallel?: boolean;
+}
+export declare function createTaskProfile(name: string): TaskProfile;
+export declare function completeTaskProfile(taskProfile: TaskProfile): void;
+export declare function createParentTaskProfile(taskProfile: TaskProfile): TaskProfile;
+/**
+ * Sets `parallel` to `true` to any children that was running at the same time
+ * of another.
+ *
+ * We assume `children[]` is in chronological `start` order.
+ */
+export declare function flagParallelChildren(profile: TaskProfile, isParentParallel?: boolean): void;
+//# sourceMappingURL=task-profiling.d.ts.map

package/internal/core/task-profiling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-profiling.d.ts","sourceRoot":"","sources":["../../src/internal/core/task-profiling.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM3D;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,WAAW,QAE3D;AAED,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAE7E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,gBAAgB,UAAQ,QAuBzB"}

package/internal/core/task-profiling.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flagParallelChildren = exports.createParentTaskProfile = exports.completeTaskProfile = exports.createTaskProfile = void 0;
+function createTaskProfile(name) {
+    return {
+        name,
+        start: process.hrtime.bigint(),
+        children: [],
+    };
+}
+exports.createTaskProfile = createTaskProfile;
+function completeTaskProfile(taskProfile) {
+    taskProfile.end = process.hrtime.bigint();
+}
+exports.completeTaskProfile = completeTaskProfile;
+function createParentTaskProfile(taskProfile) {
+    return createTaskProfile(`super::${taskProfile.name}`);
+}
+exports.createParentTaskProfile = createParentTaskProfile;
+/**
+ * Sets `parallel` to `true` to any children that was running at the same time
+ * of another.
+ *
+ * We assume `children[]` is in chronological `start` order.
+ */
+function flagParallelChildren(profile, isParentParallel = false) {
+    if (isParentParallel) {
+        profile.parallel = true;
+        for (const child of profile.children) {
+            child.parallel = true;
+        }
+    }
+    else {
+        for (const [i, child] of profile.children.entries()) {
+            if (i === 0) {
+                continue;
+            }
+            const prevChild = profile.children[i - 1];
+            if (child.start < prevChild.end) {
+                prevChild.parallel = true;
+                child.parallel = true;
+            }
+        }
+    }
+    for (const child of profile.children) {
+        flagParallelChildren(child, child.parallel);
+    }
+}
+exports.flagParallelChildren = flagParallelChildren;
+//# sourceMappingURL=task-profiling.js.map

package/internal/core/task-profiling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-profiling.js","sourceRoot":"","sources":["../../src/internal/core/task-profiling.ts"],"names":[],"mappings":";;;AAQA,SAAgB,iBAAiB,CAAC,IAAY;IAC5C,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE;QAC9B,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAND,8CAMC;AAED,SAAgB,mBAAmB,CAAC,WAAwB;IAC1D,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;AAC5C,CAAC;AAFD,kDAEC;AAED,SAAgB,uBAAuB,CAAC,WAAwB;IAC9D,OAAO,iBAAiB,CAAC,UAAU,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAFD,0DAEC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAClC,OAAoB,EACpB,gBAAgB,GAAG,KAAK;IAExB,IAAI,gBAAgB,EAAE;QACpB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE;YACpC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;SACvB;KACF;SAAM;QACL,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE;YACnD,IAAI,CAAC,KAAK,CAAC,EAAE;gBACX,SAAS;aACV;YACD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,GAAI,EAAE;gBAChC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC1B,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;aACvB;SACF;KACF;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE;QACpC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;KAC7C;AACH,CAAC;AAzBD,oDAyBC"}

package/internal/core/tasks/builtin-tasks.d.ts

@@ -0,0 +1,11 @@
+import "../../../builtin-tasks/check";
+import "../../../builtin-tasks/clean";
+import "../../../builtin-tasks/compile";
+import "../../../builtin-tasks/console";
+import "../../../builtin-tasks/flatten";
+import "../../../builtin-tasks/help";
+import "../../../builtin-tasks/node";
+import "../../../builtin-tasks/run";
+import "../../../builtin-tasks/vars";
+import "../../../builtin-tasks/test";
+//# sourceMappingURL=builtin-tasks.d.ts.map

package/internal/core/tasks/builtin-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-tasks.d.ts","sourceRoot":"","sources":["../../../src/internal/core/tasks/builtin-tasks.ts"],"names":[],"mappings":"AAAA,OAAO,8BAA8B,CAAC;AACtC,OAAO,8BAA8B,CAAC;AACtC,OAAO,gCAAgC,CAAC;AACxC,OAAO,gCAAgC,CAAC;AACxC,OAAO,gCAAgC,CAAC;AACxC,OAAO,6BAA6B,CAAC;AACrC,OAAO,6BAA6B,CAAC;AACrC,OAAO,4BAA4B,CAAC;AACpC,OAAO,6BAA6B,CAAC;AACrC,OAAO,6BAA6B,CAAC"}

package/internal/core/tasks/builtin-tasks.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("../../../builtin-tasks/check");
+require("../../../builtin-tasks/clean");
+require("../../../builtin-tasks/compile");
+require("../../../builtin-tasks/console");
+require("../../../builtin-tasks/flatten");
+require("../../../builtin-tasks/help");
+require("../../../builtin-tasks/node");
+require("../../../builtin-tasks/run");
+require("../../../builtin-tasks/vars");
+require("../../../builtin-tasks/test");
+//# sourceMappingURL=builtin-tasks.js.map

package/internal/core/tasks/builtin-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-tasks.js","sourceRoot":"","sources":["../../../src/internal/core/tasks/builtin-tasks.ts"],"names":[],"mappings":";;AAAA,wCAAsC;AACtC,wCAAsC;AACtC,0CAAwC;AACxC,0CAAwC;AACxC,0CAAwC;AACxC,uCAAqC;AACrC,uCAAqC;AACrC,sCAAoC;AACpC,uCAAqC;AACrC,uCAAqC"}

package/internal/core/tasks/dsl.d.ts

@@ -0,0 +1,76 @@
+import { ActionType, ScopeDefinition, ScopesMap, TaskArguments, TaskDefinition, TasksMap } from "../../../types";
+/**
+ * This class defines the DSL used in Hardhat config files
+ * for creating and overriding tasks.
+ */
+export declare class TasksDSL {
+    readonly internalTask: {
+        <TaskArgumentsT extends unknown>(name: string, description?: string, action?: ActionType<TaskArgumentsT> | undefined): TaskDefinition;
+        <TaskArgumentsT_1 extends unknown>(name: string, action: ActionType<TaskArgumentsT_1>): TaskDefinition;
+    };
+    private readonly _tasks;
+    private readonly _scopes;
+    /**
+     * Creates a task, overriding any previous task with the same name.
+     *
+     * @remarks The action must await every async call made within it.
+     *
+     * @param name The task's name.
+     * @param description The task's description.
+     * @param action The task's action.
+     * @returns A task definition.
+     */
+    task<TaskArgumentsT extends TaskArguments>(name: string, description?: string, action?: ActionType<TaskArgumentsT>): TaskDefinition;
+    /**
+     * Creates a task without description, overriding any previous task
+     * with the same name.
+     *
+     * @remarks The action must await every async call made within it.
+     *
+     * @param name The task's name.
+     * @param action The task's action.
+     *
+     * @returns A task definition.
+     */
+    task<TaskArgumentsT extends TaskArguments>(name: string, action: ActionType<TaskArgumentsT>): TaskDefinition;
+    /**
+     * Creates a subtask, overriding any previous task with the same name.
+     *
+     * @remarks The subtasks won't be displayed in the CLI help messages.
+     * @remarks The action must await every async call made within it.
+     *
+     * @param name The task's name.
+     * @param description The task's description.
+     * @param action The task's action.
+     * @returns A task definition.
+     */
+    subtask<TaskArgumentsT extends TaskArguments>(name: string, description?: string, action?: ActionType<TaskArgumentsT>): TaskDefinition;
+    /**
+     * Creates a subtask without description, overriding any previous
+     * task with the same name.
+     *
+     * @remarks The subtasks won't be displayed in the CLI help messages.
+     * @remarks The action must await every async call made within it.
+     *
+     * @param name The task's name.
+     * @param action The task's action.
+     * @returns A task definition.
+     */
+    subtask<TaskArgumentsT extends TaskArguments>(name: string, action: ActionType<TaskArgumentsT>): TaskDefinition;
+    scope(name: string, description?: string): ScopeDefinition;
+    /**
+     * Retrieves the task definitions.
+     *
+     * @returns The tasks container.
+     */
+    getTaskDefinitions(): TasksMap;
+    /**
+     * Retrieves the scoped task definitions.
+     *
+     * @returns The scoped tasks container.
+     */
+    getScopesDefinitions(): ScopesMap;
+    getTaskDefinition(scope: string | undefined, name: string): TaskDefinition | undefined;
+    private _addTask;
+}
+//# sourceMappingURL=dsl.d.ts.map

package/internal/core/tasks/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../../src/internal/core/tasks/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,cAAc,EAEd,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAWxB;;;GAGG;AACH,qBAAa,QAAQ;IACnB,SAAgB,YAAY;+CA2DpB,MAAM,gBACE,MAAM,oDAEnB,cAAc;iDAcT,MAAM,yCAEX,cAAc;MA9E2B;IAE5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IAEzC;;;;;;;;;OASG;IACI,IAAI,CAAC,cAAc,SAAS,aAAa,EAC9C,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAClC,cAAc;IAEjB;;;;;;;;;;OAUG;IACI,IAAI,CAAC,cAAc,SAAS,aAAa,EAC9C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,GACjC,cAAc;IAYjB;;;;;;;;;;OAUG;IACI,OAAO,CAAC,cAAc,SAAS,aAAa,EACjD,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,GAClC,cAAc;IAEjB;;;;;;;;;;OAUG;IACI,OAAO,CAAC,cAAc,SAAS,aAAa,EACjD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,CAAC,cAAc,CAAC,GACjC,cAAc;IAWV,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe;IA6CjE;;;;OAIG;IACI,kBAAkB,IAAI,QAAQ;IAIrC;;;;OAIG;IACI,oBAAoB,IAAI,SAAS;IAIjC,iBAAiB,CACtB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GACX,cAAc,GAAG,SAAS;IAQ7B,OAAO,CAAC,QAAQ;CAqDjB"}

package/internal/core/tasks/dsl.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TasksDSL = void 0;
+const errors_1 = require("../errors");
+const errors_list_1 = require("../errors-list");
+const task_definitions_1 = require("./task-definitions");
+const util_1 = require("./util");
+/**
+ * This class defines the DSL used in Hardhat config files
+ * for creating and overriding tasks.
+ */
+class TasksDSL {
+    constructor() {
+        this.internalTask = this.subtask;
+        this._tasks = {};
+        this._scopes = {};
+    }
+    task(name, descriptionOrAction, action) {
+        // if this function is updated, update the corresponding callback
+        // passed to `new SimpleScopeDefinition`
+        return this._addTask(name, descriptionOrAction, action, false);
+    }
+    subtask(name, descriptionOrAction, action) {
+        // if this function is updated, update the corresponding callback
+        // passed to `new SimpleScopeDefinition`
+        return this._addTask(name, descriptionOrAction, action, true);
+    }
+    scope(name, description) {
+        if (this._tasks[name] !== undefined) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.TASK_DEFINITIONS.TASK_SCOPE_CLASH, {
+                scopeName: name,
+            });
+        }
+        const scopeDefinition = this._scopes[name];
+        if (scopeDefinition !== undefined) {
+            // if the scope already exists, the only thing we might
+            // do is to update its description
+            if (description !== undefined) {
+                scopeDefinition.setDescription(description);
+            }
+            return scopeDefinition;
+        }
+        const scope = new task_definitions_1.SimpleScopeDefinition(name, description, (taskName, descriptionOrAction, action) => 
+        // if this function is updated, update the dsl.task function too
+        this._addTask({ scope: name, task: taskName }, descriptionOrAction, action, false), (subtaskName, descriptionOrAction, action) => 
+        // if this function is updated, update the dsl.subtask function too
+        this._addTask({ scope: name, task: subtaskName }, descriptionOrAction, action, true));
+        this._scopes[name] = scope;
+        return scope;
+    }
+    /**
+     * Retrieves the task definitions.
+     *
+     * @returns The tasks container.
+     */
+    getTaskDefinitions() {
+        return this._tasks;
+    }
+    /**
+     * Retrieves the scoped task definitions.
+     *
+     * @returns The scoped tasks container.
+     */
+    getScopesDefinitions() {
+        return this._scopes;
+    }
+    getTaskDefinition(scope, name) {
+        if (scope === undefined) {
+            return this._tasks[name];
+        }
+        else {
+            return this._scopes[scope]?.tasks?.[name];
+        }
+    }
+    _addTask(taskIdentifier, descriptionOrAction, action, isSubtask) {
+        const { scope, task } = (0, util_1.parseTaskIdentifier)(taskIdentifier);
+        if (scope === undefined && this._scopes[task] !== undefined) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.TASK_DEFINITIONS.SCOPE_TASK_CLASH, {
+                taskName: task,
+            });
+        }
+        const parentTaskDefinition = this.getTaskDefinition(scope, task);
+        let taskDefinition;
+        if (parentTaskDefinition !== undefined) {
+            taskDefinition = new task_definitions_1.OverriddenTaskDefinition(parentTaskDefinition, isSubtask);
+        }
+        else {
+            taskDefinition = new task_definitions_1.SimpleTaskDefinition(taskIdentifier, isSubtask);
+        }
+        if (descriptionOrAction instanceof Function) {
+            action = descriptionOrAction;
+            descriptionOrAction = undefined;
+        }
+        if (descriptionOrAction !== undefined) {
+            taskDefinition.setDescription(descriptionOrAction);
+        }
+        if (action !== undefined) {
+            taskDefinition.setAction(action);
+        }
+        if (scope === undefined) {
+            this._tasks[task] = taskDefinition;
+        }
+        else {
+            const scopeDefinition = this._scopes[scope];
+            (0, errors_1.assertHardhatInvariant)(scopeDefinition !== undefined, "It shouldn't be possible to create a task in a scope that doesn't exist");
+            scopeDefinition.tasks[task] = taskDefinition;
+        }
+        return taskDefinition;
+    }
+}
+exports.TasksDSL = TasksDSL;
+//# sourceMappingURL=dsl.js.map

package/internal/core/tasks/dsl.js.map

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