eth-gas-reporter

eth-gas-reporter

A mocha reporter for Truffle.

• Gas usage per unit test.
• Average gas usage per method.
• Contract deployment costs.
• Real currency costs.

Install

npm install --save-dev eth-gas-reporter

Truffle config

module.exports = {
  networks: {
    ...etc...
  },
  mocha: {
    reporter: 'eth-gas-reporter',
    reporterOptions : {
      currency: 'CHF',
      gasPrice: 21
    }
  }
};

Options

Option	Type	Default	Description
currency	String	'EUR'	National currency to represent gas costs in. Exchange rates loaded at runtime from the coinmarketcap api. Available currency codes can be found here.
gasPrice	Number	(varies)	Denominated in gwei. Default is loaded at runtime from the eth gas station api
outputFile	String	stdout	File path to write report output to
noColors	Boolean	false	Suppress report color. Useful if you are printing to file b/c terminal colorization corrupts the text.
onlyCalledMethods	Boolean	true	Omit methods that are never called from report.
rst	Boolean	false	Output with a reStructured text code-block directive. Useful if you want to include report in RTD
rstTitle	String	""	Title for reStructured text header (See Travis for example output)
showTimeSpent	Boolean	false	Show the amount of time spent as well as the gas consumed
excludeContracts	String[]	[]	Contract names to exclude from report. Ex: ['Migrations']
src	String	"contracts"	Folder in root directory to begin search for .sol files. This can also be a path to a subfolder relative to the root, e.g. "planets/annares/contracts"
url	String	value of web3.currentProvider.host	RPC client url (e.g. "http://localhost:8545")
proxyResolver	Function	none	Custom method to resolve identity of methods managed by a proxy contract.

Examples

• gnosis/gnosis-contracts
• windingtree/LifToken

Usage Notes

• Requires Node >= 8.
• Method calls that throw are filtered from the stats.
• Contracts that are only ever created by other contracts within Solidity are not shown in the deployments table.

Contributions

Feel free to open PRs or issues. There is an integration test and one of the mock test cases is expected to fail. If you're adding an option, you can vaildate it in CI by adding it to the mock options config located here.

Credits

All the ideas in this utility have been borrowed from elsewhere. Many thanks to:

• @maurelian - Mocha reporting gas instead of time is his idea.
• @cag - The table borrows from / is based his gas statistics work for the Gnosis contracts.
• Neufund - Block limit size ratios for contract deployments and euro pricing are borrowed from their ico-contracts test suite.

Contributors

• @cgewecke
• @rmuslimov
• @area
• @ldub
• @ben-kaufman
• @wighawag
• @ItsNickBarry

Changelog

0.2.1 / 2019-06-19

• Upgrade mocha from 4.1.0 to 5.2.0
• Report solc version and settings info
• Add EtherRouter method resolver logic (as option and example)
• Add proxyResolver option & support discovery of delegated method calls identity
• Add draft of 0x artifact handler
• Add url option for non-truffle, non-buidler use
• Add buidler truffle-v5 plugin support (preface to gas-reporter plugin in next release)
• Completely reorganize and refactor