# @nomicfoundation/hardhat-toolbox-mocha-ethers

> Nomic Foundation's recommended bundle of Hardhat plugins

Latest version **4.0.0** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nomicfoundation/hardhat-toolbox-mocha-ethers
pnpm add @nomicfoundation/hardhat-toolbox-mocha-ethers
yarn add @nomicfoundation/hardhat-toolbox-mocha-ethers
bun add @nomicfoundation/hardhat-toolbox-mocha-ethers
```

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 4.0.0 |
| Published | 2026-09-24 |
| First published | 2025-04-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Dependencies | 0 |
| Unpacked size | 14.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8519 |
| Author | Nomic Foundation |
| Keywords | ethereum, smart-contracts, hardhat, hardhat-plugin, toolbox |

## Links

- npm: https://www.npmjs.com/package/@nomicfoundation/hardhat-toolbox-mocha-ethers
- Repository: https://github.com/NomicFoundation/hardhat
- Homepage: https://github.com/NomicFoundation/hardhat/tree/main/packages/hardhat-toolbox-mocha-ethers
- Issues: https://github.com/NomicFoundation/hardhat/issues
- npm.io page: https://npm.io/package/@nomicfoundation/hardhat-toolbox-mocha-ethers

## Recent versions

- 4.0.0 (latest) — 2026-09-24
- 3.0.7 — 2026-06-04
- 3.0.6 — 2026-05-20
- 3.0.5 — 2026-05-07
- 3.0.4 — 2026-04-16
- 3.0.3 — 2026-02-25
- 3.0.2 — 2025-12-03
- 3.0.1 — 2025-11-04
- 3.0.0 — 2025-08-13
- 3.0.0-next.32 — 2025-08-13
- 3.0.0-next.31 — 2025-08-12
- 3.0.0-next.30 — 2025-08-11
- 3.0.0-next.29 — 2025-08-08
- 3.0.0-next.28 — 2025-08-07
- 3.0.0-next.27 — 2025-08-07
- … 23 more at https://npm.io/package/@nomicfoundation/hardhat-toolbox-mocha-ethers/versions

## README

# hardhat-toolbox-mocha-ethers

This toolbox includes a set of plugins to build Hardhat projects with [ethers.js](https://docs.ethers.io/) as the connection library and [Mocha](https://mochajs.org/) for TypeScript tests. If you are migrating a Hardhat 2 project that uses that stack, this toolbox is the recommended way to upgrade.

## Sample project

You can initialize a project based on this toolbox by running `npx hardhat --init` and selecting `A TypeScript Hardhat project using Mocha and Ethers.js` as the project type.

## Manual installation

If you want to add the toolbox manually, first install the package:

```bash
npm install --save-dev @nomicfoundation/hardhat-toolbox-mocha-ethers
```

Then add it to your Hardhat configuration:

```typescript
import { defineConfig } from "hardhat/config";
import hardhatToolboxMochaEthers from "@nomicfoundation/hardhat-toolbox-mocha-ethers";

export default defineConfig({
  plugins: [hardhatToolboxMochaEthers],
});
```

## Included functionality

With this toolbox, you can:

- Use [ethers.js](https://docs.ethers.io/) as the connection library for interacting with the network
- Write Solidity tests using Hardhat's built-in test runner
- Write TypeScript tests using [Mocha](https://mochajs.org/) and our [chai matchers plugin](https://hardhat.org/docs/plugins/hardhat-ethers-chai-matchers).
- Verify contracts with [hardhat-verify](https://hardhat.org/docs/plugins/hardhat-verify)
- Deploy contracts using [Hardhat Ignition](https://hardhat.org/ignition)

## Bundled plugins

When you install `@nomicfoundation/hardhat-toolbox-mocha-ethers`, these plugins are automatically installed as peer dependencies:

- [`@nomicfoundation/hardhat-ethers`](https://hardhat.org/docs/plugins/hardhat-ethers)
- [`@nomicfoundation/hardhat-ethers-chai-matchers`](https://hardhat.org/docs/plugins/hardhat-ethers-chai-matchers)
- [`@nomicfoundation/hardhat-ignition`](https://hardhat.org/docs/plugins/hardhat-ignition)
- [`@nomicfoundation/hardhat-ignition-ethers`](https://hardhat.org/docs/plugins/hardhat-ignition-ethers)
- [`@nomicfoundation/hardhat-keystore`](https://hardhat.org/docs/plugins/hardhat-keystore)
- [`@nomicfoundation/hardhat-mocha`](https://hardhat.org/docs/plugins/hardhat-mocha)
- [`@nomicfoundation/hardhat-network-helpers`](https://hardhat.org/docs/plugins/hardhat-network-helpers)
- [`@nomicfoundation/hardhat-typechain`](https://hardhat.org/docs/plugins/hardhat-typechain)
- [`@nomicfoundation/hardhat-verify`](https://hardhat.org/docs/plugins/hardhat-verify)

## Explicitly installing plugins

In some cases, you may need to manually install one of the included plugins. This can happen if:

- You want to use a different version than the one included in the toolbox.
- You need to import something from the plugin in your code and need to have it in your `package.json` to avoid issues.

For example, the `@nomicfoundation/hardhat-ethers-chai-matchers` plugin includes an `anyValue` predicate that can be used along with the `.withArgs` matcher. If you want to use this predicate in your code, you need to install the plugin explicitly:

```bash
npm install --save-dev @nomicfoundation/hardhat-ethers-chai-matchers
```

Then you'll be able to import things from the plugin:

```typescript
import { anyValue } from "@nomicfoundation/hardhat-ethers-chai-matchers/withArgs";
```

---
_Source: https://npm.io/package/@nomicfoundation/hardhat-toolbox-mocha-ethers · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._