# @nomiclabs/hardhat-web3

> Hardhat plugin for using Web3 1.x

Latest version **3.0.0** (published 2026-02-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nomiclabs/hardhat-web3
pnpm add @nomiclabs/hardhat-web3
yarn add @nomiclabs/hardhat-web3
bun add @nomiclabs/hardhat-web3
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2026-02-26 |
| First published | 2020-10-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 8505 |
| Author | Nomic Labs LLC |
| Maintainers | alcuadrado |
| Keywords | ethereum, smart-contracts, hardhat, hardhat-plugin, web3, web3.js |

## Links

- npm: https://www.npmjs.com/package/@nomiclabs/hardhat-web3
- Repository: https://github.com/NomicFoundation/hardhat
- Homepage: https://github.com/nomiclabs/hardhat/tree/deprecated-versions/packages/hardhat-web3
- Issues: https://github.com/NomicFoundation/hardhat/issues
- npm.io page: https://npm.io/package/@nomiclabs/hardhat-web3

## Recent versions

- 3.0.0 (latest) — 2026-02-26
- 2.1.2 (hh2) — 2025-10-30
- 2.1.1 — 2025-10-29
- 2.1.0 — 2025-07-17
- 2.0.1 — 2024-11-18
- 2.0.0 — 2020-10-22
- 2.0.0-rc.1 — 2020-10-21
- 2.0.0-rc.0 — 2020-10-19
- 0.1.0-rc.1 — 2020-10-01

## README

# hardhat-web3

This plugin integrates [Web3.js](https://github.com/ethereum/web3.js) `1.x` into [Hardhat](https://hardhat.org).

**Version compatibility warning:** This version of the package does not work with Hardhat 2 nor 3. Please read below to migrate to Hardhat 3 or install a version compatible with Hardhat 2.

### Installation

#### Hardhat 3

To learn how to migrate to Hardhat 3, please read the [migration guide](https://hardhat.org/migrate-from-hardhat2).

#### Hardhat 2

To use this package with Hardhat 2, please install the `hh2` tag with npm or your package manager of choice:

```bash
npm install --save-dev "@nomiclabs/hardhat-web3@hh2"
```

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