blockchain-lite 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e7543889414d4d92f12f6f5bfe9d708ba12c0093
-  data.tar.gz: 96017ba92283640a77ed3be91d52721f1e245791
+  metadata.gz: 7d943d2cc505e7e01dbaf6fb364ca317d55d9563
+  data.tar.gz: 4ab4b023a57d9ef9794e6024035c6cf6f718afaa
 SHA512:
-  metadata.gz: 9648bcb18e39173799709aef395c346f63ff4fe6fdff824199cc0934b3b2ade710e5ef6e11e1a802d7d435cdb2ee3d905bc4bf28efbcafe64e94c3b154198d10
-  data.tar.gz: 9b0ca66ac0656b65bc3179387ba7b9818313f94ec7e6d7f25b6ac2cb54ed57a492be7a2a37a13a813a7c6ca9550b7e50c22e3bb0268d8a4c2284d62847079b0d
+  metadata.gz: 4d10c42c537839b325d0ab9ebc59bd86238e985f9c549f5119b1b055bd5bf9d70a949ed51dd704082f07974408d40eb887fad1302148819d4fc6f9d63621de76
+  data.tar.gz: 612428a641e7e40ffab34c1c33f30a5b0e224e441479c68b551da1581c8e845f31d29624967a9c7915afce4ed6ce6f0aa421ae71f8a67924d37ea23349d55f9b

data/README.md

@@ -10,10 +10,10 @@ blockchain-lite library / gem - build your own blockchain with crypto hashes - r
 
 ## What's a Blockchain?
 
-> A blockchain is a distributed database -
+> A blockchain is a distributed database with
 > a list (that is, chain) of records (that is, blocks)
 > linked and secured by digital fingerprints
