bitcoin-transaction v1.2.1

bitcoin-transaction

The simpliest way to send bitcoins from one wallet to another using javascript. This library will hook into popular third party services such as blockchain.info and blockexplorer.com to do all the heavy lifting in sending a bitcoin transaction. Other libraries require you to parse 3rd party apis or run external software to send a transaction. This library is meant to be as simple as possible while still allowing for customization.

Designed to run on both NodeJS and in the browser.

Installation

npm install --save bitcoin-transaction

or for the browser

npm install -g browserify uglify-js
npm install bitcoin-transaction
browserify -r bitcoin-transaction -s bitcoinTransaction | uglifyjs > bitcoin-transaction.min.js

Usage

var bitcoinTransaction = require('bitcoin-transaction');

//Send all my money from wallet1 to wallet2 on the bitcoin testnet
var from = "mm3gdVh8n6YtcNyaTKYkveB6yTME7aDWNJ";
var to = "mgPUfqJk4X6gE4P5Do5RfpkTFsYmsSjCya";
var privKeyWIF = "cNZi8iySqBToXMpcsQaHKD5uv7HExBQJBSi4dTg3ZPaEzeNAzvbj";	//Private key in WIF form (Can generate this from bitcoinlib-js)

bitcoinTransaction.getBalance(from, { network: "testnet" }).then((balanceInBTC) => {
	return bitcoinTransaction.sendTransaction({
		from: from,
		to: to,
		privKeyWIF: privKeyWIF,
		btc: balanceInBTC,
		network: "testnet"
	});
});

API

bitcoinTransaction.providers

Advanced

Contains the services that provide low level functionality on the blockchain. Sensible defaults are set out of the box, but feel free to adjust these as you see fit. There are 4 provider types:

• balance - Retrieves the balance of a wallet.
• fees - Gets a list of current fees based on the BitCoin network going rate.
• utxo - Pull a list of unspent transaction outputs.
• pushtx - Push a raw transaction onto the blockchain.

Feel free to change the defaults by setting the default property on the provider. For example:

//Set the default main network balance provider to blockchain.info instead of blockexplorer.com
bitcoinTransaction.providers.balance.mainnet.default = bitcoinTransaction.providers.balance.mainnet.blockchain;

bitcoinTransaction.getBalance(address, options)

Returns a promise that yields the balance of the given address.

bitcoinTransaction.sendTransaction(options)

Returns a promise that pushes a live transaction on the BitCoin blockchain.