Ethermint

Ethereum powered by Tendermint consensus

The latest version of Ethermint only works with Tendermint up to 0.14.0.

Features

Ethermint is fully compatible with the standard Ethereum tooling such as geth, mist and truffle. Please install whichever tooling suits you best and check out the documentation for more information.

Installation

See the install documentation. For developers:

go get -u -d github.com/tendermint/ethermint
go get -u -d github.com/tendermint/tendermint
cd $GOPATH/src/github.com/tendermint/ethermint
make install
cd ../tendermint
make install

Running Ethermint

Initialisation

To get started, you need to initialise the genesis block for tendermint core and go-ethereum. We provide initialisation files with reasonable defaults and money allocated into a predefined account. If you installed from binary or docker please download these default files here.

You can choose where to store the ethermint files with --datadir. For this guide, we will use ~/.ethermint, which is a reasonable default in most cases.

Before you can run ethermint you need to initialise tendermint and ethermint with their respective genesis states. Please switch into the folder where you have the initialisation files. If you installed from source you can just follow these instructions.

ethermint --datadir ~/.ethermint --with-tendermint init

which will also invoke tendermint init --home ~/.ethermint/tendermint. You can prevent Tendermint from being starting by excluding the flag --with-tendermint for example:

ethermint --datadir ~/.ethermint init

and then you will have to invoke tendermint in another shell with the command:

tendermint init --home ~/.ethermint/tendermint

For simplicity, we'll have ethermint start tendermint as a subprocess with the flag --with-tendermint:

ethermint --with-tendermint --datadir ~/.ethermint --rpc --rpcaddr=0.0.0.0 --ws --wsaddr=0.0.0.0 --rpcapi eth,net,web3,personal,admin

Note: The password for the default account is 1234.

There you have it, Ethereum on Tendermint! For details on what to do next, check out the documentation

Contributing

Thank you for considering making contributions to Ethermint!

Check out the contributing guidelines for information on getting starting with contributing.

See the open issues for things we need help with!

Support

Check out the community page for various resources.

License

GPLv3

maxim-levy/ethermint