# @nomicfoundation/hardhat-ignition-ethers

> The Ethers extension to Hardhat Ignition. Hardhat Ignition is a declarative system for deploying smart contracts on Ethereum. It enables you to define smart contract instances you want to deploy, and any operation you want to run on them. By taking over t

Latest version **3.1.6** (published 2026-06-04) · MIT license · 0 weekly downloads

## Install

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

## Health

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

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.1.6 |
| Published | 2026-06-04 |
| First published | 2023-12-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 61.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8521 |
| Author | Nomic Foundation |
| Keywords | ethereum, smart-contracts, hardhat, blockchain, dapps, tooling, solidity, deployment, ethers |

## Links

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

## Dependencies (1)

- [@nomicfoundation/hardhat-errors](https://npm.io/package/@nomicfoundation/hardhat-errors.md) ^3.0.15

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 3.1.6 (latest) — 2026-06-04
- 0.15.17 (hh2) — 2025-12-03
- 3.1.5 — 2026-05-07
- 3.1.4 — 2026-04-27
- 3.1.3 — 2026-04-22
- 3.1.2 — 2026-04-16
- 3.1.1 — 2026-03-31
- 3.1.0 — 2026-03-19
- 3.0.9 — 2026-03-05
- 3.0.8 — 2026-02-25
- 3.0.7 — 2026-01-19
- 3.0.6 — 2025-12-03
- 3.0.5 — 2025-11-06
- 3.0.4 — 2025-11-04
- 0.15.16 — 2025-10-30
- … 57 more at https://npm.io/package/@nomicfoundation/hardhat-ignition-ethers/versions

## README

# hardhat-ignition-ethers

This plugin integrates [Hardhat Ignition](https://hardhat.org/ignition) with [ethers.js](https://ethers.org/).

## Installation

> This plugin is part of the [Ethers+Mocha Hardhat Toolbox](https://hardhat.org/plugins/nomicfoundation-hardhat-toolbox-mocha-ethers). If you are using that toolbox, there's nothing else you need to do.

To install this plugin, run the following command:

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

In your `hardhat.config.ts` file, import the plugin and add it to the `plugins` array:

```ts
import { defineConfig } from "hardhat/config";
import hardhatIgnitionEthers from "@nomicfoundation/hardhat-ignition-ethers";

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

## Usage

This plugin adds an `ignition` property to each network connection:

```ts
import { network } from "hardhat";
import Counter from "../ignition/modules/Counter.js";

const { ignition } = await network.create();
const { counter } = await ignition.deploy(Counter);

await counter.inc();
console.log(await counter.x());
```

The `ignition` object has a `deploy` method that can be used to deploy Ignition modules. This returns an ethers contract instance for each contract returned by the module.

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