#Migrating from Waffle

If you want to replace Waffle with Hardhat Chai Matchers, we recommend you migrate to the Hardhat Toolbox. If for some reason you want to migrate without using the Toolbox, read on.

# How to migrate

The @nomicfoundation/hardhat-chai-matchers plugin is meant to be a drop-in replacement for the @nomiclabs/hardhat-waffle plugin. To migrate, follow these instructions:

1. Uninstall the @nomiclabs/hardhat-waffle and ethereum-waffle packages:

   npm 7+

   npm 6

   yarn

   pnpm

   npm uninstall @nomiclabs/hardhat-waffle ethereum-waffle
   

   npm uninstall @nomiclabs/hardhat-waffle ethereum-waffle
   

   yarn remove @nomiclabs/hardhat-waffle ethereum-waffle
   

   pnpm remove @nomiclabs/hardhat-waffle ethereum-waffle
   

2. Then install the Hardhat Chai Matchers plugin:

   npm 7+

   npm 6

   yarn

   pnpm

   npm install --save-dev @nomicfoundation/hardhat-chai-matchers@hh2
   

   npm install --save-dev @nomicfoundation/hardhat-chai-matchers@hh2
   

   yarn add --dev @nomicfoundation/hardhat-chai-matchers@hh2
   

   pnpm add -D @nomicfoundation/hardhat-chai-matchers@hh2
   

3. In your Hardhat config, import the Hardhat Chai Matchers plugin and remove the hardhat-waffle one:

   TypeScript

   JavaScript

   - import "@nomiclabs/hardhat-waffle";
   + import "@nomicfoundation/hardhat-chai-matchers";
   

   - require("@nomiclabs/hardhat-waffle");
   + require("@nomicfoundation/hardhat-chai-matchers");