Module: Bitcoin::DSL

Defined in:
lib/bitcoin/dsl.rb

Instance Method Summary collapse

Instance Method Details

#backupwallet(destination) ⇒ Object

Safely copies wallet.dat to destination, which can be a directory or a path with filename.



56
57
58
 
# File 'lib/bitcoin/dsl.rb', line 56

def backupwallet(destination)
  bitcoin.backupwallet destination
end

#bitcoin ⇒ Object 



2
3
4
5
6
7
8
 
# File 'lib/bitcoin/dsl.rb', line 2

def bitcoin
  if self.class.respond_to?(:bitcoin)
    @client ||= Bitcoin::Client.new(self.class.bitcoin.user, self.class.bitcoin.pass, self.class.bitcoin.options)
  else
    @client ||= Bitcoin::Client.new(nil, nil)
  end
end

#getaccount(bitcoinaddress) ⇒ Object Also known as: account

Returns the account associated with the given address.



61
62
63
 
# File 'lib/bitcoin/dsl.rb', line 61

def getaccount(bitcoinaddress)
  bitcoin.getaccount bitcoinaddress
end

#getaccountaddress(account) ⇒ Object Also known as: account_address

Returns the current bitcoin address for receiving payments to this account.



66
67
68
 
# File 'lib/bitcoin/dsl.rb', line 66

def getaccountaddress()
  bitcoin.getaccountaddress 
end

#getaddressesbyaccount(account) ⇒ Object Also known as: addresses_by_account

Returns the list of addresses for the given account.



71
72
73
 
# File 'lib/bitcoin/dsl.rb', line 71

def getaddressesbyaccount()
  bitcoin.getaddressesbyaccount 
end

#getbalance(account = nil, minconf = 1) ⇒ Object Also known as: balance

If account is not specified, returns the server’s total available balance. If account is specified, returns the balance in the account.



77
78
79
 
# File 'lib/bitcoin/dsl.rb', line 77

def getbalance( = nil, minconf = 1)
  bitcoin.getbalance , minconf
end

#getblock(hash) ⇒ Object

Dumps the block existing with specified hash.



88
89
90
 
# File 'lib/bitcoin/dsl.rb', line 88

def getblock(hash)
  bitcoin.getblock hash
end

#getblockbycount(height) ⇒ Object Also known as: block_by_count

Dumps the block existing at specified height. Note: this is not available in the official release



83
84
85
 
# File 'lib/bitcoin/dsl.rb', line 83

def getblockbycount(height)
  bitcoin.getblockbycount height
end

#getblockcount ⇒ Object Also known as: block_count

Returns the number of blocks in the longest block chain.



93
94
95
 
# File 'lib/bitcoin/dsl.rb', line 93

def getblockcount
  bitcoin.getblockcount
end

#getblocknumber ⇒ Object Also known as: block_number

Returns the block number of the latest block in the longest block chain.



98
99
100
 
# File 'lib/bitcoin/dsl.rb', line 98

def getblocknumber
  bitcoin.getblocknumber
end

#getconnectioncount ⇒ Object Also known as: connection_count

Returns the number of connections to other nodes.



103
104
105
 
# File 'lib/bitcoin/dsl.rb', line 103

def getconnectioncount
  bitcoin.getconnectioncount
end

#getdifficulty ⇒ Object Also known as: difficulty

Returns the proof-of-work difficulty as a multiple of the minimum difficulty.



108
109
110
 
# File 'lib/bitcoin/dsl.rb', line 108

def getdifficulty
  bitcoin.getdifficulty
end

#getgenerate ⇒ Object Also known as: generate?

Returns true or false whether bitcoind is currently generating hashes



113
114
115
 
# File 'lib/bitcoin/dsl.rb', line 113

def getgenerate
  bitcoin.getgenerate
end

#gethashespersec ⇒ Object Also known as: hashes_per_sec

Returns a recent hashes per second performance measurement while generating.



118
119
120
 
# File 'lib/bitcoin/dsl.rb', line 118

def gethashespersec
  bitcoin.gethashespersec
end

#getinfo ⇒ Object Also known as: info

Returns an object containing various state info.



123
124
125
 
# File 'lib/bitcoin/dsl.rb', line 123

def getinfo
  bitcoin.getinfo
end

#getmininginfo ⇒ Object Also known as: mininginfo

