Go to file
Braydon Fuller 1b93d49f21 Include Bitcoin Core in License 2015-07-02 10:23:28 -04:00
benchmark Benchmarks for block serialization & 4x performance improvement. 2015-06-24 21:19:34 -04:00
docs add Transaction#clearOutputs 2015-05-15 15:29:05 -03:00
lib fix signature hasDefinedHashtype method to be closer to the Bitcoin Core function IsDefinedHashtypeSignature 2015-07-01 07:11:08 -04:00
test fix signature hasDefinedHashtype method to be closer to the Bitcoin Core function IsDefinedHashtypeSignature 2015-07-01 07:11:08 -04:00
.coveralls.yml Update coveralls token 2015-02-12 11:46:21 -03:00
.gitignore ignore browser build signatures 2015-02-18 15:06:08 -03:00
.jsdoc.conf polish README 2014-12-22 18:03:27 -03:00
.jshintrc Fixed issue with handling invalid output scripts 2015-05-14 01:50:14 -04:00
.travis.yml multiple versions of node 2015-05-28 09:50:22 -04:00
.zuul.yml set specific zuul platforms 2015-01-08 12:13:30 -03:00
CONTRIBUTING.md Clarify what is meant by CamelCase 2015-02-19 16:01:11 -07:00
LICENSE Include Bitcoin Core in License 2015-07-02 10:23:28 -04:00
README.md Update readme maintainers. 2015-05-26 13:04:21 -04:00
bower.json Bump package version to 0.12.11 2015-07-01 14:54:48 -04:00
gulpfile.js Fix package.json by replacing gulp-bitcore with bitcore-build 2015-01-16 11:59:22 -05:00
index.js Simplify version guard 2015-05-18 15:00:45 -04:00
karma.conf.js use gulp-bitcore for gulp 2015-01-13 19:02:16 -03:00
npm-shrinkwrap.json Bump package version to 0.12.11 2015-07-01 14:54:48 -04:00
package.json Bump package version to 0.12.11 2015-07-01 14:54:48 -04:00

README.md

Bitcore

NPM Package Build Status Coverage Status

A pure and powerful JavaScript Bitcoin library.

Principles

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.

Get Started

npm install bitcore

Using it in Node.js:

var bitcore = require('bitcore');

assert(bitcore.Address.isValid('126vMmY1fyznpZiFTTnty3cm1Rw8wuheev'));
var simpleTx = new bitcore.Transaction();
var simpleTx.from(unspent).to(address, amount);
simpleTx.sign(privateKey);

Documentation

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

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

Examples

Modules

This module provides bitcoin's core features. Other features and protocol extensions are built into separate modules. Here is a list of official bitcore modules:

Module Version Building Coverage
bitcore-payment-protocol NPM Package Build Status Coverage Status
bitcore-p2p NPM Package Build Status Coverage Status
bitcore-mnemonic NPM Package Build Status Coverage Status
bitcore-ecies NPM Package Build Status Coverage Status
bitcore-channel NPM Package Build Status Coverage Status
bitcore-explorers NPM Package Build Status Coverage Status
bitcore-message NPM Package Build Status Coverage Status

Security

We're using Bitcore in production, as are many others, but please use common sense when doing anything related to finances! We take no responsibility for your implementation decisions.

If you find a security issue, please email security@bitpay.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 bitcore full bundle for the browser:

gulp browser

This will generate files named bitcore.js and bitcore.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, e33b6e3ba6 for v0.12.6).

To verify signatures, use the following PGP keys:

Tests

Run all the tests:

gulp test

You can also run just the NodeJS 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 2013-2015 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.