Add verbosity for all hh tasks by ChristopherDedominici · Pull Request #7983 · NomicFoundation/hardhat

ChristopherDedominici · 2026-02-20T15:25:30Z

This PR implements part of the changes of this PR. See the PR for more details on the changes related to EDR.

Changes

It also implements this issue, as verbosity is now a global flag covering all Hardhat logic, and the scope is no longer limited to Solidity tests, but to all tasks that interact with EDR.

Links to website docs

PR: NomicFoundation/hardhat-website#225

How to use

Use -v to control the level of detail in Hardhat's output. Stack multiple vs to increase verbosity.

Levels

Flag	Level	Effect
(none)	0-2	No call traces (level 2 is the default: shows logs)
`-vvv`	3	Execution traces for failing tests only
`-vvvv`	4	Execution traces for all tests + setUp traces for failing tests
`-vvvvv`	5	All traces (execution + setUp) for all tests

For non-test tasks (hardhat run, hardhat ignition deploy, etc.):

Flag	Level	Effect
(none)	0-2	No call traces
`-vvv`	3	Call traces for failing transactions only
`-vvvv` / `-vvvvv`	4-5	All call traces

Usage

The flag works with any Hardhat command:

# Tests
pnpm hardhat test -vvv
pnpm hardhat test solidity -vvvvv
pnpm hardhat test mocha -vvv

# Scripts
pnpm hardhat run scripts/deploy.ts -vvvvv

# Ignition
pnpm hardhat ignition deploy ignition/modules/MyModule.ts -vvv

You can also use the long form: --verbosity 3.

Output examples

Examples for the same solidity tests:

no verbosity:

verbosity 3 (failing traces only):

verbosity 4 (traces for all tests + setUp for failures):

verbosity 5 (all traces including setUp):

Verbosity Manual Tests Scenarios

All commands run from v-next/example-project/.

Solidity tests

pnpm hardhat test solidity
pnpm hardhat test solidity -vvv
pnpm hardhat test solidity -vvvv
pnpm hardhat test solidity -vvvvv
pnpm hardhat test solidity contracts/Counter.t.sol
pnpm hardhat test solidity contracts/Counter.t.sol -vvv
pnpm hardhat test solidity contracts/Counter.t.sol -vvvv
pnpm hardhat test solidity contracts/Counter.t.sol -vvvvv

Mocha tests

pnpm hardhat test mocha
pnpm hardhat test mocha -vvv
pnpm hardhat test mocha -vvvv
pnpm hardhat test mocha -vvvvv
pnpm hardhat test mocha test/mocha/mocha-test.ts -vvv
pnpm hardhat test mocha test/mocha/mocha-test.ts -vvvvv

Node.js tests

pnpm hardhat test nodejs
pnpm hardhat test nodejs -vvv
pnpm hardhat test nodejs -vvvv
pnpm hardhat test nodejs -vvvvv
pnpm hardhat test nodejs test/node/example-test.ts -vvv
pnpm hardhat test nodejs test/node/example-test.ts -vvvvv

All runners combined

pnpm hardhat test
pnpm hardhat test -vvv
pnpm hardhat test -vvvv
pnpm hardhat test -vvvvv
pnpm hardhat test test/node/other-example-test.js -vvv

Non-test: scripts

pnpm hardhat run scripts/deploy-rocket-from-script.ts
pnpm hardhat run scripts/deploy-rocket-from-script.ts -vvv
pnpm hardhat run scripts/deploy-rocket-from-script.ts -vvvv
pnpm hardhat run scripts/deploy-rocket-from-script.ts -vvvvv

Non-test: ignition deploy

pnpm hardhat ignition deploy ignition/modules/Apollo.ts
pnpm hardhat ignition deploy ignition/modules/Apollo.ts -vvv
pnpm hardhat ignition deploy ignition/modules/Apollo.ts -vvvvv

Non-test: tasks

pnpm hardhat accounts
pnpm hardhat accounts -vvv

