Aggregate deployment gas statistics in `--gas-stats` output by schaable · Pull Request #8038 · NomicFoundation/hardhat

schaable · 2026-03-06T23:41:42Z

Closes #8037.

Docs: NomicFoundation/hardhat-website#232

Output example:

╔═══════════════════════════════════════════════════════════════════════════════════════╗
║                                  Gas Usage Statistics                                 ║
╚═══════════════════════════════════════════════════════════════════════════════════════╝
╔═══════════════════════════════════════════════════════════════════════════════════════╗
║ contracts/Calculator.sol:Calculator                                                   ║
╟───────────────────────────────────┬────────┬─────────┬────────┬────────┬──────────────╢
║ Function name                     │ Min    │ Average │ Median │ Max    │ #calls       ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║ divide                            │ 44316  │ 44316   │ 44316  │ 44316  │ 1            ║
║ multiply(uint256,uint256)         │ 44254  │ 44254   │ 44254  │ 44254  │ 2            ║
║ multiply(uint256,uint256,uint256) │ 44875  │ 44875   │ 44875  │ 44875  │ 1            ║
║ reset                             │ 21485  │ 21485   │ 21485  │ 21485  │ 1            ║
║ result                            │ 23510  │ 23510   │ 23510  │ 23510  │ 6            ║
║ subtract                          │ 44213  │ 44213   │ 44213  │ 44213  │ 1            ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║ Deployment                        │ Min    │ Average │ Median │ Max    │ #deployments ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║                                   │ 288115 │ 288115  │ 288115 │ 288115 │ 1            ║
╚═══════════════════════════════════╧════════╧═════════╧════════╧════════╧══════════════╝
╔═══════════════════════════════════════════════════════════════════════════════════════╗
║ contracts/Counter.sol:Counter                                                         ║
╟───────────────────────────────────┬────────┬─────────┬────────┬────────┬──────────────╢
║ Function name                     │ Min    │ Average │ Median │ Max    │ #calls       ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║ add(uint256)                      │ 43915  │ 43915   │ 43915  │ 43915  │ 1            ║
║ add(uint256,bool)                 │ 44284  │ 44419   │ 44419  │ 44554  │ 2            ║
║ inc                               │ 43482  │ 43482   │ 43482  │ 43482  │ 1            ║
║ x                                 │ 23466  │ 23466   │ 23466  │ 23466  │ 5            ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║ Deployment                        │ Min    │ Average │ Median │ Max    │ #deployments ║
╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢
║                                   │ 234940 │ 234940  │ 234940 │ 234940 │ 1            ║
╚═══════════════════════════════════╧════════╧═════════╧════════╧════════╧══════════════╝

changeset-bot · 2026-03-06T23:41:48Z

🦋 Changeset detected

Latest commit: 870c01c

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

This PR includes changesets to release 1 package

Name	Type
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

Copilot

Pull request overview

Updates Hardhat’s --gas-stats reporting to aggregate deployment gas measurements per contract (instead of keeping only the latest deployment), aligning deployment reporting with the existing function-call statistics approach.

Changes:

Store per-contract deployment gas measurements as a list and compute aggregated stats (min/avg/median/max/count).
Update the gas stats report to display aggregated deployment stats and remove the deployment size column.
Update tests and add a changeset documenting the behavior change.

Reviewed changes

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

