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

#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.



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

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.



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

def getblocknumber
  bitcoin.getblocknumber
end

#getconnectioncount ⇒ Object Also known as: connection_count

Returns the number of connections to other nodes.



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

def getconnectioncount
  bitcoin.getconnectioncount
end

#getdifficulty ⇒ Object Also known as: difficulty

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



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

def getdifficulty
  bitcoin.getdifficulty
end

#getgenerate ⇒ Object Also known as: generate?

Returns true or false whether bitcoind is currently generating hashes



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

def getgenerate
  bitcoin.getgenerate
end

#gethashespersec ⇒ Object Also known as: hashes_per_sec

Returns a recent hashes per second performance measurement while generating.



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

def gethashespersec
  bitcoin.gethashespersec
end

#getinfo ⇒ Object Also known as: info

Returns an object containing various state info.



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

def getinfo
  bitcoin.getinfo
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.



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

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.



130
131
132
 
# File 'lib/bitcoin/dsl.rb', line 130

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.



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

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

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

Get detailed information about txid



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

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.



152
153
154
 
# File 'lib/bitcoin/dsl.rb', line 152

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

#help(command = nil) ⇒ Object

List commands, or get help for a command.



157
158
159
 
# File 'lib/bitcoin/dsl.rb', line 157

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.



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

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



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

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



184
185
186
 
# File 'lib/bitcoin/dsl.rb', line 184

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.



189
190
191
 
# File 'lib/bitcoin/dsl.rb', line 189

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.



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

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.



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

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



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

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.



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

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.



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

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.



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

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.



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

def validateaddress(bitcoinaddress)
  bitcoin.validateaddress
end