bitcore-lib-zcash/README.md

97 lines
4.7 KiB
Markdown
Raw Permalink Normal View History

2015-10-15 12:53:03 -07:00
Bitcore Library
=======
2013-07-04 12:55:19 -07:00
2015-10-15 12:53:03 -07:00
[![NPM Package](https://img.shields.io/npm/v/bitcore-lib.svg?style=flat-square)](https://www.npmjs.org/package/bitcore-lib)
[![Build Status](https://img.shields.io/travis/bitpay/bitcore-lib.svg?branch=master&style=flat-square)](https://travis-ci.org/bitpay/bitcore-lib)
[![Coverage Status](https://img.shields.io/coveralls/bitpay/bitcore-lib.svg?style=flat-square)](https://coveralls.io/r/bitpay/bitcore-lib)
2014-04-08 12:10:52 -07:00
2014-12-23 11:33:42 -08:00
A pure and powerful JavaScript Bitcoin library.
2014-11-22 13:41:12 -08:00
## Principles
2014-12-23 11:33:42 -08:00
Bitcoin is a powerful new peer-to-peer platform for the next generation of financial technology. The decentralized nature of the Bitcoin network allows for highly resilient bitcoin infrastructure, and the developer community needs reliable, open-source tools to implement bitcoin apps and services.
2014-11-22 13:41:12 -08:00
## Get Started
2014-01-22 14:12:45 -08:00
```
2015-10-15 12:53:03 -07:00
npm install bitcore-lib
2014-01-22 14:12:45 -08:00
```
2015-10-15 12:53:03 -07:00
```
bower install bitcore-lib
```
2014-11-22 13:41:12 -08:00
## Documentation
2014-12-22 12:54:20 -08:00
The complete docs are hosted here: [bitcore documentation](http://bitcore.io/guide/). There's also a [bitcore API reference](http://bitcore.io/api/) available generated from the JSDocs of the project, where you'll find low-level details on each bitcore utility.
2015-05-26 10:01:20 -07:00
- [Read the Developer Guide](http://bitcore.io/guide/)
- [Read the API Reference](http://bitcore.io/api/)
To get community assistance and ask for help with implementation questions, please use our [community forums](https://forum.bitcore.io/).
2014-12-22 12:47:21 -08:00
2015-02-13 08:33:25 -08:00
## Examples
2015-10-15 12:53:03 -07:00
* [Generate a random address](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#generate-a-random-address)
* [Generate a address from a SHA256 hash](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#generate-a-address-from-a-sha256-hash)
* [Import an address via WIF](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#import-an-address-via-wif)
* [Create a Transaction](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#create-a-transaction)
* [Sign a Bitcoin message](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#sign-a-bitcoin-message)
* [Verify a Bitcoin message](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#verify-a-bitcoin-message)
* [Create an OP RETURN transaction](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#create-an-op-return-transaction)
* [Create a 2-of-3 multisig P2SH address](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#create-a-2-of-3-multisig-p2sh-address)
* [Spend from a 2-of-2 multisig P2SH address](https://github.com/bitpay/bitcore-lib/blob/master/docs/examples.md#spend-from-a-2-of-2-multisig-p2sh-address)
2015-01-21 11:59:56 -08:00
2014-11-22 13:41:12 -08:00
## Security
2014-12-22 12:42:45 -08:00
We're using Bitcore in production, as are [many others](http://bitcore.io#projects), but please use common sense when doing anything related to finances! We take no responsibility for your implementation decisions.
2014-01-22 14:12:45 -08:00
2014-12-22 12:42:45 -08:00
If you find a security issue, please email security@bitpay.com.
2014-01-22 14:12:45 -08:00
2014-11-22 13:41:12 -08: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-lib/blob/master/CONTRIBUTING.md) file.
2014-12-19 14:23:48 -08:00
## Building the Browser Bundle
2015-10-15 12:53:03 -07:00
To build a bitcore-lib full bundle for the browser:
2014-03-11 14:16:44 -07:00
2014-11-22 13:41:12 -08:00
```sh
gulp browser
2014-03-11 14:16:44 -07:00
```
2015-10-15 12:53:03 -07:00
This will generate files named `bitcore-lib.js` and `bitcore-lib.min.js`.
2015-10-15 12:53:03 -07:00
You can also use our pre-generated files, provided for each release along with a PGP signature by one of the project's maintainers. To get them, checkout a release commit (for example, https://github.com/bitpay/bitcore-lib/commit/e33b6e3ba6a1e5830a079e02d949fce69ea33546 for v0.12.6).
To verify signatures, use the following PGP keys:
2016-08-17 13:49:14 -07:00
- @braydonf: https://pgp.mit.edu/pks/lookup?op=get&search=0x9BBF07CAC07A276D `D909 EFE6 70B5 F6CC 89A3 607A 9BBF 07CA C07A 276D`
- @gabegattis: https://pgp.mit.edu/pks/lookup?op=get&search=0x441430987182732C `F3EA 8E28 29B4 EC93 88CB B0AA 4414 3098 7182 732C`
- @kleetus: https://pgp.mit.edu/pks/lookup?op=get&search=0x33195D27EF6BDB7F `F8B0 891C C459 C197 65C2 5043 3319 5D27 EF6B DB7F`
2016-08-17 14:14:48 -07:00
- @matiu: https://pgp.mit.edu/pks/lookup?op=get&search=0x9EDE6DE4DE531FAC `25CE ED88 A1B1 0CD1 12CD 4121 9EDE 6DE4 DE53 1FAC`
2016-08-17 13:49:14 -07:00
2015-06-16 09:50:49 -07:00
## Development & Tests
```sh
2015-10-15 12:53:03 -07:00
git clone https://github.com/bitpay/bitcore-lib
cd bitcore-lib
2015-06-16 09:50:49 -07:00
npm install
```
2014-11-22 13:41:12 -08:00
Run all the tests:
2014-03-11 14:16:44 -07:00
2014-11-22 13:41:12 -08:00
```sh
gulp test
2014-03-11 14:16:44 -07:00
```
You can also run just the Node.js tests with `gulp test:node`, just the browser tests with `gulp test:browser`
2015-02-18 11:00:18 -08:00
or create a test coverage report (you can open `coverage/lcov-report/index.html` to visualize it) with `gulp coverage`.
2014-11-22 13:41:12 -08:00
## License
2014-02-07 18:08:56 -08:00
2015-10-15 12:53:03 -07:00
Code released under [the MIT license](https://github.com/bitpay/bitcore-lib/blob/master/LICENSE).
2014-02-07 18:08:56 -08:00
2014-12-22 13:03:15 -08:00
Copyright 2013-2015 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.