hardhat

This release fixes a problem that was preventing hardhat-foundry from working when certain remappings were used.

Notice that this version depends on Hardhat v2.17.2, so you need to upgrade both packages.

This release includes several fixes and some new features:

• Added support for state overrides in the eth_call RPC method
• Added an enableTransientStorage option to enable EIP-1153 opcodes
• Deprecated the TASK_COMPILE_TRANSFORM_IMPORT_NAME subtask, added a new TASK_COMPILE_GET_REMAPPINGS subtask, and added support for remappings in the resolver.
• Fixed a problem that was causing debug_traceTransaction to return traces where the memory had a lot of empty words
• Fixed an issue where artifactExists would throw an error for missing artifacts
• Improved the error message displayed when importing a directory instead of a file
• Fixed a problem with receipts of remote transactions returning the wrong tx type when fetched through a fork

Added support for receiving Date instances in the increaseTo network helper (thanks @Saty248!)

This release fixes a bug related to remappings that use the node_modules directory.

This release adds support for base mainnet.

This release forbids our async matchers from being chained. This means that you can't do something like:

await expect(contract.f())
  .to.changeEtherBalance(...)
  .and.to.changeTokenBalance(...)

This never worked properly, leading to potential false positives in tests. Now this pattern will throw an error to make it clear that it's not supported.

If some of your tests start throwing because of this, the way to do the same thing without chaining is:

const tx = contract.f();

await expect(tx).to.changeEtherBalance(...);
await expect(tx).to.changeTokenBalance(...);

This release exposes the Etherscan class as a public API for third-party consumers. Check the "Using the Etherscan class from another plugin" section of the readme to learn more.

This release adds support for solc v0.8.21, allows using console.log in pure functions and improves the output of the flatten task (see https://github.com/NomicFoundation/hardhat/issues/1499).

Besides that, this version:

• Removed an unnecessary dependency (abort-controller) because it's no longer needed in the versions of node.js supported by Hardhat (thanks @orlandoortegajr!)
• Fixed a bug caused by nodes returning 429 responses without a Retry-After header (thanks @kowalski!)
• Added logic to throw an error when the debug_traceTransaction method is called with a tracer parameter that is not supported.

This release throws an error when a Brownie test directive is detected. These directives look like #@ if mode == "test": and are used to only include certain code blocks during testing. Since not handling them means including test code in a compilation output, Hardhat throws an error when it sees one.

This releases uses a fixed version of the @ledgerhq/hw-app-eth dependency to prevent a problem with the latest version of this package.

This version reduces the impact that hardhat-ethers has in Hardhat initial load time.

Besides that, we fixed to issues related to listening for events with contract.on (see https://github.com/NomicFoundation/hardhat/issues/4098).

This version adds support for verifying contracts in Base Goerli.

This new minor version of Hardhat drops support for Node.js v14 and adds support for Node v20. To learn about which versions of Node we support, check our Stability guarantees page.

This version also adds support for solc 0.8.19 and 0.8.20 and fixes two bugs:

• A long-standing issue related to our compilation pipeline (see https://github.com/NomicFoundation/hardhat/issues/1117).
• A problem when forking other local development networks whose latest block number has a low value (issue https://github.com/NomicFoundation/hardhat/issues/1568).

This release removes the rinkeby, ropsten and kovan deprecated test networks (thanks @pcaversaccio!)

This release adds support for listening for events using contract.on.

This version fixes a problem that was causing the compilation to be slower when using hardhat-foundry.

This release fixes an issue in the compiler download that happens when Hardhat is used with node v18.16.x (the latest versions of node v18).

This is the first release of our new official plugin: hardhat-ledger! This plugin lets you send transactions and sign messages using your Ledger wallet.

To start using it, first you'll have to install it:

npm install --save-dev @nomicfoundation/hardhat-ledger

And add it to your Hardhat config:

require("@nomicfoundation/hardhat-ledger")

Then add a ledgerAccounts entry to the network where you want to use a Ledger account. This entry is an array of addresses:

module.exports = {
  networks: {
    sepolia: {
      url: "...",
      ledgerAccounts: ["0x123..."],
    },
  },
};

When a transaction is sent or a message is signed from one of those addresses, the execution will halt until you confirm the signing in your Ledger.

Check the plugin docs to learn more.

Feedback is welcome! Please open an issue if you find a problem or there's something you think could be improved.

This version of Hardhat adds a new extensibility point: you can now wrap Hardhat's network provider with your own logic.

This is done by using the new extendProvider configuration function:

extendProvider(async (provider, config, network) => {
  const newProvider = new MyProviderWrapper(provider);
  return newProvider;
});

Doing this means that all the JSON-RPC calls will go through your custom provider wrapper. You can use this to intercept and handle some requests while forwarding the rest to the original provider.

To learn more about this, read the "Extending the Hardhat provider" section in our docs. If you have questions about how to use this, please open a new discussion.

Other changes

Besides this new feature, this version includes the following changes:

• console.sol is now memory-safe (thanks @ZumZoom!)
• Added optional params to some compilation subtasks to make them more flexible (thanks @adjisb!)
• Added a HARDHAT_DISABLE_TELEMETRY_PROMPT environment variable that can be set to true to prevent Hardhat from showing the telemetry consent prompt
• The opt-in telemetry is now done using Google Analytics 4

• Fixed URLs for the Aurora networks (thanks @zZoMROT and @ZumZoom!)
• Fixed a problem where the --list-networks flag wasn't working without passing an address (thanks @clauBv23!)
• Success messages are now more generic (thanks @clauBv23!).