blockchain-lite 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ccf43eee1725688110917d1fa4f252448b08c10f
-  data.tar.gz: 56476b389bcdf4abdb42b623485e303686f32f34
+  metadata.gz: 9fb07dad5bc09c884d56005cca1811efa4b97885
+  data.tar.gz: 3ec43658943f4e9890d627effdbd1944abeea133
 SHA512:
-  metadata.gz: 6d069c0c8a7c2d58268cb2c56a5fae5126f36bd10f75238f3ccefdff32c90599467465c9683bc0c56e3d748f81e364d7b568b7b09a105faba34ee51f91fce3a9
-  data.tar.gz: c9d6579d3b24560fb709631b2682afd37ae8fd4af9bc8202db278011a4ca711ec836f37e61ea5932313ec6f5ecfb0163b9d672f8c48ba3d95166c694e5a1b094
+  metadata.gz: 52a6008f77adf15d70f0f8a71b41c880fc1015eb5144cf849b829337f6ab4dc67afeacd2b0ecbdf3b4e47e4adacbb257c2af857c831052dbe13cf9e7b00e74cf
+  data.tar.gz: 8ac88194f2f5791d83326f2c3fd4bdf8d71af6f9452fcffea13861cc954ef0db777c8f9cf902543facc6acbad56a28e3b537f99630fd521f8be30824abcb6e39

data/Manifest.txt

@@ -4,9 +4,9 @@ Manifest.txt
 README.md
 Rakefile
 lib/blockchain-lite.rb
+lib/blockchain-lite/base.rb
 lib/blockchain-lite/basic/block.rb
 lib/blockchain-lite/bitcoin/block.rb
-lib/blockchain-lite/block.rb
 lib/blockchain-lite/blockchain.rb
 lib/blockchain-lite/proof_of_work/block.rb
 lib/blockchain-lite/version.rb
@@ -15,3 +15,4 @@ test/test_block.rb
 test/test_block_basic.rb
 test/test_block_proof_of_work.rb
 test/test_blockchain.rb
+test/test_version.rb

data/README.md