Returns an object containing various mining info.



128
129
130
 
# File 'lib/bitcoin/dsl.rb', line 128

def getmininginfo
  bitcoin.getmininginfo
end

#getnewaddress(account = nil) ⇒ Object Also known as: new_address

Returns a new bitcoin address for receiving payments. If account is specified (recommended), it is added to the address book so payments received with the address will be credited to account.



134
135
136
 
# File 'lib/bitcoin/dsl.rb', line 134

def getnewaddress( = nil)
  bitcoin.getnewaddress 
end

#getreceivedbyaccount(account, minconf = 1) ⇒ Object Also known as: received_by_account

Returns the total amount received by addresses with account in transactions with at least minconf confirmations.



140
141
142
 
# File 'lib/bitcoin/dsl.rb', line 140

def getreceivedbyaccount(, minconf = 1)
  bitcoin.getreceivedbyaccount , minconf
end

#getreceivedbyaddress(bitcoinaddress, minconf = 1) ⇒ Object Also known as: received_by_address

Returns the total amount received by bitcoinaddress in transactions with at least minconf confirmations.



145
146
147
 
# File 'lib/bitcoin/dsl.rb', line 145

def getreceivedbyaddress(bitcoinaddress, minconf = 1)
  bitcoin.getreceivedbyaddress bitcoinaddress, minconf
end

#gettransaction(txid) ⇒ Object Also known as: transaction

Get detailed information about txid



150
151
152
 
# File 'lib/bitcoin/dsl.rb', line 150

def gettransaction(txid)
  bitcoin.gettransaction txid
end

#getwork(data = nil) ⇒ Object Also known as: work, get_work

If data is not specified, returns formatted hash data to work on:

:midstate => precomputed hash state after hashing the first half of the data
:data     => block data
:hash1    => formatted hash buffer for second hash
:target   => little endian hash target

If data is specified, tries to solve the block and returns true if it was successful.



162
163
164
 
# File 'lib/bitcoin/dsl.rb', line 162

def getwork(data = nil)
  bitcoin.getwork data
end

#help(command = nil) ⇒ Object

List commands, or get help for a command.



167
168
169
 
# File 'lib/bitcoin/dsl.rb', line 167

def help(command = nil)
  bitcoin.help command
end

#host(value = nil) ⇒ Object 



38
39
40
 
# File 'lib/bitcoin/dsl.rb', line 38

def host(value = nil)
  value ? bitcoin.host = value : bitcoin.host
end

#host=(value) ⇒ Object 



18
19
20
 
# File 'lib/bitcoin/dsl.rb', line 18

def host=(value)
  bitcoin.host = value
end

#listaccounts(minconf = 1) ⇒ Object Also known as: accounts

Returns Object that has account names as keys, account balances as values.



172
173
174
 
# File 'lib/bitcoin/dsl.rb', line 172

def listaccounts(minconf = 1)
  bitcoin.listaccounts minconf
end

#listreceivedbyaccount(minconf = 1, includeempty = false) ⇒ Object Also known as: list_received_by_account

Returns an array of objects containing:

:account       => the account of the receiving addresses
:amount        => total amount received by addresses with this account
:confirmations => number of confirmations of the most recent transaction included



182
183
184
 
# File 'lib/bitcoin/dsl.rb', line 182

def listreceivedbyaccount(minconf = 1, includeempty = false)
  bitcoin.listreceivedbyaccount minconf, includeempty
end

#listreceivedbyaddress(minconf = 1, includeempty = false) ⇒ Object Also known as: list_received_by_address

Returns an array of objects containing:

:address       => receiving address
:account       => the account of the receiving address
:amount        => total amount received by the address
:confirmations => number of confirmations of the most recent transaction included

To get a list of accounts on the system, execute bitcoind listreceivedbyaddress 0 true



194
195
196
 
# File 'lib/bitcoin/dsl.rb', line 194

def listreceivedbyaddress(minconf = 1, includeempty = false)
  bitcoin.listreceivedbyaddress minconf, includeempty
end

#listtransactions(account, count = 10) ⇒ Object Also known as: transactions, list_transactions

Returns up to count most recent transactions for account account.



199
200
201
 
# File 'lib/bitcoin/dsl.rb', line 199

def listtransactions(, count = 10)
  bitcoin.listtransactions , count