-> (that is, hashes also known as (one-way) crypto(graphic) hash digest checksums).
+> (that is, crypto hashes).
 
 See the [Awesome Blockchains](https://github.com/openblockchains/awesome-blockchains) page for more.
 
@@ -28,45 +28,51 @@ require 'blockchain-lite'
 
 b0 = Block.first( 'Genesis' )
 b1 = Block.next( b0, 'Transaction Data...' )
-b2 = Block.next( b1, 'Transaction Data......' )
-b3 = Block.next( b2, 'More Transaction Data...' )
+b2 = Block.next( b1, 'Transaction Data...' )
+b3 = Block.next( b2, 'Transaction Data...' )
 
 blockchain = [b0, b1, b2, b3]
 
 pp blockchain
+```
+
+will pretty print (pp) something like:
 
-######
-#  will pretty print (pp) something like:
-#
-# [#<Block:0x1eed2a0
-#   @index         = 0,
-#   @timestamp     = 2017-09-15 20:52:38,
-#   @data          = "Genesis",
-#   @previous_hash = "0",
-#   @hash          ="edbd4e11e69bc399a9ccd8faaea44fb27410fe8e3023bb9462450a0a9c4caa1b">,
-#  #<Block:0x1eec9a0
-#   @index         = 1,
-#   @timestamp     = 2017-09-15 20:52:38,
-#   @data          = "Transaction Data...",
-#   @hash          = "eb8ecbf6d5870763ae246e37539d82e37052cb32f88bb8c59971f9978e437743",
-#   @previous_hash = "edbd4e11e69bc399a9ccd8faaea44fb27410fe8e3023bb9462450a0a9c4caa1b">,
-#  #<Block:0x1eec838
-#   @index         = 2,
-#   @timestamp     = 2017-09-15 20:52:38,
-#   @data          = "Transaction Data......",
-#   @hash          = "be50017ee4bbcb33844b3dc2b7c4e476d46569b5df5762d14ceba9355f0a85f4",
-#   @previous_hash = "eb8ecbf6d5870763ae246e37539d82e37052cb32f88bb8c59971f9978e437743">,
-#  #<Block:0x1eec6d0
-#   @index         = 3,
-#   @timestamp     = 2017-09-15 20:52:38
-#   @data          = "More Transaction Data...",
-#   @hash          = "5ee2981606328abfe0c3b1171440f0df746c1e1f8b3b56c351727f7da7ae5d8d",
-#   @previous_hash = "be50017ee4bbcb33844b3dc2b7c4e476d46569b5df5762d14ceba9355f0a85f4">]
+```
+[#<Block:0x1eed2a0
+  @index              = 0,
+  @timestamp          = 2017-09-15 20:52:38,
+  @transactions_count = 1,
+  @transactions       = ["Genesis"],
+  @previous_hash      = "0",
+  @hash               = "edbd4e11e69bc399a9ccd8faaea44fb27410fe8e3023bb9462450a0a9c4caa1b">,
+ #<Block:0x1eec9a0
+  @index              = 1,
+  @timestamp          = 2017-09-15 20:52:38,
+  @transactions_count = 1,
+  @transactions       = ["Transaction Data..."],
+  @hash               = "eb8ecbf6d5870763ae246e37539d82e37052cb32f88bb8c59971f9978e437743",
+  @previous_hash      = "edbd4e11e69bc399a9ccd8faaea44fb27410fe8e3023bb9462450a0a9c4caa1b">,
+ #<Block:0x1eec838
+  @index              = 2,
+  @timestamp          = 2017-09-15 20:52:38,
+  @transactions_count = 1,
+  @transactions       = ["Transaction Data..."],
+  @hash               = "be50017ee4bbcb33844b3dc2b7c4e476d46569b5df5762d14ceba9355f0a85f4",
+  @previous_hash      = "eb8ecbf6d5870763ae246e37539d82e37052cb32f88bb8c59971f9978e437743">,
+ #<Block:0x1eec6d0
+  @index              = 3,
+  @timestamp          = 2017-09-15 20:52:38
+  @transactions_count = 1,
+  @transactions       = ["Transaction Data..."],
+  @hash               = "5ee2981606328abfe0c3b1171440f0df746c1e1f8b3b56c351727f7da7ae5d8d",
+  @previous_hash      = "be50017ee4bbcb33844b3dc2b7c4e476d46569b5df5762d14ceba9355f0a85f4">]
 ```
 
+
 ### Blocks
 
-[Basic](#basic)
+[Basic](#basic) •
 [Proof-of-Work](#proof-of-work)
 
 Supported block types / classes for now include:
@@ -78,21 +84,27 @@ class Block
 
   attr_reader :index
   attr_reader :timestamp
-  attr_reader :data
+  attr_reader :transactions_count
+  attr_reader :transactions       
   attr_reader :previous_hash
   attr_reader :hash
 
-  def initialize(index, data, previous_hash)
-    @index         = index
-    @timestamp     = Time.now.utc    ## note: use coordinated universal time (utc)
-    @data          = data
-    @previous_hash = previous_hash
-    @hash          = calc_hash
+  def initialize(index, transactions, previous_hash)
+    @index              = index
+    @timestamp          = Time.now.utc    ## note: use coordinated universal time (utc)
+    @transactions       = transactions
+    @transactions_count = transactions.size
+    @previous_hash      = previous_hash
+    @hash               = calc_hash
   end
 
   def calc_hash
     sha = Digest::SHA256.new
-    sha.update( @index.to_s + @timestamp.to_s + @data + @previous_hash )
+    sha.update( @index.to_s +
+                @timestamp.to_s +
+                @transactions.to_s +
+                @transactions_count.to_s +
+                @previous_hash )
     sha.hexdigest
   end
   ...
@@ -109,22 +121,29 @@ class Block
 
   attr_reader :index
   attr_reader :timestamp
-  attr_reader :data
+  attr_reader :transactions_count
+  attr_reader :transactions       
   attr_reader :previous_hash
   attr_reader :nonce        ## proof of work if hash starts with leading zeros (00)
   attr_reader :hash
 
-  def initialize(index, data, previous_hash)
-    @index         = index
-    @timestamp     = Time.now.utc    ## note: use coordinated universal time (utc)
-    @data          = data
-    @previous_hash = previous_hash
-    @nonce, @hash  = compute_hash_with_proof_of_work
+  def initialize(index, transactions, previous_hash)
+    @index              = index
+    @timestamp          = Time.now.utc    ## note: use coordinated universal time (utc)
+    @transactions       = transactions
+    @transactions_count = transactions.size
+    @previous_hash      = previous_hash
+    @nonce, @hash       = compute_hash_with_proof_of_work
   end
 
   def calc_hash
     sha = Digest::SHA256.new
-    sha.update( @nonce.to_s + @index.to_s + @timestamp.to_s + @data + @previous_hash )
+    sha.update( @nonce.to_s +
+                @index.to_s +
+                @timestamp.to_s +
+                @transactions.to_s +
+                @transactions_count.to_s +
+                @previous_hash )
     sha.hexdigest
   end
   ...
@@ -144,8 +163,8 @@ for building and checking blockchains. Example:
 b = Blockchain.new       # note: will (auto-) add the first (genesis) block
 
 b << 'Transaction Data...'
-b << 'Transaction Data......'
-b << 'More Transaction Data...'
+b << 'Transaction Data...'
+b << 'Transaction Data...'
 
 pp b
 ```
@@ -163,8 +182,8 @@ or use the `Blockchain` class as a wrapper (pass in the blockchain array):
 ``` ruby
 b0 = Block.first( 'Genesis' )
 b1 = Block.next( b0, 'Transaction Data...' )
-b2 = Block.next( b1, 'Transaction Data......' )
-b3 = Block.next( b2, 'More Transaction Data...' )
+b2 = Block.next( b1, 'Transaction Data...' )
+b3 = Block.next( b2, 'Transaction Data...' )
 
 blockchain = [b0, b1, b2, b3]
 
@@ -178,6 +197,90 @@ b.broken?
 and so on.
 
 
+### Transactions
+
+Let's put the transactions from the (hyper) ledger book from [Tulips on the Blockchain!](https://github.com/openblockchains/tulips)
+on the blockchain:
+
+
+| From                | To           | What                      | Qty |
+|---------------------|--------------|---------------------------|----:|
+| Dutchgrown (†)      | Vincent      | Tulip Bloemendaal Sunset  |  10 |
+| Keukenhof (†)       | Anne         | Tulip Semper Augustus     |   7 |
+|                     |              |                           |     |
+| Flowers (†)         | Ruben        | Tulip Admiral van Eijck   |   5 |
+| Vicent              | Anne         | Tulip Bloemendaal Sunset  |   3 |
+| Anne                | Julia        | Tulip Semper Augustus     |   1 |
+| Julia               | Luuk         | Tulip Semper Augustus     |   1 |
+|                     |              |                           |     |
+| Bloom & Blossom (†) | Daisy        | Tulip Admiral of Admirals |   8 |
+| Vincent             | Max          | Tulip Bloemendaal Sunset  |   2 |
+| Anne                | Martijn      | Tulip Semper Augustus     |   2 |
+| Ruben               | Julia        | Tulip Admiral van Eijck   |   2 |
+|                     |              |                           |     |
+| Teleflora (†)       | Max          | Tulip Red Impression      |  11 |
+| Anne                | Naomi        | Tulip Bloemendaal Sunset  |   1 |
+| Daisy               | Vincent      | Tulip Admiral of Admirals |   3 |
+| Julia               | Mina         | Tulip Admiral van Eijck   |   1 |
+
+(†): Grower Transaction - New Tulips on the Market!
+
+
+```ruby
+b0 = Block.first(
+        { from: "Dutchgrown", to: "Vincent", what: "Tulip Bloemendaal Sunset", qty: 10 },
+        { from: "Keukenhof",  to: "Anne",    what: "Tulip Semper Augustus",    qty: 7  } )
+
+b1 = Block.next( b0,
+        { from: "Flowers", to: "Ruben", what: "Tulip Admiral van Eijck",  qty: 5 },
+        { from: "Vicent",  to: "Anne",  what: "Tulip Bloemendaal Sunset", qty: 3 },
+        { from: "Anne",    to: "Julia", what: "Tulip Semper Augustus",    qty: 1 },
+        { from: "Julia",   to: "Luuk",  what: "Tulip Semper Augustus",    qty: 1 } )
+
+b2 = Block.next( b1,
+        { from: "Bloom & Blossom", to: "Daisy",   what: "Tulip Admiral of Admirals", qty: 8 },
+        { from: "Vincent",         to: "Max",     what: "Tulip Bloemendaal Sunset",  qty: 2 },
+        { from: "Anne",            to: "Martijn", what: "Tulip Semper Augustus",     qty: 2 },
+        { from: "Ruben",           to: "Julia",   what: "Tulip Admiral van Eijck",   qty: 2 } )
+...
+```
+
+resulting in:
+
+```
+[#<Block:0x2da3da0
+  @index              = 0,
+  @timestamp          = 1637-09-24 11:40:15,
+  @previous_hash      = "0",
+  @hash               = "32bd169baebba0b70491b748329ab631c85175be15e1672f924ca174f628cb66",
+  @transactions_count = 2,
+  @transactions       =
+   [{:from=>"Dutchgrown", :to=>"Vincent", :what=>"Tulip Bloemendaal Sunset", :qty=>10},
+    {:from=>"Keukenhof",  :to=>"Anne",    :what=>"Tulip Semper Augustus",    :qty=>7}]>,
+ #<Block:0x2da2ff0
+  @index              = 1,
+  @timestamp          = 1637-09-24 11:50:15,
+  @previous_hash      = "32bd169baebba0b70491b748329ab631c85175be15e1672f924ca174f628cb66",
+  @hash               = "57b519a8903e45348ac8a739c788815e2bd90423663957f87e276307f77f1028",
+  @transactions_count = 4,
+  @transactions       =
+   [{:from=>"Flowers", :to=>"Ruben", :what=>"Tulip Admiral van Eijck",  :qty=>5},
+    {:from=>"Vicent",  :to=>"Anne",  :what=>"Tulip Bloemendaal Sunset", :qty=>3},
+    {:from=>"Anne",    :to=>"Julia", :what=>"Tulip Semper Augustus",    :qty=>1},
+    {:from=>"Julia",   :to=>"Luuk",  :what=>"Tulip Semper Augustus",    :qty=>1}]>,
+ #<Block:0x2da2720
+  @index              = 2,
+  @timestamp          = 1637-09-24 12:00:15,
+  @previous_hash      = "57b519a8903e45348ac8a739c788815e2bd90423663957f87e276307f77f1028",
+  @hash               = "ec7dd5ea86ab966d4d4db182abb7aa93c7e5f63857476e6301e7e38cebf36568",
+  @transactions_count = 4,
+  @transactions       =
+   [{:from=>"Bloom & Blossom", :to=>"Daisy",   :what=>"Tulip Admiral of Admirals", :qty=>8},
+    {:from=>"Vincent",         :to=>"Max",     :what=>"Tulip Bloemendaal Sunset",  :qty=>2},
+    {:from=>"Anne",            :to=>"Martijn", :what=>"Tulip Semper Augustus",     :qty=>2},
+    {:from=>"Ruben",           :to=>"Julia",   :what=>"Tulip Admiral van Eijck",   :qty=>2}]>,
+ ...
+```
 
 
 ## Install

data/lib/blockchain-lite/basic/block.rb

@@ -8,33 +8,57 @@ class Block
 
   attr_reader :index
   attr_reader :timestamp
-  attr_reader :data
+  attr_reader :transactions_count   # use alias - txn_count - why? why not?
+  attr_reader :transactions         # use alias - txn       - why? why not?
   attr_reader :previous_hash
   attr_reader :hash
 
-  def initialize(index, data, previous_hash)
-    @index         = index
-    @timestamp     = Time.now.utc    ## note: use coordinated universal time (utc)
-    @data          = data
-    @previous_hash = previous_hash
-    @hash          = calc_hash
+  def initialize(index, transactions, previous_hash, timestamp: nil)
+    @index              = index
+
+    ## note: use coordinated universal time (utc)
+    ##    auto-add timestamp for new blocks (e.g. timestamp is nil)
+    @timestamp          = timestamp ? timestamp : Time.now.utc
+
+    ## note: assumes / expects an array for transactions
+    @transactions       = transactions
+    @transactions_count = transactions.size
+
+    @previous_hash      = previous_hash
+    @hash               = calc_hash
   end
 
   def calc_hash
     sha = Digest::SHA256.new
-    sha.update( @index.to_s + @timestamp.to_s + @data + @previous_hash )
+    sha.update( @index.to_s +
+                @timestamp.to_s +
+                @transactions.to_s +
+                @transactions_count.to_s +
+                @previous_hash )
     sha.hexdigest
   end
 
 
 
-  def self.first( data='Genesis' )    # create genesis (big bang! first) block
+  def self.first( *transactions )    # create genesis (big bang! first) block
+    ##  note: allow/support splat-* for now for convenience (auto-wraps args into array)
+    if transactions.size == 1 && transactions[0].is_a?( Array )
+      t = transactions[0]   ## "unwrap" array in array
+    else
+      t = transactions      ## use "auto-wrapped" splat array
+    end
     ## uses index zero (0) and arbitrary previous_hash ('0')
-    Block.new( 0, data, '0' )
+    Block.new( 0, t, '0'  )
   end
 
-  def self.next( previous, data='Transaction Data...' )
-    Block.new( previous.index+1, data, previous.hash )
+  def self.next( previous, *transactions )
+    ## note: allow/support splat-* for now for convenience (auto-wraps args into array)
+    if transactions.size == 1 && transactions[0].is_a?( Array )
+      t = transactions[0]   ## "unwrap" array in array
+    else
+      t = transactions      ## use "auto-wrapped" splat array
+    end
+    Block.new( previous.index+1, t, previous.hash )
   end
 
 end  # class Block

data/lib/blockchain-lite/blockchain.rb

@@ -9,35 +9,51 @@ class Blockchain
 
   def initialize( chain=nil, block_class: nil )
     if chain.nil?
-      @block_class = block_class || BlockchainLite::ProofOfWork::Block
+      @block_class = if block_class
+        block_class
+      else
+        ## check if Block is defined
+        ##    if yes, use it othwerwise fallback for ProofOfWork::Block
+        defined?( Block ) ? Block : BlockchainLite::ProofOfWork::Block
+      end
+
       b0 = @block_class.first( 'Genesis' )
       @chain = [b0]
     else
       @chain = chain    # "wrap" passed in blockchain (in array)
-      if block_class          # configure block class ("factory")
-        @block_class = block_class
-      else
-        ### no block class configured; use class of first block
-        ##  todo/fix: throw except if chain is empty (no class configured) - why? why not??
-        @block_class = @chain.first.class    if @chain.first
-      end
+      @block_class = if block_class
+          block_class
+        else
+          ### no block class configured; use class of first block
+          if @chain.first
+            @chain.first.class
+          else
+            ##  todo/fix: throw except if chain is empty (no class configured) - why? why not??
+            ##   throw exception on add block if not a block - why? why not??
+          end
+        end
     end
   end
 
 
+
   def last() @chain.last; end     ## return last block in chain
 
 
+  ###
+  ##  make method-<< abstract/virtual - why? why not?
+  ##     must be added by to make sure proper block_class is always used - why? why not??
+
   def <<( arg )
-    if arg.is_a? String   ## assume its (just) data
+    if arg.is_a? Array   ## assume its (just) data
       data = arg
       bl   = @chain.last
       b    = @block_class.next( bl, data )
     elsif arg.class.respond_to?( :first ) &&       ## check if respond_to? Block.first? and Block.next? - assume it's a block
           arg.class.respond_to?( :next )           ##  check/todo: use is_a? @block_class why? why not?
       b = arg
-    else  ## fallback; assume its (just) data (not a block)
-      data = arg.to_s    ## note: always convert arg to string!!  - why? why not??
+    else  ## fallback; assume single transaction record; wrap in array - allow fallback - why? why not??
+      data = [arg]
       bl   = @chain.last
       b    = @block_class.next( bl, data )
     end

data/lib/blockchain-lite/proof_of_work/block.rb

@@ -8,36 +8,73 @@ class Block
 
   attr_reader :index
   attr_reader :timestamp
-  attr_reader :data
+  attr_reader :transactions_count   # use alias - txn_count - why? why not?
+  attr_reader :transactions         # use alias - txn       - why? why not?
   attr_reader :previous_hash
-  attr_reader :nonce        ## proof of work if hash starts with leading zeros (00)
+  attr_reader :nonce                # ("lucky" number used once) - proof of work if hash starts with leading zeros (00)
   attr_reader :hash
 
-  def initialize(index, data, previous_hash)
-    @index         = index
-    @timestamp     = Time.now.utc    ## note: use coordinated universal time (utc)
-    @data          = data
+  def initialize(index, transactions, previous_hash, timestamp: nil, nonce: nil)
+    @index = index
+
+    ## note: assumes / expects an array for transactions
+    @transactions       = transactions
+    @transactions_count = transactions.size
+
     @previous_hash = previous_hash
-    @nonce, @hash  = compute_hash_with_proof_of_work
+
+    ## note: use coordinated universal time (utc)
+    @timestamp = timestamp ? timestamp : Time.now.utc
+
+    if nonce     ## restore pre-computed/mined block (from disk/cache/db/etc.)
+       ## todo: check timestamp MUST NOT be nil
+       @nonce = nonce
+       @hash  = calc_hash
+    else   ## new block  (mine! e.g. find nonce - "lucky" number used once)
+       @nonce, @hash = compute_hash_with_proof_of_work
+    end
   end
 
   def calc_hash
-    sha = Digest::SHA256.new
-    sha.update( @nonce.to_s + @index.to_s + @timestamp.to_s + @data + @previous_hash )
-    sha.hexdigest
+    calc_hash_with_nonce( @nonce )
   end
 
 
-  def self.first( data='Genesis' )    # create genesis (big bang! first) block
+
+  def self.first( *transactions, **opts )    # create genesis (big bang! first) block
+    ##  note: allow/support splat-* for now for convenience (auto-wraps args into array)
+    if transactions.size == 1 && transactions[0].is_a?( Array )
+      t = transactions[0]   ## "unwrap" array in array
+    else
+      t = transactions      ## use "auto-wrapped" splat array
+    end
     ## uses index zero (0) and arbitrary previous_hash ('0')
-    Block.new( 0, data, '0' )
+    ##  note: pass along (optional) custom timestamp (e.g. used for 1637 etc.)
+    Block.new( 0, t, '0', timestamp: opts[:timestamp] )
   end
 
-  def self.next( previous, data='Transaction Data...' )
-    Block.new( previous.index+1, data, previous.hash )
+  def self.next( previous, *transactions, **opts )
+    ## note: allow/support splat-* for now for convenience (auto-wraps args into array)
+    if transactions.size == 1 && transactions[0].is_a?( Array )
+      t = transactions[0]   ## "unwrap" array in array
+    else
+      t = transactions      ## use "auto-wrapped" splat array
+    end
+    Block.new( previous.index+1, t, previous.hash, timestamp: opts[:timestamp] )
   end
 
+
 private
+  def calc_hash_with_nonce( nonce=0 )
+    sha = Digest::SHA256.new
+    sha.update( nonce.to_s +
+                @index.to_s +
+                @timestamp.to_s +
+                @transactions.to_s +
+                @transactions_count.to_s +
+                @previous_hash )
+    sha.hexdigest
+  end
 
   def compute_hash_with_proof_of_work( difficulty='00' )
     nonce = 0
@@ -51,12 +88,6 @@ private
     end
   end
 
-  def calc_hash_with_nonce( nonce=0 )
-    sha = Digest::SHA256.new
-    sha.update( nonce.to_s + @index.to_s + @timestamp.to_s + @data + @previous_hash )
-    sha.hexdigest
-  end
-
 end  # class Block
 
 

data/lib/blockchain-lite/version.rb

@@ -4,7 +4,7 @@
 module BlockchainLite
 
   MAJOR = 1
-  MINOR = 1
+  MINOR = 2
   PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

data/test/test_block.rb

@@ -18,14 +18,78 @@ def test_version
    assert true  ## (for now) everything ok if we get here
 end
 
+
 def test_example
 
   b0 = Block.first( 'Genesis' )
   b1 = Block.next( b0, 'Transaction Data...' )
-  b2 = Block.next( b1, 'Transaction Data......' )
-  b3 = Block.next( b2, 'More Transaction Data...' )
+  b2 = Block.next( b1, 'Transaction Data...', 'Transaction Data...' )
+  b3 = Block.next( b2 )   ## no transaction data
+  b4 = Block.next( b3, ['Transaction Data...', 'Transaction Data...'] )
+
+  blockchain = [b0, b1, b2, b3, b4]
+
+  pp blockchain
+
+  assert true  ## (for now) everything ok if we get here
+end
+
+def test_tulips_example
+  b0 = Block.first(
+        { from: "Dutchgrown", to: "Vincent", what: "Tulip Bloemendaal Sunset", qty: 10 },
+        { from: "Keukenhof",  to: "Anne",    what: "Tulip Semper Augustus",    qty: 7  } )
+
+  b1 = Block.next( b0,
+        { from: "Flowers", to: "Ruben", what: "Tulip Admiral van Eijck",  qty: 5 },
+        { from: "Vicent",  to: "Anne",  what: "Tulip Bloemendaal Sunset", qty: 3 },
+        { from: "Anne",    to: "Julia", what: "Tulip Semper Augustus",    qty: 1 },
+        { from: "Julia",   to: "Luuk",  what: "Tulip Semper Augustus",    qty: 1 } )
+
+  b2 = Block.next( b1,
+        { from: "Bloom & Blossom", to: "Daisy",   what: "Tulip Admiral of Admirals", qty: 8 },
+        { from: "Vincent",         to: "Max",     what: "Tulip Bloemendaal Sunset",  qty: 2 },
+        { from: "Anne",            to: "Martijn", what: "Tulip Semper Augustus",     qty: 2 },
+        { from: "Ruben",           to: "Julia",   what: "Tulip Admiral van Eijck",   qty: 2 } )
+
+  blockchain = [b0, b1, b2]
+
+  pp blockchain
+
+  assert true  ## (for now) everything ok if we get here
+end
+
+
+def timestamp1637
+    ## change year to 1637 :-)
+    ##   note: time (uses signed integer e.g. epoch/unix time starting in 1970 with 0)
+    ##  todo: add nano/mili-seconds - why? why not? possible?
+    now = Time.now.utc.to_datetime
+    past = DateTime.new( 1637, now.month, now.mday, now.hour, now.min, now.sec, now.zone )
+    past
+  end
+
+def test_tulips_1637_example
+
+  b0 = Block.first(
+        { from: "Dutchgrown", to: "Vincent", what: "Tulip Bloemendaal Sunset", qty: 10 },
+        { from: "Keukenhof",  to: "Anne",    what: "Tulip Semper Augustus",    qty: 7  },
+        timestamp: timestamp1637 )
+
+  b1 = Block.next( b0,
+        { from: "Flowers", to: "Ruben", what: "Tulip Admiral van Eijck",  qty: 5 },
+        { from: "Vicent",  to: "Anne",  what: "Tulip Bloemendaal Sunset", qty: 3 },
+        { from: "Anne",    to: "Julia", what: "Tulip Semper Augustus",    qty: 1 },
+        { from: "Julia",   to: "Luuk",  what: "Tulip Semper Augustus",    qty: 1 },
+        timestamp: timestamp1637 )
+
+  b2 = Block.next( b1,
+        { from: "Bloom & Blossom", to: "Daisy",   what: "Tulip Admiral of Admirals", qty: 8 },
+        { from: "Vincent",         to: "Max",     what: "Tulip Bloemendaal Sunset",  qty: 2 },
+        { from: "Anne",            to: "Martijn", what: "Tulip Semper Augustus",     qty: 2 },
+        { from: "Ruben",           to: "Julia",   what: "Tulip Admiral van Eijck",   qty: 2 },
+        timestamp: timestamp1637 )
 
-  blockchain = [b0, b1, b2, b3]
+  blockchain = [b0, b1, b2]
 
   pp blockchain
 

data/test/test_block_basic.rb

@@ -16,10 +16,11 @@ def test_example
 
   b0 = block_class.first( 'Genesis' )
   b1 = block_class.next( b0, 'Transaction Data...' )
-  b2 = block_class.next( b1, 'Transaction Data......' )
-  b3 = block_class.next( b2, 'More Transaction Data...' )
+  b2 = block_class.next( b1, 'Transaction Data...', 'Transaction Data...' )
+  b3 = block_class.next( b2 )   ## no transaction data
+  b4 = block_class.next( b3, ['Transaction Data...', 'Transaction Data...'] )
 
-  blockchain = [b0, b1, b2, b3]
+  blockchain = [b0, b1, b2, b3, b4]
 
   pp blockchain
 

data/test/test_block_proof_of_work.rb

@@ -16,10 +16,11 @@ def test_example
 
   b0 = block_class.first( 'Genesis' )
   b1 = block_class.next( b0, 'Transaction Data...' )
-  b2 = block_class.next( b1, 'Transaction Data......' )
-  b3 = block_class.next( b2, 'More Transaction Data...' )
+  b2 = block_class.next( b1, 'Transaction Data...', 'Transaction Data...' )
+  b3 = block_class.next( b2 )   ## no transaction data
+  b4 = block_class.next( b3, ['Transaction Data...', 'Transaction Data...'] )
 
-  blockchain = [b0, b1, b2, b3]
+  blockchain = [b0, b1, b2, b3, b4]
 
   pp blockchain
 

data/test/test_blockchain.rb

@@ -14,11 +14,14 @@ def test_new
   b = Blockchain.new
 
   b << 'Transaction Data...'
+  b << ['Transaction Data...']
+  b << ['Transaction Data...', 'Transaction Data...']
+  b << []   ## empty block (no transactions)
 
   ## add do-it-yourself built block
-  b << Block.next( b.last, 'Transaction Data......' )
+  b << Block.next( b.last, 'Transaction Data...' )
 
-  b << 'More Transaction Data...'
+  b << 'Transaction Data...'
 
   pp b
 
@@ -31,8 +34,8 @@ def test_with_block_class
   b = Blockchain.new( block_class: BlockchainLite::Basic::Block )
 
   b << 'Transaction Data...'
-  b << 'Transaction Data......'
-  b << 'More Transaction Data...'
+  b << 'Transaction Data...'
+  b << 'Transaction Data...'
 
   pp b
 
@@ -44,8 +47,8 @@ def test_wrap
 
   b0 = Block.first( 'Genesis' )
   b1 = Block.next( b0, 'Transaction Data...' )
-  b2 = Block.next( b1, 'Transaction Data......' )
-  b3 = Block.next( b2, 'More Transaction Data...' )
+  b2 = Block.next( b1, 'Transaction Data...' )
+  b3 = Block.next( b2, 'Transaction Data...' )
   blockchain = [b0, b1, b2, b3]
 
   b = Blockchain.new( blockchain )
@@ -58,7 +61,7 @@ def test_wrap
   assert_equal true,  b.valid?
 
   ## corrupt data in block in chain
-  b2.instance_eval %{ @data='XXXXXXX' }
+  b2.instance_eval %{ @transactions=['XXXXXXX'] }
 
   assert_equal true,   b.broken?
   assert_equal false,  b.valid?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blockchain-lite
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-23 00:00:00.000000000 Z
+date: 2017-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rdoc