A pure JavaScript Bitcoin library for node.js and browsers. Used in production by over 1.5 million wallet users, BitcoinJS is the backbone for almost all Bitcoin web wallets in production today.

BitcoinJS 1.0.0 has been released! Click here to read the announcement.

Features

• Clean - Pure JavaScript, concise code, easy to read.
• Tested - Coverage > 95%, third-party integration tests.
• Careful - Two person approval process for small, focused pull requests.
• Compatible - Works on Node.js and all modern browsers.
• Powerful - Support for advanced features, such as multi-sig, HD Wallets.
• Secure - Strong random number generation, PGP signed releases, trusted developers.
• Principled - No support for browsers with crap RNG (IE < 11)
• Standardized - Node community coding style, Browserify, Node's stdlib and Buffers.
• Fast - Optimized code, uses typed arrays instead of byte arrays for performance.
• Experiment-friendly - Bitcoin Mainnet and Testnet support.
• Altcoin-ready - Capable of working with bitcoin-derived currencies (such as Dogecoin).

Who's using BitcoinJS

• Hive Wallet *
• Blockchain.info
• Dark Wallet
• BitAddress
• GreenAddress
• Skyhook ATM *
• Dogechain Wallet
• Justcoin Exchange *
• Brainwallet
• Coinpunk *

* directly contributed code or funding to the project.

Who's not

• Your bank.

Get Started

Install via NPM

$ npm install -g bitcoinjs-lib

Compile for browser

$ npm -g install bitcoinjs-lib browserify uglify-js
$ browserify -r bitcoinjs-lib -s Bitcoin | uglifyjs > bitcoinjs.min.js

Examples

Generating a Bitcoin address:

key = Bitcoin.ECKey.makeRandom()

// Print your private key (in WIF format)
console.log(key.toWIF())
// => 8c112cf628362ecf4d482f68af2dbb50c8a2cb90d226215de925417aa9336a48

// Print your public key (toString defaults to a Bitcoin address)
console.log(key.pub.getAddress().toString())
// => 14bZ7YWde4KdRb5YN7GYkToz3EHVCvRxkF
        

Creating a Transaction

tx = new Bitcoin.Transaction()

// Add the input (who is paying) of the form [previous transaction hash, index of the output to use]
tx.addInput("aa94ab02c182214f090e99a0d57021caffd0f195a81c24602b1028b130b63e31", 0)

// Add the output (who to pay to) of the form [payee's address, amount in satoshis]
tx.addOutput("1Gokm82v6DmtwKEB8AiVhm82hyFSsEvBDK", 15000)

// Initialize a private key using WIF
key = Bitcoin.ECKey.fromWIF("L1uyy5qTuGrVXrmrsvHWHgVzW9kKdrp27wBC7Vs6nZDTF2BRUVwy")

// Sign the first input with the new key
tx.sign(0, key)

// Print transaction serialized as hex
console.log(tx.serializeHex())
// => 0100000001313eb630b128102b60241ca895f1d0ffca2170d5a0990e094f2182c102ab94aa000000008a47304402200169f1f844936dc60df54e812345f5dd3e6681fea52e33c25154ad9cc23a330402204381ed8e73d74a95b15f312f33d5a0072c7a12dd6c3294df6e8efbe4aff27426014104e75628573696aed32d7656fb35e9c71ea08eb6492837e13d2662b9a36821d0fff992692fd14d74fdec20fae29128ba12653249cbeef521fc5eba84dde0689f27ffffffff01983a0000000000001976a914ad618cf4333b3b248f9744e8e81db2964d0ae39788ac00000000

// You could now push the transaction onto the Bitcoin network manually (see https://blockchain.info/pushtx)
        

Documentation

Soon. For now, use the tests as a reference. They show what the code is supposed to do.

Contributors

Stefan Thomas is the inventor and creator of this project. His pioneering work made Bitcoin web wallets possible.

Since then, many developers have joined in to improve the library. Click here to see the full list.

Daniel Cousens, Wei Lu, JP Richardson and Kyle Drake lead the major refactor of the library from 0.1.3 to 1.0.0.

Contributing

We always welcome help on the library. If you want to help build (or fix bugs), fork the repository, create a topic branch (keep it focused, and ADD TESTS), make the change, commit to your forked repo, and send a pull request.