@@ -281,13 +281,18 @@ resulting in:
 ```
 
 
-## Install
+## Blockchain Lite in the Real World
 
-Just install the gem:
+- [**centralbank**](https://github.com/openblockchains/centralbank) - command line tool (and core library) - print your own money / cryptocurrency; run your own federated central bank nodes on the blockchain peer-to-peer over HTTP; revolutionize the world one block at a time
+- [**tulipmania**](https://github.com/openblockchains/tulipmania) - command line tool (and core library) - tulips on the blockchain; learn by example from the real world (anno 1637) - buy! sell! hodl! enjoy the beauty of admiral of admirals, semper augustus, and more; run your own hyper ledger tulip exchange nodes on the blockchain peer-to-peer over HTTP; revolutionize the world one block at a time
+- [**shilling**](https://github.com/bitshilling/bitshilling.tools) - command line tool (and core library) - shilling (or schilling) on the blockchain! rock-solid alpine dollar from austria; print (mine) your own shillings; run your own federated shilling central bank nodes w/ public distributed (hyper) ledger book on the blockchain peer-to-peer over HTTP; revolutionize the world one block at a time
+- You? Add your tool / service
+
+
+## References
+
+[**Programming Cryptocurrencies and Blockchains (in Ruby)**](http://yukimotopress.github.io/blockchains) by Gerald Bauer et al, 2018, Yuki & Moto Press
 
-```
-$ gem install blockchain-lite
-```
 
 
 ## License

data/lib/blockchain-lite.rb

@@ -1,29 +1,11 @@
-# encoding: utf-8
-
-require 'digest'    # for hash checksum digest function SHA256
-require 'pp'        # for pp => pretty printer
-
-require 'date'
-require 'time'
-require 'json'
-require 'uri'
-
-
-## 3rd party libs
-require 'merkletree'
-
-
-## our own code
-require 'blockchain-lite/version'    # note: let version always go first
-
-require 'blockchain-lite/basic/block'
-require 'blockchain-lite/proof_of_work/block'
-
-require 'blockchain-lite/blockchain'
-
-require 'blockchain-lite/block'       ## configure "standard" default block (e.g. basic, proof-of-work, etc.)
-
-
-
-# say hello
-puts BlockchainLite.banner    if defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG
+# encoding: utf-8
+
+
+## our own code (without "top-level" shortcuts e.g. "modular version")
+require 'blockchain-lite/base'
+
+###
+#  add convenience top-level shortcut / alias
+#    "standard" default block for now block with proof of work
+Block      = BlockchainLite::ProofOfWork::Block
+Blockchain = BlockchainLite::Blockchain

data/lib/blockchain-lite/base.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+require 'digest'    # for hash checksum digest function SHA256
+require 'pp'        # for pp => pretty printer
+
+require 'forwardable'
+require 'date'
+require 'time'
+require 'json'
+require 'uri'
+
+
+## 3rd party libs
+require 'merkletree'
+
+
+## our own code
+require 'blockchain-lite/version'    # note: let version always go first
+
+require 'blockchain-lite/basic/block'
+require 'blockchain-lite/proof_of_work/block'
+
+require 'blockchain-lite/blockchain'
+
+
+
+# say hello
+puts BlockchainLite.banner    if defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG

data/lib/blockchain-lite/blockchain.rb

@@ -4,64 +4,49 @@
 ##
 # convenience wrapper for array holding blocks (that is, a blockchain)
 
+module BlockchainLite
 
-class Blockchain
 
-  def initialize( chain=nil, block_class: nil )
-    if chain.nil?
-      @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
+class Blockchain
+  extend Forwardable
 
-      b0 = @block_class.first( 'Genesis' )
-      @chain = [b0]
-    else
-      @chain = chain    # "wrap" passed in blockchain (in array)
-      @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
+  def initialize( chain=[] )
+    @chain = chain    # "wrap" passed in blockchain (in array)
   end
 
+  ##
+  #  todo/check: can we make it work without "virtual" block_class method
+  ##    e.g. use constant lookup with singleton class or something - possible?
+  def block_class() Block; end    # if not configured; fallback to "top level" Block
 
 
-  def last() @chain.last; end     ## return last block in chain
 
+  ## delegate some methods (and operators) to chain array (for easier/shortcut access)
+  def_delegators :@chain, :[], :size, :each, :last, :empty?, :any?
 
-  ###
-  ##  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?( 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?
+    if arg.is_a?( block_class )
       b = arg
-    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 )
+    else
+      if arg.is_a?( Array )   ## assume its (just) data
+        data = arg
+      else  ## fallback; assume single transaction record; wrap in array - allow fallback - why? why not??
+        data = [arg]
+      end
+
+      if @chain.empty?
+        b = block_class.first( data )
+      else
+        bl = @chain.last
+        b  = block_class.next( bl, data )
+      end
     end
+
     @chain << b   ## add/append (new) block to chain
   end
 
 
-
   def broken?
     ## check for validation conventions
     ##   - start with first block?
@@ -110,3 +95,5 @@ class Blockchain
   def valid?() !broken?; end
 
 end   ## class Blockchain
+
+end   ## module BlockchainLite

data/lib/blockchain-lite/version.rb

@@ -4,8 +4,8 @@
 module BlockchainLite
 
   MAJOR = 1
-  MINOR = 3
-  PATCH = 1
+  MINOR = 4
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/test/helper.rb

@@ -7,4 +7,22 @@ require 'minitest/autorun'
 
 ## our own code
 
-require 'blockchain-lite'
+require 'blockchain-lite/base'    ## note: use "modular" version without "top-level" Block constant
+
+
+module Basic
+  Block = BlockchainLite::Basic::Block    ## convenience shortcut
+
+  class Blockchain < BlockchainLite::Blockchain
+    def block_class() Block; end
+  end
+end # module Basic
+
+
+module ProofOfWork
+  Block = BlockchainLite::ProofOfWork::Block    ## convenience shortcut
+
+  class Blockchain < BlockchainLite::Blockchain
+    def block_class() Block; end
+  end
+end  # module ProofOfWork

data/test/test_block.rb

@@ -10,13 +10,7 @@ require 'helper'
 
 class TestBlock < MiniTest::Test
 
-def test_version
-   pp BlockchainLite.version
-   pp BlockchainLite.banner
-   pp BlockchainLite.root
-
-   assert true  ## (for now) everything ok if we get here
-end
+include ProofOfWork   ## adds Block = BlockchainLite::ProofOfWork::Block etc.
 
 
 def test_example
@@ -36,20 +30,20 @@ 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  } )
+        { from: "Dutchgrown", to: "Vincent", name: "Tulip Bloemendaal Sunset", qty: 10 },
+        { from: "Keukenhof",  to: "Anne",    name: "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 } )
+        { from: "Flowers", to: "Ruben", name: "Tulip Admiral van Eijck",  qty: 5 },
+        { from: "Vicent",  to: "Anne",  name: "Tulip Bloemendaal Sunset", qty: 3 },
+        { from: "Anne",    to: "Julia", name: "Tulip Semper Augustus",    qty: 1 },
+        { from: "Julia",   to: "Luuk",  name: "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 } )
+        { from: "Bloom & Blossom", to: "Daisy",   name: "Tulip Admiral of Admirals", qty: 8 },
+        { from: "Vincent",         to: "Max",     name: "Tulip Bloemendaal Sunset",  qty: 2 },
+        { from: "Anne",            to: "Martijn", name: "Tulip Semper Augustus",     qty: 2 },
+        { from: "Ruben",           to: "Julia",   name: "Tulip Admiral van Eijck",   qty: 2 } )
 
   blockchain = [b0, b1, b2]
 
@@ -71,22 +65,22 @@ def timestamp1637
 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  },
+        { from: "Dutchgrown", to: "Vincent", name: "Tulip Bloemendaal Sunset", qty: 10 },
+        { from: "Keukenhof",  to: "Anne",    name: "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 },
+        { from: "Flowers", to: "Ruben", name: "Tulip Admiral van Eijck",  qty: 5 },
+        { from: "Vicent",  to: "Anne",  name: "Tulip Bloemendaal Sunset", qty: 3 },
+        { from: "Anne",    to: "Julia", name: "Tulip Semper Augustus",    qty: 1 },
+        { from: "Julia",   to: "Luuk",  name: "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 },
+        { from: "Bloom & Blossom", to: "Daisy",   name: "Tulip Admiral of Admirals", qty: 8 },
+        { from: "Vincent",         to: "Max",     name: "Tulip Bloemendaal Sunset",  qty: 2 },
+        { from: "Anne",            to: "Martijn", name: "Tulip Semper Augustus",     qty: 2 },
+        { from: "Ruben",           to: "Julia",   name: "Tulip Admiral van Eijck",   qty: 2 },
         timestamp: timestamp1637 )
 
   blockchain = [b0, b1, b2]

data/test/test_block_basic.rb

@@ -10,15 +10,16 @@ require 'helper'
 
 class TestBlockBasic < MiniTest::Test
 
-def test_example
+include Basic   ## adds Block = BlockchainLite::Basic::Block etc.
+
 
-  block_class = BlockchainLite::Basic::Block
+def test_example
 
-  b0 = block_class.first( 'Genesis' )
-  b1 = block_class.next( b0, '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...'] )
+  b0 = Block.first( 'Genesis' )
+  b1 = Block.next( b0, '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]
 

data/test/test_block_proof_of_work.rb

@@ -10,15 +10,16 @@ require 'helper'
 
 class TestBlockProofOfWork < MiniTest::Test
 
-def test_example
+include ProofOfWork   ## adds Block = BlockchainLite::ProofOfWork::Block etc.
+
 
-  block_class = BlockchainLite::ProofOfWork::Block
+def test_example
 
-  b0 = block_class.first( 'Genesis' )
-  b1 = block_class.next( b0, '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...'] )
+  b0 = Block.first( 'Genesis' )
+  b1 = Block.next( b0, '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]
 

data/test/test_blockchain.rb

@@ -9,10 +9,18 @@ require 'helper'
 
 class TestBlockchain < MiniTest::Test
 
+include ProofOfWork   ## adds:
+                      ##   Block = BlockchainLite::ProofOfWork::Block etc.
+                      ##   class Blockchain < BlockchainLite::Blockchain
+                      ##      def block_class() Block; end
+                      ##   end
+
+
 def test_new
 
   b = Blockchain.new
 
+  b << 'Genesis'
   b << 'Transaction Data...'
   b << ['Transaction Data...']
   b << ['Transaction Data...', 'Transaction Data...']
@@ -29,20 +37,6 @@ def test_new
 end
 
 
-def test_with_block_class
-
-  b = Blockchain.new( block_class: BlockchainLite::Basic::Block )
-
-  b << 'Transaction Data...'
-  b << 'Transaction Data...'
-  b << 'Transaction Data...'
-
-  pp b
-
-  assert true  ## (for now) everything ok if we get here
-end
-
-
 def test_wrap
 
   b0 = Block.first( 'Genesis' )

data/test/test_version.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_version.rb
+
+
+require 'helper'
+
+
+class TestVersion < MiniTest::Test
+
+def test_version
+   pp BlockchainLite.version
+   pp BlockchainLite.banner
+   pp BlockchainLite.root
+
+   assert true  ## (for now) everything ok if we get here
+end
+
+end # class TestVersion

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blockchain-lite
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-23 00:00:00.000000000 Z
+date: 2018-01-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: merkletree
@@ -69,9 +69,9 @@ files:
 - README.md
 - Rakefile
 - lib/blockchain-lite.rb
+- lib/blockchain-lite/base.rb
 - lib/blockchain-lite/basic/block.rb
 - lib/blockchain-lite/bitcoin/block.rb
-- lib/blockchain-lite/block.rb
 - lib/blockchain-lite/blockchain.rb
 - lib/blockchain-lite/proof_of_work/block.rb
 - lib/blockchain-lite/version.rb
@@ -80,6 +80,7 @@ files:
 - test/test_block_basic.rb
 - test/test_block_proof_of_work.rb
 - test/test_blockchain.rb
+- test/test_version.rb
 homepage: https://github.com/openblockchains/blockchain.lite.rb
 licenses:
 - Public Domain

data/lib/blockchain-lite/block.rb

@@ -1,5 +0,0 @@
-# encoding: utf-8
-
-
-## "standard" default block for now block with proof of work
-Block = BlockchainLite::ProofOfWork::Block