zold 0.6.2 → 0.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c34164f9da323f0a19a831a982d4904b2c3eaffd
-  data.tar.gz: 77d4935724eab082b127abdc5505be79d02fe6e8
+  metadata.gz: 2005a5319083f1a638f7c4764776cf02c22fec87
+  data.tar.gz: 9ffb162b8a5c5daa797b0c1402283d49a81f5d26
 SHA512:
-  metadata.gz: fa900d58a11e33b2f8855b62a7bd8503a39c68d1cdd3a270ad85defac1529fb120c38b3be8437513120911a0ec6725d8d23749503c92bd0ac8809dd8aa1767ac
-  data.tar.gz: 9d73f149efa4a79c9acf55edec7caeb5c12613ec115310a5023ec962fd7786e6975b54c1070965bb21bc7484ff4ad01cb1a1e63ac79bd2a8c2895a4a29331e38
+  metadata.gz: 39f357589c34b08f98d405b8ee8307a8044c5809e51fce67a00e87ce53d713be7179ba2098ee548e4b7b9788aa276e9b40ebe271c4ade47cc7917d859a08079a
+  data.tar.gz: 18edefa475f83289160649fbfdd07df40e7c494722f5c5352650d3ae1e16d945ea269d430294a9e61e8f6f4d202c1f3efe7c66b4f72b0657dac7a9434e73e2ea

data/.gitattributes

@@ -5,3 +5,4 @@
 * text=auto eol=lf
 *.rb ident
 *.xml ident
+*.png binary

data/README.md

