/bch-lib

Primary LanguageJavaScriptOtherNOASSERTION

Bch Lib

NPM Package Build Status Coverage Status

A pure and powerful JavaScript Bitcoin Cash library.

Attribution

This repository was created by copy forking btccore-lib 09b97ac.

Principles

Bitcoin Cash is an other powerful peer-to-peer platform for the next generation of financial technology. The decentralized nature of the Bitcoin Cash network allows for highly resilient bitcoin cash infrastructure, and the developer community needs reliable, open-source tools to implement bitcoin cash apps and services.

Bitcoin Cash vs. Bitcoin

Bitcoin Cash uses a different sighash for transaction signatures. The implementation in bitcore cash has been tested agains the original bitcoin cash test vectors (see sighash.json in /test). bitcoin cash modifications in script evaluation has not been implemented yet.

Get Started

npm install bch-lib
bower install bch-lib

Documentation

The complete docs are hosted here: bch documentation. There's also a bch API reference available generated from the JSDocs of the project, where you'll find low-level details on each bch utility.

To get community assistance and ask for help with implementation questions, please use our community forums.

Examples

Security

If you find a security issue, please email security@openwalletstack.com.

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 file.

Building the Browser Bundle

To build a bch-lib full bundle for the browser:

gulp browser

This will generate files named bch.js and bch.min.js.

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/owstack/bch-lib/commit/e33b6e3ba6a1e5830a079e02d949fce69ea33546 for v0.12.6).

To verify signatures, use the following PGP keys:

Development & Tests

git clone https://github.com/owstack/bch-lib
cd bch-lib
npm install

Run all the tests:

gulp test

You can also run just the Node.js tests with gulp test:node, just the browser tests with gulp test:browser or create a test coverage report (you can open coverage/lcov-report/index.html to visualize it) with gulp coverage.

License

Code released under the MIT license.

Copyright 2017 Open Wallet Stack.