changeset-bot · 2026-02-20T15:25:35Z

🦋 Changeset detected

Latest commit: 96b785c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@nomicfoundation/hardhat-utils	Patch
hardhat	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-02-20T15:26:50Z

hardhat

Total size of the bundle: 246M
Total number of dependencies (including transitive): 48

List of dependencies (sorted by size)

239M	total
37M	@nomicfoundation/edr-linux-x64-musl
37M	@nomicfoundation/edr-linux-x64-gnu
34M	@nomicfoundation/edr-linux-arm64-musl
34M	@nomicfoundation/edr-linux-arm64-gnu
25M	@nomicfoundation/edr-win32-x64-msvc
25M	@nomicfoundation/edr-darwin-x64
21M	@nomicfoundation/edr-darwin-arm64
7.3M	@sentry/core
5.2M	zod
2.7M	micro-eth-signer
1.9M	@noble/curves
1.7M	undici
1.2M	@noble/hashes
1.1M	@nomicfoundation/hardhat-utils
884K	@nomicfoundation/hardhat-vendored
864K	@streamparser/json
624K	micro-packed
592K	tsx
556K	@nomicfoundation/hardhat-errors
492K	@scure/bip39
476K	@nomicfoundation/edr
408K	json-stream-stringify
368K	ethereum-cryptography
344K	fast-equals
332K	@streamparser/json-node
320K	enquirer
320K	@nomicfoundation/hardhat-zod-utils
288K	semver
200K	ws
180K	chokidar
176K	get-tsconfig
168K	@scure/base
160K	esbuild
136K	adm-zip
96K	@scure/bip32
92K	chalk
72K	@nomicfoundation/solidity-analyzer
68K	debug
60K	readdirp
56K	rfdc
48K	ansi-colors
44K	resolve.exports
40K	resolve-pkg-maps
36K	p-map
24K	strip-ansi
24K	env-paths
24K	ansi-regex
20K	ms

ChristopherDedominici · 2026-02-20T15:28:57Z

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts

@@ -0,0 +1,203 @@
+import type { Colorizer } from "../../../../utils/colorizer.js";


These functions have been moved from hardhat/src/internal/builtin-plugins/solidity-test/formatters.ts, except for verbosityToIncludeTraces, which is a newly added function.

ChristopherDedominici · 2026-02-20T15:29:27Z

v-next/hardhat/src/internal/builtin-plugins/solidity-test/formatters.ts

-  );
-}
-
-function formatInputs(


These functions starting from this one have been moved to v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts because this logic is no longer limited to solidity tests

ChristopherDedominici · 2026-02-20T15:30:03Z

v-next/hardhat/src/internal/builtin-plugins/solidity-test/formatters.ts

  return `${sourceName}:${artifactId.name}`;
 }
