|
|
- # Tendermint
-
- [Byzantine-Fault Tolerant](https://en.wikipedia.org/wiki/Byzantine_fault_tolerance)
- [State Machine Replication](https://en.wikipedia.org/wiki/State_machine_replication).
- Or [Blockchain](https://en.wikipedia.org/wiki/Blockchain_(database)) for short.
-
- [](https://github.com/tendermint/tendermint/releases/latest)
- [](https://godoc.org/github.com/tendermint/tendermint)
- [](https://cosmos.rocket.chat/)
- [](https://github.com/tendermint/tendermint/blob/master/LICENSE)
- [](https://github.com/tendermint/tendermint)
-
-
- Branch | Tests | Coverage
- ----------|-------|----------
- master | [](https://circleci.com/gh/tendermint/tendermint/tree/master) | [](https://codecov.io/gh/tendermint/tendermint)
- develop | [](https://circleci.com/gh/tendermint/tendermint/tree/develop) | [](https://codecov.io/gh/tendermint/tendermint)
-
- _NOTE: This is alpha software. Please contact us if you intend to run it in production._
-
- Tendermint Core is Byzantine Fault Tolerant (BFT) middleware that takes a state transition machine - written in any programming language -
- and securely replicates it on many machines.
-
- For more information, from introduction to install to application development, [Read The Docs](http://tendermint.readthedocs.io/projects/tools/en/master).
-
- ## Install
-
- To download pre-built binaries, see our [downloads page](https://tendermint.com/downloads).
-
- To install from source, you should be able to:
-
- `go get -u github.com/tendermint/tendermint/cmd/tendermint`
-
- For more details (or if it fails), [read the docs](http://tendermint.readthedocs.io/projects/tools/en/master/install.html).
-
- ## Resources
-
- ### Tendermint Core
-
- All resources involving the use of, building application on, or developing for, tendermint, can be found at [Read The Docs](http://tendermint.readthedocs.io/projects/tools/en/master). Additional information about some - and eventually all - of the sub-projects below, can be found at Read The Docs.
-
- ### Sub-projects
-
- * [ABCI](http://github.com/tendermint/abci), the Application Blockchain Interface
- * [Go-Wire](http://github.com/tendermint/go-wire), a deterministic serialization library
- * [Go-Crypto](http://github.com/tendermint/go-crypto), an elliptic curve cryptography library
- * [TmLibs](http://github.com/tendermint/tmlibs), an assortment of Go libraries used internally
- * [IAVL](http://github.com/tendermint/iavl), Merkleized IAVL+ Tree implementation
-
- ### Tools
- * [Deployment, Benchmarking, and Monitoring](http://tendermint.readthedocs.io/projects/tools/en/develop/index.html#tendermint-tools)
-
- ### Applications
-
- * [Ethermint](http://github.com/tendermint/ethermint); Ethereum on Tendermint
- * [Cosmos SDK](http://github.com/cosmos/cosmos-sdk); a cryptocurrency application framework
-
- ### More
-
- * [Master's Thesis on Tendermint](https://atrium.lib.uoguelph.ca/xmlui/handle/10214/9769)
- * [Original Whitepaper](https://tendermint.com/static/docs/tendermint.pdf)
- * [Tendermint Blog](https://blog.cosmos.network/tendermint/home)
- * [Cosmos Blog](https://blog.cosmos.network)
-
- ## Contributing
-
- Yay open source! Please see our [contributing guidelines](CONTRIBUTING.md).
-
- ## Versioning
-
- ### SemVer
-
- Tendermint uses [SemVer](http://semver.org/) to determine when and how the version changes.
- According to SemVer, anything in the public API can change at any time before version 1.0.0
-
- To provide some stability to Tendermint users in these 0.X.X days, the MINOR version is used
- to signal breaking changes across a subset of the total public API. This subset includes all
- interfaces exposed to other processes (cli, rpc, p2p, etc.), as well as parts of the following packages:
-
- - types
- - rpc/client
- - config
- - node
-
- Exported objects in these packages that are not covered by the versioning scheme
- are explicitly marked by `// UNSTABLE` in their go doc comment and may change at any time.
- Functions, types, and values in any other package may also change at any time.
-
- ### Upgrades
-
- In an effort to avoid accumulating technical debt prior to 1.0.0,
- we do not guarantee that breaking changes (ie. bumps in the MINOR version)
- will work with existing tendermint blockchains. In these cases you will
- have to start a new blockchain, or write something custom to get the old
- data into the new chain.
-
- However, any bump in the PATCH version should be compatible with existing histories
- (if not please open an [issue](https://github.com/tendermint/tendermint/issues)).
-
- ## Code of Conduct
-
- Please read, understand and adhere to our [code of conduct](CODE_OF_CONDUCT.md).
|
