hardhat-zksync 🚀

ZKsync Era Hardhat plugin provides a convenient method for bundling and accessing a range of ZKsync-related Hardhat plugins.

⚠️ Version Compatibility Warning

Ensure you are using the correct version of the plugin with ethers:

• For plugin version <1.0.0:

  • Compatible with ethers v5.

• For plugin version ≥1.0.0:

  • Compatible with ethers v6 (⭐ Recommended)

📥 Installation

To install hardhat-zksync plugin, run:

npm i -D @matterlabs/hardhat-zksync

or

yarn add -D @matterlabs/hardhat-zksync

Usage

Here is an overview of the plugins currently available in this package when installed:

| 🔌 Plugin | 📄 Description | |-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------| | hardhat-zksync-solc | Simplifies compiling Solidity contracts for the ZKsync network, streamlining deployment preparation. | | hardhat-zksync-deploy | Facilitates the deployment of contracts on ZKsync, utilizing artifacts from hardhat-zksync-solc. | | hardhat-zksync-verify | Automates the process of verifying smart contracts on the ZKsync network, enhancing transparency and trust. | | hardhat-zksync-upgradeable | Enables easier deployment and upgrading of smart contracts on the ZKsync network, improving contract lifecycle management. | | hardhat-zksync-node | Convenient plugin to run anvil-zksync locally. | | hardhat-zksync-ethers | A zksync-ethers SDK wrapper providing additional methods for accelerated development on ZKsync. |

This plugin enables access to all commands available for each specific plugin, making them readily accessible with just the usage of this plugin. To view the available commands and their descriptions, please refer to the documentation for each individual plugin.

For certain tasks present in the plugins encompassed by this plugin, it overrides them with new features and parameters. These tasks streamline common functionalities into a simplified workflow.

Here is a list of overriden tasks where this plugin adds new optional parameter --verify:

• deploy-zksync:contract
• deploy-zksync:proxy
• upgrade-zksync:proxy
• deploy-zksync:beacon
• upgrade-zksync:beacon

The --verify parameter allow the task to immediately verify all deployed and upgraded contracts when task is called.

To check other parameters present in these tasks, please check the documentation pages for hardhat-zksync-deploy and hardhat-zksync-upgradable.

📝 Documentation

In addition to the hardhat-zksync, ZKsync's Era website offers a variety of resources including:

Guides to get started: Learn how to start building on ZKsync Era.
Hardhat ZKsync Era plugins: Overview and guides for all Hardhat ZKsync Era plugins.
ZK Chains: Deep dive into the concept of ZK chains.

🤝 Contributing

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

Go to CONTRIBUTING.md to learn about steps and best practices for contributing to ZKsync hardhat tooling base repository.

🙌 Feedback, help and news

ZKsync Era Discord server: for questions and feedback.
Follow ZKsync Era on Twitter

Happy building! 👷‍♀️👷‍♂️