bitcore-node-zcash/README.md

66 lines
3.0 KiB
Markdown
Raw Permalink Normal View History

2015-07-31 08:40:15 -07:00
Bitcore Node
============
2014-08-12 12:03:04 -07:00
2016-07-05 07:12:44 -07:00
A Bitcoin full node for building applications and services with Node.js. A node is extensible and can be configured to run additional services. At the minimum a node has an interface to [Bitcoin Core with additional indexing](https://github.com/bitpay/bitcoin/tree/0.12.1-bitcore) for more advanced address queries. Additional services can be enabled to make a node more useful such as exposing new APIs, running a block explorer and wallet service.
2014-08-20 14:51:07 -07:00
## Install
```bash
npm install -g bitcore-node
bitcore-node start
```
2016-07-05 07:12:44 -07:00
Note: For your convenience, we distribute bitcoind binaries for x86_64 Linux and x86_64 Mac OS X. Upon npm install, the binaries for your platform will be downloaded. For more detailed installation instructions, or if you want to compile the project yourself, then please see the Bitcore branch of [Bitcoin Core with additional indexing](https://github.com/bitpay/bitcoin/tree/0.12.1-bitcore).
2015-09-30 13:41:46 -07:00
## Prerequisites
2016-05-09 13:41:06 -07:00
- GNU/Linux x86_32/x86_64, or OSX 64bit *(for bitcoind distributed binaries)*
- Node.js v0.10, v0.12 or v4
- ZeroMQ *(libzmq3-dev for Ubuntu/Debian or zeromq on OSX)*
2016-05-09 11:23:53 -07:00
- ~200GB of disk storage
2016-05-31 09:58:31 -07:00
- ~8GB of RAM
2015-09-30 13:41:46 -07:00
## Configuration
2015-10-16 21:56:29 -07:00
Bitcore includes a Command Line Interface (CLI) for managing, configuring and interfacing with your Bitcore Node.
```bash
bitcore-node create -d <bitcoin-data-dir> mynode
cd mynode
2015-10-20 14:09:28 -07:00
bitcore-node install <service>
bitcore-node install https://github.com/yourname/helloworld
```
This will create a directory with configuration files for your node and install the necessary dependencies. For more information about (and developing) services, please see the [Service Documentation](docs/services.md).
2015-09-22 08:38:14 -07:00
## Add-on Services
2015-10-16 21:56:29 -07:00
There are several add-on services available to extend the functionality of Bitcore:
2015-09-22 08:38:14 -07:00
2016-07-01 06:53:08 -07:00
- [Insight API](https://github.com/bitpay/insight-api)
- [Insight UI](https://github.com/bitpay/insight-ui)
2015-10-16 21:56:29 -07:00
- [Bitcore Wallet Service](https://github.com/bitpay/bitcore-wallet-service)
2015-09-22 08:38:14 -07:00
## Documentation
2015-07-23 13:52:22 -07:00
- [Upgrade Notes](docs/upgrade.md)
- [Services](docs/services.md)
- [Bitcoind](docs/services/bitcoind.md) - Interface to Bitcoin Core
2015-09-10 08:56:16 -07:00
- [Web](docs/services/web.md) - Creates an express application over which services can expose their web/API content
2016-04-18 12:27:12 -07:00
- [Development Environment](docs/development.md) - Guide for setting up a development environment
- [Node](docs/node.md) - Details on the node constructor
- [Bus](docs/bus.md) - Overview of the event bus constructor
- [Release Process](docs/release.md) - Information about verifying a release and the release process.
2015-07-23 13:52:22 -07:00
## Contributing
Please send pull requests for bug fixes, code optimization, and ideas for improvement. For more information on how to contribute, please refer to our [CONTRIBUTING](https://github.com/bitpay/bitcore/blob/master/CONTRIBUTING.md) file.
2015-07-09 06:35:42 -07:00
## License
2014-08-12 12:03:04 -07:00
2015-07-31 08:40:15 -07:00
Code released under [the MIT license](https://github.com/bitpay/bitcore-node/blob/master/LICENSE).
2015-07-09 06:35:42 -07:00
Copyright 2013-2015 BitPay, Inc.
2014-08-12 12:03:04 -07:00
- bitcoin: Copyright (c) 2009-2015 Bitcoin Core Developers (MIT License)