pochette 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 32a5e22b912d750c86f5ce857e8fd6c13e0be105
-  data.tar.gz: b4b5176cfaabc855f88c692d17f721699ff4dc68
+  metadata.gz: c505a9f75cdfc003b454e87cd97c48f8fc11aeb7
+  data.tar.gz: 9e6c94633014b5d0f1ab9328dd1d9f0edea20ca1
 SHA512:
-  metadata.gz: a9e1050c5b93cf85eea51bbcfb3e16468a6331c5ff49b1e5d4ef9c9bdd9bfe1bc5a3fedcc0c98db244eec3121fe63a7de1a1ca6801fbe083935edf2f4fd0c7b1
-  data.tar.gz: 9d806da72bafad0279da22e85e3375a36957a8d667cb994361cfb1071eee80cabd0d46d1740b6313b7ca4955529838372415c872b4ea3e5541f2e5cddad3e414
+  metadata.gz: ba821bb23b235bb6ca4b9a2249c6ca6a3844665bcfe1a967e16066da4976e37d1cf01ce7e7004cc83c522fc84359d0a419e14a352264c1a4a5aa570a8b3b55cf
+  data.tar.gz: 2b312820cb91d983c0638473d957a13b4f45fe99044aa4361eede24d61d1ec638b2da51fcc4243e1f8c9d13a2d96107e0f687e0a9a9a8ea6869e76ab348f3f3e

data/README.md