File	Description
v-next/hardhat/src/internal/builtin-plugins/gas-analytics/gas-analytics-manager.ts	Aggregates deployment gas measurements and updates report output to show deployment stats (min/avg/median/max/#deployments).
v-next/hardhat/test/internal/builtin-plugins/gas-analytics/gas-analytics-manager.ts	Updates aggregation/stat/report tests to validate the new deployment stats behavior and formatting.
.changeset/evil-beers-pump.md	Documents the patch change: deployment gas stats are now aggregated instead of showing only last deployment cost/size.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-06T23:44:31Z

          type: "row",
          cells: [
-            `${contractGasStats.deployment.gas}`,
-            `${contractGasStats.deployment.size}`,
+            "",
+            `${contractGasStats.deployment.min}`,
+            `${contractGasStats.deployment.avg}`,
+            `${contractGasStats.deployment.median}`,
+            `${contractGasStats.deployment.max}`,
+            `${contractGasStats.deployment.calls}`,


The deployment stats data row uses an empty string for the first cell, so the column labeled "Deployment" has no value in the only row. Consider putting a label (e.g. "Deployment") in the row’s first cell (or making the first column header blank) to avoid a confusing blank column in the rendered output.

If we use "Deployment" as the first cell in the row, we could remove the subheaders and keep only the top headers. We could even sort the table to place the deployment row first. Still, the first column header ("Function Name") might be a bit misleading. Wdyt @alcuadrado?

If we do this, we'd also need to update the last column header.

Some examples:

Initial suggestion:

╔═══════════════════════════════════════════════════════════════════════════════════════╗ ║ contracts/Calculator.sol:Calculator ║ ╟───────────────────────────────────┬────────┬─────────┬────────┬────────┬──────────────╢ ║ Function name │ Min │ Average │ Median │ Max │ #calls ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ divide │ 44316 │ 44316 │ 44316 │ 44316 │ 1 ║ ║ multiply(uint256,uint256) │ 44254 │ 44254 │ 44254 │ 44254 │ 2 ║ ║ multiply(uint256,uint256,uint256) │ 44875 │ 44875 │ 44875 │ 44875 │ 1 ║ ║ reset │ 21485 │ 21485 │ 21485 │ 21485 │ 1 ║ ║ result │ 23510 │ 23510 │ 23510 │ 23510 │ 6 ║ ║ subtract │ 44213 │ 44213 │ 44213 │ 44213 │ 1 ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ │ Min │ Average │ Median │ Max │ #deployments ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ Deployment │ 288115 │ 288115 │ 288115 │ 288115 │ 1 ║ ╚═══════════════════════════════════╧════════╧═════════╧════════╧════════╧══════════════╝

Alternative 1:

╔═══════════════════════════════════════════════════════════════════════════════════════╗ ║ contracts/Calculator.sol:Calculator ║ ╟───────────────────────────────────┬────────┬─────────┬────────┬────────┬──────────────╢ ║ │ Min │ Average │ Median │ Max │ Count ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ Deployment │ 288115 │ 288115 │ 288115 │ 288115 │ 1 ║ ║ divide │ 44316 │ 44316 │ 44316 │ 44316 │ 1 ║ ║ multiply(uint256,uint256) │ 44254 │ 44254 │ 44254 │ 44254 │ 2 ║ ║ multiply(uint256,uint256,uint256) │ 44875 │ 44875 │ 44875 │ 44875 │ 1 ║ ║ reset │ 21485 │ 21485 │ 21485 │ 21485 │ 1 ║ ║ result │ 23510 │ 23510 │ 23510 │ 23510 │ 6 ║ ║ subtract │ 44213 │ 44213 │ 44213 │ 44213 │ 1 ║ ╚═══════════════════════════════════╧════════╧═════════╧════════╧════════╧══════════════╝

Deployment could be colorized to distinguish it from functions.

Alternative 2:

╔═══════════════════════════════════════════════════════════════════════════════════════╗ ║ contracts/Calculator.sol:Calculator ║ ╟───────────────────────────────────┬────────┬─────────┬────────┬────────┬──────────────╢ ║ Function name │ Min │ Average │ Median │ Max │ #calls ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ divide │ 44316 │ 44316 │ 44316 │ 44316 │ 1 ║ ║ multiply(uint256,uint256) │ 44254 │ 44254 │ 44254 │ 44254 │ 2 ║ ║ multiply(uint256,uint256,uint256) │ 44875 │ 44875 │ 44875 │ 44875 │ 1 ║ ║ reset │ 21485 │ 21485 │ 21485 │ 21485 │ 1 ║ ║ result │ 23510 │ 23510 │ 23510 │ 23510 │ 6 ║ ║ subtract │ 44213 │ 44213 │ 44213 │ 44213 │ 1 ║ ╟───────────────────────────────────┼────────┼─────────┼────────┼────────┼──────────────╢ ║ Deployment │ 288115 │ 288115 │ 288115 │ 288115 │ 1 ║ ╚═══════════════════════════════════╧════════╧═════════╧════════╧════════╧══════════════╝

schaable · 2026-03-12T17:02:44Z

Added an issue to edr to get the runtime size from the deployments, so we can show it in the --gas-stats table.

schaable · 2026-03-12T17:19:15Z

Added #8059

…ad of storing last deployment

Copilot

Pull request overview

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

schaable requested a review from Copilot March 6, 2026 23:41

schaable self-assigned this Mar 6, 2026

schaable added the no peer bump needed label Mar 6, 2026

Copilot started reviewing on behalf of schaable March 6, 2026 23:42 View session

Copilot AI reviewed Mar 6, 2026

View reviewed changes

schaable mentioned this pull request Mar 7, 2026

docs: update gas statistics page for aggregated deployment stats NomicFoundation/hardhat-website#232

Merged

schaable requested review from alcuadrado and kanej March 7, 2026 00:21

kanej linked an issue Mar 9, 2026 that may be closed by this pull request

Aggregate deployment gas statistics in --gas-stats output #8037

Closed

schaable changed the title ~~Deployment gas stats~~ Aggregate deployment gas statistics in --gas-stats output Mar 9, 2026

kanej removed the request for review from alcuadrado March 9, 2026 15:37

schaable force-pushed the aggregate-gas-stats-output branch from eec7cb6 to e62d33c Compare March 12, 2026 13:05

kanej removed their request for review March 12, 2026 15:17

schaable force-pushed the aggregate-gas-stats-output branch from 8ab302f to 126259a Compare March 12, 2026 16:51

Base automatically changed from aggregate-gas-stats-output to main March 12, 2026 17:08

Copilot AI review requested due to automatic review settings March 12, 2026 17:28

schaable force-pushed the deployment-gas-stats branch from 343f139 to 3a35c9e Compare March 12, 2026 17:28

Copilot started reviewing on behalf of schaable March 12, 2026 17:29 View session

schaable added 3 commits March 12, 2026 17:30

feat: aggregate deployment gas stats (min/avg/median/max/count) inste…

494400a

…ad of storing last deployment

add changeset

465d00d

refactor: rename GasStats.calls to count for semantic consistency

870c01c

schaable force-pushed the deployment-gas-stats branch from 3a35c9e to 870c01c Compare March 12, 2026 17:30

Copilot AI reviewed Mar 12, 2026

View reviewed changes

schaable requested a review from alcuadrado March 12, 2026 18:27

alcuadrado approved these changes Mar 18, 2026

View reviewed changes

schaable added this pull request to the merge queue Mar 18, 2026

Merged via the queue into main with commit f1b501e Mar 18, 2026
213 checks passed

schaable deleted the deployment-gas-stats branch March 18, 2026 14:17

github-actions Bot mentioned this pull request Mar 18, 2026

Version Packages (v3) #8057

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Aggregate deployment gas statistics in `--gas-stats` output#8038

Aggregate deployment gas statistics in `--gas-stats` output#8038
schaable merged 3 commits intomainfrom
deployment-gas-stats

schaable commented Mar 6, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Mar 6, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Mar 6, 2026

Uh oh!

schaable Mar 6, 2026

Uh oh!

schaable Mar 6, 2026

Uh oh!

schaable Mar 7, 2026 •

edited

Loading

Uh oh!

schaable commented Mar 12, 2026

Uh oh!

schaable commented Mar 12, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

schaable commented Mar 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

schaable Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

schaable Mar 6, 2026

Choose a reason for hiding this comment

Uh oh!

schaable Mar 7, 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!

schaable commented Mar 12, 2026

Uh oh!

schaable commented Mar 12, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

schaable commented Mar 6, 2026 •

edited

Loading

changeset-bot Bot commented Mar 6, 2026 •

edited

Loading

schaable Mar 7, 2026 •

edited

Loading