end

#move(fromaccount, toaccount, amount, minconf = 1, comment = nil) ⇒ Object

Move from one account in your wallet to another.



204
205
206
 
# File 'lib/bitcoin/dsl.rb', line 204

def move(fromaccount, toaccount, amount, minconf = 1, comment = nil)
  bitcoin.move fromaccount, toaccount, amount, minconf, comment
end

#password(value = nil) ⇒ Object 



34
35
36
 
# File 'lib/bitcoin/dsl.rb', line 34

def password(value = nil)
  value ? bitcoin.pass = value : bitcoin.pass
end

#password=(value) ⇒ Object 



14
15
16
 
# File 'lib/bitcoin/dsl.rb', line 14

def password=(value)
  bitcoin.pass = value
end

#port(value = nil) ⇒ Object 



42
43
44
 
# File 'lib/bitcoin/dsl.rb', line 42

def port(value = nil)
  value ? bitcoin.port = value : bitcoin.port
end

#port=(value) ⇒ Object 



22
23
24
 
# File 'lib/bitcoin/dsl.rb', line 22

def port=(value)
  bitcoin.port = value
end

#sendfrom(fromaccount, tobitcoinaddress, amount, minconf = 1, comment = nil, comment_to = nil) ⇒ Object Also known as: send_from

amount is a real and is rounded to 8 decimal places. Returns the transaction ID if successful.



209
210
211
 
# File 'lib/bitcoin/dsl.rb', line 209

def sendfrom(fromaccount, tobitcoinaddress, amount, minconf = 1, comment = nil, comment_to = nil)
  bitcoin.sendfrom fromaccount, tobitcoinaddress, amount, minconf, comment, comment_to
end

#sendtoaddress(bitcoinaddress, amount, comment = nil, comment_to = nil) ⇒ Object Also known as: send_to_address

amount is a real and is rounded to 8 decimal places



214
215
216
 
# File 'lib/bitcoin/dsl.rb', line 214

def sendtoaddress(bitcoinaddress, amount, comment = nil, comment_to = nil)
  bitcoin.sendtoaddress bitcoinaddress, amount, comment, comment_to
end

#setaccount(bitcoinaddress, account) ⇒ Object Also known as: account=, set_account

Sets the account associated with the given address.



219
220
221
 
# File 'lib/bitcoin/dsl.rb', line 219

def setaccount(bitcoinaddress, )
  bitcoin.setaccount bitcoinaddress, 
end

#setgenerate(generate, genproclimit = -1)) ⇒ Object Also known as: generate=, set_generate

generate is true or false to turn generation on or off. Generation is limited to genproclimit processors, -1 is unlimited.



225
226
227
 
# File 'lib/bitcoin/dsl.rb', line 225

def setgenerate(generate, genproclimit = -1)
  bitcoin.setgenerate generate, genproclimit
end

#ssl(value = nil) ⇒ Object 



46
47
48
 
# File 'lib/bitcoin/dsl.rb', line 46

def ssl(value = nil)
  value.nil? ? bitcoin.ssl : bitcoin.ssl = value
end

#ssl=(value) ⇒ Object 



26
27
28
 
# File 'lib/bitcoin/dsl.rb', line 26

def ssl=(value)
  bitcoin.ssl = value
end

#ssl? ⇒ Boolean

Returns:

  • (Boolean) 


50
51
52
 
# File 'lib/bitcoin/dsl.rb', line 50

def ssl?
  bitcoin.ssl?
end

#stop ⇒ Object

Stop bitcoin server.



230
231
232
 
# File 'lib/bitcoin/dsl.rb', line 230

def stop
  bitcoin.stop
end

#username(value = nil) ⇒ Object 



30
31
32
 
# File 'lib/bitcoin/dsl.rb', line 30

def username(value = nil)
  value ? bitcoin.user = value : bitcoin.user
end

#username=(value) ⇒ Object 



10
11
12
 
# File 'lib/bitcoin/dsl.rb', line 10

def username=(value)
  bitcoin.user = value
end

#validateaddress(bitcoinaddress) ⇒ Object Also known as: validate_address

Return information about bitcoinaddress.



235
236
237
 
# File 'lib/bitcoin/dsl.rb', line 235

def validateaddress(bitcoinaddress)
  bitcoin.validateaddress
end