hardhat 2.17.3 → 2.18.0

package/README.md

@@ -19,7 +19,7 @@ npm install --save-dev hardhat
 Once it's installed, just run this command and follow its instructions:
 
 ```
-npx hardhat
+npx hardhat init
 ```
 
 ## Documentation

package/builtin-tasks/help.js

@@ -3,16 +3,47 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const HelpPrinter_1 = require("../internal/cli/HelpPrinter");
 const constants_1 = require("../internal/constants");
 const config_env_1 = require("../internal/core/config/config-env");
+const errors_1 = require("../internal/core/errors");
+const errors_list_1 = require("../internal/core/errors-list");
 const hardhat_params_1 = require("../internal/core/params/hardhat-params");
 const task_names_1 = require("./task-names");
 (0, config_env_1.task)(task_names_1.TASK_HELP, "Prints this message")
+    .addOptionalPositionalParam("scopeOrTask", "An optional scope or task to print more info about")
     .addOptionalPositionalParam("task", "An optional task to print more info about")
-    .setAction(async ({ task: taskName }, { tasks, version }) => {
-    const helpPrinter = new HelpPrinter_1.HelpPrinter(constants_1.HARDHAT_NAME, constants_1.HARDHAT_EXECUTABLE_NAME, version, hardhat_params_1.HARDHAT_PARAM_DEFINITIONS, tasks);
-    if (taskName !== undefined) {
-        helpPrinter.printTaskHelp(taskName);
+    .setAction(async ({ scopeOrTask, task: taskName }, { tasks, scopes, version }) => {
+    const helpPrinter = new HelpPrinter_1.HelpPrinter(constants_1.HARDHAT_NAME, constants_1.HARDHAT_EXECUTABLE_NAME, version, hardhat_params_1.HARDHAT_PARAM_DEFINITIONS, tasks, scopes);
+    if (scopeOrTask === undefined) {
+        // no params, print global help
+        helpPrinter.printGlobalHelp();
         return;
     }
-    helpPrinter.printGlobalHelp();
+    const taskDefinition = tasks[scopeOrTask];
+    if (taskDefinition !== undefined) {
+        // the first param is a valid task
+        helpPrinter.printTaskHelp(tasks[scopeOrTask]);
+        return;
+    }
+    const scopeDefinition = scopes[scopeOrTask];
+    if (scopeDefinition === undefined) {
+        // if the first parameter is neither a task nor a scope,
+        // we don't know what the user was trying to print,
+        // so we assume that it's an unrecognized task
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
+            task: scopeOrTask,
+        });
+    }
+    if (taskName === undefined) {
+        // if the second parameter is not present, print scope help
+        helpPrinter.printScopeHelp(scopeDefinition);
+        return;
+    }
+    const scopedTaskDefinition = scopeDefinition.tasks[taskName];
+    if (scopedTaskDefinition === undefined) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPED_TASK, {
+            scope: scopeOrTask,
+            task: taskName,
+        });
+    }
+    helpPrinter.printTaskHelp(scopedTaskDefinition);
 });
 //# sourceMappingURL=help.js.map

