README.md

BitcoinCash.js: The simple, safe, and powerful JavaScript library for Bitcoin Cash

About Bitcoin Cash

Bitcoin Cash is peer-to-peer electronic cash for the Internet. It is fully decentralized, has no central bank, and requires no trusted third-parties to operate. Bitcoin Cash is the continuation of the Bitcoin project, upgraded with consensus rules that allow it to grow and scale.

About BitcoinCash.js

BitcoinCash.js is the first JavaScript library specifically made for Bitcoin Cash. It supports all major Bitcoin Cash uses cases right out of the box, keeping up-to-date with the latest network upgrades. This library can be used - and is thoroughly tested - both in the back-end (Node.js) and the front-end (web browsers).

BitcoinCash.js is a fork from bitcore-lib, which is an extremely easy-to-use and well-tested JavaScript library for Bitcoin developed by Bitpay, Inc. However, as consensus rules between BTC and BCH become more and more incompatible, BitcoinCash.js will not add support for functionality specific to BTC, such as SegWit or the bech32 address format, and will continue to support all Bitcoin Cash uses cases as first-class citizens.

Installation

Using NPM

$ npm install --save bitcoincashjs

Using Bower

$ bower install --save bitcoincashjs

Manually

You may also download the distribution file manually and place it within your third-party scripts directory: dist/bitcoincashjs.0.1.10.min.js.

Examples

You can find many useful, up-to-date examples to get you started right away on the BitcoinCash.js website or by following the next links:

• Generate a random address
• Generate a address from a SHA256 hash
• Translate an address to any Bitcoin Cash address format
• Read an address from any Bitcoin Cash address format
• Import an address via WIF
• Create a Transaction
• Verify a Bitcoin message
• Sign a Bitcoin message
• Create an OP RETURN transaction
• Create a 2-of-3 multisig P2SH address
• Spend from a 2-of-2 multisig P2SH address

Security

BitcoinCash.js is a fork from bitcore-lib, which is used in production at Bitpay Inc., and many other projects. If you find a security issue, please email [email protected].

Contributing

This is an open-source project, and any form of contribution is welcome. Feel free to create an issue in case you would like to share ideas for improvement, or would like to report a bug. Also, please send pull requests for bug fixes or code optimization. For more information on how to contribute, please refer to our CONTRIBUTING file.

Development

To get started with development, you should first clone the repository and install any dependencies:

$ git clone https://github.com/bitcoincashjs/bitcoincashjs
$ cd bitcoincashjs
$ npm install

Next, you can check everything is installed correctly by running the full test-suite and verifying that all tests are completed successfully.

$ npm test

License

Code released under the MIT license.