Class: Zold::Wallet

Inherits:
Object
  • Object
show all
Defined in:
lib/zold/wallet.rb

Overview

A single wallet

Constant Summary collapse

MAIN_NETWORK =

The name of the main production network. All other networks must have different names.

'zold'
EXTENSION =

The extension of the wallet files

'.z'

Instance Method Summary collapse

Constructor Details

#initialize(file) ⇒ Wallet

Returns a new instance of Wallet.



56
57
58
59
60
# File 'lib/zold/wallet.rb', line 56

def initialize(file)
  @file = File.absolute_path(File.extname(file).empty? ? "#{file}#{EXTENSION}" : file)
  @txns = Txns::Cached.new(Txns.new(@file))
  @head = Head::Cached.new(Head.new(@file))
end

Instance Method Details

#==(other) ⇒ Object



62
63
64
# File 'lib/zold/wallet.rb', line 62

def ==(other)
  to_s == other.to_s
end

#add(txn) ⇒ Object



131
132
133
134
135
136
137
138
139
# File 'lib/zold/wallet.rb', line 131

def add(txn)
  raise 'The txn has to be of type Txn' unless txn.is_a?(Txn)
  dup = txns.find { |t| t.bnf == txn.bnf && t.id == txn.id }
  raise "Wallet #{id} can't pay itself: #{txn}" if txn.bnf == id
  raise "The transaction with the same ID and BNF already exists in #{id}: #{dup}" unless dup.nil?
  raise "The tax payment already exists in #{id}: #{txn}" if Tax.new(self).exists?(txn)
  File.open(@file, 'a') { |f| f.print "#{txn}\n" }
  @txns.flush
end

#ageObject

Age of wallet in hours



170
171
172
173
# File 'lib/zold/wallet.rb', line 170

def age
  list = txns
  list.empty? ? 0 : (Time.now - list.min_by(&:date).date) / (60 * 60)
end

#balanceObject



106
107
108
# File 'lib/zold/wallet.rb', line 106

def balance
  txns.inject(Amount::ZERO) { |sum, t| sum + t.amount }
end

#digestObject



165
166
167
# File 'lib/zold/wallet.rb', line 165

def digest
  OpenSSL::Digest::SHA256.new(File.read(@file)).hexdigest
end

#exists?Boolean

Returns:

  • (Boolean)


82
83
84
# File 'lib/zold/wallet.rb', line 82

def exists?
  File.exist?(@file)
end

#has?(id, bnf) ⇒ Boolean

Returns:

  • (Boolean)


141
142
143
144
145
# File 'lib/zold/wallet.rb', line 141

def has?(id, bnf)
  raise 'The txn ID has to be of type Integer' unless id.is_a?(Integer)
  raise 'The bnf has to be of type Id' unless bnf.is_a?(Id)
  !txns.find { |t| t.id == id && t.bnf == bnf }.nil?
end

#idObject



102
103
104
# File 'lib/zold/wallet.rb', line 102

def id
  Id.new(@head.fetch[2].strip)
end

#incomeObject



155
156
157
158
159
# File 'lib/zold/wallet.rb', line 155

def income
  txns.each do |t|
    yield t unless t.amount.negative?
  end
end

#init(id, pubkey, overwrite: false, network: 'test') ⇒ Object



90
91
92
93
94
95
96
# File 'lib/zold/wallet.rb', line 90

def init(id, pubkey, overwrite: false, network: 'test')
  raise "File '#{@file}' already exists" if File.exist?(@file) && !overwrite
  raise "Invalid network name '#{network}'" unless network =~ /^[a-z]{4,16}$/
  AtomicFile.new(@file).write("#{network}\n#{PROTOCOL}\n#{id}\n#{pubkey.to_pub}\n\n")
  @txns.flush
  @head.flush
end

#keyObject



151
152
153
# File 'lib/zold/wallet.rb', line 151

def key
  Key.new(text: @head.fetch[3].strip)
end

#mtimeObject



161
162
163
# File 'lib/zold/wallet.rb', line 161

def mtime
  File.mtime(@file)
end

#networkObject



70
71
72
73
74
# File 'lib/zold/wallet.rb', line 70

def network
  n = @head.fetch[0].strip
  raise "Invalid network name '#{n}'" unless n =~ /^[a-z]{4,16}$/
  n
end

#pathObject



86
87
88
# File 'lib/zold/wallet.rb', line 86

def path
  @file
end

#prefix?(prefix) ⇒ Boolean

Returns:

  • (Boolean)


147
148
149
# File 'lib/zold/wallet.rb', line 147

def prefix?(prefix)
  key.to_pub.include?(prefix)
end

#protocolObject



76
77
78
79
80
# File 'lib/zold/wallet.rb', line 76

def protocol
  v = @head.fetch[1].strip
  raise "Invalid protocol version name '#{v}'" unless v =~ /^[0-9]+$/
  v.to_i
end

#refurbishObject



179
180
181
182
183
184
# File 'lib/zold/wallet.rb', line 179

def refurbish
  AtomicFile.new(@file).write(
    "#{network}\n#{protocol}\n#{id}\n#{key.to_pub}\n\n#{txns.map { |t| t.to_s + "\n" }.join}"
  )
  @txns.flush
end

#root?Boolean

Returns:

  • (Boolean)


98
99
100
# File 'lib/zold/wallet.rb', line 98

def root?
  id == Id::ROOT
end

#sub(amount, invoice, pvt, details = '-', time: Time.now) ⇒ Object



110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
# File 'lib/zold/wallet.rb', line 110

def sub(amount, invoice, pvt, details = '-', time: Time.now)
  raise 'The amount has to be of type Amount' unless amount.is_a?(Amount)
  raise "The amount can't be negative: #{amount}" if amount.negative?
  raise 'The pvt has to be of type Key' unless pvt.is_a?(Key)
  prefix, target = invoice.split('@')
  tid = max + 1
  raise 'Too many transactions already, can\'t add more' if max > 0xffff
  txn = Txn.new(
    tid,
    time,
    amount * -1,
    prefix,
    Id.new(target),
    details
  )
  txn = txn.signed(pvt, id)
  raise 'This is not the right private key for this wallet' unless Signature.new.valid?(key, id, txn)
  add(txn)
  txn
end

#to_sObject



66
67
68
# File 'lib/zold/wallet.rb', line 66

def to_s
  id.to_s
end

#txnsObject



175
176
177
# File 'lib/zold/wallet.rb', line 175

def txns
  @txns.fetch
end