@ethereum-waffle/provider

@ethereum-waffle/provider

A mock provider for your blockchain testing needs.

Installation

In the current version of waffle (v2.x.x) you will install this package as a dependency of the main waffle package - ethereum-waffle.

yarn add --dev ethereum-waffle
npm install --save-dev ethereum-waffle

If you want to use this package directly please install it via:

yarn add --dev @ethereum-waffle/provider
npm install --save-dev @ethereum-waffle/provider

Feature overview

NOTE: You do not need to use this package directly. You can install it through the main package (ethereum-waffle) and use it instead.

MockProvider

The MockProvider class is the main way of interacting with the blockchain in your waffle tests.

It wraps ganache-core in an ethers provider and extends it with useful functionality.

You can learn more about it in the documentation.

Examples:

const {MockProvider} = require('@ethereum-waffle/provider');
const {expect} = require('chai');

describe('waffle tests', () => {
  it('wallets have non-zero balance', () => {
    const provider = new MockProvider();
    const wallets = provider.getWallets();
    const balance = await wallets[0].getBalance();
    expect(balance.gt(0)).to.equal(true)
  })
})

Fixtures

Fixtures are an advanced concept that you can use to make your tests run faster. They take advantage of the snapshot mechanism in Ganache.

You can learn more about it in the documentation.

Legacy API

• createMockProvider - this was the old way to construct a MockProvider instance
• getGanacheOptions - previously it was possible to load the options from the waffle config file
• getWallets - this was the old way to get wallets from a provider