wf.bitcoin.javabitcoindrpcclient

Interface BitcoindRpcClient

All Known Implementing Classes:

BitcoinJSONRPCClient

public interface BitcoindRpcClient

Author:

Mikhail Yevchenko m.ṥῥẚɱ.ѓѐḿởύḙ@azazar.com Small modifications by Alessandro Polverini polverini at gmail.com

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BitcoindRpcClient.AddressValidationResult
static class	BitcoindRpcClient.BasicTxInput
static class	BitcoindRpcClient.BasicTxOutput
static interface	BitcoindRpcClient.Block
static interface	BitcoindRpcClient.BlockChainInfo
static interface	BitcoindRpcClient.Info
static interface	BitcoindRpcClient.PeerInfoResult
static interface	BitcoindRpcClient.RawTransaction
static interface	BitcoindRpcClient.ReceivedAddress
static interface	BitcoindRpcClient.Transaction returned by listsinceblock and listtransactions
static interface	BitcoindRpcClient.TransactionsSinceBlock
static interface	BitcoindRpcClient.TxInput
static interface	BitcoindRpcClient.TxOutput
static interface	BitcoindRpcClient.Unspent

Method Summary

Modifier and Type	Method and Description
String	createRawTransaction(List<BitcoindRpcClient.TxInput> inputs, List<BitcoindRpcClient.TxOutput> outputs)
String	dumpPrivKey(String address)
List<String>	generate(int numBlocks) Used in regtest mode to generate an arbitrary number of blocks
String	getAccount(String address)
String	getAccountAddress(String address)
List<String>	getAddressesByAccount(String account)
double	getBalance()
double	getBalance(String account)
double	getBalance(String account, int minConf)
String	getBestBlockHash()
BitcoindRpcClient.Block	getBlock(int height)
BitcoindRpcClient.Block	getBlock(String blockHash)
BitcoindRpcClient.BlockChainInfo	getBlockChainInfo()
int	getBlockCount()
String	getBlockHash(int height)
double	getEstimateFee(int nBlocks)
double	getEstimatePriority(int nBlocks)
BitcoindRpcClient.Info	getInfo()
String	getNewAddress()
String	getNewAddress(String account)
List<BitcoindRpcClient.PeerInfoResult>	getPeerInfo()
List<String>	getRawMemPool()
BitcoindRpcClient.RawTransaction	getRawTransaction(String txId)
String	getRawTransactionHex(String txId)
double	getReceivedByAddress(String address)
double	getReceivedByAddress(String address, int minConf) Returns the total amount received by <bitcoinaddress> in transactions with at least [minconf] confirmations.
void	importPrivKey(String bitcoinPrivKey)
void	importPrivKey(String bitcoinPrivKey, String label)
void	importPrivKey(String bitcoinPrivKey, String label, boolean rescan)
void	invalidateBlock(String hash) In regtest mode, invalidates a block to create an orphan chain
Map<String,Number>	listAccounts() listaccounts [minconf=1]
Map<String,Number>	listAccounts(int minConf)
List<BitcoindRpcClient.ReceivedAddress>	listReceivedByAddress()
List<BitcoindRpcClient.ReceivedAddress>	listReceivedByAddress(int minConf)
List<BitcoindRpcClient.ReceivedAddress>	listReceivedByAddress(int minConf, boolean includeEmpty)
BitcoindRpcClient.TransactionsSinceBlock	listSinceBlock()
BitcoindRpcClient.TransactionsSinceBlock	listSinceBlock(String blockHash)
BitcoindRpcClient.TransactionsSinceBlock	listSinceBlock(String blockHash, int targetConfirmations)
List<BitcoindRpcClient.Transaction>	listTransactions()
List<BitcoindRpcClient.Transaction>	listTransactions(String account)
List<BitcoindRpcClient.Transaction>	listTransactions(String account, int count)
List<BitcoindRpcClient.Transaction>	listTransactions(String account, int count, int from)
List<BitcoindRpcClient.Unspent>	listUnspent()
List<BitcoindRpcClient.Unspent>	listUnspent(int minConf)
List<BitcoindRpcClient.Unspent>	listUnspent(int minConf, int maxConf)
List<BitcoindRpcClient.Unspent>	listUnspent(int minConf, int maxConf, String... addresses)
String	move(String fromAccount, String toBitcoinAddress, double amount)
String	move(String fromAccount, String toBitcoinAddress, double amount, int minConf)
String	move(String fromAccount, String toBitcoinAddress, double amount, int minConf, String comment)
void	reconsiderBlock(String hash) In regtest mode, undo the invalidation of a block, possibly making it on the top of the chain
String	sendFrom(String fromAccount, String toBitcoinAddress, double amount)
String	sendFrom(String fromAccount, String toBitcoinAddress, double amount, int minConf)
String	sendFrom(String fromAccount, String toBitcoinAddress, double amount, int minConf, String comment)
String	sendFrom(String fromAccount, String toBitcoinAddress, double amount, int minConf, String comment, String commentTo) Will send the given amount to the given address, ensuring the account has a valid balance using minConf confirmations.
String	sendRawTransaction(String hex)
String	sendToAddress(String toAddress, double amount)
String	sendToAddress(String toAddress, double amount, String comment)
String	sendToAddress(String toAddress, double amount, String comment, String commentTo)
void	setGenerate(boolean doGenerate)
String	signRawTransaction(String hex)
void	stop()
BitcoindRpcClient.AddressValidationResult	validateAddress(String address)

