zold 0.13.46 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 625ff3a7512954db5e783a2fb126775e0fd92faa
-  data.tar.gz: d959c632de322a3ff1ddaa489a4b3d0abbebe739
+  metadata.gz: 22288b6f4438266980018f938ab695cb09064eec
+  data.tar.gz: 986101be3001551301d2fff682197314eca1baff
 SHA512:
-  metadata.gz: c0558d0d5bf65cb36fd726b1a6e1ffe89a69c6f804001c46226aac260a086bf83be248271cb4bb32d8bcd19edb73edff8c800cb0c0aec85f90d61798cdbc69c5
-  data.tar.gz: 6b06b4e039bbac0a7d421dba1b096322aab860f5b512abfb7d6bbdbfade89837b762b6345a698edc596acd5fdbd85111974c3c3af1f2fc279a81c386e8727609
+  metadata.gz: 5bb4185d912befc802f4050e8cbe7baf2fc1ac957fb6b8bbbc5b4bba6aa48648519e4960c0ea64ab96680afa8586b0b9993baa1a55422dc937f1f4bc0ba122da
+  data.tar.gz: 4779556696ca19d5deef4405cd218fd0423b051e99cd28e3377f5010bcee315a52717f47fd9bb10be05f00314bb7d9d10c0ea7a7f7ea3978c5aab8c343689da9

data/.ruby-version

@@ -0,0 +1 @@
+2.3.3

data/.rultor.yml

@@ -12,7 +12,7 @@ release:
     rm -rf *.gem
     sed -i "s/0\.0\.0/${tag}/g" lib/zold/version.rb
     bundle install
-    rake
+    rake --quiet
     git add lib/zold/version.rb
     git commit -m "version set to ${tag}"
     gem build zold.gemspec
@@ -38,7 +38,7 @@ architect:
 merge:
   script: |-
     bundle install
-    rake
+    rake --quiet
     pdd -f /dev/null -v
 deploy:
   script: |-

data/.simplecov

@@ -35,6 +35,6 @@ else
   SimpleCov.start do
     add_filter "/test/"
     add_filter "/features/"
-    #minimum_coverage 100
+    minimum_coverage 30
   end
 end

data/.travis.yml

@@ -7,7 +7,9 @@ branches:
     - master
 install:
   - travis_retry bundle update
+  - gem install pdd
 script:
-  - rake
+  - pdd -f /dev/null
+  - rake --quiet
 after_success:
   - "bash <(curl -s https://codecov.io/bash)"

data/INSTALL.md

@@ -48,7 +48,10 @@ Without homebrew:
 
 ## Windows
 
