cosmos-sdk/README.md

47 lines
2.1 KiB
Markdown
Raw Normal View History

2017-01-26 13:48:54 -08:00
# Basecoin
DISCLAIMER: Basecoin is not associated with Coinbase.com, an excellent Bitcoin/Ethereum service.
2017-02-03 18:17:11 -08:00
Basecoin is an [ABCI application](https://github.com/tendermint/abci) designed to be used with the [tendermint consensus engine](https://tendermint.com/) to form a Proof-of-Stake cryptocurrency.
It also provides a general purpose framework for extending the feature-set of the cryptocurrency
by implementing plugins.
2017-01-26 13:48:54 -08:00
2017-02-03 18:17:11 -08:00
Basecoin serves as a reference implementation for how we build ABCI applications in Go,
and is the framework in which we implement the [Cosmos Hub](https://cosmos.network).
It's easy to use, and doesn't require any forking - just implement your plugin, import the basecoin libraries,
and away you go with a full-stack blockchain and command line tool for transacting.
2017-01-26 13:48:54 -08:00
2017-02-03 18:17:11 -08:00
WARNING: Currently uses plain-text private keys for transactions and is otherwise not production ready.
2017-01-26 13:48:54 -08:00
## Installation
We use glide for dependency management. The prefered way of compiling from source is the following:
```
go get -d github.com/tendermint/basecoin/cmd/basecoin
2017-01-26 13:48:54 -08:00
cd $GOPATH/src/github.com/tendermint/basecoin
make get_vendor_deps
make install
```
2017-01-29 12:43:30 -08:00
This will create the `basecoin` binary in `$GOPATH/bin`.
2017-01-28 12:19:30 -08:00
2017-02-03 18:17:11 -08:00
## Command Line Interface
2017-02-03 18:17:11 -08:00
The basecoin CLI can be used to start a stand-alone basecoin instance (`basecoin start`),
2017-01-29 12:48:28 -08:00
or to start basecoin with tendermint in the same process (`basecoin start --in-proc`).
It can also be used to send transactions, eg. `basecoin sendtx --to 0x4793A333846E5104C46DD9AB9A00E31821B2F301 --amount 100`
See `basecoin --help` and `basecoin [cmd] --help` for more details`.
2017-02-03 18:17:11 -08:00
## Learn more
2017-01-29 15:23:50 -08:00
2017-02-03 18:17:11 -08:00
1. Getting started with the [Basecoin tool](/docs/guide/basecoin-basics.md)
1. Learn more about [Basecoin's design](/docs/guide/basecoin-design.md)
1. Make your own [cryptocurrency using Basecoin plugins](/docs/guide/example-counter.md)
1. Learn more about [plugin design](/docs/guide/plugin-design.md)
1. See some [more example applications](/docs/guide/more-examples.md)
2017-02-04 21:43:55 -08:00
1. Learn how to use [InterBlockchain Communication (IBC)](/docs/guide/ibc.md)
2017-02-03 18:17:11 -08:00
1. [Deploy testnets](deployment.md) running your basecoin application.
2017-01-29 15:23:50 -08:00