@@ -45,8 +45,6 @@ yet, you can run:
 $ ssh-keygen -t rsa -b 4096
 ```
 
-## Operations
-
 ### Remote
 
 Each node maintains a list of visible "remote" nodes.
@@ -157,42 +155,6 @@ Each HTTP response contains `Content-type` header.
 
 ## Files
 
-Each wallet is a text file with the name equal to the wallet ID, for example:
-
-```text
-12345678abcdef
-AAAAB3NzaC1yc2EAAAADAQABAAABAQCuLuVr4Tl2sXoN5Zb7b6SKMPrVjLxb...
-
-34;2017-07-19T21:24:51Z;-560700;98bb82c81735c4ee;for services;SKMPrVjLxbM5oDm0IhniQQy3shF...
-35;2017-07-19T21:25:07Z;-56990;98bb82c81735c4ee;;QCuLuVr4Tl2sXoN5Zb7b6SKMPrVjLxb...
-134;2017-07-19T21:29:11Z;647388;18bb82dd1735b6e9;;
-36;2017-07-19T22:18:43Z;-884733;38ab8fc8e735c4fc;for fun;2sXoN5Zb7b6SKMPrVjLxb7b6SKMPrVjLx...
-```
-
-Lines are separated by either CR or CRLF, doesn't matter. There is a
-header and a ledger, separated by an empty line.
-The header includes two lines:
-
-  * Wallet ID, a 64-bit unsigned integer;
-  * Public RSA key of the wallet owner.
-
-The ledger includes transactions, one per line. Each transaction line
-contains fields separated by a semi-colon:
-
-  * Transaction ID, an unsigned 16-bit integer;
-  * Date and time, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601);
-  * Amount (integer);
-  * Wallet ID of the beneficiary;
-  * Details: `/[a-zA-Z0-9 -.]{1,128}/`;
-  * RSA signature of the sender of "ID;amount;beneficiary;details" text.
-
-Transactions with positive amount don't
-have RSA signatures. Their IDs point to ID fields of corresponding
-beneficiaries' wallets.
-
-The combination "ID+Beneficiary" is unique in the entire wallet.
-
-The directory `.zold` is automatically created and contains system data.
 
 `.zold/remotes` is a comma-separated file with a list of remote nodes with
 these columns:

data/bin/zold

@@ -167,18 +167,8 @@ Available options:"
     require_relative '../lib/zold/commands/push'
     Zold::Push.new(wallets: wallets, remotes: remotes, log: log).run(args)
   when 'score'
-    require_relative '../lib/zold/score'
-    raise 'Exactly four args required: host, port, invoice, strength' if args.length != 4
-    host = args[0]
-    port = args[1].to_i
-    invoice = args[2]
-    strength = args[3].to_i
-    raise "Invalid strength: #{strength}" if strength <= 0 || strength > 8
-    score = Zold::Score.new(Time.now, host, port, invoice, strength: strength)
-    loop do
-      log.info(score.to_s)
-      score = score.next
-    end
+    require_relative '../lib/zold/commands/calculate'
+    Zold::Calculate.new(log: log).run(args)
   else
     raise "Command '#{command}' is not supported"
   end

data/fixtures/scripts/calculate-scores.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -x
+set -e
+shopt -s expand_aliases
+
+alias zold="$1 --ignore-global-config --trace"
+
+zold score --host=zold.io --port=4096 --invoice=NOSUFFIX@ffffffffffffffff --strength=2 --max=5

data/fixtures/scripts/print-helps.sh

@@ -3,7 +3,7 @@ set -x
 set -e
 shopt -s expand_aliases
 
-alias zold="$1"
+alias zold="$1 --ignore-global-config --trace"
 
 zold --help
 declare -a commands=(node create invoice remote pay show fetch clean diff merge propagate pull push)

data/lib/zold/commands/calculate.rb

@@ -0,0 +1,84 @@
+# 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 'slop'
+require_relative '../log'
+require_relative '../score'
+
+# SCORE command.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018 Yegor Bugayenko
+# License:: MIT
+module Zold
+  # Calculate score
+  class Calculate
+    def initialize(log: Log::Quiet.new)
+      @log = log
+    end
+
+    def run(args = [])
+      opts = Slop.parse(args, help: true, suppress_errors: true) do |o|
+        o.banner = "Usage: zold push [ID...] [options]
+Available options:"
+        o.string '--invoice',
+          'The invoice you want to collect money to'
+        o.integer '--port',
+          "TCP port to open for the Net (default: #{Remotes::PORT})",
+          default: Remotes::PORT
+        o.string '--host', 'Host name (default: 127.0.0.1)',
+          default: '127.0.0.1'
+        o.integer '--strength',
+          "The strength of the score (default: #{Score::STRENGTH})",
+          default: Score::STRENGTH
+        o.integer '--max',
+          'Maximum value to find and then stop (default: 8)',
+          default: 8
+        o.bool '--hide-hash', 'Don\'t print hash',
+          default: false
+        o.bool '--help', 'Print instructions'
+      end
+      if opts.help?
+        @log.info(opts.to_s)
+        return
+      end
+      calculate(opts)
+    end
+
+    def calculate(opts)
+      start = Time.now
+      strength = opts[:strength]
+      raise "Invalid strength: #{strength}" if strength <= 0 || strength > 8
+      score = Zold::Score.new(
+        Time.now, opts[:host], opts[:port].to_i,
+        opts[:invoice], strength: strength
+      )
+      loop do
+        msg = score.to_s
+        msg += (score.value > 0 ? ' ' + score.hash : '') unless opts['hide-hash']
+        @log.info(msg)
+        break if score.value >= opts[:max].to_i
+        score = score.next
+      end
+      seconds = (Time.now - start).round(2)
+      @log.info("Took #{seconds} seconds, #{seconds / score.value} per value")
+      score
+    end
+  end
+end

data/lib/zold/commands/push.rb

@@ -66,20 +66,24 @@ Available options:"
           next
         end
         unless response.code == '200'
+          @remotes.error(r[:host], r[:port])
           @log.error("#{uri} failed as #{response.code}/#{response.message}")
           next
         end
         json = JSON.parse(response.body)['score']
         score = Score.parse_json(json)
         unless score.valid?
+          @remotes.error(r[:host], r[:port])
           @log.error("#{uri} invalid score: #{score}")
           next
         end
         if score.expired?
+          @remotes.error(r[:host], r[:port])
           @log.error("#{uri} expired score: #{score}")
           next
         end
         if score.strength < Score::STRENGTH
+          @remotes.error(r[:host], r[:port])
           @log.error("#{uri} score is too weak")
           next
         end

data/lib/zold/score.rb

@@ -96,13 +96,20 @@ module Zold
       )
     end
 
+    def hash
+      raise 'Score has zero value, there is no hash' if @suffixes.empty?
+      @suffixes.reduce(prefix) do |pfx, suffix|
+        Digest::SHA256.hexdigest(pfx + ' ' + suffix)[0, 63]
+      end
+    end
+
     def to_text
-      prefix, bnf = @invoice.split('@')
+      pfx, bnf = @invoice.split('@')
       [
         @time.to_i.to_s(16),
         @host,
         @port.to_s(16),
-        prefix,
+        pfx,
         bnf,
         @suffixes.join(' ')
       ].join(' ')
@@ -127,7 +134,8 @@ module Zold
         invoice: @invoice,
         time: @time.utc.iso8601,
         suffixes: @suffixes,
-        strength: @strength
+        strength: @strength,
+        hash: value.zero? ? nil : hash
       }
     end
 
@@ -160,14 +168,12 @@ module Zold
       @time < Time.now - 24 * 60
     end
 
+    def prefix
+      "#{@time.utc.iso8601} #{@host} #{@port} #{@invoice}"
+    end
+
     def valid?
-      start = "#{@time.utc.iso8601} #{@host} #{@port} #{@invoice}"
-      @suffixes.reduce(start) do |prefix, suffix|
-        hex = Digest::SHA256.hexdigest(prefix + ' ' + suffix)
-        return false unless hex.end_with?('0' * @strength)
-        hex[0, 63]
-      end
-      true
+      @suffixes.empty? || hash.end_with?('0' * @strength)
     end
 
     def value

data/lib/zold/signature.rb

@@ -42,7 +42,7 @@ module Zold
     private
 
     def body(id, t)
-      [id, t.id, t.amount.to_i, t.prefix, t.bnf, t.details].join(' ')
+      [id, t.id, t.date.utc.iso8601, t.amount.to_i, t.prefix, t.bnf, t.details].join(' ')
     end
   end
 end

data/lib/zold/version.rb

@@ -23,5 +23,5 @@
 # Copyright:: Copyright (c) 2018 Yegor Bugayenko
 # License:: MIT
 module Zold
-  VERSION = '0.6.2'.freeze
+  VERSION = '0.6.3'.freeze
 end

data/test/commands/test_calculate.rb

@@ -0,0 +1,37 @@
+# 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 'minitest/autorun'
+require_relative '../../lib/zold/log'
+require_relative '../../lib/zold/commands/calculate'
+
+# SCORE test.
+# Author:: Yegor Bugayenko (yegor256@gmail.com)
+# Copyright:: Copyright (c) 2018 Yegor Bugayenko
+# License:: MIT
+class TestCalculate < Minitest::Test
+  def test_calculates_score
+    score = Zold::Calculate.new.run(
+      ['score', '--strength=2', '--max=8', '--invoice=NOSUFFIX@ffffffffffffffff']
+    )
+    assert(score.valid?)
+    assert_equal(8, score.value)
+  end
+end

data/test/test_score.rb

@@ -95,4 +95,12 @@ class TestScore < Minitest::Test
     assert(score.valid?)
     assert(!score.expired?)
   end
+
+  def test_correct_number_of_zeroes
+    score = Zold::Score.new(
+      Time.now, 'localhost', 443,
+      'NOPREFIX@ffffffffffffffff', strength: 3
+    ).next
+    assert(score.hash.end_with?('000'))
+  end
 end

data/wp/.gitignore

@@ -1,3 +1,4 @@
+_minted-wp
 wp.aux
 wp.bcf
 wp.log

data/wp/wp.tex

@@ -1,22 +1,28 @@
 \documentclass[11pt,oneside]{article}
 \usepackage[utf8]{inputenc}
 \usepackage[american]{babel}
-% \usepackage[
-%   paperwidth=6in, paperheight=9in,
-%   bindingoffset=0.25in, left=0.75in, right=0.75in, top=0.75in, bottom=1.25in
-% ]{geometry}
 \usepackage{setspace}
 \usepackage{microtype}
 \usepackage{mathpazo} % Palantino font
+\usepackage{mdframed}
 \usepackage{minted}
-  \setminted{fontsize=\footnotesize}
+  \setminted{fontsize=\small}
   \setminted{breaklines}
   \usemintedstyle{bw}
+  \BeforeBeginEnvironment{minted}{\vspace{6pt}\begin{mdframed}[topline=false,rightline=false,bottomline=false,linecolor=black,linewidth=2pt]}
+  \AfterEndEnvironment{minted}{\end{mdframed}}
+\usepackage{xcolor}
+\usepackage{graphicx}
+\newcommand\dd[1]{\colorbox{gray!30}{\texttt{#1}}}
 \usepackage{hyperref}
+  \hypersetup{colorlinks=true,allcolors=blue!40!black}
 \pagestyle{empty}
 \setstretch{1.2}
+\setlength{\topskip}{6pt}
+\setlength{\parindent}{0pt} % indent first line
+\setlength{\parskip}{6pt} % before par
 
-\title{Zold, Lightweight Crypto Currency}
+\title{\includegraphics[scale=0.05]{logo.png}\\Zold: Lightweight Crypto Currency}
 \author{Yegor Bugayenko\\\texttt{yegor@zold.io}}
 
 \begin{document}
@@ -49,69 +55,101 @@ of existing digital currencies.
 
 \section{Principles}
 
-\textbf{Open source}.
-Zold is a command line tool. Its entire code base is open source.
+\textbf{Open Source}.
+Zold is a command line tool. Its entire code base is open source
+and hosted at the GitHub \href{https://github.com/yegor256/zold}{yegor256/zold}
+repository.
+
+\textbf{No Trust}.
+The network of communicating nodes maintains wallets of users.
+Anyone can add a node to the network.
+It is assumed that any node may contain corrupted data, either by mistake or intentionally.
+
+\textbf{Proof of work}.
+Each node, in order to earn trust, must invest its CPU power
+and find hash suffixes, performing certain calculations.
+
+\textbf{No General Ledger}.
+There is no central ledger, each wallet has its own personal ledger.
+All transactions in each ledger are confirmed by
+\href{https://en.wikipedia.org/wiki/RSA_(cryptosystem)}{RSA signatures}
+of their owners;
 
 \textbf{Capacity}.
 One currency unit is called ZLD.
-One ZLD by convention equals to $2^24$ (16,777,216) \emph{zents}.
+One ZLD by convention equals to $2^{24}$ \emph{zents} (16,777,216).
 All amounts are stored as signed 64-bit integers.
 Thus, the technical capacity of the currency is 549,755,813,888 ZLD (half a trillion).
 
-\textbf{Zero wallet}.
-There is no mining, the only way to get ZLD is to receive it from someone else.
-The wallet with the \texttt{0x00} ID belongs to the
+\textbf{Zero Wallet}.
+There is no ``mining,'' the only way to get ZLD is to receive it from someone else.
+The wallet with the \dd{0x00} ID belongs to the
 issuer and may have a negative balance. All other wallets
-may have only positive balances.
-
-\textbf{No general ledger}.
-There is no central ledger, each wallet has its own personal ledger.
-Each transaction in the ledger is confirmed by RSA signature;
-
-\textbf{No trust}.
-The network of communicating nodes maintains wallets of users.
-Anyone can add a node to the network.
-It is assumed that any node may contain corrupted data, either by mistake or intentionally.
+may only have positive balances.
 
 \section{Proof of Work}
 
-Each node calculates its own score.
-First, it builds the initial text body, which consists of four parts,
+The system consists of nodes (server machines), which maintain the data.
+In order to guarantee data consistency among all distributed nodes
+there has to be an algorithm of data segregation.
+Corrupted data must be detected earlier and filtered out as quickly as possible.
+Bitcoin introduced such an algorithm and called it \emph{proof of work}.
+
+Its fundamental principle is that each block of data must have a special
+number attached to it, known as \emph{nonce}, which is rather difficult to calculate,
+because it requires a lot of CPU power. It is assumed that at any moment
+of time the majority of nodes in the network invest their CPU power into
+calculating the nonces for the data that is not corrupted. If and when for any reason
+some data gets corrupted, the amount of CPU power a part of the network
+decides to invest into its nonces calculation would be smaller than what
+the other part of the network invests into legal data. The latter part
+will quickly dominate the former and the nodes with corrupted data will
+be ostracized and eventually ignored.
+
+Zold has borrowed this principle, although modified it. We also require
+our nodes to invest their CPU power into meaninless and repetative
+calculations just to help us identify which part of the network they belong to:
+corrupted or not. Each Zold node has to calculate its \emph{trust score},
+which is as big as much CPU power the node has invested into its calculation.
+
+Similar to Bitcoin nonces we repetatively calculate cryptographic hashes,
+looking for consecutive zeros inside them. First, in order to calculate a score,
+a node makes the \emph{prefix}, which consists of four parts,
 separated by spaces:
 
-\begin{itemize}
-\item The current timestamp in UTC ISO 8601,
-\item The host name or IP address, e.g. \texttf{b2.zold.io},
-\item The TCP port number,
+\begin{enumerate}
+\item The current timestamp in UTC, in \href{https://en.wikipedia.org/wiki/ISO_8601}{ISO 8601},
+\item The host name or IP address, e.g. \dd{b2.zold.io},
+\item The \href{https://en.wikipedia.org/wiki/Port_(computer_networking)}{TCP port} number,
 \item The invoice.
-\end{itemize}
+\end{enumerate}
 
-For example, the body may look like this:
+For example, the prefix may look like this:
 
 \begin{minted}{text}
-2017-07-19T21:24:51Z b2.zold.io 4096 Yt0lOy6Rgf@0000000000000000
+2018-05-17T03:50:59Z b2.zold.io 4096 THdonv1E@0000000000000000
 \end{minted}
 
-Then, it attempts to append any
-arbitrary text (has to match \texttt{[a-zA-Z0-9]+} regular expression)
-to the end of it and to calculate SHA-256 of the text
-in the hexadecimal format. For example, this would be the body
-with \texttt{abcdef} suffix:
+Then, the node attempts to append any arbitrary text, which has to match
+\dd{/[a-zA-Z0-9]+/} regular expression, to the end of the prefix and calculates
+\href{https://en.wikipedia.org/wiki/SHA-2}{SHA-256 hash}
+of the text in the hexadecimal format. For example, this would be the prefix
+with the attached \dd{117b1f} suffix:
 
 \begin{minted}{text}
-2017-07-19T21:24:51Z b2.zold.io 4096 Yt0lOy6Rgf@0000000000000000 abcdef
+2018-05-17T03:50:59Z b2.zold.io 4096 THdonv1E@0000000000000000 117b1f
 \end{minted}
 
-The SHA-256 of this body will be:
+The hash of this text will be:
 
 \begin{minted}{text}
-2017-07-19T21:24:51Z b2.zold.io 4096 Yt0lOy6Rgf@0000000000000000 abcdef
+670baa704726fe2c837c5ca764202adca5ab12c9b90c94d9fb1b8d629000000
 \end{minted}
 
 The node attempts to try different sufficies until one of them produces
-SHA-256 hash that ends with \texttt{000000} (six zeros). For example, this
-suffix \texttt{...} works
-(it took about an hour to find it on 2.3GHz Intel Core i7):
+a hash that ends with a few tailing zeroes. The one above ends
+with six zeroes
+(it took three minutes to find it on 2.3GHz Intel Core i7):
 
 When the first suffix is found, the score is 1. Then, to
 increase the score by one, the next suffix has to be found, which
@@ -119,18 +157,82 @@ can be added to the first 64 characters of the previous hash
 in order to obtain a new hash with trailing zeros, for example:
 
 \begin{minted}{text}
-2017-07-19T21:24:51Z b2.zold.io 4096 Yt0lOy6Rgf@0000000000000000 abcdef abcdef
+2018-05-17T03:50:59Z b2.zold.io 4096 THdonv1E@0000000000000000 117b1f 1546e35
+\end{minted}
+
+Produces:
+
+\begin{minted}{text}
+99dcd18e4bd03004e1205437866b5b68035cc8985240ae52cbd37640a000000
 \end{minted}
 
 And so on.
 
 The score is valid only when the starting time point is earlier than
-current time, but not earlier than 24 hours ago. The strength of the score
+the current time, but not earlier than 24 hours ago. The strength of the score
 is the amount of the trailing zeros in the hash. In the example above the
-strength was equal to six.
+strength is six.
 
 \section{Wallets}
 
+There is no central ledger in Zold.
+Each user has \emph{wallets} (any number of them).
+Each wallet is an ASCII-text file with the name equal to the wallet ID.
+For example, the wallet in the file \dd{12345678abcdef} may include:
+
+\begin{minted}{text}
+12345678abcdef
+AAAAB3NzaC1yc2EAAAADAQABAAABAQCuLuVr4Tl2sXoN5Zb7b6SKMPrVjLxb...
+
+34;2017-07-19T21:24:51Z;-560700;Ui0wpLu7;98bb82c81735c4ee;For services;SKMPrVjLxbM5oDm0IhniQQy3shF...
+35;2017-07-19T21:25:07Z;-56990;xksQuJa9;98bb82c81735c4ee;For food;QCuLuVr4Tl2sXoN5Zb7b6SKMPrVjLxb...
+134;2017-07-19T21:29:11Z;647388;kkIZo09s;18bb82dd1735b6e9;-;
+36;2017-07-19T22:18:43Z;-884733;pplIe28s;38ab8fc8e735c4fc;For programming;2sXoN5Zb7b6SKMPrVjLxb7b6SKMPrVjLx...
+\end{minted}
+
+Lines are separated by either CR or CRLF.
+There is a header and a ledger, separated by an empty line.
+The header includes two lines:
+
+\begin{enumerate}
+  \item Wallet ID, a 64-bit unsigned integer in hexadecimal format;
+  \item Public \href{https://en.wikipedia.org/wiki/RSA_(cryptosystem)}{RSA}
+    key of the wallet owner, in \href{https://en.wikipedia.org/wiki/Base64}{Base64}.
+\end{enumerate}
+
+The ledger includes transactions, one per line. Each transaction line
+contains fields separated by a semi-colon:
+
+\begin{enumerate}
+  \item Transaction ID, an unsigned 16-bit integer;
+  \item Date and time, in \href{https://en.wikipedia.org/wiki/ISO_8601}{ISO 8601} format;
+  \item Amount, a signed 64-bit integer;
+  \item Payment prefix, 8-32 symbols;
+  \item Wallet ID of the beneficiary;
+  \item Details, matching \dd{/[a-zA-Z0-9 -.]\{1,128\}/};
+  \item \href{https://en.wikipedia.org/wiki/RSA_(cryptosystem)}{RSA} signature,
+    684 symbols in \href{https://en.wikipedia.org/wiki/Base64}{Base64}.
+\end{enumerate}
+
+Transactions with positive amount don't have signatures.
+Their IDs point to ID fields of corresponding beneficiaries' wallets.
+
+The combination \dd{ID+Beneficiary} is unique in the entire wallet.
+
+The \href{https://en.wikipedia.org/wiki/RSA_(cryptosystem)}{RSA}
+signature is calculated using the private RSA key of the
+wallet and the following fields of transaction, separated by spaces:
+
+\begin{enumerate}
+  \item Wallet ID;
+  \item Transaction ID, an unsigned 16-bit integer;
+  \item Date and time, in ISO 8601 format;
+  \item Amount, a signed 64-bit integer;
+  \item Payment prefix;
+  \item Wallet ID of the beneficiary;
+  \item Details, matching \dd{/[a-zA-Z0-9 -.]{1,128}/}.
+\end{enumerate}
+
 \section{Push}
 
 \section{Fetch and Merge}

data/zold.gemspec

@@ -39,7 +39,7 @@ Gem::Specification.new do |s|
   s.homepage = 'http://github.com/zerocracy/zold'
   s.files = `git ls-files`.split($RS)
   s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  s.test_files = s.files.grep(%r{^(test|spec|features)/})
+  s.test_files = s.files.grep(%r{^(test|spec|features|wp)/})
   s.rdoc_options = ['--charset=UTF-8']
   s.extra_rdoc_files = ['README.md', 'LICENSE.txt']
   s.add_runtime_dependency 'concurrent-ruby', '1.0.5'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zold
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.6.3
 platform: ruby
 authors:
 - Yegor Bugayenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-16 00:00:00.000000000 Z
+date: 2018-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -271,10 +271,12 @@ files:
 - fixtures/keys/1.pub
 - fixtures/keys/2
 - fixtures/keys/2.pub
+- fixtures/scripts/calculate-scores.sh
 - fixtures/scripts/print-helps.sh
 - fixtures/scripts/push-and-pull.sh
 - lib/zold.rb
 - lib/zold/amount.rb
+- lib/zold/commands/calculate.rb
 - lib/zold/commands/clean.rb
 - lib/zold/commands/create.rb
 - lib/zold/commands/diff.rb
@@ -308,6 +310,7 @@ files:
 - lib/zold/wallet.rb
 - lib/zold/wallets.rb
 - resources/remotes
+- test/commands/test_calculate.rb
 - test/commands/test_clean.rb
 - test/commands/test_create.rb
 - test/commands/test_diff.rb
@@ -341,6 +344,7 @@ files:
 - test/test_zold.rb
 - wp/.gitignore
 - wp/Makefile
+- wp/logo.png
 - wp/wp.tex
 - zold.gemspec
 homepage: http://github.com/zerocracy/zold
@@ -373,6 +377,7 @@ test_files:
 - features/gem_package.feature
 - features/step_definitions/steps.rb
 - features/support/env.rb
+- test/commands/test_calculate.rb
 - test/commands/test_clean.rb
 - test/commands/test_create.rb
 - test/commands/test_diff.rb
@@ -404,3 +409,7 @@ test_files:
 - test/test_wallet.rb
 - test/test_wallets.rb
 - test/test_zold.rb
+- wp/.gitignore
+- wp/Makefile
+- wp/logo.png
+- wp/wp.tex