A javascript Bitcoin library for node.js and browsers.

Find a file

Wei Lu c9ad359520 Merge pull request #196 from dcousens/intasync Integration tests running async causing wrong balance		2014-05-29 00:12:00 +08:00
src	ensures that pubKey length is greater than m	2014-05-28 01:48:17 -07:00
test	integration: use Script.getHash	2014-05-29 02:06:49 +10:00
.gitignore	cleanup runners, add coverage script, fix typo	2014-03-11 12:23:37 -07:00
.travis.yml	package.json: add support for continuous coverage reporting	2014-05-25 18:06:37 +10:00
LICENSE	Updated licensing information.	2011-12-20 12:47:50 +01:00
package.json	package.json: add support for continuous coverage reporting	2014-05-25 18:06:37 +10:00
README.md	README: improve feature list	2014-05-27 13:10:58 +10:00

README.md

bitcoinjs-lib

A pure JavaScript Bitcoin library for node.js and browsers. A continued implementation of the original 0.1.3 version used by over a million wallet users; and the backbone for almost all Bitcoin web wallets in production today.

Should I use this in production?

If you are thinking of using the master branch of this library in production, stop. Master is not stable; it is our development branch, and only tagged releases may be classified as stable.

Master is currently being heavily refactored to clean things up, add new functionality and merge improvements from the community. If you are looking for the original, it is tagged as 0.1.3. We are releasing quasi-stable releases tagged under 0.2.x, with the expectation that this is still beta software and is PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.

This is not the original bitcoinjs-lib that was not updated for a long time.

Features

Default's to the Bitcoin network, however testnet, Dogecoin and Litecoin are all supported natively.
HD Wallets.
Random private key generation that uses window.crypto.getRandomValues in the underlying implementation.
ECDSA signing and verification.
Standard transaction creation, with support for PubKeyHash, ScriptHash, MultiSig and PubKey scripts, and
A (somewhat incomplete) wallet implementation, with improvements ongoing.

Installation

npm install bitcoinjs-lib

Note: The npm version is currently out of date, are working to resolve this. The best way to use the latest code is to clone the repository.

Setup

Node.js

var bitcoin = require('bitcoinjs-lib')

From the repo:

var bitcoin = require('./src/index.js')

Browser

Compile bitcoinjs-min.js with the following command:

$ npm run-script compile

After loading this file in your browser, you will be able to use the global Bitcoin object.

Usage

These examples assume you are running bitcoinjs-lib in the browser.

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)

Projects utilizing bitcoinjs-lib

Feel free to send pull requests to have your project/startup listed here.

Contributing

Instructions

Fork the repo
Push changes to your fork
Create a pull request

Running the test suite

$ npm test

Alternatives

License

This library is free and open-source software released under the MIT license.

README.md Unescape Escape