hub / github.com/NomicFoundation/hardhat

github.com/NomicFoundation/hardhat

repository ↗ · DeepWiki ↗ · release hardhat@3.18.0 ↗ · + Follow · compare 12 versions

5,476 symbols 18,939 edges 1,750 files ⚖ custom 521 documented · 10% ● updated 9d ago@nomicfoundation/ignition-ui@3.2.0 · 2026-09-17★ 8,508600 open issues

Browse by type

⨍ Functions 4,156◇ Types & classes 1,320

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Hardhat is an Ethereum development environment for professionals. It facilitates performing frequent tasks, such as running tests, automatically checking code for mistakes or interacting with smart contracts.

Built by the Nomic Foundation for the Ethereum community.

💡 This is the README for Hardhat 3, the new major version of Hardhat. For the previous version (v2), see this branch instead.

Getting started

To install Hardhat and initialize a new project, run the following command in an empty directory:

npx hardhat --init

This will take you through an interactive setup process to get started.

Learn more

To learn more about Hardhat, check out the documentation.

Contributing

Contributions are always welcome! Feel free to open any issue or send a pull request.

Go to CONTRIBUTING.md to learn about how to set up Hardhat's development environment.

Extension points exported contracts — how you extend this code

NetworkConnection (Interface)

(no doc) [11 implementers]

packages/hardhat-viem/src/type-extensions.ts

EIP1193Provider (Interface)

(no doc) [11 implementers]

packages/ignition-core/src/types/provider.ts

HardhatViemAssertions (Interface)

(no doc) [4 implementers]

packages/hardhat-viem-assertions/src/types.ts

ISpinner (Interface)

(no doc) [3 implementers]

packages/hardhat-utils/src/spinner.ts

FileManager (Interface)

(no doc) [3 implementers]

packages/hardhat-keystore/src/internal/types.ts

StackReference (Interface)

* Represents the result of successful parsing of a stack trace line. * * Example of a complete stack trace line: * `a

packages/hardhat-node-test-reporter/src/error-formatting.ts

browse all types & interfaces →

Core symbols most depended-on inside this repo

↓ 116 filesassertRejectsWithHardhatError

packages/hardhat-test-utils/src/hardhat-error.ts

↓ 113 filesEIP1193Provider

packages/ignition-core/src/types/provider.ts

↓ 108 filescreateHardhatRuntimeEnvironment

packages/hardhat/src/internal/hre-initialization.ts

↓ 107 filesIgnitionModuleBuilder

packages/ignition-core/src/types/module-builder.ts

↓ 97 filesResolvedConfigurationVariable

packages/hardhat/src/types/config.ts

↓ 92 filesbuildModule

packages/ignition-core/src/build-module.ts

browse all functions →

Shape

Function 2,501

Method 1,655

Interface 805

Class 478

Enum 37

Languages

TypeScript100%

Modules by API surface

packages/hardhat-ethers/src/internal/hardhat-ethers-provider/hardhat-ethers-provider.ts74 symbols

packages/ignition-core/test/execution/future-processor/helpers/network-interaction-execution.ts53 symbols

packages/hardhat-ignition/src/helpers/pretty-event-handler.ts46 symbols

packages/ignition-core/src/internal/module.ts44 symbols

packages/hardhat-utils/src/fs.ts43 symbols

packages/ignition-core/src/internal/module-builder.ts40 symbols

packages/hardhat-verify/src/internal/etherscan.ts40 symbols

packages/hardhat/src/internal/builtin-plugins/solidity/build-system/build-system.ts38 symbols

packages/ignition-core/src/types/execution-events.ts37 symbols

packages/hardhat-network-helpers/src/types.ts35 symbols

packages/hardhat-keystore/src/internal/keystores/encryption.ts35 symbols

packages/ignition-core/src/internal/execution/jsonrpc-client.ts34 symbols

Dependencies from manifests, versioned

@actions/core3.0.1 · 1×

@changesets/changelog-github0.7.0 · 1×

@changesets/cli2.31.1 · 1×

@eslint-community/eslint-plugin-eslint-comments4.7.2 · 1×

@ethersproject/abi5.8.0 · 1×

@ethersproject/address5.8.0 · 1×

@fontsource/roboto5.3.0 · 1×

@istanbuljs/nyc-config-typescript1.0.2 · 1×

@ledgerhq/errors6.25.0 · 1×

@ledgerhq/evm-tools1.7.7 · 1×

@ledgerhq/hw-app-eth7.0.0 · 1×

@ledgerhq/hw-transport6.35.7 · 1×

For agents

$ claude mcp add hardhat \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

github.com/NomicFoundation/hardhat @hardhat@3.18.0@hardhat@3.17.0@hardhat@3.16.0@hardhat@3.15.0@hardhat@3.14.0@hardhat@3.13.0@hardhat@3.12.0@hardhat@3.11.1@hardhat@3.11.0@hardhat@3.10.0@hardhat@3.9.1@3.9.1

Getting started

Learn more

Contributing

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Languages

Modules by API surface

Dependencies from manifests, versioned

For agents

Ask about this repo answers extend the page

github.com/NomicFoundation/hardhat