-... please contribute ...
+Download and install [RubyInstaller (with Devkit)](https://rubyinstaller.org/downloads/).  
+If Windows Defender (or antivirus software) throws an error, ignore it and allow the file. This file is known to trigger [false positives](https://groups.google.com/forum/#!topic/rubyinstaller/LCR-CbBoGOI).  
+Download and install [RubyGems](https://rubygems.org/pages/download). Manual install `ruby setup.rb` works.  
+Install [Zold gem](https://rubygems.org/gems/zold) `gem install --no-ri --no-rdoc zold`
 
 ## CentOS 7.5
 

data/README.md

@@ -13,7 +13,7 @@
 [![Gem Version](https://badge.fury.io/rb/zold.svg)](http://badge.fury.io/rb/zold)
 [![Test Coverage](https://img.shields.io/codecov/c/github/zold-io/zold.svg)](https://codecov.io/github/zold-io/zold?branch=master)
 
-[![Maintainability](https://api.codeclimate.com/v1/badges/7489c1d2bacde40ffc09/maintainability)](https://codeclimate.com/github/zold-io/zold/maintainability)
+[![Maintainability](https://api.codeclimate.com/v1/badges/2861728929db934eb376/maintainability)](https://codeclimate.com/github/zold-io/zold/maintainability)
 
 **NOTICE**: It's an experiment and a very early draft! Please, feel free to
 submit your ideas and/or pull requests.
@@ -37,7 +37,7 @@ To make sure it's installed, try:
 $ zold --help
 ```
 
-You will need PGP private and public keys in `~/.ssh`.
+You will need RSA private and public keys in `~/.ssh`.
 If you don't have them yet, run this in order to generate a new pair
 (just hit <kbd>Enter</kbd> when it asks you for a password):
 
@@ -122,7 +122,7 @@ send you bonuses for keeping the node online (approximately 1 ZLD per day).
 
 ## Frequently Asked Questions
 
-> Where are my PGP private/public keys?
+> Where are my RSA private/public keys?
 
 They are in `~/.ssh/id_rsa` (private key) and `~/.ssh/id_rsa.pub` (public key).
 Make sure you have a copy of your private key in some safe place.
@@ -225,6 +225,101 @@ To be continued...
 
 `hours_alive` is the time in hours your server is alive without a reboot.
 
+## SDK
+
+Here is how you use Zold SDK from your Ruby app. First, you should
+add `zold` [gem](https://rubygems.org/gems/zold)
+to your [`Gemfile`](https://bundler.io/gemfile.html) or just:
+
+```bash
+$ gem install zold
+```
+
+Then, you will need a directory where wallets and other supplementary data will be kept.
+This can be any directory, including a temporary one. If it doesn't exist,
+it will automatically be created:
+
+```ruby
+home = '/tmp/my-zold-dir'
+```
+
+Then, you need to create three objects:
+
+```ruby
+require 'zold/wallets'
+require 'zold/remotes'
+wallets = Zold::Wallets.new(home)
+remotes = Zold::Remotes.new(File.join(home, 'remotes'))
+copies = File.join(home, 'copies')
+```
+
+The first step is to update the list of remote nodes, in order
+to be properly connected to the network:
+
+```ruby
+require 'zold/commands/remote'
+Zold::Remote.new(remotes: remotes).run(['remote', 'update'])
+```
+
+Now you are ready to create a wallet:
+
+```ruby
+require 'zold/commands/create'
+Zold::Create.new(wallets: wallets).run(['create', '--public-key=/tmp/id_rsa.pub'])
+```
+
+Here `--public-key=/tmp/id_rsa.pub` points to the absolute location of
+a public RSA key for the wallet you want to create.
+
+You can also pull a wallet from the network:
+
+```ruby
+require 'zold/commands/pull'
+Zold::Pull.new(wallets: wallets, remotes: remotes, copies: copies).run(['pull', '00000000000ff1ce'])
+```
+
+Then, you can make a payment:
+
+```ruby
+require 'zold/commands/pay'
+Zold::Pay.new(wallets: wallets).run(
+  ['pay', '17737fee5b825835', '00000000000ff1ce', '19.99', 'For a pizza', '--private-key=/tmp/id_rsa']
+)
+```
+
+Here `--private-key=/tmp/id_rsa` points to the absolute location of the private RSA key of
+the paying wallet.
+
+Finally, you can push a wallet to the network:
+
+```ruby
+require 'zold/commands/push'
+Zold::Push.new(wallets: wallets, remotes: remotes).run(%w[push 17737fee5b825835])
+```
+
+By default, all commands will work quietly, reporting absolutely nothing
+to the console. To change that, you can use `log` argument of their constructors.
+For example, `Zold::Log::Verbose` will print a lot of information to the console:
+
+```ruby
+require 'zold/commands/push'
+Zold::Push.new(wallets: wallets, remotes: remotes, log: Zold::Log::Verbose.new).run(['push'])
+```
+
+Also, all commands by default assume that you are working in a `test` network.
+This is done in order to protect our production network from your test cases.
+In order to instruct them to deal with real data and real nodes, you should
+give them `--network=zold` argument, for example:
+
+```ruby
+require 'zold/commands/push'
+Zold::Push.new(wallets: wallets, remotes: remotes).run(%w[push 17737fee5b825835 --network=zold])
+```
+
+If anything doesn't work as explained above, please
+[submit at ticket](https://github.com/zold-io/zold/issues) or join our
+[Telegram group](https://t.me/zold_io) and complain there.
+
 ## How to Contribute
 
 It is a Ruby command line gem. First, install

data/Rakefile

@@ -36,6 +36,7 @@ task default: %i[clean test features rubocop xcop copyright]
 require 'rake/testtask'
 desc 'Run all unit tests'
 Rake::TestTask.new(:test) do |test|
+  ENV['TEST_QUIET_LOG'] = 'true' if ARGV.include?('--quiet')
   Rake::Cleaner.cleanup_files(['coverage'])
   test.libs << 'lib' << 'test'
   test.pattern = 'test/**/test_*.rb'

data/bin/zold

@@ -40,6 +40,8 @@ require_relative '../lib/zold/key'
 require_relative '../lib/zold/amount'
 require_relative '../lib/zold/copies'
 require_relative '../lib/zold/remotes'
+require_relative '../lib/zold/upgrades'
+require_relative '../lib/zold/version_file'
 
 
 Encoding.default_external = Encoding::UTF_8
@@ -91,7 +93,9 @@ Available commands:
       Pay taxes, check their status
     #{Rainbow('node').green} [options]
       Run node at the given TCP port
-    #{Rainbow('score').green} host port strength [options]
+    #{Rainbow('alias').green} [alias] [wallet ID]
+      Set an alias for a wallet
+    #{Rainbow('score').green} [options]
       Generate score for the given host and port
 Available options:"
     o.string '--home',
@@ -132,6 +136,8 @@ Available options:"
   FileUtils.mkdir_p(opts[:home])
   Dir.chdir(opts[:home])
 
+  Zold::Upgrades.new(Zold::VersionFile.new('.zoldata/version'), 'upgrades').run
+
   wallets = Zold::Wallets.new('.')
   remotes = Zold::Remotes.new('./.zoldata/remotes', network: opts['network'])
   copies = './.zoldata/copies'
@@ -179,6 +185,9 @@ Available options:"
   when 'push'
     require_relative '../lib/zold/commands/push'
     Zold::Push.new(wallets: wallets, remotes: remotes, log: log).run(args)
+  when 'alias'
+    require_relative '../lib/zold/commands/alias'
+    Zold::Alias.new(wallets: wallets, remotes: remotes, log: log).run(args)
   when 'score'
     require_relative '../lib/zold/commands/calculate'
     Zold::Calculate.new(log: log).run(args)

data/fixtures/merge/into-no-wallet/assert.rb

@@ -0,0 +1,23 @@
+# Copyright (c) 2018 Yegor Bugayenko
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the 'Software'), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+require_relative 'asserts'
+wallet = Zold::Wallet.new(Zold::Id.new('0123456789abcdef'))
+assert_equal(Zold::Amount.new(zld: 512.0), wallet.balance)

data/fixtures/merge/into-no-wallet/copies/0123456789abcdef/scores.z

@@ -0,0 +1 @@
+1,0.0.0.0,4096,50,NOW

data/fixtures/merge/random-expenses/copies/0123456789abcdef/scores.z

@@ -0,0 +1,5 @@
+1,0.0.0.0,4096,10,NOW
+2,0.0.0.0,4096,20,NOW
+3,0.0.0.0,4096,30,NOW
+4,0.0.0.0,4096,40,NOW
+5,0.0.0.0,4096,50,NOW

data/fixtures/merge/simple-case/{0123456789abcdef → 0123456789abcdef.z}

@@ -2,4 +2,3 @@ test
 1
 0123456789abcdef
 MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAnppnkzrCreiKaHF09XKS6bO+2274+wSGo+F8KHvVrNbqear/e09r9PB/P6bFdLoMh4Xc7p/7+NSEZLeu2Eg/dBkQLEb8M/zgkT4gBDGyETW/zusYHIznX/lgf0f8qleIQIIB/3Y7QpDztkamWYTKWlnmlrcQvCVB0uRRPm4ZMcMJouKR9n7E2DpL9eolKyOwr/JY08iJOuK3HuW6tRdvE+0x7I+wDprM65OH/PoArlfO5qnIGbeXwsEGRXt0w6a/ubPpeadFjPXotE7cT1SA4YSD1tWTIVm1ZWppOE967XoDIum6tzt5KfzDNRfs9GbCfO0BL235HxbO8I9rTlVLTKcNAiEe0CWolY9HR5pMaosOgZ6PB54InJEZJs4L2b10c+IlVUX1RSnwfFYg0vy5oqrYyqt7gnipl/06YW4PKIYc7TljogsEHf9Cz/kpEKzqDtsH2LrmjMNsbWiousvNHM+MPgcuMg8ZnwLKwDy9NWdI4XLTpg6hVRJNH9erZdfAO5tg/3ub3JLeJbyNo4Bd5f/Bnr5YN/9ahZ87kSpI7v0Qk94dR4hDPjstEcghyZ9RVUoN52+h1g83cd3cIqksJd0kifMCoBmObD013RSPQqNwr9GGU2JaJEm25Vq35dy2DHAkOQpUZVT8GNg9IM4qUDV0yagTN3bZyvuLWIgufb0CAwEAAQ==
-

data/fixtures/merge/simple-case/copies/0123456789abcdef/1.z

@@ -0,0 +1,6 @@
+test
+1
+0123456789abcdef
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAnppnkzrCreiKaHF09XKS6bO+2274+wSGo+F8KHvVrNbqear/e09r9PB/P6bFdLoMh4Xc7p/7+NSEZLeu2Eg/dBkQLEb8M/zgkT4gBDGyETW/zusYHIznX/lgf0f8qleIQIIB/3Y7QpDztkamWYTKWlnmlrcQvCVB0uRRPm4ZMcMJouKR9n7E2DpL9eolKyOwr/JY08iJOuK3HuW6tRdvE+0x7I+wDprM65OH/PoArlfO5qnIGbeXwsEGRXt0w6a/ubPpeadFjPXotE7cT1SA4YSD1tWTIVm1ZWppOE967XoDIum6tzt5KfzDNRfs9GbCfO0BL235HxbO8I9rTlVLTKcNAiEe0CWolY9HR5pMaosOgZ6PB54InJEZJs4L2b10c+IlVUX1RSnwfFYg0vy5oqrYyqt7gnipl/06YW4PKIYc7TljogsEHf9Cz/kpEKzqDtsH2LrmjMNsbWiousvNHM+MPgcuMg8ZnwLKwDy9NWdI4XLTpg6hVRJNH9erZdfAO5tg/3ub3JLeJbyNo4Bd5f/Bnr5YN/9ahZ87kSpI7v0Qk94dR4hDPjstEcghyZ9RVUoN52+h1g83cd3cIqksJd0kifMCoBmObD013RSPQqNwr9GGU2JaJEm25Vq35dy2DHAkOQpUZVT8GNg9IM4qUDV0yagTN3bZyvuLWIgufb0CAwEAAQ==
+
+0001;2018-06-22T07:38:23Z;0000020000000000;g6hVRJNH;0000000000000000;To help you;

data/fixtures/merge/simple-case/copies/0123456789abcdef/scores.z

@@ -0,0 +1 @@
+1,0.0.0.0,4096,50,NOW

data/fixtures/scripts/push-and-pull.sh

@@ -29,6 +29,7 @@ zold taxes debt 0000000000000000
 
 zold remote show
 zold push 0000000000000000
+sleep 2
 zold fetch 0000000000000000 --ignore-score-weakness
 zold diff 0000000000000000
 zold merge 0000000000000000

data/lib/zold/atomic_file.rb

@@ -28,20 +28,21 @@ module Zold
     def initialize(file)
       raise 'File can\'t be nil' if file.nil?
       @file = file
+      @mutex = Mutex.new
     end
 
     def read
-      File.open(@file, 'rb') do |f|
-        f.flock(File::LOCK_EX)
-        f.read
+      @mutex.synchronize do
+        File.open(@file, 'rb', &:read)
       end
     end
 
     def write(content)
       raise 'Content can\'t be nil' if content.nil?
-      File.open(@file, 'wb') do |f|
-        f.flock(File::LOCK_EX)
-        f.write(content)
+      @mutex.synchronize do
+        File.open(@file, 'wb') do |f|
+          f.write(content)
+        end
       end
     end
   end

data/lib/zold/commands/alias.rb

@@ -0,0 +1,37 @@
+require 'slop'
+require 'rainbow'
+require_relative 'args'
+require_relative '../log'
+
+module Zold
+  # Command to set an alias for wallet ID
+  class Alias
+    def initialize(wallets:, remotes:, log: Log::Quiet.new)
+      @wallets = wallets
+      @remotes = remotes
+      @log = log
+    end
+
+    def run(args = [])
+      opts = Slop.parse(args, help: true, suppress_errors: true) do |o|
+        o.banner = "Usage: zold alias [args]
+    #{Rainbow('alias set <wallet> <alias>').green}
+      Make wallet known under an alias.
+    #{Rainbow('alias remove <alias>').green}
+      Remove an alias.
+    #{Rainbow('alias show <alias>').green}
+      Show where the alias is pointing to.
+Available options:"
+        o.bool '--help', 'Print instructions'
+      end
+      mine = Args.new(opts, @log).take || return
+      command = mine[0]
+      raise "A command is required, try 'zold alias --help'" unless command
+
+      # @todo #279:30min Implement command handling. As in other commands,
+      #  there should be case/when command/end loop and commands should be
+      #  implemented as methods.
+      raise NotImplementedError, 'This is not yet implemented'
+    end
+  end
+end

data/lib/zold/commands/calculate.rb

@@ -35,8 +35,11 @@ module Zold
 
     def run(args = [])
       opts = Slop.parse(args, help: true, suppress_errors: true) do |o|
-        o.banner = "Usage: zold push [ID...] [options]
+        o.banner = "Usage: zold score [options]
 Available options:"
+        o.string '--time',
+          'The time to start a score prefix with (default: current time)',
+          default: Time.now.utc.iso8601
         o.string '--invoice',
           'The invoice you want to collect money to'
         o.integer '--port',
@@ -71,7 +74,7 @@ Available options:"
       strength = opts[:strength]
       raise "Invalid strength: #{strength}" if strength <= 0 || strength > 8
       score = Zold::Score.new(
-        Time.now, opts[:host], opts[:port].to_i,
+        Time.parse(opts[:time]), opts[:host], opts[:port].to_i,
         opts[:invoice], strength: strength
       )
       loop do

data/lib/zold/commands/diff.rb

@@ -71,8 +71,8 @@ Available options:"
       end
       before = AtomicFile.new(wallet.path).read
       after = ''
-      Tempfile.open do |f|
-        patch.save(f, overwrite: true)
+      Tempfile.open(['', Wallet::EXTENSION]) do |f|
+        patch.save(f.path, overwrite: true)
         after = File.read(f)
       end
       diff = Diffy::Diff.new(before, after, context: 0).to_s(:color)

data/lib/zold/commands/fetch.rb

@@ -77,7 +77,8 @@ Available options:"
       end
       raise "There are no remote nodes, run 'zold remote reset'" if nodes.zero?
       raise "No nodes out of #{nodes} have the wallet #{id}" if done.zero?
-      @log.debug("#{nodes} copies of #{id} fetched for the total score of #{total}, #{cps.all.count} local copies")
+      @log.debug("#{nodes} copies of #{id} fetched for the total score of #{total}, \
+#{cps.all.count} local copies:\n  #{cps.all.map { |c| "#{c[:name]}: #{c[:score]}" }.join("\n  ")}")
     end
 
     def fetch_one(id, r, cps, opts)
@@ -94,15 +95,34 @@ Available options:"
       r.assert_valid_score(score)
       r.assert_score_ownership(score)
       r.assert_score_strength(score) unless opts['ignore-score-weakness']
-      Tempfile.open do |f|
+      Tempfile.open(['', Wallet::EXTENSION]) do |f|
         body = json['body']
         File.write(f, body)
         wallet = Wallet.new(f.path)
         copy = cps.add(body, score.host, score.port, score.value)
-        @log.info("#{r} returned #{body.length}b/#{wallet.txns.count}t as copy ##{copy} \
+        @log.info("#{r} returned #{body.length}b/#{wallet.txns.count}t/#{digest(json)}/#{age(json)} as copy #{copy} \
 of #{id} in #{(Time.now - start).round(2)}s: #{Rainbow(score.value).green} (#{json['version']})")
       end
       score.value
     end
+
+    def digest(json)
+      hash = json['digest']
+      return '?' if hash.nil?
+      hash[0, 6]
+    end
+
+    def age(json)
+      mtime = json['mtime']
+      return '?' if mtime.nil?
+      sec = Time.now - Time.parse(mtime)
+      if sec < 60
+        "#{sec}s"
+      elsif sec < 60 * 60
+        "#{(sec / 60).round}m"
+      else
+        "#{(sec / 3600).round}h"
+      end
+    end
   end
 end

data/lib/zold/commands/merge.rb

@@ -67,20 +67,23 @@ Available options:"
     def merge(id, cps, opts)
       cps = cps.all.sort_by { |c| c[:score] }.reverse
       patch = Patch.new(@wallets, log: @log)
-      cps.each do |c|
-        merge_one(opts, patch, Wallet.new(c[:path]), c[:name])
-        @log.debug("Copy ##{c[:name]} merged: #{patch}")
+      score = 0
+      cps.each_with_index do |c, idx|
+        wallet = Wallet.new(c[:path])
+        merge_one(opts, patch, wallet, "#{c[:name]}/#{idx}/#{c[:score]}")
+        score += c[:score]
       end
       wallet = @wallets.find(id)
       if wallet.exists?
         merge_one(opts, patch, wallet, 'localhost')
-        @log.debug("Local copy merged: #{patch}")
+        @log.debug("Local copy of #{id} merged: #{patch}")
       else
-        @log.debug("Local copy is absent, won't merge")
+        @log.debug("Local copy of #{id} is absent, nothing to merge")
       end
       modified = patch.save(wallet.path, overwrite: true)
       if modified
-        @log.debug("#{cps.count} copies merged successfully into #{wallet.id}, balance is #{wallet.balance}")
+        @log.debug("#{cps.count} copies with the total score of #{score} successfully merged \
+into #{wallet.id}/#{wallet.balance}/#{wallet.txns.count}t")
       else
         @log.debug("Nothing changed in #{wallet.id} after merge of #{cps.count} copies")
       end
@@ -88,9 +91,11 @@ Available options:"
     end
 
     def merge_one(opts, patch, wallet, name)
+      @log.debug("Building a patch for #{wallet.id} from remote copy #{name}...")
       patch.join(wallet, !opts['no-baseline'])
+      @log.debug("Copy #{name} of #{wallet.id} merged: #{patch}")
     rescue StandardError => e
-      @log.error("Can't merge copy ##{name}: #{e.message}")
+      @log.error("Can't merge copy #{name}: #{e.message}")
       @log.debug(Backtrace.new(e).to_s)
     end
   end

data/lib/zold/commands/node.rb

@@ -25,6 +25,7 @@ require_relative '../backtrace'
 require_relative '../metronome'
 require_relative '../wallet'
 require_relative '../wallets'
+require_relative '../hungry_wallets'
 require_relative '../remotes'
 require_relative '../verbose_thread'
 require_relative '../node/entrance'
@@ -45,7 +46,7 @@ module Zold
   # NODE command
   class Node
     def initialize(wallets:, remotes:, copies:, log: Log::Quiet.new)
-      @wallets = wallets
+      @wallets = HungryWallets.new(wallets)
       @remotes = remotes
       @copies = copies
       @log = log
@@ -128,11 +129,13 @@ module Zold
       end
       Front.set(:log, @log)
       Front.set(:version, opts['expose-version'])
+      Front.set(:protocol, Zold::PROTOCOL)
       Front.set(:logging, @log.debug?)
       Front.set(:home, Dir.pwd)
       @log.info("Home directory: #{Dir.pwd}")
       @log.info("Ruby version: #{RUBY_VERSION}")
       @log.info("Zold gem version: #{Zold::VERSION}")
+      @log.info("Zold protocol version: #{Zold::PROTOCOL}")
       @log.info("Network ID: #{opts['network']}")
       host = opts[:host] || ip
       address = "#{host}:#{opts[:port]}".downcase
@@ -174,7 +177,7 @@ module Zold
             @wallets, @remotes, address,
             log: @log,
             ignore_score_weakeness: opts['ignore-score-weakness']
-          ), log: @log
+          ), File.join(Dir.pwd, '.zoldata/entrance'), log: @log
         ), network: opts['network']
       ).start do |entrance|
         Front.set(:entrance, entrance)

data/lib/zold/commands/pay.rb

@@ -103,7 +103,18 @@ Available options:"
       @log.debug("#{amount} sent from #{from} to #{txn.bnf}: #{details}")
       @log.debug("Don't forget to do 'zold push #{from}'")
       @log.info(txn.id)
+      notify_of_tax_debt(from)
       txn
     end
+
+    # @todo #79:40min Extract message cretion into a separate method for easier
+    #  testing. Add tests for when in debt and not. Extract to a
+    #  module, possibly Notify.
+    def notify_of_tax_debt(wallet)
+      tax = Tax.new(wallet)
+      message = "The tax debt of #{wallet} is #{tax.debt}"
+      message += ' (still acceptable)' unless tax.in_debt?
+      @log.info(message)
+    end
   end
 end

data/lib/zold/commands/push.rb

@@ -98,7 +98,7 @@ of #{wallet.id} there, in #{(Time.now - start).round(2)}s")
       r.assert_valid_score(score)
       r.assert_score_ownership(score)
       r.assert_score_strength(score) unless opts['ignore-score-weakness']
-      @log.info("#{r} accepted #{content.length}b/#{wallet.txns.count}t of #{wallet.id} \
+      @log.info("#{r} accepted #{content.length}b/#{wallet.digest[0, 6]}/#{wallet.txns.count}t of #{wallet.id} \
 in #{(Time.now - start).round(2)}s: #{Rainbow(score.value).green} (#{json['version']})")
       score.value
     end