2020-07-17 18:07:05 +00:00
<!--
parent:
order: false
-->
< div align = "center" >
< h1 > Ethermint < / h1 >
< / div >
2021-08-20 15:38:03 +00:00
![banner ](docs/ethermint.jpg )
2020-07-17 18:07:05 +00:00
< div align = "center" >
2022-06-19 09:43:41 +00:00
< a href = "https://github.com/evmos/ethermint/releases/latest" >
2021-06-22 10:49:18 +00:00
< img alt = "Version" src = "https://img.shields.io/github/tag/tharsis/ethermint.svg" / >
2020-07-17 18:07:05 +00:00
< / a >
2022-06-19 09:43:41 +00:00
< a href = "https://github.com/evmos/ethermint/blob/main/LICENSE" >
2021-06-22 10:49:18 +00:00
< img alt = "License: Apache-2.0" src = "https://img.shields.io/github/license/tharsis/ethermint.svg" / >
2020-07-17 18:07:05 +00:00
< / a >
2022-06-19 09:43:41 +00:00
< a href = "https://pkg.go.dev/github.com/evmos/ethermint" >
< img alt = "GoDoc" src = "https://godoc.org/github.com/evmos/ethermint?status.svg" / >
2020-07-17 18:07:05 +00:00
< / a >
2022-06-19 09:43:41 +00:00
< a href = "https://goreportcard.com/report/github.com/evmos/ethermint" >
< img alt = "Go report card" src = "https://goreportcard.com/badge/github.com/evmos/ethermint" / >
2020-07-17 18:07:05 +00:00
< / a >
2021-07-16 10:54:43 +00:00
< a href = "https://bestpractices.coreinfrastructure.org/projects/5018" >
2021-09-13 13:28:43 +00:00
< img alt = "Lines of code" src = "https://img.shields.io/tokei/lines/github/tharsis/ethermint" >
2021-07-16 10:54:43 +00:00
< / a >
2020-07-17 18:07:05 +00:00
< / div >
< div align = "center" >
2021-09-07 07:54:53 +00:00
< a href = "https://discord.gg/trje9XuAmy" >
2021-08-26 18:06:44 +00:00
< img alt = "Discord" src = "https://img.shields.io/discord/809048090249134080.svg" / >
2020-07-17 18:07:05 +00:00
< / a >
2022-06-19 09:43:41 +00:00
< a href = "https://github.com/evmos/ethermint/actions?query=branch%3Amain+workflow%3ALint" >
< img alt = "Lint Status" src = "https://github.com/evmos/ethermint/actions/workflows/lint.yml/badge.svg?branch=main" / >
2020-07-17 18:07:05 +00:00
< / a >
2021-06-22 10:49:18 +00:00
< a href = "https://codecov.io/gh/tharsis/ethermint" >
< img alt = "Code Coverage" src = "https://codecov.io/gh/tharsis/ethermint/branch/main/graph/badge.svg" / >
2020-07-17 18:07:05 +00:00
< / a >
< / div >
2021-09-29 16:15:55 +00:00
Ethermint is a scalable and interoperable Ethereum library, built on Proof-of-Stake with fast-finality using the [Cosmos SDK ](https://github.com/cosmos/cosmos-sdk/ ) which runs on top of [Tendermint Core ](https://github.com/tendermint/tendermint ) consensus engine.
2020-07-17 18:07:05 +00:00
2022-10-31 16:46:48 +00:00
**Note**: Requires [Go 1.19+ ](https://golang.org/dl/ )
2020-07-17 18:07:05 +00:00
2021-08-26 18:06:44 +00:00
## Installation
2022-12-22 10:14:45 +00:00
For prerequisites and detailed build instructions please read the Evmos [Installation ](https://docs.evmos.org/validators/quickstart/installation.html ) instructions. Once the dependencies are installed, run:
2021-08-26 18:06:44 +00:00
```bash
make install
```
2022-06-19 09:43:41 +00:00
Or check out the latest [release ](https://github.com/evmos/ethermint/releases ).
2021-08-26 18:06:44 +00:00
2020-07-17 18:07:05 +00:00
## Quick Start
2022-12-22 08:48:43 +00:00
To learn how Ethermint works from a high-level perspective, go to the [Introduction ](https://docs.evmos.org/about/intro/overview.html ) section from the documentation. You can also check the instructions to [Run a Node ](https://docs.evmos.org/validators/quickstart/run_node.html ).
2020-07-17 18:07:05 +00:00
2021-09-29 16:15:55 +00:00
For an example on how Ethermint can be used on any Cosmos-SDK chain, please refer to [Evmos ](https://www.github.com/tharsis/evmos ).
2020-07-17 18:07:05 +00:00
2021-08-26 18:06:44 +00:00
## Community
2018-07-12 22:25:48 +00:00
The following chat channels and forums are a great spot to ask questions about Ethermint:
2021-11-09 19:50:27 +00:00
- [Evmos Twitter ](https://twitter.com/EvmosOrg )
- [Evmos Discord ](https://discord.gg/trje9XuAmy )
- [Evmos Telegram ](https://t.me/EvmosOrg )
2021-09-29 16:15:55 +00:00
- [Tharsis Twitter ](https://twitter.com/TharsisHQ )
2021-08-26 18:06:44 +00:00
## Contributing
2022-06-19 09:43:41 +00:00
Looking for a good place to start contributing? Check out some [`good first issues` ](https://github.com/evmos/ethermint/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22 ).
2021-08-26 18:06:44 +00:00
For additional instructions, standards and style guides, please refer to the [Contributing ](./CONTRIBUTING.md ) document.
## Careers
2022-12-22 10:14:45 +00:00
See our open positions on [Greenhouse ](https://boards.eu.greenhouse.io/evmos ).