From 0b48920f94dda777befb3bd517f2dcd1129d4088 Mon Sep 17 00:00:00 2001 From: Jack Zampolin Date: Thu, 12 Jul 2018 15:25:48 -0700 Subject: [PATCH 1/3] Add README.md --- README.md | 38 ++++++++++++++++++++++++++++++++++---- 1 file changed, 34 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 5b51f6ed..445d7673 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,39 @@ -# Ethermint Skeleton +[![](https://godoc.org/github.com/cosmos/ethermint?status.svg)](http://godoc.org/github.com/cosmos/ethermint) [![Go Report Card](https://goreportcard.com/badge/github.com/cosmos/ethermint)](https://goreportcard.com/report/github.com/cosmos/ethermint) -To build, execute these two commands: +# Ethermint -dep ensure +__**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 should it be used to hold any value. We will remove this warning when we have a release that is stable, secure, and properly tested. -go build main.go copied.go +### What is it? +`ethermint` will be an implementation of the EVM that runs on top of [`tendermint`](https://github.com/tendermint/tendermint) consensus, a Proof of Stake system. This project has as its primary goals: +- [Hard Spoon](https://blog.cosmos.network/introducing-the-hard-spoon-4a9288d3f0df) 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 Steps + +- [x] 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](https://github.com/cosmos/cosmos-sdk/blob/master/docs/core/app3.md) +- [ ] 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: + +```bash +# To build the binary and put the results in ./build +$ make get-tools get-vendor-deps build + +# To build the project and install it in $GOBIN +$ make get-tools get-vendor-deps install +``` + +### Community + +The following chat channels and forums are a great spot to ask questions about Ethermint: + +- [Cosmos Riot Chat Channel](https://riot.im/app/#/group/+cosmos:matrix.org) +- Cosmos Forum [![Discourse status](https://img.shields.io/discourse/https/forum.cosmos.network/status.svg)](https://forum.cosmos.network) From 940fdcf66f319920971c6dc53eca037a5399594d Mon Sep 17 00:00:00 2001 From: Jack Zampolin Date: Fri, 13 Jul 2018 12:47:48 -0700 Subject: [PATCH 2/3] Address PR comment --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 445d7673..35c345cc 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # 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 should it be used to hold any value. We will remove this warning when we have a release that is stable, secure, and properly tested. +__**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? From b0b1c1f11d7fba5abbec60e6f9d8d37deddd02b4 Mon Sep 17 00:00:00 2001 From: Jack Zampolin Date: Fri, 13 Jul 2018 13:41:17 -0700 Subject: [PATCH 3/3] Update make targets --- CONTRIBUTING.md | 2 +- Dockerfile | 2 +- Makefile | 10 +++++----- README.md | 4 ++-- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ffcf87f2..dfe6f7d6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -45,7 +45,7 @@ software. Since some dependencies are not under our control, a third party may break our build, in which case we can fall back on `dep ensure` (or `make -get-vendor-deps`). Even for dependencies under our control, `dep` helps us to +deps`). Even for dependencies under our control, `dep` helps us to keep multiple repos in sync as they evolve. Anything with an executable, such as apps, tools, and the core, should use `dep`. diff --git a/Dockerfile b/Dockerfile index 069a6493..85ec13fb 100644 --- a/Dockerfile +++ b/Dockerfile @@ -13,7 +13,7 @@ RUN apk add --update $PACKAGES COPY . . # Make the binary -RUN make update-tools get-vendor-deps build +RUN make update-tools deps build # Final image FROM alpine:edge diff --git a/Makefile b/Makefile index 8510e60c..5e536a31 100644 --- a/Makefile +++ b/Makefile @@ -24,9 +24,9 @@ ERRCHECK_CHECK := $(shell command -v errcheck 2> /dev/null) UNPARAM_CHECK := $(shell command -v unparam 2> /dev/null) GOCYCLO_CHECK := $(shell command -v gocyclo 2> /dev/null) -all: get-tools get-vendor-deps install +all: tools deps install -ci: get-tools get-vendor-deps install +ci: tools deps install build: ifeq ($(OS),Windows_NT) @@ -45,7 +45,7 @@ update-tools: @echo "Updating golang dependencies" go get -u -v $(DEP) $(GOLINT) $(GOMETALINTER) $(UNCONVERT) $(INEFFASSIGN) $(MISSPELL) $(ERRCHECK) $(UNPARAM) $(GOCYCLO) -get-tools: +tools: ifdef DEP_CHECK @echo "Dep is already installed. Run 'make update-tools' to update." else @@ -101,7 +101,7 @@ get-tools: go get -v $(GOCYCLO) endif -get-vendor-deps: +deps: @rm -rf vendor/ @echo "--> Running dep ensure" @dep ensure -v @@ -115,4 +115,4 @@ docker: docker tag ${DOCKER_IMAGE}:${DOCKER_TAG} ${DOCKER_IMAGE}:latest docker tag ${DOCKER_IMAGE}:${DOCKER_TAG} ${DOCKER_IMAGE}:${COMMIT_HASH} -.PHONY: build install update-tools get-tools get-vendor-deps godocs +.PHONY: build install update-tools tools deps godocs diff --git a/README.md b/README.md index 35c345cc..e9ab4627 100644 --- a/README.md +++ b/README.md @@ -25,10 +25,10 @@ To build, execute the following commands: ```bash # To build the binary and put the results in ./build -$ make get-tools get-vendor-deps build +$ make tools deps build # To build the project and install it in $GOBIN -$ make get-tools get-vendor-deps install +$ make tools deps install ``` ### Community