Laconic state machine
Go to file
Jack Zampolin f5b0a1878d
Merge pull request #455 from cosmos/bez/update-pr-template
Update PULL_REQUEST_TEMPLATE.md
2018-08-01 10:03:28 -07:00
.circleci Fix name on circleci/config.yml 2018-07-31 17:37:38 -07:00
.github Update PULL_REQUEST_TEMPLATE.md 2018-08-01 08:35:42 -04:00
app Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
cmd Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
core Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
data Move blockchain file: 2018-07-13 14:12:18 -07:00
server Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
state Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
test Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
types Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
version Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
x Merge pull request #447: Initial Application Skeleton Structure 2018-07-19 17:16:53 -04:00
.gitignore Clean up gitignore 2018-07-16 07:49:52 -07:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-07-17 11:52:20 -04:00
CONTRIBUTING.md Update make targets 2018-07-13 13:41:17 -07:00
Dockerfile Fix make tools (indentation) and update Dockerfile to reflect fixed make target 2018-07-13 13:58:22 -07:00
gometalinter.json Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
Gopkg.lock Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
Gopkg.toml Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
LICENSE Initial commit 2018-06-10 14:25:18 +01:00
Makefile Merge pull request #453: Core/State Unit Tests 2018-07-26 09:36:07 -04:00
README.md Merge pull request #446: Restructure Importing Test 2018-07-18 14:14:49 -04:00

Go Report Card

Ethermint

WARNING: Ethermint is under VERY ACTIVE DEVELOPMENT and should be treated as pre-alpha software. This means it is not meant to be run in production, its APIs are subject to change without warning and should not be relied upon, and it should not be used to hold any value. We will remove this warning when we have a release that is stable, secure, and properly tested.

What is it?

ethermint will be an implementation of the EVM that runs on top of tendermint consensus, a Proof of Stake system. This project has as its primary goals:

  • Hard Spoon enablement: This is the ability to take a token from the Ethereum mainnet and "spoon" (shift) the balances over to another network. This feature is intended to make it easy for applications that require more transactions than the Ethereum main chain can provide to move their code over to a compatible chain with much more capacity.
  • Web3 Compatibility: In order enable applications to be moved over to an ethermint chain existing tooling (i.e. web3 compatable clients) need to be able to interact with ethermint.

Implementation

  • Have a working implementation that can parse and validate the existing ETH Chain and persist it in a Tendermint store
  • Benchmark this implementation to ensure performance
  • Allow the Ethermint EVM to interact with other Cosmos SDK modules
  • Implement the Web3 APIs as a Cosmos Light Client for Ethermint
  • Ethermint is a full Cosmos SDK application and can be deployed as it's own zone

Building Ethermint

To build, execute the following commands:

# To build the binary and put the results in ./build
$ make tools deps build

# To build the project and install it in $GOBIN
$ make tools deps install

Using Ethermint to parse Mainnet Ethereum blocks

There is an included Ethereum Mainnet blockchain file in data/blockchain that provides an easy way to run the demo of parsing Mainnet Ethereum blocks. The dump in data/ only includes up to block 97638. To run this, type the following command:

$ go run test/run.go

By default, state will be dumped into $HOME/.ethermint. See --help for further usage.

Community

The following chat channels and forums are a great spot to ask questions about Ethermint: