tendermint/README.md

65 lines
2.0 KiB
Markdown
Raw Normal View History

2015-01-20 03:30:57 -08:00
# Tendermint
2016-03-03 16:54:23 -08:00
Simple, Secure, Scalable Blockchain Platform
2014-11-07 23:27:03 -08:00
2016-06-16 16:24:23 -07:00
[![CircleCI](https://circleci.com/gh/tendermint/tendermint.svg?style=svg)](https://circleci.com/gh/tendermint/tendermint)
2015-06-10 09:06:28 -07:00
2016-06-20 03:03:14 -07:00
_NOTE: This is yet pre-alpha non-production-quality software._
2016-05-04 14:10:36 -07:00
## Resources
2016-05-04 14:01:51 -07:00
2016-05-04 14:10:15 -07:00
### Tendermint Core
2016-03-03 16:54:23 -08:00
2016-05-04 14:10:15 -07:00
- [Introduction](https://github.com/tendermint/tendermint/wiki/Introduction)
- [Validators](https://github.com/tendermint/tendermint/wiki/Validators)
- [Byzantine Consensus Algorithm](https://github.com/tendermint/tendermint/wiki/Byzantine-Consensus-Algorithm)
- [Block Structure](https://github.com/tendermint/tendermint/wiki/Block-Structure)
- [RPC](https://github.com/tendermint/tendermint/wiki/RPC)
- [Genesis](https://github.com/tendermint/tendermint/wiki/Genesis)
- [Configuration](https://github.com/tendermint/tendermint/wiki/Configuration)
- [Light Client Protocol](https://github.com/tendermint/tendermint/wiki/Light-Client-Protocol)
- [Roadmap for V2](https://github.com/tendermint/tendermint/wiki/Roadmap-for-V2)
2015-05-12 19:09:54 -07:00
2016-05-04 14:10:15 -07:00
### Sub-projects
* [TMSP](http://github.com/tendermint/tmsp)
* [Mintnet](http://github.com/tendermint/mintnet)
* [Go-Wire](http://github.com/tendermint/go-wire)
* [Go-P2P](http://github.com/tendermint/go-p2p)
* [Go-Merkle](http://github.com/tendermint/go-merkle)
2016-05-14 09:02:12 -07:00
*
### Install
Make sure you have installed Go and [set the GOPATH](https://github.com/tendermint/tendermint/wiki/Setting-GOPATH).
Install `glide`, used for dependency management:
```
go get https://github.com/Masterminds/glide
```
Install tendermint:
```
mkdir -p $GOPATH/src/github.com/tendermint
git clone https://github.com/tendermint/tendermint $GOPATH/src/github.com/tendermint/tendermint
cd $GOPATH/src/github.com/tendermint/tendermint
glide install
go install ./cmd/tendermint
```
2016-05-14 09:02:53 -07:00
Initialize a sample tendermint directory with an example genesis file (in `~/.tendermint`):
2016-05-14 09:02:12 -07:00
```
tendermint init
```
Now run the tendermint node:
```
tendermint node --proxy_app=dummy
```
2016-05-16 08:16:53 -07:00
For tutorials on running other applications with Tendermint, and for launching test networks,
see http://tendermint.com/guide/