Hardhat Community Plugins

The following plugins were created by the community and tested on ZKsync Era. Feel free to suggest new plugins by creating a issue(feat request) at this page.

Supported plugins

Here is a template project configured with all plugins mentioned below. You can use it as a starting template for your projects.

hardhat-deploy

Multiple tasks for advanced deployments.

This plugin was updated to support ZKsync Era on version 0.11.26.

More information

typechain/hardhat

Automatically generate TypeScript bindings for smart contracts.

More Information

Plugin used to deploy and update upgradable smart contracts (proxies). Use the hardhat-zksync-upgradable plugin which provides an easy-to-use interface for interacting with the OpenZeppelin Upgrades Plugins within a Hardhat environment on ZKsync.

hardhat-chai-matchers

Adds capabilities to make your smart contract tests easy to write and read.

More Information

hardhat-contract-sizer

More Information

hardhat-abi-exporter

Different options to export smart contract ABIs.

More Information

hardhat-gas-reporter

Although this plugin works out of the box, ZKsync Era has a different fee model than Ethereum. Users should consider this when analysing the report generated by this plugin.

In addition, make sure to read about local testing.

More Information

hardhat-preprocessor

This plugin enables the pre-processing of contract source code prior to compilation.

CACHE_BREAKER Field Issue:The hardhat-preprocessor plugin adds the CACHE_BREAKER field to the list of libraries, which can lead to failed verification when using hardhat-zksync-verify plugin. To prevent this, please include the --no-compile flag: yarn hardhat verify --no-compile.

More Information

Unsupported plugins

nomicfoundation/hardhat-network-helpers

This plugin adds new methods that interact with the Hardhat network used for testing.

However, we do not recommend using the Hardhat network for testing contracts that will be deployed on ZKsync Era.

We recommend instead using the in-memory node or the docker setup to test your contracts as they will give you the same results as our testnet/mainnet.

The additional methods provided by this plugin are not compatible with the ZKsync Era in-memory node or docker setup yet. Currently, we are working on adapting our in-memory node to ensure compatibility with hardhat-network-helpers.

hardhat-zksync-node

Guide on using the hardhat-zksync-node plugin.

Overview

Learn how to use Foundry ZKsync to build, test, and deploy smart contracts. Includes installation guides, and migration considerations.