package/builtin-tasks/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/builtin-tasks/help.ts"],"names":[],"mappings":";;AAAA,6DAA0D;AAC1D,qDAA8E;AAC9E,mEAA0D;AAC1D,2EAAmF;AAEnF,6CAAyC;AAEzC,IAAA,iBAAI,EAAC,sBAAS,EAAE,qBAAqB,CAAC;KACnC,0BAA0B,CACzB,MAAM,EACN,2CAA2C,CAC5C;KACA,SAAS,CACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAqB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;IAClE,MAAM,WAAW,GAAG,IAAI,yBAAW,CACjC,wBAAY,EACZ,mCAAuB,EACvB,OAAO,EACP,0CAAyB,EACzB,KAAK,CACN,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO;KACR;IAED,WAAW,CAAC,eAAe,EAAE,CAAC;AAChC,CAAC,CACF,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/builtin-tasks/help.ts"],"names":[],"mappings":";;AAAA,6DAA0D;AAC1D,qDAA8E;AAC9E,mEAA0D;AAC1D,oDAAuD;AACvD,8DAAsD;AACtD,2EAAmF;AAEnF,6CAAyC;AAEzC,IAAA,iBAAI,EAAC,sBAAS,EAAE,qBAAqB,CAAC;KACnC,0BAA0B,CACzB,aAAa,EACb,oDAAoD,CACrD;KACA,0BAA0B,CACzB,MAAM,EACN,2CAA2C,CAC5C;KACA,SAAS,CACR,KAAK,EACH,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAA2C,EACxE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAC1B,EAAE;IACF,MAAM,WAAW,GAAG,IAAI,yBAAW,CACjC,wBAAY,EACZ,mCAAuB,EACvB,OAAO,EACP,0CAAyB,EACzB,KAAK,EACL,MAAM,CACP,CAAC;IAEF,IAAI,WAAW,KAAK,SAAS,EAAE;QAC7B,+BAA+B;QAC/B,WAAW,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO;KACR;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,cAAc,KAAK,SAAS,EAAE;QAChC,kCAAkC;QAClC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9C,OAAO;KACR;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5C,IAAI,eAAe,KAAK,SAAS,EAAE;QACjC,wDAAwD;QACxD,mDAAmD;QACnD,8CAA8C;QAC9C,MAAM,IAAI,qBAAY,CAAC,oBAAM,CAAC,SAAS,CAAC,iBAAiB,EAAE;YACzD,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;KACJ;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE;QAC1B,2DAA2D;QAC3D,WAAW,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC5C,OAAO;KACR;IAED,MAAM,oBAAoB,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,oBAAoB,KAAK,SAAS,EAAE;QACtC,MAAM,IAAI,qBAAY,CAAC,oBAAM,CAAC,SAAS,CAAC,wBAAwB,EAAE;YAChE,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;KACJ;IAED,WAAW,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;AAClD,CAAC,CACF,CAAC"}

package/internal/cli/ArgumentsParser.d.ts