Method Detail

createRawTransaction

String createRawTransaction(List<BitcoindRpcClient.TxInput> inputs,
                            List<BitcoindRpcClient.TxOutput> outputs)
                     throws BitcoinRpcException

Throws:

BitcoinRpcException

dumpPrivKey

String dumpPrivKey(String address)
            throws BitcoinRpcException

Throws:

BitcoinRpcException

getAccount

String getAccount(String address)
           throws BitcoinRpcException

Throws:

BitcoinRpcException

getAccountAddress

String getAccountAddress(String address)
                  throws BitcoinRpcException

Throws:

BitcoinRpcException

getAddressesByAccount

List<String> getAddressesByAccount(String account)
                            throws BitcoinRpcException

Throws:

BitcoinRpcException

getBalance

double getBalance()
           throws BitcoinRpcException

Returns:

returns the server's total available balance

Throws:

BitcoinRpcException

getBalance

double getBalance(String account)
           throws BitcoinRpcException

Parameters:

account -

Returns:

returns the balance in the account

Throws:

BitcoinRpcException

getBalance

double getBalance(String account,
                  int minConf)
           throws BitcoinRpcException

Parameters:

account -

minConf -

Returns:

returns the balance in the account

Throws:

BitcoinRpcException

getInfo

BitcoindRpcClient.Info getInfo()
                        throws BitcoinRpcException

Returns:

infos about the bitcoind instance

Throws:

BitcoinRpcException

getBlock

BitcoindRpcClient.Block getBlock(int height)
                          throws BitcoinRpcException

Throws:

BitcoinRpcException

getBlock

BitcoindRpcClient.Block getBlock(String blockHash)
                          throws BitcoinRpcException

Throws:

BitcoinRpcException

getBlockHash

String getBlockHash(int height)
             throws BitcoinRpcException

Throws:

BitcoinRpcException

getBlockChainInfo

BitcoindRpcClient.BlockChainInfo getBlockChainInfo()
                                            throws BitcoinRpcException

Throws:

BitcoinRpcException

getBlockCount

int getBlockCount()
           throws BitcoinRpcException

Throws:

BitcoinRpcException

getNewAddress

String getNewAddress()
              throws BitcoinRpcException

Throws:

BitcoinRpcException

getNewAddress

String getNewAddress(String account)
              throws BitcoinRpcException

Throws:

BitcoinRpcException

getRawMemPool

List<String> getRawMemPool()
                    throws BitcoinRpcException

Throws:

BitcoinRpcException

getBestBlockHash

String getBestBlockHash()
                 throws BitcoinRpcException

Throws:

BitcoinRpcException

getRawTransactionHex

String getRawTransactionHex(String txId)
                     throws BitcoinRpcException

Throws:

BitcoinRpcException

getRawTransaction

