Command line interface to Ethereum node web3 API

Summary

Ethester is a command line tool which can be used to automate and/or test tasks like:

• create new accounts;
• check account's balance;
• list all available accounts;
• send ether from one account to another;
• deploy new contract;
• call contract's public and/or external methods;
• get smart contract byte code from the blockchain;
• fetch logs from the blockchain;
• execute custom JavaScript code on a Geth node.

Full documentation available in the doc/ subdirectory.

Requirements

• python 2.7;
• Ethester cannot work alone. Every command invocation (except for -h/--help option) requires running geth node and geth.ipc socket readable and writable by current user. Last version of geth can be found here;
• probably, you'll need Solidity compiler in order to work with smart contracts.

Installation

Install Ethester executable to /usr/bin/:

sudo make install

Synopsis and usage

In general, Ethester command syntax is:

ethester [common_options] command [command_options] [command_args] [expectations]

For more details type

ethester --help

Using Ethester for testing

Good example can be used in test/Makefile.

License

2-clause BSD. Full license text can be found in LICENSE file.

Run unit tests

Requirements:

• geth - go-ethereum executable;
• solc - Solidity compiler.

To run tests type:

make test