@@ -8,14 +8,38 @@ bitcoin deposits to preparing transactions with bip32 paths instead of input add
 ready to be signed with a [Trezor Device](https://www.bitcointrezor.com/)
 
 Pochette offers a common interface to full bitcoin nodes like
-[Bitcoin Core](https://bitcoin.org/en/download) or [Toshi](http://toshi.io)
+[Bitcoin Core](https://bitcoin.org/en/download)
+[Blockchain.info](https://blockchain.info/api) or [Toshi](http://toshi.io)
 and will let you run several instances of each one of them simultaneously
-always choosing the most recent node to query.
+always choosing the most recent node to query. 
 
 It also provides a Pochette::TransactionBuilder class which receives a list
-of 'source' addresses and a list of recipients as "address/amount" pairs.
-
-## Installation
+of 'source' addresses and a list of recipients as "address/amount" pairs and
+uses them to select unspent outputs and build a raw transaction to be signed
+and broadcasted.
+
+The Pochette::TrezorTransactionBuilder class extends Pochette::TransactionBuilder
+including transactions, inputs and outputs that are formatted in a way they can
+be passed directly to a Trezor device for signing.
+
+## Table of contents
+- [Installation and Setup](#installation-and-setup)
+- [Pochette::TransactionBuilder](#the-pochettetransactionbuilder)
+- [Pochette::TrezorTransactionBuilder](#the-pochettetrezortransactionbuilder)
+- [Backend API](#backend-api)
+  - [incoming_for(addresses, min_date)](#incoming_foraddresses-min_date)
+  - [balances_for(addresses, confirmations)](#balances_foraddresses-confirmations)
+  - [list_unspent(addresses)](#list_unspentaddresses)
+  - [list_transactions(txids)](#list_transactionstxids)
+  - [block_height](#block_height)
+  - [pushtx(hex)](#pushtxhex)
+- Supported Backends
+  - [BitcoinCore Backend](#bitcoincore-backend)
+  - [BlockchainInfo Backend](#blockchaininfo-backend)
+  - [Toshi Backend](#toshi-backend)
+  - [Trendy Backend](#trendy-backend)
+
+## Installation and Setup
 
 Add this line to your application's Gemfile:
 
@@ -31,55 +55,522 @@ Or install it yourself as:
 
     $ gem install pochette
 
+You will probably want to setup Pochette with a global default backend,
+the backend can also be configured separately for each instance of
+a Pochette::TransactionBuilder
+
+```ruby
+>>> Pochette.backend = Pochette::Backends::BlockchainInfo.new
+>>> Pochette::TransactionBuilder.backend = Pochette::Backends::BlockchainInfo.new
+>>> Pochette::TrezorTransactionBuilder.backend = Pochette::Backends::BlockchainInfo.new
+```
+
+Pochette can also be configured to use the bitcoin testnet, this will change
+the default network used by the Bitcoin gem and may alter the way backends work too.
+
+```ruby
+>>> Pochette.testnet = true
+```
+
 ## The Pochette::TransactionBuilder
 
 The TransactionBuilder builds transactions from a list of source addresses and a list of recipients,
-using Pochette.backend to fetch unspent outputs and related transaction data.
+using a configured backend to fetch unspent outputs and related transaction data.
 Instantiating will perform all the required queries, you'll be left with a
 TransactionBuilder object that is either valid? or not, and if valid,
 you can query the results via to_hash.
 
+#### Receives
 The TransactionBuilder's initializer receives a single options hash with:
-  addresses:
-    List of addresses in wallet.
-    We will be spending their unspent outputs.
-  outputs:
-    List of pairs [recipient_address, amount]
-    This will not be all the final outputs in the transaction,
-    as a 'change' output may be added if needed.
-  utxo_blacklist:
-    List of utxos to ignore, a list of pairs [transaction hash, position]
-  change_address:
-    Change address to use. Will default to the first source address.
-  fee_per_kb:
-    Defaults to 10000 satoshis.
-  spend_all:
-    Wether to spend all available utxos or just select enough to
-    cover the given outputs.
-
-TODO: Document as_hash output.
-
-## Building for Trezor with Pochette::TrezorTransactionBuilder
-
-Same as TransactionBuilder but outputs a transaction hash with all the
-required data to create and sign a transaction using a BitcoinTrezor.
-
-* Uses BIP32 addresses instead of regular strings.
+
+<dl>
+<dt>addresses:</dt>
+<dd>
+  List of addresses in wallet.
+  We will be spending their unspent outputs.
+</dd>
+<dt>outputs:</dt>
+<dd>
+  List of pairs [recipient_address, amount]
+  This will not be all the final outputs in the transaction,
+  as a 'change' output may be adted if needed.
+</dd>
+<dt>utxo_blacklist:</dt>
+<dd>
+  Optional. List of utxos to ignore, a list of pairs [transaction hash, position]
+</dd>
+<dt>change_address:</dt>
+<dd>
+  Optional. Change address to use. Will default to the first source address.
+</dd>
+<dt>fee_per_kb:</dt>
+<dd>
+  Optional. Defaults to 10000 satoshis.
+</dd>
+<dt>spend_all:</dt>
+<dd>
+  Optional. Boolean. Wether to spend all available utxos or just select enough to
+  cover the given outputs.
+</dd>
+</dl>
+
+#### Returns
+
+A hash with
+
+<dl>
+<dt>input_total:</dt>
+<dd>The sum of all input amounts, in satoshis.</dd>
+<dt>output_total:</dt>
+<dd>The sum of all outputs, in satoshis.</dd>
+<dt>fee:</dt>
+<dd>fee to pay (input_total - output_total).</dd>
+<dt>outputs:</dt>
+<dd>Array of [destination address, amount in satoshis]</dd>
+<dt>inputs:</dt>
+<dd>Array of [input address, utxo transaction hash, utxo position, amount]</dd>
+<dt>utxos_to_blacklist:</dt>
+<dd>
+  Transaction inputs formatted to be used as utxo_blacklist on another
+  TransactionBuilder.
+</dd>
+</dl>
+
+
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> transaction = Pochette::TransactionBuilder.new({
+      addresses: ["2NAHscN6XVqUPzBSJHC3fhkeF5SQVxiR9p9"],
+      outputs: [
+        ["mvtUvWSWCU7knrcMVzjcKJgjL1LdekLK5q", 1_0000_0000],
+      ],
+      utxo_blacklist: [
+        ["0ded7f014fa3213e9b000bc81b8151bc6f2f926b9afea6e3643c8ad658353c72", 1]
+      ],
+      change_address: 'mgaTEUM4ZE9kLiK58FcffwHfvxpte5CfvE',
+      fee_per_kb: 10000,
+      spend_all: false,
+      backend: backend
+    })
+>>> transaction.valid?
+=> true
+>>> transaction.as_hash
+=> {
+    input_total: 2_0000_0000,
+    output_total: 1_9999_0000,
+    fee: 10000,
+    outputs: [
+      ["mvtUvWSWCU7knrcMVzjcKJgjL1LdekLK5q", 1_0000_0000],
+      ["mgaTEUM4ZE9kLiK58FcffwHfvxpte5CfvE", 9999_0000],
+    ],
+    inputs: [
+      [ "2NAHscN6XVqUPzBSJHC3fhkeF5SQVxiR9p9",
+        "956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40",
+        1,
+        200000000
+      ],
+    ],
+    utxos_to_blacklist: [
+      ["956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40", 1]
+    ],
+   }
+```
+
+## The Pochette::TrezorTransactionBuilder
+
+Builds a transaction like TransactionBuilder but includes transaction data
+and formats inputs and outputs in a way that can be sent directly to your trezor
+device.
+If you're using [Trezor Connect](https://github.com/trezor/connect) for signing
+then you won't need to pass in the transactions.
+
+#### Receives
+The TransactionBuilder's initializer receives a single options hash with:
+
+<dl>
+<dt>addresses:</dt>
+<dd>
+  List of addresses in wallet. We will be spending their unspent outputs.
   Each address is represented as a pair, with the public address string
   and the BIP32 path as a list of integers, for example:
   ['public-address-as-string', [44, 1, 3, 11]]
-
-* Includes associated transaction data for each input being spent,
-  ready to be consumed by your Trezor device.
-
-* Outputs are represented as JSON with script_type as expected by Trezor.
+</dd>
+<dt>outputs:</dt>
+<dd>
+  List of pairs [recipient_address, amount]
+  This will not be all the final outputs in the transaction,
+  as a 'change' output may be adted if needed.
+</dd>
+<dt>utxo_blacklist:</dt>
+<dd>
+  Optional. List of utxos to ignore, a list of pairs [transaction hash, position]
+</dd>
+<dt>change_address:</dt>
+<dd>
+  Optional. Change address to use. Will default to the first source address.
+</dd>
+<dt>fee_per_kb:</dt>
+<dd>
+  Optional. Defaults to 10000 satoshis.
+</dd>
+<dt>spend_all:</dt>
+<dd>
+  Optional. Boolean. Wether to spend all available utxos or just select enough to
+  cover the given outputs.
+</dd>
+</dl>
+
+#### Returns
+
+A hash with
+
+<dl>
+<dt>input_total:</dt>
+<dd>The sum of all input amounts, in satoshis.</dd>
+<dt>output_total:</dt>
+<dd>The sum of all outputs, in satoshis.</dd>
+<dt>fee:</dt>
+<dd>fee to pay (input_total - output_total).</dd>
+<dt>outputs:</dt>
+<dd>Array of [destination address, amount in satoshis]</dd>
+<dt>inputs:</dt>
+<dd>Array of [input address, utxo transaction hash, utxo position, amount]</dd>
+<dt>utxos_to_blacklist:</dt>
+<dd>
+  Transaction inputs formatted to be used as utxo_blacklist on another
+  TransactionBuilder.
+</dd>
+<dt>transactions:</dt>
+<dd>Transaction data for each input.</dd>
+<dt>trezor_inputs:</dt>
+<dd>
+  List of inputs as hashes with bip32 paths instead of addresses
+  { address_n: [42,1,1],
+    prev_hash: "956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40",
+    prev_index: 1}
+</dd>
+<dt>trezor_outputs:</dt>
+<dd>
+  List of outputs as Hashes with:
   { script_type: 'PAYTOADDRESS',
     address: '1address-as-string',
-    amount: amount_in_satoshis }
+    amount: amount in satoshis }
+</dd>
+</dl>
 
-TODO: Document as_hash output.
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> transaction = Pochette::TransactionBuilder.new({
+      addresses: [
+        ["2NAHscN6XVqUPzBSJHC3fhkeF5SQVxiR9p9", [44, 1, 3, 11]]
+      ],
+      outputs: [
+        ["mvtUvWSWCU7knrcMVzjcKJgjL1LdekLK5q", 1_0000_0000],
+      ],
+      utxo_blacklist: [
+        ["0ded7f014fa3213e9b000bc81b8151bc6f2f926b9afea6e3643c8ad658353c72", 1]
+      ],
+      change_address: 'mgaTEUM4ZE9kLiK58FcffwHfvxpte5CfvE',
+      fee_per_kb: 10000,
+      spend_all: false
+    })
+>>> transaction.valid?
+=> true
+>>> transaction.as_hash
+=> {
+    input_total: 2_0000_0000,
+    output_total: 1_9999_0000,
+    fee: 10000,
+    outputs: [
+      ["mvtUvWSWCU7knrcMVzjcKJgjL1LdekLK5q", 1_0000_0000],
+      ["mgaTEUM4ZE9kLiK58FcffwHfvxpte5CfvE", 9999_0000],
+    ],
+    trezor_outputs: [
+      { script_type: 'PAYTOADDRESS',
+        address: "mvtUvWSWCU7knrcMVzjcKJgjL1LdekLK5q",
+        amount: 1_0000_0000 },
+      { script_type: 'PAYTOADDRESS',
+        address: "mgaTEUM4ZE9kLiK58FcffwHfvxpte5CfvE",
+        amount: 9999_0000 },
+    ],
+    inputs: [
+      [ "2NAHscN6XVqUPzBSJHC3fhkeF5SQVxiR9p9",
+        "956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40",
+        1,
+        200000000
+      ],
+    ],
+    trezor_inputs: [
+      { address_n: [43,1,3,11],
+        prev_hash: "956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40",
+        prev_index: 1 },
+    ],
+    transactions: [
+      { hash: "956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40",
+        version: "1",
+        lock_time: "0",
+        inputs: [
+          { prev_hash: "158d6bbe586b4e00347f992e8296532d69f902d0ead32d964b6c87d4f8f0d3ea",
+            prev_index: 0,
+            sequence: 4294967295,
+            script_sig: "SCRIPTSCRIPTSCRIPT"
+          }
+        ],
+        bin_outputs: [
+          { amount: 1234568, script_pubkey: "76a914988cb8253f4e28be6e8bfded1b4aa11c646e1a8588ac" },
+          { amount: 200000000, script_pubkey: "76a914988cb8253f4e28be6e8bfded1b4aa11c646e1a8588ac"}
+        ]
+      }
+    ],
+    utxos_to_blacklist: [
+      ["956b30c3c4335f019dbee60c60d76994319473acac356f774c7858cd5c968e40", 1]
+    ],
+   }
+```
+
+## Backend API
+
+Pochette offers a common interface to full bitcoin nodes like
+[Bitcoin Core](https://bitcoin.org/en/download)
+[Blockchain.info](https://blockchain.info/api) or [Toshi](http://toshi.io)
+and will let you run several instances of each one of them simultaneously
+always choosing the most recent node to query. 
+
+## incoming_for(addresses, min_date)
+
+The incoming_for method is useful when registering deposits received to
+a number of bitcoin addresses.
+
+#### Receives
+- addresses: A list of public bitcoin addresses to check for incoming transactions.
+- min_date: Do not check for deposits earlier than this date. This is only to prevent
+    fetching too many results if the backend was to return too many,
+    each backend may apply its own limits so higher value here is not guaranteed to
+    fetch more results.
+
+#### Returns
+  A list with
+
+- Amount received, in satoshis.
+- Address which received the deposit.
+- Transaction hash for the deposit.
+- Confirmations for the transaction. 
+- Position of this deposit in the transaction outputs list.
+- Senders, as a comma-separated list of addresses (no whitespaces)
+
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> addresses = [
+      'mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L', 
+      'mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP',
+      'mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg',
+      'mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr',
+      'mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9',
+      'mhLAgRz5f1YogfYBZCDFSRt3ceeKBPVEKg',
+    ]
+>>> Pochette.backend.incoming_for(addresses, 1.day.ago) 
+=> [
+    [ 500000, "mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L",
+      "fb401691795a73e0160252c00af18327a15006fcdf877ccca0c116809669032e", 1629, 0,
+      "my2hmDuD9XjmtQWFu9HyyNAsE5WGSDBKpQ"],
+    [100000, "mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr",
+      "250978b77fe1310d6c72239d9e9589d7ac3dc6edf1b2412806ace5104553da34", 1648, 1,
+      "mv9ES7SmQQQ8dpMravBKsLWukgxU2DXfFs"],
+    [500000, "mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg",
+      "d9afd460b0a5e065fdd87bf97cb1843a29ea588c59daabd1609794e8166bb75f", 1648, 0,
+      "my2hmDuD9XjmtQWFu9HyyNAsE5WGSDBKpQ"],
+    [ 100000, "mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr",
+      "5bd72a4aa7818f47ac8943e3e17519be00c46530760860e608d898d728b9d46e", 553, 1,
+      "mvUhgW1ZcUju181bvwEhmZu2x2sRdbV4y2"],
+    [ 500000, "mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP",
+      "b252037526ecb616ab5901552abb903f00bf73400a1fc49b5b5bd699b84bce77", 1632, 0,
+      "my2hmDuD9XjmtQWFu9HyyNAsE5WGSDBKpQ"],
+    [ 500000, "mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9",
+      "ff768084764a05d1de72628432c0a4419538b2786089ec8ad009f6096bc69fe1", 1660, 0,
+      "my2hmDuD9XjmtQWFu9HyyNAsE5WGSDBKpQ"]
+   ]
+```
+
+## balances_for(addresses, confirmations)
+
+Gets confirmed and unconfirmed sent, received and total balances for the given
+addresses. It's useful for payment processing as you can see what's the total
+amount seen on the network for a given address, and the final confirmed amount as well.
+
+#### Receives
+  - addresses: A list of public bitcoin addresses to check balances for.
+  - confirmations: How many confirmations to use for the 'confirmed' amounts.
+
+#### Returns
+  A hash where keys are public addresses and values ara a list of
+  
+  - Confirmed received
+  - Confirmed sent
+  - Confirmed balance
+  - Unconfirmed received
+  - Unconfirmed sent
+  - Unconfirmed balance
+
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> addresses = [
+      'mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L', 
+      'mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP',
+      'mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg',
+      'mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr',
+      'mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9',
+      'mhLAgRz5f1YogfYBZCDFSRt3ceeKBPVEKg',
+    ]
+>>> backend.balances_for(addresses, 6) 
+>>> [
+"mhLAgRz5f1YogfYBZCDFSRt3ceeKBPVEKg" =>
+  [0.00544426, 0.00544426, 0.0, 0.00544426, 0.00544426, 0.0],
+"mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L" =>
+  [0.005, 0.0, 0.005, 0.006, 0.0, 0.006],
+"mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg" =>
+  [0.005, 0.0, 0.005, 0.005, 0.0, 0.005],
+"mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP" =>
+  [0.005, 0.0, 0.005, 0.005, 0.0, 0.005],
+"mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr" =>
+  [0.002, 0.0, 0.002, 0.002, 0.0, 0.002],
+"mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9" =>
+  [0.005, 0.0, 0.005, 0.005, 0.0, 0.005],
+```
 
-## Using a Bitcoin-Core backend.
+## list_unspent(addresses)
+
+Gets unspent transaction outputs (a.k.a. utxos) for all the given addresses.
+You may not need to use this directly, but rather through a
+Pochette::TransactionBuilder which is smart about selecting utxos.
+
+#### Receives
+  - addresses: A list of public bitcoin addresses to check balances for.
+
+#### Returns
+  A list of list, each of them is
+  
+  - Address
+  - Transaction Hash
+  - Output position in transaction
+  - Unspent amount
+
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> addresses = [
+      'mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L', 
+      'mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP',
+      'mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg',
+      'mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr',
+      'mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9',
+      'mhLAgRz5f1YogfYBZCDFSRt3ceeKBPVEKg',
+    ]
+>>> backend.list_unspent(addresses).should == [
+  ["mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L",
+  "fb401691795a73e0160252c00af18327a15006fcdf877ccca0c116809669032e", 0, 500000],
+  ["mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr",
+  "250978b77fe1310d6c72239d9e9589d7ac3dc6edf1b2412806ace5104553da34", 1, 100000],
+  ["mvrDG7Ts6Mq9ejhZxdsQLjbScycVaktqsg",
+  "d9afd460b0a5e065fdd87bf97cb1843a29ea588c59daabd1609794e8166bb75f", 0, 500000],
+  ["mxYzRdJfPk8PcaKSsSzNkX85mMfNcr2CGr",
+  "5bd72a4aa7818f47ac8943e3e17519be00c46530760860e608d898d728b9d46e", 1, 100000],
+  ["mwZE4QfzzriE7nsgHSWbgmtT7s6SDysYvP",
+  "b252037526ecb616ab5901552abb903f00bf73400a1fc49b5b5bd699b84bce77", 0, 500000],
+  ["mjfa56Keq7PXRKgdPSDB6eWLp4aaAVcj6L",
+  "9142d7a8e96124a36db9708dd21afa4ac81f15a77bd85c06f16e808a4d700da2", 1, 100000],
+  ["mzbXim4u1Nq4J2kVggu471pZL3ahxNkmE9",
+  "ff768084764a05d1de72628432c0a4419538b2786089ec8ad009f6096bc69fe1", 0, 500000]
+]
+```
+
+## list_transactions(txids)
+
+List full transaction data for the given transaction hashes. The output 
+is formatted for Trezor as required by their multi-step signature process.
+You may not want to use this directly and use Pochette::TrezorTransactionBuilder
+instead.
+
+#### Receives
+  - Transactions: A list of Transaction ids
+
+#### Returns
+  A list of ruby hashes will transaction data for each id passed.
+
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> transactions = [
+      "fb401691795a73e0160252c00af18327a15006fcdf877ccca0c116809669032e",
+      "250978b77fe1310d6c72239d9e9589d7ac3dc6edf1b2412806ace5104553da34",
+    ]
+>>> backend.list_transactions(transactions)
+=> [{ hash: "fb401691795a73e0160252c00af18327a15006fcdf877ccca0c116809669032e",
+      version: 1,
+      lock_time: 0,
+      inputs: [
+        { prev_hash: "f948600a52719ec63947bd47105411c2cb032bda91b08b25bb7b1de22f1f7458",
+          prev_index: 1,
+          sequence: 4294967295,
+          script_sig: "483045022100898b773c1cf095d5c1608a892673ad067387663e00327e7b88dd48cc4eb9cf2a02203a53336afd4440ea52c6a55e07ac60035dc386cb01b5b6810efac018f0346fad01210316cff587a01a2736d5e12e53551b18d73780b83c3bfb4fcf209c869b11b6415e"
+        }
+      ],
+      bin_outputs: [
+        { amount: 500000, script_pubkey: "76a9142d81b210deb7e22475cd7f2fda0bf582dddc9da788ac" },
+        { amount: 276607256, script_pubkey: "76a914c01a7ca16b47be50cbdbc60724f701d52d75156688ac"}
+      ]
+    },
+    { hash: "250978b77fe1310d6c72239d9e9589d7ac3dc6edf1b2412806ace5104553da34",
+      version: 1,
+      lock_time: 0,
+      inputs: [
+        { prev_hash: "8505c663d0414b678827eed85ba9e7652e616c19ff1be871f6b083d5ed400a20",
+          prev_index: 0,
+          sequence: 4294967295,
+          script_sig: "47304402203ac7cb9afe1a14189b63807aff301ef6bb8507f6dc0471bcee5362282a8c3e38022012c3bfe9680f013735f0d6d012d6420383c0e3a1dbf010f97be9cc834a93d1f601210221af8672ff613d2ea198d8dadcc387a36ef47d7cba6f541221db61b96aa20149"
+        }
+      ],
+      bin_outputs: [
+        { amount: 999293000, script_pubkey: "76a91426beab63a5fb7b2103929e91b65f339a2c5b285088ac"},
+        { amount: 100000, script_pubkey: "76a914badcbfae4d83a52dc2c8f68605663adc9d4922a688ac"}
+      ]
+    }
+  ]
+```
+
+## block_height
+
+Get the latest block height for this backend. Always in the main branch.
+  
+```ruby
+>>> require 'pochette'
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> backend.get_height
+=> 376152
+```
+
+## pushtx
+
+Propagates a raw transaction to the network.
+
+#### Receives
+  - transaction: A raw transaction in hex format
+
+#### Returns
+  The transaction id (hash)
+  
+```ruby
+>>> require 'pochette'
+>>> hex = "0100000001d11a6cc978fc41aaf5b24fc5c8ddde71fb91ffdba9579cd62ba20fc284b2446c000000008a47304402206d2f98829a9e5017ade2c084a8b821625c35aeaa633f718b1c348906afbe68b00220094cb8ee519adcebe866e655532abab818aa921144bd98a12491481931d2383a014104e318459c24b89c0928cec3c9c7842ae749dcca78673149179af9155c80f3763642989df3ffe34ab205d02e2efd07e9a34db2f00ed8b821dd5bb087ff64df2c9effffffff0280f0fa02000000001976a9149b754a70b9a3dbb64f65db01d164ef51101c18d788ac40aeeb02000000001976a914aadf5d54eda13070d39af72eb5ce40b1d3b8282588ac00000000"
+>>> backend = Pochette::Backends::BlockchainInfo.new
+>>> backend.pushtx(hex)
+=> 'fb92420f73af6d25f5fab93435bc6b8ebfff3a07c02abd053f0923ae296fe380'
+```
+
+## BitcoinCore backend
 
 Pochette will connect to your bitcoin-core node via JSON-RPC, using the
 [bitcoin-rpc gem](https://github.com/bitex-la/bitcoin-rpc)
@@ -91,13 +582,41 @@ To properly use Pochette you need to be running your bitcoin node with setting t
 Also, if you're creating new addresses and want bitcoin-core to track them you'll want to import
 them using the bitcoin-rpc gem, like so:
 
-      >>> BitcoinRpc::Client.new('http://user:pass@your_server').importaddress('1PUBLICADDRESS', '', false)
+```ruby
+>>> BitcoinRpc::Client.new('http://user:pass@your_server').importaddress('1PUBLICADDRESS', '', false)
+```
 
 Setting up bitcoin-core as a backend can be done like this:
 
-      >>> Pochette.backend = Pochette::Backends::BitcoinCore.new('http://user:pass@your_server')
+```ruby
+>>> Pochette.backend = Pochette::Backends::BitcoinCore.new('http://user:pass@your_server')
+```
+
+## BlockchainInfo backend
+
+Pochette can use blockchain.info's public API to fetch unspent outputs,
+sleeping a bit after each request to prevent blockchain.info from banning your IP.
+This backend is probably the slowest one but also the one that's more convenient for
+testing and managing small wallets.
+
+This backend is not usable for testnet transactions, all queries will be done to the
+main network.
 
-## Using a Toshi backend.
+You can create a blockchain.info backend like this
+
+```ruby
+>>> Pochette::Backends::BlockchainInfo.new
+```
+
+The default cooldown time is 1 second after each request, but if you have a Blockchain.info
+API key you can configure your backend like so:
+
+```ruby
+>>> Pochette::Backends::BlockchainInfo.cooldown = 0.1 # Make the cooldown a tenth of a second
+>>> Pochette.backend = Pochette::Backends::BlockchainInfo.new("your_api_key")
+```
+
+## Toshi backend
 
 Pochette will connect to your Toshi node's postgres database directly.
 It's provided as a separate gem as it depends on the pg gem which needs local
@@ -105,7 +624,7 @@ postgres extensions to work. You may need to add some extra indexes to your post
 to speed things up when using Pochette.
 [See the gem readme](https://github.com/bitex-la/pochette-toshi) for more info.
 
-## Using the best of many available backends
+## Trendy Backend
 
 Pochette provides a higher level Backend Pochette::Backends::Trendy which chooses
 between a pool of available backends always using the one at the highest block height,
@@ -114,9 +633,11 @@ between a pool of available backends always using the one at the highest block h
 This is useful for automatic fallbacks and redundancy, you could also mix Toshi and Bitcoin-Core
 backends and use whatever looks more up to date.
 
-      >>> alpha = Pochette::Backends::BitcoinCore.new('http://user:pass@alpha_host')
-      >>> beta = Pochette::Backends::BitcoinCore.new('http://user:pass@beta_host')
-      >>> Pochette.backend = Pochette::Backends::Trendy.new([alpha, beta])
+```ruby
+>>> alpha = Pochette::Backends::BitcoinCore.new('http://user:pass@alpha_host')
+>>> beta = Pochette::Backends::BitcoinCore.new('http://user:pass@beta_host')
+>>> Pochette.backend = Pochette::Backends::Trendy.new([alpha, beta])
+```
 
 ## Development
 

data/lib/pochette.rb

@@ -6,12 +6,24 @@ require "bitcoin"
 
 module Pochette
   mattr_accessor :backend
+  
+  def self.testnet=(v)
+    @testnet = v
+    Bitcoin.network = v ? :testnet : :bitcoin
+  end
+  def self.testnet
+    @testnet
+  end
+  def self.testnet?
+    self.testnet
+  end
 
   module Backends
   end
 end
 
 require "pochette/backends/bitcoin_core"
+require "pochette/backends/blockchain_info"
 require "pochette/backends/trendy"
 require "pochette/transaction_builder"
 require "pochette/trezor_transaction_builder"

data/lib/pochette/backends/bitcoin_core.rb

@@ -102,4 +102,8 @@ class Pochette::Backends::BitcoinCore
   def block_height
     client.getinfo[:blocks]
   end
+
+  def pushtx(hex)
+    client.sendrawtransaction(hex)
+  end
 end

data/lib/pochette/backends/blockchain_info.rb

@@ -0,0 +1,111 @@
+# A bitcoin backend that uses blockchain.info to retrieve information.
+# See Pochette::Backends::Trendy to learn more about the backend
+# interface and contract.
+require 'open-uri'
+
+class Pochette::Backends::BlockchainInfo
+  cattr_accessor(:cooldown){1}
+  attr_accessor :api_key
+
+  def initialize(key = nil)
+    self.api_key = key
+  end
+
+  def list_unspent(addresses)
+    json = get_json("unspent", {active: addresses.join('|'), format: 'json'})
+    json['unspent_outputs'].collect do |utxo|
+      address = Bitcoin::Script.new(utxo['script'].htb).get_address
+      [address, utxo['tx_hash_big_endian'], utxo['tx_output_n'].to_i, utxo['value']]
+    end
+  end
+  
+  def balances_for(addresses, confirmations)
+    json = get_json("multiaddr", {active: addresses.join('|'), format: 'json'})
+    result = {}
+    json['addresses'].collect do |a|
+      address = a['address']
+      sent = get_json("q/getsentbyaddress/#{address}",
+        {confirmations: confirmations, format: 'json'})
+      received = get_json("q/getreceivedbyaddress/#{address}",
+        {confirmations: confirmations, format: 'json'})
+      result[address] = [
+        sat(received), sat(sent), sat(received - sent),
+        sat(a['total_received']), sat(a['total_sent']), sat(a['final_balance'])]
+    end
+    result
+  end
+
+  def sat(x)
+    x.to_d / 1_0000_0000
+  end
+  
+  def incoming_for(addresses, min_date)
+    return unless latest_block = block_height
+    addresses.in_groups_of(50, false).collect do |group|
+      incoming_for_helper(group, latest_block)
+    end.flatten(1)
+  end
+
+  def incoming_for_helper(addresses, latest_block)
+    json = get_json("multiaddr", {active: addresses.join('|'), format: 'json'})
+
+    json['txs'].collect do |transaction|
+      transaction['out'].collect do |out|
+        next unless addresses.include? out['addr']
+        confirmations = latest_block - transaction['block_height'].to_i
+        senders = transaction['inputs'].collect{ |i| i['prev_out']['addr'] }.join(',')
+        [ out['value'].to_d, out['addr'], transaction['hash'], confirmations, out['n'], senders ]
+      end.compact
+    end.flatten(1)
+  end
+
+  def list_transactions(txids)
+    return nil if txids.empty?
+    txids.collect do |txid|
+      tx = get_json("rawtx/#{txid}", {format: 'json'})
+      inputs = tx['inputs'].collect do |i|
+        prevhash = get_json("rawtx/#{i['prev_out']['tx_index']}", {format: 'json'})['hash']
+        { prev_hash: prevhash,
+          prev_index: i['prev_out']['n'],
+          sequence: i['sequence'],
+          script_sig: i['script']
+        }
+      end
+
+      outputs = tx['out'].collect do |o|
+        { amount: o['value'].to_i, script_pubkey: o['script'] }
+      end
+
+      { hash: tx['hash'], version: tx['ver'], lock_time: tx['lock_time'],
+        inputs: inputs, bin_outputs: outputs}
+    end
+  end
+
+  def block_height
+    get_json("latestblock", {format: 'json'})['height'].to_i
+  end
+
+  def pushtx(hex)
+    uri = URI.parse("https://blockchain.info/pushtx")
+    params = { "tx" => hex }
+    params['api_code'] = api_key if api_key
+    Net::HTTP.post_form(uri, params)
+    Bitcoin::Protocol::Tx.new(hex.htb).hash
+  end
+
+  def get_json(path, params={})
+    params['api_code'] = api_key if api_key
+    query = params.empty? ? '' : "?#{params.to_query}"
+    retries = 30
+    begin
+      raw_response = open("https://blockchain.info/#{path}#{query}").read
+      sleep cooldown
+      Oj.load(raw_response)
+    rescue OpenURI::HTTPError => e
+      raise if retries < 0 || e.message.to_i != 429
+      retries -= 1
+      sleep (cooldown * 5)
+      retry
+    end
+  end
+end

data/lib/pochette/backends/trendy.rb

@@ -42,6 +42,13 @@ class Pochette::Backends::Trendy
   # [[address, txid, position (vout), amount (in satoshis)], ...]
   def list_unspent(addresses)
     backend.list_unspent(addresses)
+  rescue OpenURI::HTTPError => e
+    # Blockchain.info returns 500 when there are no unspent outputs
+    if e.io.read == "No free outputs to spend"
+      return []
+    else
+      raise
+    end
   end
 
   # Gets information for the given transactions

data/lib/pochette/transaction_builder.rb

@@ -3,25 +3,13 @@
 # Instantiating will perform all the given queries, you'll be left with a
 # TransactionBuilder object that is either valid? or not, and if valid
 # you can query the results via to_hash.
-# Options:
-#   addresses:
-#     List of addresses in wallet.
-#     We will be spending their unspent outputs.
-#   outputs:
-#     List of pairs [recipient_address, amount]
-#     This will not be all the final outputs in the transaction,
-#     as a 'change' output may be added if needed.
-#   utxo_blacklist:
-#     List of utxos to ignore, a list of pairs [transaction hash, position]
-#   change_address:
-#     Change address to use. Will default to the first source address.
-#   fee_per_kb:
-#     Defaults to 10000 satoshis.
-#   spend_all:
-#     Wether to spend all available utxos or just select enough to
-#     cover the given outputs.
 
 class Pochette::TransactionBuilder
+  # Backend can be set globally, or independently for each class and instance.
+  class_attribute :backend
+  def self.backend
+    @backend || Pochette.backend
+  end
 
   cattr_accessor(:dust_size){ 546 }
   cattr_accessor(:output_size){ 149 }
@@ -30,6 +18,7 @@ class Pochette::TransactionBuilder
   cattr_accessor(:default_fee_per_kb){ 10000 }
 
   def initialize(options)
+    self.backend = options[:backend] if options[:backend]
     initialize_options(options)
     return unless valid?
     initialize_fee
@@ -42,10 +31,13 @@ class Pochette::TransactionBuilder
 
   def as_hash
     return nil unless valid?
-    { amount: inputs_amount,
+    { input_total: inputs_amount,
+      output_total: outputs_amount,
       fee: inputs_amount - outputs_amount,
       inputs: inputs,
-      outputs: outputs}
+      outputs: outputs,
+      utxos_to_blacklist: inputs.collect{|i| [i[1], i[2]] },
+    }
   end
 
   def valid?

data/lib/pochette/trezor_transaction_builder.rb

@@ -44,11 +44,10 @@ class Pochette::TrezorTransactionBuilder < Pochette::TransactionBuilder
 
   def as_hash
     return nil unless valid?
-    { amount: inputs_amount,
-      fee: inputs_amount - outputs_amount,
-      inputs: trezor_inputs,
-      outputs: trezor_outputs,
-      transactions: transactions}
+    super.merge(
+      trezor_inputs: trezor_inputs,
+      trezor_outputs: trezor_outputs,
+      transactions: transactions)
   end
 
 protected

data/lib/pochette/version.rb

@@ -1,3 +1,3 @@
 module Pochette
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

data/pochette.gemspec

@@ -29,4 +29,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "rspec", "~> 3"
   spec.add_development_dependency "webmock", "~> 1.21"
   spec.add_development_dependency "timecop", "~> 0.8.0"
+  spec.add_development_dependency "byebug"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pochette
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Nubis
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-22 00:00:00.000000000 Z
+date: 2015-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -123,6 +123,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: "Pochette is a Bitcoin Wallet backend offering a common\n    interface
   to several bitcoin nodes so you can build single purpose wallets.\n    You can pass
   in a bunch of addresses and outputs and it will select the\n    appropriate unspent
@@ -146,6 +160,7 @@ files:
 - bin/setup
 - lib/pochette.rb
 - lib/pochette/backends/bitcoin_core.rb
+- lib/pochette/backends/blockchain_info.rb
 - lib/pochette/backends/trendy.rb
 - lib/pochette/transaction_builder.rb
 - lib/pochette/trezor_transaction_builder.rb