---
myst:
  html_meta:
    "description": "Integrate Remix IDE with a Hardhat project using Remix Desktop to compile and debug contracts with the Hardhat provider."
    "keywords": "hardhat remix, hardhat integration, remix desktop, hardhat provider, ethereum development"
---

# Hardhat

Remix IDE has built-in support for [Hardhat](https://hardhat.org/), an Ethereum development environment for compiling, deploying, testing, and debugging Solidity smart contracts. With Remix Desktop, you can connect to a local Hardhat project, giving you access to Hardhat compilation and the Hardhat Provider for deploying to a local node.

## Enable Hardhat compilation

### Prerequisites

To use Hardhat compilation with Remix Desktop efficiently:

1. **Hardhat** should be installed locally on the system [https://hardhat.org/docs/getting-started](https://hardhat.org/docs/getting-started).
2. The folder should be a Hardhat project containing `hardhat.config.js` or `hardhat.config.ts`.

### How to Use

When you open a Hardhat project on Remix Desktop, there will be an extra checkbox in the `Solidity Compiler` plugin with the label `Enable Hardhat Compilation`.

![Enable Hardhat Compilation checkbox in the Solidity Compiler plugin](images/hardhat/a-hardhat-compilation.png)

Check the `Enable Hardhat Compilation` box to run the compilation for Hardhat along with Remix using the compiler configuration in the `Solidity Compiler` plugin.

On clicking the `Compile` button, a `remix-compiler.config.js` file will be created in the project root which stores the compiler configuration set in Remix's `Solidity Compiler` plugin. It is passed to Hardhat for compilation.

The result of the compilation will be shown in the Remix IDE terminal.

![Successful Hardhat compilation output in Remix IDE terminal](images/hardhat/a-hardhat-compilation-success.png)

## Hardhat provider

```{note}
In Hardhat, contracts are deployed by starting a local node. Read more about it in the [Hardhat documentation](https://hardhat.org/docs/getting-started).
```

**Hardhat Provider** enables deployment to the Hardhat localhost network. This can be chosen in the **ENVIRONMENT** dropdown of the **Deploy and Run** plugin.

![Hardhat Provider option in the Environment dropdown](images/hardhat/a-hardhat-provider-dropdown.png)

As soon as you select `Hardhat Provider`, a modal is opened asking for the `Hardhat JSON-RPC Endpoint`.

![Modal prompting for the Hardhat JSON-RPC Endpoint](images/hardhat/a-hardhat-provider-modal.png)

If the Hardhat node is running with default options, the default endpoint value in the modal will not need any change. If the Hardhat node host and port are different, the JSON-RPC endpoint should be updated in the modal text box.

Once the correct endpoint is filled in the modal, click `OK` and the accounts from the Hardhat node will be loaded in the `ACCOUNT` section. The network id will also be shown.

![Remix IDE connected to Hardhat Provider showing loaded accounts](images/hardhat/a-hardhat-provider-connected.png)

Now, you can start deploying the contract from Remix IDE to the Hardhat local node as usual.

## Using `console.log` in Remix IDE

Remix IDE supports the Hardhat console library while using `Remix VM`. It can be used while making a transaction or running unit tests.

### Using `console.log`

To try it out, you need to put an import statement and use `console.log` to print the value as shown in the image.

![Solidity file with console.log import and usage](images/hardhat/hardhat-console-file.png)

Further, once you execute the `changeOwner` method, the value from the console statement will be shown in the Remix terminal after the transaction details:

![Remix terminal showing console.log output after transaction](images/hardhat/hardhat-tx-terminal.png)

### Solidity Unit Testing

Similarly, `console.log` can be used while running unit tests using the Remix Solidity Unit Testing plugin.

![Solidity unit test file using console.log](images/hardhat/hardhat-utesting-file.png)

For tests that include a logging message, the output will display in the Remix Terminal corresponding to the test name.

![Remix terminal showing console.log output from unit tests](images/hardhat/hardhat-utesting-terminal.png)