-
-export function formatLogs(


removed as it is not used anywhere

ChristopherDedominici · 2026-02-20T15:30:25Z

v-next/hardhat/src/internal/builtin-plugins/solidity-test/formatters.ts

-import { bytesToHexString } from "@nomicfoundation/hardhat-utils/hex";
-import chalk from "chalk";
-
-export interface Colorizer {


moved to file v-next/hardhat/src/internal/utils/colorizer.ts because this logic is no longer limited to solidity tests

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts

ChristopherDedominici · 2026-02-20T15:35:50Z

v-next/hardhat/test/internal/cli/main.ts

          task(["task4"]).addLevel({
-            name: "verbosity",
-            shortName: "v",
+            name: "logLevel",


verbosity custom param used in these tests clashes with the ne added global flag verbosity, so I replaced the custom param with logLevel

ChristopherDedominici · 2026-02-20T15:36:16Z

v-next/hardhat/test/internal/builtin-plugins/network-manager/edr/edr-provider.ts

        failed: false,
        gas: 21000,
-        returnValue: "",
+        returnValue: "0x",


Before hardhat used edrRpcDebugTraceToHardhat that was converting to "", now we use EDR response directly

alcuadrado · 2026-02-23T11:44:30Z

@ChristopherDedominici can you add an explanation about how this works from the user POV? When are the traces printed? How? Some screenshots would also help. Thanks!

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts

…nto edr-upgrade-25

…grade-25

Copilot

Pull request overview

This PR introduces a new global --verbosity/-v level that controls trace output across Hardhat tasks that interact with EDR, and wires that verbosity into both Solidity test output and the EDR-backed network provider (including upgrading to EDR’s new call trace plumbing).

Changes:

Add verbosity as a built-in global option and propagate it through HRE/network initialization.
Centralize trace formatting + verbosity→trace-inclusion mapping under the network-manager EDR utilities, and update Solidity test reporter/helpers accordingly.
Enable provider-side call trace collection/printing by passing includeCallTraces into EDR provider config based on global verbosity.

Reviewed changes

Copilot reviewed 22 out of 22 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
v-next/hardhat/src/internal/builtin-global-options.ts	Adds global `verbosity` level option (`-v/--verbosity`) with default.
v-next/hardhat/src/types/global-options.ts	Extends `GlobalOptions` with `verbosity: number`.
v-next/hardhat/src/internal/utils/colorizer.ts	Introduces shared `Colorizer` interface for trace formatting/reporting.
v-next/hardhat/src/internal/builtin-plugins/network-manager/network-manager.ts	Threads verbosity into network manager and maps it to `includeCallTraces`.
v-next/hardhat/src/internal/builtin-plugins/network-manager/hook-handlers/hre.ts	Passes `hre.globalOptions.verbosity` into `NetworkManagerImplementation`.
v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts	New shared `formatTraces` + `verbosityToIncludeTraces`.
v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts	Adds `includeCallTraces` to provider config and prints call traces from responses.
v-next/hardhat/src/internal/builtin-plugins/solidity-test/helpers.ts	Uses shared verbosity→IncludeTraces mapping.
v-next/hardhat/src/internal/builtin-plugins/solidity-test/reporter.ts	Imports shared `formatTraces` and updates trace printing thresholds.
v-next/hardhat/src/internal/builtin-plugins/solidity-test/task-action.ts	Reads verbosity from `hre.globalOptions` instead of task args.
v-next/hardhat/src/internal/builtin-plugins/test/index.ts	Removes per-task `verbosity` level (now global).
v-next/hardhat/src/internal/builtin-plugins/test/task-action.ts	Stops forwarding task-level verbosity option (now global).
v-next/hardhat-utils/src/env.ts	Allows numeric global options to be set as env vars.
v-next/hardhat/test/internal/hre-initialization.ts	Updates expected resolved global options to include `verbosity`.
v-next/hardhat/test/internal/cli/main.ts	Updates CLI help expectations + avoids name collision by renaming a test level arg.
v-next/hardhat/test/internal/cli/help/get-global-help-string.ts	Updates global help string expectations to include verbosity.
v-next/hardhat/test/internal/builtin-plugins/solidity-test/helpers.ts	Updates IncludeTraces expectations for new verbosity thresholds.
v-next/hardhat/test/internal/builtin-plugins/network-manager/network-manager.ts	Updates NetworkManager tests for the new verbosity constructor param.
v-next/hardhat/test/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts	Updates/extends tests for shared trace utilities.
.changeset/cyan-drinks-beg.md	Changeset entry announcing global verbosity support.

You can also share your feedback on Copilot code review. Take the survey.

Copilot · 2026-03-12T09:59:25Z

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts

+  #outputCallTraces(edrResponse: Response): void {
+    try {
+      const callTraces = edrResponse.callTraces();
+
+      if (callTraces.length > 0) {
+        const formatted = formatTraces(callTraces, "  ", chalk);
+        this.#printLineFn("  Call Traces:");
+        this.#printLineFn(formatted);
+      }
+    } catch (e) {
+      log("Failed to get call traces: %O", e);
+    }
+  }


#handleEdrResponse calls #outputCallTraces for every JSON-RPC response, and #outputCallTraces always calls edrResponse.callTraces(). Consider storing the configured includeCallTraces on the provider instance and returning early when it’s IncludeTraces.None/undefined to avoid unnecessary per-request work (and potential debug spam if callTraces() throws when disabled).

This piece of feedback is valuable, for performance reasons. So that we don't call callTraces if not needed, which goes through the FFI barrier.

This is already fixed in the PR on top of this one, see here: https://github.com/NomicFoundation/hardhat/pull/8031/changes#r3000654383

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts

…grade-25

alcuadrado

Looks good, but we should address this comment: https://github.com/NomicFoundation/hardhat/pull/7983/changes#r3000591649

alcuadrado · 2026-03-27T12:05:01Z

.changeset/cyan-drinks-beg.md

+"hardhat": patch
+---
+
+Added `-v` verbosity support for all tasks ([7983](https://github.com/NomicFoundation/hardhat/pull/7983)), ([7963](https://github.com/NomicFoundation/hardhat/issues/7963)).


Suggested change

Added `-v` verbosity support for all tasks ([7983](https://github.com/NomicFoundation/hardhat/pull/7983)), ([7963](https://github.com/NomicFoundation/hardhat/issues/7963)).

Added `--verbosity` (and `-v`, `-vv`, and the other shorthands) to all tasks, including TypeScript tests.

Done here (I kept the links): 7a9a64c

alcuadrado · 2026-03-27T12:11:38Z

Actually, this comment can be better address in the second PR

…grade-25

…nto edr-upgrade-25

Copilot

Pull request overview

Copilot reviewed 22 out of 22 changed files in this pull request and generated 1 comment.

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts

Copilot

Pull request overview

Copilot reviewed 22 out of 22 changed files in this pull request and generated no new comments.

add verbosity for all hh tasks

dce7149

ChristopherDedominici self-assigned this Feb 20, 2026

ChristopherDedominici added this to Hardhat Feb 20, 2026

github-actions bot added the status:triaging label Feb 20, 2026

github-actions bot assigned kanej Feb 20, 2026

github-project-automation bot moved this to Backlog in Hardhat Feb 20, 2026

ChristopherDedominici removed the status:triaging label Feb 20, 2026

ChristopherDedominici unassigned kanej Feb 20, 2026

ChristopherDedominici moved this from Backlog to In Progress in Hardhat Feb 20, 2026

ChristopherDedominici marked this pull request as draft February 20, 2026 15:26

ChristopherDedominici commented Feb 20, 2026

View reviewed changes

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts Outdated Show resolved Hide resolved

ChristopherDedominici commented Feb 20, 2026

View reviewed changes

Create cyan-drinks-beg.md

8e194d0

ChristopherDedominici linked an issue Feb 20, 2026 that may be closed by this pull request

Add support for -vvvv in JS/TS tests #7963

Closed

1 task

ChristopherDedominici commented Feb 23, 2026

View reviewed changes

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/utils/trace-formatters.ts Outdated Show resolved Hide resolved

ChristopherDedominici mentioned this pull request Feb 23, 2026

build: upgrade to @nomicfoundation/edr v0.12.0-next.25 #7949

Closed

7 tasks

ChristopherDedominici added the no peer bump needed label Feb 23, 2026

ChristopherDedominici moved this from In Progress to In Review in Hardhat Feb 23, 2026

ChristopherDedominici marked this pull request as ready for review February 23, 2026 15:37

ChristopherDedominici added 3 commits February 24, 2026 14:25

set verbosity to have max logs from level 4

05bd623

Merge branch 'edr-upgrade-25' of github.com:NomicFoundation/hardhat i…

18eb2f9

…nto edr-upgrade-25

minor improvements

722cb9b

ChristopherDedominici added 2 commits March 2, 2026 14:42

Merge branch 'main' of github.com:NomicFoundation/hardhat into edr-up…

3f78af7

…grade-25

Merge branch 'main' of github.com:NomicFoundation/hardhat into edr-up…

593a016

…grade-25

Copilot AI review requested due to automatic review settings March 12, 2026 09:50

Copilot started reviewing on behalf of ChristopherDedominici March 12, 2026 09:50 View session

Copilot AI reviewed Mar 12, 2026

View reviewed changes

ChristopherDedominici mentioned this pull request Mar 16, 2026

Verbosity (-vvv) improve style #8031

Merged

ChristopherDedominici changed the title ~~Add verbosity for all hh tasks + upgrade to edr v0.12.0-next.25~~ Add verbosity for all hh tasks Mar 16, 2026

Merge branch 'main' of github.com:NomicFoundation/hardhat into edr-up…

c917a3c

…grade-25

alcuadrado approved these changes Mar 27, 2026

View reviewed changes

alcuadrado reviewed Mar 27, 2026

View reviewed changes

ChristopherDedominici added 2 commits March 30, 2026 10:58

Merge branch 'main' of github.com:NomicFoundation/hardhat into edr-up…

564d509

…grade-25

Merge branch 'edr-upgrade-25' of github.com:NomicFoundation/hardhat i…

1141434

…nto edr-upgrade-25

Copilot AI review requested due to automatic review settings March 30, 2026 10:59

Copilot started reviewing on behalf of ChristopherDedominici March 30, 2026 10:59 View session

Copilot AI reviewed Mar 30, 2026

View reviewed changes

v-next/hardhat/src/internal/builtin-plugins/network-manager/edr/edr-provider.ts Outdated Show resolved Hide resolved

ChristopherDedominici added 2 commits March 30, 2026 11:05

fix building error after merge

273318b

update changeset

7a9a64c

Copilot AI review requested due to automatic review settings March 30, 2026 11:07

Copilot started reviewing on behalf of ChristopherDedominici March 30, 2026 11:08 View session

Copilot AI reviewed Mar 30, 2026

View reviewed changes

Verbosity (-vvv) improve style (#8031)

96b785c

ChristopherDedominici added this pull request to the merge queue Mar 30, 2026

github-merge-queue bot removed this pull request from the merge queue due to failed status checks Mar 30, 2026

ChristopherDedominici added this pull request to the merge queue Mar 30, 2026

Merged via the queue into main with commit d5f59f7 Mar 30, 2026
258 checks passed

ChristopherDedominici deleted the edr-upgrade-25 branch March 30, 2026 16:26

github-project-automation bot moved this from In Review to Done in Hardhat Mar 30, 2026

github-actions bot mentioned this pull request Mar 30, 2026

Version Packages (v3) #8076

Merged

		@@ -0,0 +1,203 @@
		import type { Colorizer } from "../../../../utils/colorizer.js";

	Added `-v` verbosity support for all tasks ([7983](https://github.com/NomicFoundation/hardhat/pull/7983)), ([7963](https://github.com/NomicFoundation/hardhat/issues/7963)).
	Added `--verbosity` (and `-v`, `-vv`, and the other shorthands) to all tasks, including TypeScript tests.

Conversation

ChristopherDedominici commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Links to website docs

How to use

Levels

Usage

Output examples

Verbosity Manual Tests Scenarios

Solidity tests

Mocha tests

Node.js tests

All runners combined

Non-test: scripts

Non-test: ignition deploy

Non-test: tasks

Uh oh!

changeset-bot bot commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

hardhat

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ChristopherDedominici Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ChristopherDedominici Feb 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

alcuadrado commented Feb 23, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 12, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

alcuadrado left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

alcuadrado commented Mar 27, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Reviewers

ChristopherDedominici commented Feb 20, 2026 •

edited

Loading

changeset-bot bot commented Feb 20, 2026 •

edited

Loading

github-actions bot commented Feb 20, 2026 •

edited

Loading

ChristopherDedominici Feb 20, 2026 •

edited

Loading

ChristopherDedominici Feb 20, 2026 •

edited

Loading