BitcoindRpcClient.RawTransaction getRawTransaction(String txId)
                                            throws BitcoinRpcException

Throws:

BitcoinRpcException

getReceivedByAddress

double getReceivedByAddress(String address)
                     throws BitcoinRpcException

Throws:

BitcoinRpcException

getReceivedByAddress

double getReceivedByAddress(String address,
                            int minConf)
                     throws BitcoinRpcException

Returns the total amount received by <bitcoinaddress> in transactions with at least [minconf] confirmations. While some might consider this obvious, value reported by this only considers *receiving* transactions. It does not check payments that have been made *from* this address. In other words, this is not "getaddressbalance". Works only for addresses in the local wallet, external addresses will always show 0.

Parameters:

address -

minConf -

Returns:

the total amount received by <bitcoinaddress>

Throws:

BitcoinRpcException

importPrivKey

void importPrivKey(String bitcoinPrivKey)
            throws BitcoinRpcException

Throws:

BitcoinRpcException

importPrivKey

void importPrivKey(String bitcoinPrivKey,
                   String label)
            throws BitcoinRpcException

Throws:

BitcoinRpcException

importPrivKey

void importPrivKey(String bitcoinPrivKey,
                   String label,
                   boolean rescan)
            throws BitcoinRpcException

Throws:

BitcoinRpcException

listAccounts

Map<String,Number> listAccounts()
                         throws BitcoinRpcException

listaccounts [minconf=1]

Returns:

Map that has account names as keys, account balances as values

Throws:

BitcoinRpcException

listAccounts

Map<String,Number> listAccounts(int minConf)
                         throws BitcoinRpcException

Throws:

BitcoinRpcException

listReceivedByAddress

List<BitcoindRpcClient.ReceivedAddress> listReceivedByAddress()
                                                       throws BitcoinRpcException

Throws:

BitcoinRpcException

listReceivedByAddress

List<BitcoindRpcClient.ReceivedAddress> listReceivedByAddress(int minConf)
                                                       throws BitcoinRpcException

Throws:

BitcoinRpcException

listReceivedByAddress

List<BitcoindRpcClient.ReceivedAddress> listReceivedByAddress(int minConf,
                                                              boolean includeEmpty)
                                                       throws BitcoinRpcException

Throws:

BitcoinRpcException

listSinceBlock

BitcoindRpcClient.TransactionsSinceBlock listSinceBlock()
                                                 throws BitcoinRpcException

Throws:

BitcoinRpcException

listSinceBlock

BitcoindRpcClient.TransactionsSinceBlock listSinceBlock(String blockHash)
                                                 throws BitcoinRpcException

Throws:

BitcoinRpcException

listSinceBlock

BitcoindRpcClient.TransactionsSinceBlock listSinceBlock(String blockHash,
                                                        int targetConfirmations)
                                                 throws BitcoinRpcException

Throws:

BitcoinRpcException

listTransactions

List<BitcoindRpcClient.Transaction> listTransactions()
                                              throws BitcoinRpcException

Throws:

BitcoinRpcException

listTransactions

List<BitcoindRpcClient.Transaction> listTransactions(String account)
                                              throws BitcoinRpcException

Throws:

BitcoinRpcException

listTransactions

List<BitcoindRpcClient.Transaction> listTransactions(String account,
                                                     int count)
                                              throws BitcoinRpcException

Throws:

BitcoinRpcException

listTransactions

List<BitcoindRpcClient.Transaction> listTransactions(String account,
                                                     int count,
                                                     int from)
                                              throws BitcoinRpcException

Throws:

BitcoinRpcException

listUnspent

List<BitcoindRpcClient.Unspent> listUnspent()
                                     throws BitcoinRpcException

Throws:

BitcoinRpcException

listUnspent

List<BitcoindRpcClient.Unspent> listUnspent(int minConf)
                                     throws BitcoinRpcException

Throws:

BitcoinRpcException

listUnspent

List<BitcoindRpcClient.Unspent> listUnspent(int minConf,
                                            int maxConf)
                                     throws BitcoinRpcException

Throws:

BitcoinRpcException

listUnspent

