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.Address
static interface	BitcoindRpcClient.AddressValidationResult
static class	BitcoindRpcClient.BasicTxInput
static class	BitcoindRpcClient.BasicTxOutput
static interface	BitcoindRpcClient.Block
static interface	BitcoindRpcClient.BlockChainInfo
static interface	BitcoindRpcClient.DecodedScript
static class	BitcoindRpcClient.ExtendedTxInput
static interface	BitcoindRpcClient.Info
static interface	BitcoindRpcClient.MiningInfo
static interface	BitcoindRpcClient.MultiSig
static interface	BitcoindRpcClient.NetTotals
static interface	BitcoindRpcClient.Network
static interface	BitcoindRpcClient.NetworkInfo
static interface	BitcoindRpcClient.NodeInfo
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.TxOut
static interface	BitcoindRpcClient.TxOutput
static interface	BitcoindRpcClient.TxOutSetInfo
static interface	BitcoindRpcClient.Unspent
static interface	BitcoindRpcClient.WalletInfo

Method Summary

Modifier and Type	Method and Description
String	addMultiSigAddress(int nRequired, List<String> keyObject)
String	addMultiSigAddress(int nRequired, List<String> keyObject, String account)
void	addNode(String node, String command)
void	backupWallet(String destination)
BitcoindRpcClient.MultiSig	createMultiSig(int nRequired, List<String> keys)
String	createRawTransaction(List<BitcoindRpcClient.TxInput> inputs, List<BitcoindRpcClient.TxOutput> outputs)
BitcoindRpcClient.DecodedScript	decodeScript(String hex)
String	dumpPrivKey(String address)
void	dumpWallet(String filename)
void	encryptWallet(String passPhrase)
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<BitcoindRpcClient.NodeInfo>	getAddedNodeInfo(boolean dummy, String node)
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)
long	getConnectionCount()
double	getDifficulty()
double	getEstimateFee(int nBlocks)
double	getEstimatePriority(int nBlocks)
boolean	getGenerate()
BitcoindRpcClient.Info	getInfo()
BitcoindRpcClient.MiningInfo	getMiningInfo()
BitcoindRpcClient.NetTotals	getNetTotals()
double	getNetworkHashPs()
BitcoindRpcClient.NetworkInfo	getNetworkInfo()
String	getNewAddress()
String	getNewAddress(String account)
List<BitcoindRpcClient.PeerInfoResult>	getPeerInfo()
String	getRawChangeAddress()
List<String>	getRawMemPool()
BitcoindRpcClient.RawTransaction	getRawTransaction(String txId)
String	getRawTransactionHex(String txId)
BigDecimal	getReceivedByAccount(String account)
double	getReceivedByAddress(String address)
double	getReceivedByAddress(String address, int minConf) Returns the total amount received by <bitcoinaddress> in transactions with at least [minconf] confirmations.
BitcoindRpcClient.TxOut	getTxOut(String txId, long vout)
BitcoindRpcClient.TxOutSetInfo	getTxOutSetInfo()
double	getUnconfirmedBalance()
BitcoindRpcClient.WalletInfo	getWalletInfo()
void	importPrivKey(String bitcoinPrivKey)
void	importPrivKey(String bitcoinPrivKey, String label)
void	importPrivKey(String bitcoinPrivKey, String label, boolean rescan)
void	importWallet(String filename)
void	invalidateBlock(String hash) In regtest mode, invalidates a block to create an orphan chain
void	keyPoolRefill()
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	ping()
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)
boolean	setTxFee(BigDecimal amount)
String	signMessage(String bitcoinAdress, String message)
String	signRawTransaction(String hex, List<BitcoindRpcClient.ExtendedTxInput> inputs, List<String> privateKeys)
void	stop()
void	submitBlock(String hexData)
BitcoindRpcClient.AddressValidationResult	validateAddress(String address)
boolean	verifyChain()
boolean	verifyMessage(String bitcoinAddress, String signature, String message)
void	walletPassPhrase(String passPhrase, long timeOut)

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

getMiningInfo

BitcoindRpcClient.MiningInfo getMiningInfo()
                                    throws BitcoinRpcException

Returns:

miningInfo about the bitcoind instance

Throws:

BitcoinRpcException

createMultiSig

BitcoindRpcClient.MultiSig createMultiSig(int nRequired,
                                          List<String> keys)
                                   throws BitcoinRpcException

Throws:

BitcoinRpcException

getNetworkInfo

BitcoindRpcClient.NetworkInfo getNetworkInfo()
                                      throws BitcoinRpcException

Throws:

BitcoinRpcException

getTxOutSetInfo

BitcoindRpcClient.TxOutSetInfo getTxOutSetInfo()

getWalletInfo

BitcoindRpcClient.WalletInfo getWalletInfo()

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,
                          List<BitcoindRpcClient.ExtendedTxInput> inputs,
                          List<String> privateKeys)
                   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()

getRawChangeAddress

String getRawChangeAddress()

getConnectionCount

long getConnectionCount()

getUnconfirmedBalance

double getUnconfirmedBalance()

getDifficulty

double getDifficulty()

ping

void ping()

decodeScript

BitcoindRpcClient.DecodedScript decodeScript(String hex)

getNetTotals

BitcoindRpcClient.NetTotals getNetTotals()

getGenerate

boolean getGenerate()

getNetworkHashPs

double getNetworkHashPs()

setTxFee

boolean setTxFee(BigDecimal amount)

addNode

void addNode(String node,
             String command)

backupWallet

void backupWallet(String destination)

signMessage

String signMessage(String bitcoinAdress,
                   String message)

dumpWallet

void dumpWallet(String filename)

importWallet

void importWallet(String filename)

keyPoolRefill

void keyPoolRefill()

getReceivedByAccount

BigDecimal getReceivedByAccount(String account)

encryptWallet

void encryptWallet(String passPhrase)

walletPassPhrase

void walletPassPhrase(String passPhrase,
                      long timeOut)

verifyMessage

boolean verifyMessage(String bitcoinAddress,
                      String signature,
                      String message)

addMultiSigAddress

String addMultiSigAddress(int nRequired,
                          List<String> keyObject)

addMultiSigAddress

String addMultiSigAddress(int nRequired,
                          List<String> keyObject,
                          String account)

verifyChain

boolean verifyChain()

getAddedNodeInfo

List<BitcoindRpcClient.NodeInfo> getAddedNodeInfo(boolean dummy,
                                                  String node)

submitBlock

void submitBlock(String hexData)

getTxOut

BitcoindRpcClient.TxOut getTxOut(String txId,
                                 long vout)