README
¶
Ethermint
Ethereum powered by Tendermint consensus
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.
Directories