wallet.md

##info.blockchain.api.wallet package

The wallet package contains the Wallet class that reflects the functionality documented at at https://blockchain.info/api/blockchain_wallet_api. It allows users to directly interact with their existing Blockchain.info wallet, send funds, manage addresses etc.

Example usage:

package test;
import info.blockchain.api.wallet.*;

public class App 
{
    public static void main(String[] args) throws Exception
    {	
    	Wallet wallet = new Wallet("18d4cf81-fcec-4a94-aa93-202a25085c0e", "yourPassword123");
    	
    	// get an address from your wallet and include only transactions with up to 3
    	// confirmations in the balance
    	Address addr = wallet.getAddress("1JzSZFs2DQke2B3S4pBxaNaMzzVZaG4Cqh", 3);
    	System.out.println(String.format("The balance is %s", addr.getBalance()));
    	
    	// send 0.2 bitcoins with a custom fee of 0.01 BTC and a note
        // public notes require a minimum transaction size of 0.005 BTC
    	PaymentResponse payment = wallet.send("1dice6YgEVBf88erBFra9BHf6ZMoyvG88", 20000000L, null, 1000000L, "Amazon payment");
    	System.out.println(String.format("The payment TX hash is %s", payment.getTxHash()));
    	
    	long totalBalance = wallet.getBalance();
    	System.out.println(String.format("The total wallet balance is %s", totalBalance));
    	
    	// list all addresses and their balances (with 0 confirmations)
    	List<Address> addresses = wallet.listAddresses(0);
    	for (Address a : addresses)
    	{
    		System.out.println(String.format("The address %s has a balance of % satoshi",
    				a.getAddress(), a.getBalance()));
    	}
    	
    	// archive an old address
    	wallet.archiveAddress("1JzSZFs2DQke2B3S4pBxaNaMzzVZaG4Cqh");
    	
    	// consolidate addresses that have been inactive more than 25 days
    	List<String> consolidated = wallet.consolidate(25);
    	for (String c : consolidated)
    	{
    		System.out.println(String.format("Address %s has been consolidated", c));
    	}
    	
    	// create a new address and attach a label to it
    	Address newAddr = wallet.newAddress("test label 123");
    	System.out.println(String.format("The new address is %s", newAddr.getAddress()));
    }
}