375a7a074d
* evm: fix non-determinism * fixes * typo * fix tests * local testnet command * fix testnet cmd (#383) fix export-eth-key generate eth type account in genesis.json file * fixes * update docker * minor changes * fix build-docker-local-ethermint * fix dockerfile * update Makefile * update denoms * update genesis file * update makefile * fix docker-compose.yml images * fix localnet execution (#398) * finish documentation * changelog and comment rpc tests workflow * update codecov * update testnet docs * fix docker-compose execution * update docs * fix errors and make testnet work (#403) * fix errors and make testnet work * Update Dockerfile Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com> * wip - fix db * fixes emintd nodes and syncs nodes * starts daemon and rpc server in bg Co-authored-by: Federico Kunze <31522760+fedekunze@users.noreply.github.com> Co-authored-by: Federico Kunze <federico.kunze94@gmail.com> * update entrypoint and docs * update logs * try fix rpc * build docker image * Update Dockerfile Co-authored-by: Holechain <nrgh@foxmail.com> Co-authored-by: Alessio Treglia <quadrispro@ubuntu.com> Co-authored-by: Daniel Choi <choidanielw@gmail.com>
86 lines
3.4 KiB
Markdown
86 lines
3.4 KiB
Markdown
<!--
|
|
parent:
|
|
order: false
|
|
-->
|
|
|
|
<div align="center">
|
|
<h1> Ethermint </h1>
|
|
</div>
|
|
|
|
<div align="center">
|
|
<a href="https://github.com/ChainSafe/ethermint/releases/latest">
|
|
<img alt="Version" src="https://img.shields.io/github/tag/ChainSafe/ethermint.svg" />
|
|
</a>
|
|
<a href="https://github.com/ChainSafe/ethermint/blob/development/LICENSE">
|
|
<img alt="License: Apache-2.0" src="https://img.shields.io/github/license/ChainSafe/ethermint.svg" />
|
|
</a>
|
|
<a href="https://pkg.go.dev/github.com/cosmos/ethermint?tab=doc">
|
|
<img alt="GoDoc" src="https://godoc.org/github.com/ChainSafe/ethermint?status.svg" />
|
|
</a>
|
|
<a href="https://goreportcard.com/report/github.com/ChainSafe/ethermint">
|
|
<img alt="Go report card" src="https://goreportcard.com/badge/github.com/ChainSafe/ethermint"/>
|
|
</a>
|
|
<a href="https://codecov.io/gh/ChainSafe/ethermint">
|
|
<img alt="Code Coverage" src="https://codecov.io/gh/ChainSafe/ethermint/branch/development/graph/badge.svg" />
|
|
</a>
|
|
</div>
|
|
<div align="center">
|
|
<a href="https://github.com/cosmos/ethermint">
|
|
<img alt="Lines Of Code" src="https://tokei.rs/b1/github/cosmos/ethermint" />
|
|
</a>
|
|
<a href="https://discord.gg/AzefAFd">
|
|
<img alt="Discord" src="https://img.shields.io/discord/669268347736686612.svg" />
|
|
</a>
|
|
<a href="https://github.com/ChainSafe/ethermint/actions?query=workflow%3ABuild">
|
|
<img alt="Build Status" src="https://github.com/ChainSafe/ethermint/workflows/Build/badge.svg" />
|
|
</a>
|
|
<a href="https://github.com/ChainSafe/ethermint/actions?query=workflow%3ALint">
|
|
<img alt="Lint Status" src="https://github.com/ChainSafe/ethermint/workflows/Lint/badge.svg" />
|
|
</a>
|
|
</div>
|
|
|
|
Ethermint is a scalable, high-throughput Proof-of-Stake blockchain that is fully compatible and
|
|
interoperable with Ethereum. It's build using the the [Cosmos SDK](https://github.com/cosmos/cosmos-sdk/) which runs on top of [Tendermint Core](https://github.com/tendermint/tendermint) consensus engine.
|
|
|
|
> **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.
|
|
|
|
**Note**: Requires [Go 1.14+](https://golang.org/dl/)
|
|
|
|
## Quick Start
|
|
|
|
To learn how the Ethermint works from a high-level perspective, go to the [Introduction](./docs/intro/overview.md) section from the documentation.
|
|
|
|
For more, please refer to the [Ethermint Docs](./docs/), which are also hosted on [docs.ethermint.zone](https://docs.ethermint.zone/).
|
|
|
|
## Tests
|
|
|
|
Unit tests are invoked via:
|
|
|
|
```bash
|
|
make test
|
|
```
|
|
|
|
To run JSON-RPC tests, execute:
|
|
|
|
```bash
|
|
make test-rpc
|
|
```
|
|
|
|
There is also 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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
- [Cosmos Discord](https://discord.gg/W8trcGV)
|
|
- [Cosmos Forum](https://forum.cosmos.network)
|