@@ -1,11 +1,16 @@
-import { HardhatArguments, HardhatParamDefinitions, TaskArguments, TaskDefinition } from "../../types";
+import { HardhatArguments, HardhatParamDefinitions, ScopesMap, TaskArguments, TaskDefinition, TasksMap } from "../../types";
 export declare class ArgumentsParser {
     static readonly PARAM_PREFIX = "--";
     static paramNameToCLA(paramName: string): string;
     static cLAToParamName(cLA: string): string;
     parseHardhatArguments(hardhatParamDefinitions: HardhatParamDefinitions, envVariableArguments: HardhatArguments, rawCLAs: string[]): {
         hardhatArguments: HardhatArguments;
-        taskName?: string;
+        scopeOrTaskName: string | undefined;
+        allUnparsedCLAs: string[];
+    };
+    parseScopeAndTaskNames(allUnparsedCLAs: string[], taskDefinitions: TasksMap, scopeDefinitions: ScopesMap): {
+        scopeName?: string;
+        taskName: string;
         unparsedCLAs: string[];
     };
     parseTaskArguments(taskDefinition: TaskDefinition, rawCLAs: string[]): TaskArguments;

package/internal/cli/ArgumentsParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ArgumentsParser.d.ts","sourceRoot":"","sources":["../../src/internal/cli/ArgumentsParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,uBAAuB,EAGvB,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC;AAIrB,qBAAa,eAAe;IAC1B,gBAAuB,YAAY,QAAQ;WAE7B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;WAUzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAqB1C,qBAAqB,CAC1B,uBAAuB,EAAE,uBAAuB,EAChD,oBAAoB,EAAE,gBAAgB,EACtC,OAAO,EAAE,MAAM,EAAE,GAChB;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;IAuDM,kBAAkB,CACvB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,MAAM,EAAE,GAChB,aAAa;IAYhB,OAAO,CAAC,wBAAwB;IAmChC,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,yBAAyB;CAgDlC"}
+{"version":3,"file":"ArgumentsParser.d.ts","sourceRoot":"","sources":["../../src/internal/cli/ArgumentsParser.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,gBAAgB,EAChB,uBAAuB,EAGvB,SAAS,EACT,aAAa,EACb,cAAc,EACd,QAAQ,EACT,MAAM,aAAa,CAAC;AAIrB,qBAAa,eAAe;IAC1B,gBAAuB,YAAY,QAAQ;WAE7B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;WAUzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAqB1C,qBAAqB,CAC1B,uBAAuB,EAAE,uBAAuB,EAChD,oBAAoB,EAAE,gBAAgB,EACtC,OAAO,EAAE,MAAM,EAAE,GAChB;QACD,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B;IAwDM,sBAAsB,CAC3B,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,QAAQ,EACzB,gBAAgB,EAAE,SAAS,GAC1B;QACD,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB;IAsDM,kBAAkB,CACvB,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,MAAM,EAAE,GAChB,aAAa;IAYhB,OAAO,CAAC,wBAAwB;IAmChC,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,wBAAwB;IAqBhC,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,yBAAyB;CAgDlC"}

package/internal/cli/ArgumentsParser.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArgumentsParser = void 0;
+const task_names_1 = require("../../builtin-tasks/task-names");
 const errors_1 = require("../core/errors");
 const errors_list_1 = require("../core/errors-list");
 class ArgumentsParser {
@@ -29,34 +30,94 @@ class ArgumentsParser {
     }
     parseHardhatArguments(hardhatParamDefinitions, envVariableArguments, rawCLAs) {
         const hardhatArguments = {};
-        let taskName;
-        const unparsedCLAs = [];
+        let scopeOrTaskName;
+        const allUnparsedCLAs = [];
         for (let i = 0; i < rawCLAs.length; i++) {
             const arg = rawCLAs[i];
-            if (taskName === undefined) {
+            if (scopeOrTaskName === undefined) {
                 if (!this._hasCLAParamNameFormat(arg)) {
-                    taskName = arg;
+                    scopeOrTaskName = arg;
+                    allUnparsedCLAs.push(arg);
                     continue;
                 }
                 if (!this._isCLAParamName(arg, hardhatParamDefinitions)) {
                     throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_COMMAND_LINE_ARG, { argument: arg });
                 }
-                i = this._parseArgumentAt(rawCLAs, i, hardhatParamDefinitions, hardhatArguments, taskName);
+                i = this._parseArgumentAt(rawCLAs, i, hardhatParamDefinitions, hardhatArguments, scopeOrTaskName);
             }
             else {
                 if (!this._isCLAParamName(arg, hardhatParamDefinitions)) {
-                    unparsedCLAs.push(arg);
+                    allUnparsedCLAs.push(arg);
                     continue;
                 }
-                i = this._parseArgumentAt(rawCLAs, i, hardhatParamDefinitions, hardhatArguments, taskName);
+                i = this._parseArgumentAt(rawCLAs, i, hardhatParamDefinitions, hardhatArguments, scopeOrTaskName);
             }
         }
         return {
             hardhatArguments: this._addHardhatDefaultArguments(hardhatParamDefinitions, envVariableArguments, hardhatArguments),
-            taskName,
-            unparsedCLAs,
+            scopeOrTaskName,
+            allUnparsedCLAs,
         };
     }
+    parseScopeAndTaskNames(allUnparsedCLAs, taskDefinitions, scopeDefinitions) {
+        const [firstCLA, secondCLA] = allUnparsedCLAs;
+        if (allUnparsedCLAs.length === 0) {
+            return {
+                taskName: task_names_1.TASK_HELP,
+                unparsedCLAs: [],
+            };
+        }
+        else if (allUnparsedCLAs.length === 1) {
+            if (scopeDefinitions[firstCLA] !== undefined) {
+                // this is a bit of a hack, but it's the easiest way to print
+                // the help of a scope when no task is specified
+                return {
+                    taskName: task_names_1.TASK_HELP,
+                    unparsedCLAs: [firstCLA],
+                };
+            }
+            else if (taskDefinitions[firstCLA] !== undefined) {
+                return {
+                    taskName: firstCLA,
+                    unparsedCLAs: allUnparsedCLAs.slice(1),
+                };
+            }
+            else {
+                throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
+                    task: firstCLA,
+                });
+            }
+        }
+        else {
+            const scopeDefinition = scopeDefinitions[firstCLA];
+            if (scopeDefinition !== undefined) {
+                if (scopeDefinition.tasks[secondCLA] !== undefined) {
+                    return {
+                        scopeName: firstCLA,
+                        taskName: secondCLA,
+                        unparsedCLAs: allUnparsedCLAs.slice(2),
+                    };
+                }
+                else {
+                    throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPED_TASK, {
+                        scope: firstCLA,
+                        task: secondCLA,
+                    });
+                }
+            }
+            else if (taskDefinitions[firstCLA] !== undefined) {
+                return {
+                    taskName: firstCLA,
+                    unparsedCLAs: allUnparsedCLAs.slice(1),
+                };
+            }
+            else {
+                throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
+                    task: firstCLA,
+                });
+            }
+        }
+    }
     parseTaskArguments(taskDefinition, rawCLAs) {
         const { paramArguments, rawPositionalArguments } = this._parseTaskParamArguments(taskDefinition, rawCLAs);
         const positionalArguments = this._parsePositionalParamArgs(rawPositionalArguments, taskDefinition.positionalParamDefinitions);
@@ -112,7 +173,7 @@ class ArgumentsParser {
     _hasCLAParamNameFormat(str) {
         return str.startsWith(ArgumentsParser.PARAM_PREFIX);
     }
-    _parseArgumentAt(rawCLAs, index, paramDefinitions, parsedArguments, taskName) {
+    _parseArgumentAt(rawCLAs, index, paramDefinitions, parsedArguments, scopeOrTaskName) {
         const claArg = rawCLAs[index];
         const paramName = ArgumentsParser.cLAToParamName(claArg);
         const definition = paramDefinitions[paramName];
@@ -130,7 +191,7 @@ class ArgumentsParser {
             if (value === undefined) {
                 throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.MISSING_TASK_ARGUMENT, {
                     param: ArgumentsParser.paramNameToCLA(paramName),
-                    task: taskName ?? "help",
+                    task: scopeOrTaskName ?? "help",
                 });
             }
             // We only parse the arguments of non-subtasks, and those only

package/internal/cli/ArgumentsParser.js.map

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

package/internal/cli/HelpPrinter.d.ts

@@ -1,13 +1,17 @@
-import { HardhatParamDefinitions, TasksMap } from "../../types";
+import { HardhatParamDefinitions, ScopeDefinition, ScopesMap, TaskDefinition, TasksMap } from "../../types";
 export declare class HelpPrinter {
     private readonly _programName;
     private readonly _executableName;
     private readonly _version;
     private readonly _hardhatParamDefinitions;
     private readonly _tasks;
-    constructor(_programName: string, _executableName: string, _version: string, _hardhatParamDefinitions: HardhatParamDefinitions, _tasks: TasksMap);
+    private readonly _scopes;
+    constructor(_programName: string, _executableName: string, _version: string, _hardhatParamDefinitions: HardhatParamDefinitions, _tasks: TasksMap, _scopes: ScopesMap);
     printGlobalHelp(includeSubtasks?: boolean): void;
-    printTaskHelp(taskName: string): void;
+    printScopeHelp(scopeDefinition: ScopeDefinition, includeSubtasks?: boolean): void;
+    printTaskHelp(taskDefinition: TaskDefinition): void;
+    private _printTasks;
+    private _printScopes;
     private _getParamValueDescription;
     private _getParamsList;
     private _getPositionalParamsList;

package/internal/cli/HelpPrinter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HelpPrinter.d.ts","sourceRoot":"","sources":["../../src/internal/cli/HelpPrinter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAGvB,QAAQ,EACT,MAAM,aAAa,CAAC;AAMrB,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAJN,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,wBAAwB,EAAE,uBAAuB,EACjD,MAAM,EAAE,QAAQ;IAG5B,eAAe,CAAC,eAAe,UAAQ;IAqCvC,aAAa,CAAC,QAAQ,EAAE,MAAM;IAgDrC,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,wBAAwB;IA4BhC,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,4BAA4B;CAuBrC"}
+{"version":3,"file":"HelpPrinter.d.ts","sourceRoot":"","sources":["../../src/internal/cli/HelpPrinter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAGvB,eAAe,EACf,SAAS,EACT,cAAc,EACd,QAAQ,EACT,MAAM,aAAa,CAAC;AAMrB,qBAAa,WAAW;IAEpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,wBAAwB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBALP,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,wBAAwB,EAAE,uBAAuB,EACjD,MAAM,EAAE,QAAQ,EAChB,OAAO,EAAE,SAAS;IAG9B,eAAe,CAAC,eAAe,UAAQ;IA4BvC,cAAc,CACnB,eAAe,EAAE,eAAe,EAChC,eAAe,UAAQ;IA4BlB,aAAa,CAAC,cAAc,EAAE,cAAc;IA2CnD,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,yBAAyB;IAIjC,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,wBAAwB;IA4BhC,OAAO,CAAC,kBAAkB;IA2B1B,OAAO,CAAC,4BAA4B;CAuBrC"}

package/internal/cli/HelpPrinter.js

@@ -5,47 +5,50 @@ const errors_1 = require("../core/errors");
 const errors_list_1 = require("../core/errors-list");
 const ArgumentsParser_1 = require("./ArgumentsParser");
 class HelpPrinter {
-    constructor(_programName, _executableName, _version, _hardhatParamDefinitions, _tasks) {
+    constructor(_programName, _executableName, _version, _hardhatParamDefinitions, _tasks, _scopes) {
         this._programName = _programName;
         this._executableName = _executableName;
         this._version = _version;
         this._hardhatParamDefinitions = _hardhatParamDefinitions;
         this._tasks = _tasks;
+        this._scopes = _scopes;
     }
     printGlobalHelp(includeSubtasks = false) {
         console.log(`${this._programName} version ${this._version}\n`);
-        console.log(`Usage: ${this._executableName} [GLOBAL OPTIONS] <TASK> [TASK OPTIONS]\n`);
+        console.log(`Usage: ${this._executableName} [GLOBAL OPTIONS] [SCOPE] <TASK> [TASK OPTIONS]\n`);
         console.log("GLOBAL OPTIONS:\n");
-        this._printParamDetails(this._hardhatParamDefinitions);
+        let length = this._printParamDetails(this._hardhatParamDefinitions);
         console.log("\n\nAVAILABLE TASKS:\n");
-        const tasksToShow = {};
-        for (const [taskName, taskDefinition] of Object.entries(this._tasks)) {
-            if (includeSubtasks || !taskDefinition.isSubtask) {
-                tasksToShow[taskName] = taskDefinition;
-            }
-        }
-        const nameLength = Object.keys(tasksToShow)
-            .map((n) => n.length)
-            .reduce((a, b) => Math.max(a, b), 0);
-        for (const name of Object.keys(tasksToShow).sort()) {
-            const { description = "" } = this._tasks[name];
-            console.log(`  ${name.padEnd(nameLength)}\t${description}`);
+        length = this._printTasks(this._tasks, includeSubtasks, length);
+        if (Object.keys(this._scopes).length > 0) {
+            console.log("\n\nAVAILABLE TASK SCOPES:\n");
+            this._printScopes(this._scopes, length);
         }
         console.log("");
-        console.log(`To get help for a specific task run: npx ${this._executableName} help [task]\n`);
+        console.log(`To get help for a specific task run: npx ${this._executableName} help [SCOPE] <TASK>\n`);
     }
-    printTaskHelp(taskName) {
-        const taskDefinition = this._tasks[taskName];
-        if (taskDefinition === undefined) {
-            throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
-                task: taskName,
+    printScopeHelp(scopeDefinition, includeSubtasks = false) {
+        const name = scopeDefinition.name;
+        const description = scopeDefinition.description ?? "";
+        console.log(`${this._programName} version ${this._version}`);
+        console.log(`\nUsage: hardhat [GLOBAL OPTIONS] ${name} <TASK> [TASK OPTIONS]`);
+        console.log(`\nAVAILABLE TASKS:\n`);
+        if (this._scopes[name] === undefined) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPE, {
+                scope: name,
             });
         }
+        this._printTasks(this._scopes[name].tasks, includeSubtasks);
+        console.log(`\n${name}: ${description}`);
+        console.log(`\nFor global options help run: ${this._executableName} help\n`);
+    }
+    printTaskHelp(taskDefinition) {
         const { description = "", name, paramDefinitions, positionalParamDefinitions, } = taskDefinition;
         console.log(`${this._programName} version ${this._version}\n`);
         const paramsList = this._getParamsList(paramDefinitions);
         const positionalParamsList = this._getPositionalParamsList(positionalParamDefinitions);
-        console.log(`Usage: ${this._executableName} [GLOBAL OPTIONS] ${name}${paramsList}${positionalParamsList}\n`);
+        const scope = taskDefinition.scope !== undefined ? `${taskDefinition.scope} ` : "";
+        console.log(`Usage: ${this._executableName} [GLOBAL OPTIONS] ${scope}${name}${paramsList}${positionalParamsList}\n`);
         if (Object.keys(paramDefinitions).length > 0) {
             console.log("OPTIONS:\n");
             this._printParamDetails(paramDefinitions);
@@ -59,6 +62,33 @@ class HelpPrinter {
         console.log(`${name}: ${description}\n`);
         console.log(`For global options help run: ${this._executableName} help\n`);
     }
+    _printTasks(tasksMap, includeSubtasks, length = 0) {
+        const taskNameList = Object.entries(tasksMap)
+            .filter(([, taskDefinition]) => includeSubtasks || !taskDefinition.isSubtask)
+            .map(([taskName]) => taskName)
+            .sort();
+        const nameLength = taskNameList
+            .map((n) => n.length)
+            .reduce((a, b) => Math.max(a, b), length);
+        for (const name of taskNameList) {
+            const { description = "" } = tasksMap[name];
+            console.log(`  ${name.padEnd(nameLength)}\t${description}`);
+        }
+        return nameLength;
+    }
+    _printScopes(scopesMap, length) {
+        const scopeNamesList = Object.entries(scopesMap)
+            .map(([scopeName]) => scopeName)
+            .sort();
+        const nameLength = scopeNamesList
+            .map((n) => n.length)
+            .reduce((a, b) => Math.max(a, b), length);
+        for (const name of scopeNamesList) {
+            const { description = "" } = scopesMap[name];
+            console.log(`  ${name.padEnd(nameLength)}\t${description}`);
+        }
+        return nameLength;
+    }
     _getParamValueDescription(paramDefinition) {
         return `<${paramDefinition.type.name.toUpperCase()}>`;
     }
@@ -114,6 +144,7 @@ class HelpPrinter {
             }
             console.log(msg);
         }
+        return paramsNameLength;
     }
     _printPositionalParamDetails(positionalParamDefinitions) {
         const paramsNameLength = positionalParamDefinitions

package/internal/cli/HelpPrinter.js.map

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

package/internal/cli/cli.js

@@ -79,7 +79,7 @@ async function main() {
     try {
         const envVariableArguments = (0, env_variables_1.getEnvHardhatArguments)(hardhat_params_1.HARDHAT_PARAM_DEFINITIONS, process.env);
         const argumentsParser = new ArgumentsParser_1.ArgumentsParser();
-        const { hardhatArguments, taskName: parsedTaskName, unparsedCLAs, } = argumentsParser.parseHardhatArguments(hardhat_params_1.HARDHAT_PARAM_DEFINITIONS, envVariableArguments, process.argv.slice(2));
+        const { hardhatArguments, scopeOrTaskName, allUnparsedCLAs } = argumentsParser.parseHardhatArguments(hardhat_params_1.HARDHAT_PARAM_DEFINITIONS, envVariableArguments, process.argv.slice(2));
         if (hardhatArguments.verbose) {
             reporter_1.Reporter.setVerbose(true);
             debug_1.default.enable("hardhat*");
@@ -93,22 +93,29 @@ async function main() {
             await printVersionMessage();
             return;
         }
-        if (hardhatArguments.config === undefined && !(0, project_structure_1.isCwdInsideProject)()) {
-            if (process.stdout.isTTY === true ||
-                process.env.HARDHAT_CREATE_JAVASCRIPT_PROJECT_WITH_DEFAULTS !==
-                    undefined ||
-                process.env.HARDHAT_CREATE_TYPESCRIPT_PROJECT_WITH_DEFAULTS !==
-                    undefined) {
-                await (0, project_creation_1.createProject)();
+        // ATTENTION! DEPRECATED CODE!
+        // The command `npx hardhat`, when used to create a new Hardhat project, will be removed with Hardhat V3.
+        // It will become `npx hardhat init`.
+        // The code marked with the tag #INIT-DEP can be deleted after HarhatV3 is out.
+        // Create a new Hardhat project
+        if (scopeOrTaskName === "init") {
+            return await createNewProject();
+        }
+        // #INIT-DEP - START OF DEPRECATED CODE
+        else {
+            if (scopeOrTaskName === undefined &&
+                hardhatArguments.config === undefined &&
+                !(0, project_structure_1.isCwdInsideProject)()) {
+                await createNewProject();
+                // Warning for Hardhat V3 deprecation
+                console.warn(chalk_1.default.yellow.bold("\n\nDEPRECATION WARNING\n\n"), chalk_1.default.yellow(`Initializing a project with ${chalk_1.default.white.italic("npx hardhat")} is deprecated and will be removed in the future.\n`), chalk_1.default.yellow(`Please use ${chalk_1.default.white.italic("npx hardhat init")} instead.\n\n`));
                 return;
             }
-            // Many terminal emulators in windows fail to run the createProject()
-            // workflow, and don't present themselves as TTYs. If we are in this
-            // situation we throw a special error instructing the user to use WSL or
-            // powershell to initialize the project.
-            if (process.platform === "win32") {
-                throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.NOT_INSIDE_PROJECT_ON_WINDOWS);
-            }
+        }
+        // #INIT-DEP - END OF DEPRECATED CODE
+        // Tasks are only allowed inside a Hardhat project (except the init task)
+        if (hardhatArguments.config === undefined && !(0, project_structure_1.isCwdInsideProject)()) {
+            throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.NOT_INSIDE_PROJECT);
         }
         if (process.env.HARDHAT_EXPERIMENTAL_ALLOW_NON_LOCAL_INSTALLATION !==
             "true" &&
@@ -123,14 +130,17 @@ async function main() {
                 throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.TYPECHECK_USED_IN_JAVASCRIPT_PROJECT);
             }
         }
-        let taskName = parsedTaskName ?? task_names_1.TASK_HELP;
-        const showEmptyConfigWarning = true;
-        const showSolidityConfigWarnings = taskName === task_names_1.TASK_COMPILE;
         const ctx = context_1.HardhatContext.createHardhatContext();
         const { resolvedConfig, userConfig } = (0, config_loading_1.loadConfigAndTasks)(hardhatArguments, {
-            showEmptyConfigWarning,
-            showSolidityConfigWarnings,
+            showEmptyConfigWarning: true,
+            showSolidityConfigWarnings: scopeOrTaskName === task_names_1.TASK_COMPILE,
         });
+        const envExtenders = ctx.environmentExtenders;
+        const providerExtenders = ctx.providerExtenders;
+        const taskDefinitions = ctx.tasksDSL.getTaskDefinitions();
+        const scopesDefinitions = ctx.tasksDSL.getScopesDefinitions();
+        // eslint-disable-next-line prefer-const
+        let { scopeName, taskName, unparsedCLAs } = argumentsParser.parseScopeAndTaskNames(allUnparsedCLAs, taskDefinitions, scopesDefinitions);
         let telemetryConsent = (0, global_dir_1.hasConsentedTelemetry)();
         const isHelpCommand = hardhatArguments.help || taskName === task_names_1.TASK_HELP;
         if (telemetryConsent === undefined &&
@@ -148,19 +158,30 @@ async function main() {
         if (telemetryConsent === true) {
             reporter_1.Reporter.setEnabled(true);
         }
-        const envExtenders = ctx.environmentExtenders;
-        const providerExtenders = ctx.providerExtenders;
-        const taskDefinitions = ctx.tasksDSL.getTaskDefinitions();
         const [abortAnalytics, hitPromise] = await analytics.sendTaskHit();
         let taskArguments;
         // --help is a also special case
         if (hardhatArguments.help && taskName !== task_names_1.TASK_HELP) {
-            taskArguments = { task: taskName };
+            // we "move" the task and scope names to the task arguments,
+            // and run the help task
+            if (scopeName !== undefined) {
+                taskArguments = { scopeOrTask: scopeName, task: taskName };
+            }
+            else {
+                taskArguments = { scopeOrTask: taskName };
+            }
             taskName = task_names_1.TASK_HELP;
+            scopeName = undefined;
         }
         else {
-            const taskDefinition = taskDefinitions[taskName];
+            const taskDefinition = ctx.tasksDSL.getTaskDefinition(scopeName, taskName);
             if (taskDefinition === undefined) {
+                if (scopeName !== undefined) {
+                    throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_SCOPED_TASK, {
+                        scope: scopeName,
+                        task: taskName,
+                    });
+                }
                 throw new errors_1.HardhatError(errors_list_1.ERRORS.ARGUMENTS.UNRECOGNIZED_TASK, {
                     task: taskName,
                 });
@@ -172,11 +193,11 @@ async function main() {
             }
             taskArguments = argumentsParser.parseTaskArguments(taskDefinition, unparsedCLAs);
         }
-        const env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, taskDefinitions, envExtenders, ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig, providerExtenders);
+        const env = new runtime_environment_1.Environment(resolvedConfig, hardhatArguments, taskDefinitions, scopesDefinitions, envExtenders, ctx.experimentalHardhatNetworkMessageTraceHooks, userConfig, providerExtenders);
         ctx.setHardhatRuntimeEnvironment(env);
         try {
             const timestampBeforeRun = new Date().getTime();
-            await env.run(taskName, taskArguments);
+            await env.run({ scope: scopeName, task: taskName }, taskArguments);
             const timestampAfterRun = new Date().getTime();
             if (timestampAfterRun - timestampBeforeRun >
                 ANALYTICS_SLOW_TASK_THRESHOLD &&
@@ -250,6 +271,27 @@ async function main() {
         process.exit(1);
     }
 }
+async function createNewProject() {
+    if ((0, project_structure_1.isCwdInsideProject)()) {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.HARDHAT_PROJECT_ALREADY_CREATED, {
+            hardhatProjectRootPath: (0, project_structure_1.getUserConfigPath)(),
+        });
+    }
+    if (process.stdout.isTTY === true ||
+        process.env.HARDHAT_CREATE_JAVASCRIPT_PROJECT_WITH_DEFAULTS !== undefined ||
+        process.env.HARDHAT_CREATE_TYPESCRIPT_PROJECT_WITH_DEFAULTS !== undefined) {
+        await (0, project_creation_1.createProject)();
+        return;
+    }
+    // Many terminal emulators in windows fail to run the createProject()
+    // workflow, and don't present themselves as TTYs. If we are in this
+    // situation we throw a special error instructing the user to use WSL or
+    // powershell to initialize the project.
+    if (process.platform === "win32") {
+        throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.NOT_INSIDE_PROJECT_ON_WINDOWS);
+    }
+    throw new errors_1.HardhatError(errors_list_1.ERRORS.GENERAL.NOT_IN_INTERACTIVE_SHELL);
+}
 main()
     .then(() => process.exit(process.exitCode))
     .catch((error) => {