Laconic state machine
Go to file
Austin Abell 2b4d2bea82 Implements eth_call (#127)
* Fixed tx receipt error on failed transaction

* Add returnData to failed transaction for logs bloom

* Added simulate call option, without returning evm data

* Added encoding and decoding of data from EVM execution for usability

* Remove unused context parameter

* Fix function comment and remove unnecessary logging on eth_call
2019-10-22 11:40:34 -05:00
.circleci Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
.github Update PULL_REQUEST_TEMPLATE.md 2018-09-06 14:54:17 -04:00
app Gas usage implementation (#123) 2019-10-19 08:14:38 +09:00
cmd eth_getBlockByHash and block hash mapping functionality (#114) 2019-09-27 10:08:45 -04:00
core Updating ethereum version from fork (#68) 2019-07-11 14:05:34 -04:00
crypto Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
docs TX Routing Refactor (#496) 2018-11-28 14:19:22 -08:00
importer Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
keys Implement eth_sendTransaction (#104) 2019-09-20 09:30:20 -04:00
rpc Implements eth_call (#127) 2019-10-22 11:40:34 -05:00
types Implements eth_call (#127) 2019-10-22 11:40:34 -05:00
utils Implements eth_getProof (#122) 2019-10-16 09:46:50 +09:00
version Query and bug fixes (#110) 2019-09-26 11:36:23 -04:00
x/evm Implements eth_call (#127) 2019-10-22 11:40:34 -05:00
.gitignore Adds AppModuleBasic and Genesis Functions (#62) 2019-07-08 12:02:20 -04:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-07-17 11:52:20 -04:00
CONTRIBUTING.md Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
Dockerfile Fix dockerfile 2018-11-27 10:31:39 -08:00
go.mod Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
go.sum Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
gometalinter.json Upgrade geth and cleanup 2018-09-28 17:40:58 -04:00
LICENSE Initial commit 2018-06-10 14:25:18 +01:00
Makefile Implement eth_pendingTransactions, bump sdk version (#124) 2019-10-19 08:23:09 +09:00
README.md Switch package management to go modules (#1) 2019-06-25 15:56:54 -04:00

CircleCI 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 compatible clients) need to be able to interact with ethermint.

Implementation

Completed

  • Have a working implementation that can parse and validate the existing ETH Chain and persist it in a Tendermint store
  • Implement Ethereum transactions in the CosmosSDK

Current Work

  • Implement web3 compatible API layer
  • Implement the EVM as a CosmosSDK module
  • Allow the Ethermint EVM to interact with other Cosmos SDK modules

Next Steps

  • Hard spoon enablement: The ability to export state from geth and import token balances into Ethermint
  • Ethermint is a functioning Cosmos SDK application and can be deployed as its own zone
  • Full web3 compatibility will enable existing Ethereum applications to use Ethermint

Building Ethermint

To build, execute the following commands:

# To build the binary and put the resulting binary in ./build
$ make tools verify build

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

Tests

Integration tests are invoked via:

$ make test

To run CLI tests, execute:

$ make test-cli

Ethereum Mainnet Import

There is an included Ethereum mainnet exported blockchain file in importer/blockchain that includes blocks up to height 97638. To execute and test a full import of these blocks using the EVM module, execute:

$ make test-import

You may also provide a custom blockchain export file to test importing more blocks via the --blockchain flag. See TestImportBlocks for further documentation.

Community

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