chaithereum

Unit testing 'utility belt' for Ethereum Solidity contracts

npm install chaithereum

Usage

const Chaithereum = require('chaithereum')
const chaithereum = new Chaithereum(/*options*/)

Examples

One good place to look for chaithereum examples is the safemarket/protocol repo. Those tests were written with [email protected], however their API is the same. The only difference is that in [email protected], require('chaithereum') returns a Chaithereum constructor instead of a chaithereum instance.

Options

options.Web3

A Web3 constructor. Default listed in package.json.

options.chai

A chai instance. Default listed in package.json.

options.provider

A Web3 provider instance. Default is provider generated by testrpc listed in package.json

Interface

chaithereum.chai

A custom chai instance

chaithereum.web3

A custom web3 instance suited for unit testing

chaithereum.provider

The provider used to instantiate web3

chaithereum.promise

A Q promise that will be fulfilled when chaithereum is ready. Typically you would start a test waiting for the chaitheruem promise.

before(() => { return chaithereum.promise })

chaithereum.accounts

A list of 10 accounts

chaithereum.account

The first account, set as web3.eth.defaultAccount

chaithereum.generateAddress() returns promise of an address

Generate an address asynchronously. chaithereum.generateAddress().then((address) => { ... }))

chaithereum.generateAddresses(count) returns promise of addresses

Generate an addresses asynchronously. chaithereum.generateAddresses(5).then((addresses[5]) => { ... }))

chaithereum.increaseTime(seconds) returns promise

Jump forward in time asynchronously. chaithereum.increaseTime(42).then(() => { ... }))

chaithereum.mineBlock() returns promise

Mine a block. chaithereum.mineBlock().then(() => { ... }))

chaithereum.mineBlocks(count) returns promise

Mine count blocks. chaithereum.mineBlocks(...).then(() => { ... }))

chaithereum.takeSnapshot() returns promise

Take a snapshot of the current state. chaithereum.takeSnapshot(...).then((id) => { ... }))

chaithereum.revertSnapshot(id) returns promise

Take a snapshot of the current state. chaithereum.revertSnapshot(...).then(() => { ... }))

Bindings

Chaithereum loads bindings from the following packages

chai-web3-bindings chai-bignumber chai-as-promised