2017-01-07 22:43:08 -08:00
|
|
|
# Bcoin
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2017-07-23 08:24:52 -07:00
|
|
|
__NOTE__: The latest release of bcoin contains a non-backward compatible change
|
|
|
|
|
to the rest API. Please read the [changelog]'s "migrating" section for more
|
|
|
|
|
details.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
**Bcoin** is an alternative implementation of the bitcoin protocol, written in
|
|
|
|
|
node.js.
|
2016-07-04 05:36:06 -07:00
|
|
|
|
2017-12-28 11:19:27 -08:00
|
|
|
Bcoin is well tested and aware of all known consensus rules. It is currently
|
|
|
|
|
used in production as the consensus backend and wallet system for
|
|
|
|
|
[purse.io][purse].
|
2017-02-10 09:39:44 -08:00
|
|
|
|
|
|
|
|
## Uses
|
2016-02-26 03:21:39 -08:00
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
- Full Node
|
|
|
|
|
- SPV Node
|
|
|
|
|
- Wallet Backend (bip44 derivation)
|
|
|
|
|
- Mining Backend (getblocktemplate support)
|
|
|
|
|
- Layer 2 Backend (lightning)
|
|
|
|
|
- General Purpose Bitcoin Library
|
2016-02-26 03:21:39 -08:00
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
Try it in the browser: http://bcoin.io/browser.html
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2016-01-27 19:46:11 -08:00
|
|
|
## Install
|
2014-11-05 10:46:56 -08:00
|
|
|
|
|
|
|
|
```
|
2016-07-21 14:26:42 -07:00
|
|
|
$ git clone git://github.com/bcoin-org/bcoin.git
|
|
|
|
|
$ cd bcoin
|
|
|
|
|
$ npm install
|
2017-05-12 14:05:12 -07:00
|
|
|
$ ./bin/bcoin
|
2014-11-05 10:46:56 -08:00
|
|
|
```
|
|
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
See the [Beginner's Guide][guide] for more in-depth installation instructions.
|
2016-07-21 14:26:42 -07:00
|
|
|
|
2016-04-15 07:11:30 -07:00
|
|
|
## Documentation
|
2016-02-26 03:21:39 -08:00
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
- API Docs: http://bcoin.io/docs/
|
2017-10-09 21:16:04 +04:00
|
|
|
- REST Docs: http://bcoin.io/api-docs/index.html
|
2017-07-21 00:48:46 +04:00
|
|
|
- Docs: [docs/](docs/README.md)
|
2016-02-26 03:21:39 -08:00
|
|
|
|
2017-01-07 22:43:08 -08:00
|
|
|
## Support
|
|
|
|
|
|
2017-05-12 15:52:03 -07:00
|
|
|
Join us on [freenode][freenode] in the [#bcoin][irc] channel.
|
2017-01-07 22:43:08 -08:00
|
|
|
|
2016-10-24 17:30:37 -07:00
|
|
|
## Disclaimer
|
|
|
|
|
|
2017-02-03 22:47:26 -08:00
|
|
|
Bcoin does not guarantee you against theft or lost funds due to bugs, mishaps,
|
2016-10-24 17:30:37 -07:00
|
|
|
or your own incompetence. You and you alone are responsible for securing your
|
|
|
|
|
money.
|
|
|
|
|
|
2016-08-26 05:37:36 -07:00
|
|
|
## Contribution and License Agreement
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2016-08-26 05:37:36 -07:00
|
|
|
If you contribute code to this project, you are implicitly allowing your code
|
|
|
|
|
to be distributed under the MIT license. You are also implicitly verifying that
|
|
|
|
|
all code is your original work. `</legalese>`
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2016-08-26 05:37:36 -07:00
|
|
|
## License
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
- Copyright (c) 2014-2015, Fedor Indutny (MIT License).
|
|
|
|
|
- Copyright (c) 2014-2017, Christopher Jeffrey (MIT License).
|
2014-04-28 17:12:26 +04:00
|
|
|
|
2016-08-26 05:37:36 -07:00
|
|
|
See LICENSE for more info.
|
2014-05-26 09:43:40 -05:00
|
|
|
|
2017-02-10 09:39:44 -08:00
|
|
|
[purse]: https://purse.io
|
2017-07-23 08:24:52 -07:00
|
|
|
[guide]: https://github.com/bcoin-org/bcoin/blob/master/docs/Beginner's-Guide.md
|
2017-05-12 15:52:03 -07:00
|
|
|
[freenode]: https://freenode.net/
|
2017-01-07 22:43:08 -08:00
|
|
|
[irc]: irc://irc.freenode.net/bcoin
|
2017-07-23 08:24:52 -07:00
|
|
|
[changelog]: https://github.com/bcoin-org/bcoin/blob/master/CHANGELOG.md
|