List<BitcoindRpcClient.Unspent> listUnspent(int minConf,
                                            int maxConf,
                                            String... addresses)
                                     throws BitcoinRpcException

Throws:

BitcoinRpcException

move

String move(String fromAccount,
            String toBitcoinAddress,
            double amount)
     throws BitcoinRpcException

Throws:

BitcoinRpcException

move

String move(String fromAccount,
            String toBitcoinAddress,
            double amount,
            int minConf)
     throws BitcoinRpcException

Throws:

BitcoinRpcException

move

String move(String fromAccount,
            String toBitcoinAddress,
            double amount,
            int minConf,
            String comment)
     throws BitcoinRpcException

Throws:

BitcoinRpcException

sendFrom

String sendFrom(String fromAccount,
                String toBitcoinAddress,
                double amount)
         throws BitcoinRpcException

Throws:

BitcoinRpcException

sendFrom

String sendFrom(String fromAccount,
                String toBitcoinAddress,
                double amount,
                int minConf)
         throws BitcoinRpcException

Throws:

BitcoinRpcException

sendFrom

String sendFrom(String fromAccount,
                String toBitcoinAddress,
                double amount,
                int minConf,
                String comment)
         throws BitcoinRpcException

Throws:

BitcoinRpcException

sendFrom

String sendFrom(String fromAccount,
                String toBitcoinAddress,
                double amount,
                int minConf,
                String comment,
                String commentTo)
         throws BitcoinRpcException

Will send the given amount to the given address, ensuring the account has a valid balance using minConf confirmations.

Parameters:

fromAccount -

toBitcoinAddress -

amount - is a real and is rounded to 8 decimal places

minConf -

comment -

commentTo -

Returns:

the transaction ID if successful

Throws:

BitcoinRpcException

sendRawTransaction

String sendRawTransaction(String hex)
                   throws BitcoinRpcException

Throws:

BitcoinRpcException

sendToAddress

String sendToAddress(String toAddress,
                     double amount)
              throws BitcoinRpcException

Throws:

BitcoinRpcException

sendToAddress

String sendToAddress(String toAddress,
                     double amount,
                     String comment)
              throws BitcoinRpcException

Throws:

BitcoinRpcException

sendToAddress

String sendToAddress(String toAddress,
                     double amount,
                     String comment,
                     String commentTo)
              throws BitcoinRpcException

Parameters:

toAddress -

amount - is a real and is rounded to 8 decimal places

comment -

commentTo -

Returns:

the transaction ID <txid> if successful

Throws:

BitcoinRpcException

signRawTransaction

String signRawTransaction(String hex)
                   throws BitcoinRpcException

Throws:

BitcoinRpcException

setGenerate

void setGenerate(boolean doGenerate)
          throws BitcoinRPCException

Parameters:

doGenerate - a boolean indicating if blocks must be generated with the cpu

Throws:

BitcoinRPCException

generate

List<String> generate(int numBlocks)
               throws BitcoinRPCException

Used in regtest mode to generate an arbitrary number of blocks

Parameters:

numBlocks - a boolean indicating if blocks must be generated with the cpu

Returns:

the list of hashes of the generated blocks

Throws:

BitcoinRPCException

validateAddress

BitcoindRpcClient.AddressValidationResult validateAddress(String address)
                                                   throws BitcoinRpcException

Throws:

BitcoinRpcException

getEstimateFee

double getEstimateFee(int nBlocks)
               throws BitcoinRpcException

Throws:

BitcoinRpcException

getEstimatePriority

double getEstimatePriority(int nBlocks)
                    throws BitcoinRpcException

Throws:

BitcoinRpcException

invalidateBlock

void invalidateBlock(String hash)
              throws BitcoinRpcException

In regtest mode, invalidates a block to create an orphan chain

Parameters:

hash -

Throws:

BitcoinRpcException

reconsiderBlock

void reconsiderBlock(String hash)
              throws BitcoinRpcException

In regtest mode, undo the invalidation of a block, possibly making it on the top of the chain

Parameters:

hash -

Throws:

BitcoinRpcException

getPeerInfo

List<BitcoindRpcClient.PeerInfoResult> getPeerInfo()

stop

void stop()