tulipmania 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 43c6117496ffb6839f9d060bd44fedbf675f6236
-  data.tar.gz: 9128fd6314ecd688f6769946d9b7c05c906d6c9e
+  metadata.gz: 9527e2c2fe08d3e412be319aa0602d2059d9b1b7
+  data.tar.gz: 8a206a9f8bc796e3293bc3f3bf4c4b9e45115b5e
 SHA512:
-  metadata.gz: a5338475a3b1366689431aba1be3789e3a783b89f87a01ba28cfb85a02da74d632c5cdb124a425e9be324fc744e41fd7312711ac4e27caea6aa39cdb47a32277
-  data.tar.gz: 8cc2013daab3ece6ce8b1303045ab0bbb6166240114bf51bc2a98795044ba8caa6e6906570703007b25dade78d4d3bcc4272831679ba93d1ea941ae3027d330e
+  metadata.gz: 7e9d26f3ac11a9600eefc7ab2bc543103c07afa2a47f036f4fe03b2de80c421c205488b23781feb859bf8ef7aab032a0edf5405e5d6569f056c6ff29c008fddb
+  data.tar.gz: 3d3b9bf1f770fcac4f0f45507f711bba029a47bfa5e0e40256b9b4eecb46cf09cef8d8642bf0a4a47b08f715eeed98f8c29310ed3a2d64948208ed5abce17bbb

data/LICENSE.md

@@ -0,0 +1,116 @@
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not
+invalidate the remainder of the License, and in such case Affirmer hereby
+affirms that he or she will not (i) exercise any of his or her remaining
+Copyright and Related Rights in the Work or (ii) assert any associated claims
+and causes of action with respect to the Work, in either case contrary to
+Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions
+  or other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this
+  CC0 or use of the Work.
+
+For more information, please see
+<http://creativecommons.org/publicdomain/zero/1.0/>

data/Manifest.txt

@@ -1,7 +1,9 @@
 HISTORY.md
+LICENSE.md
 Manifest.txt
 README.md
 Rakefile
+bin/tulipmania
 lib/tulipmania.rb
 lib/tulipmania/block.rb
 lib/tulipmania/blockchain.rb
@@ -9,6 +11,9 @@ lib/tulipmania/cache.rb
 lib/tulipmania/exchange.rb
 lib/tulipmania/ledger.rb
 lib/tulipmania/node.rb
+lib/tulipmania/pool.rb
+lib/tulipmania/service.rb
+lib/tulipmania/tool.rb
 lib/tulipmania/transaction.rb
 lib/tulipmania/version.rb
 lib/tulipmania/views/_blockchain.erb

data/README.md

@@ -12,8 +12,59 @@ run your own hyper ledger tulip exchange nodes on the blockchain peer-to-peer ov
 
 
 
+## Command Line
 
-## Development
+Use the `tulipmania` command line tool. Try:
+
+```
+$ tulipmania -h     
+```
+
+resulting in:
+
+```
+Usage: tulipmania [options]
+
+  Wallet options:
+    -n, --name=NAME                  Address name (default: Anne)
+
+  Server (node) options:
+    -o, --host HOST                  listen on HOST (default: 0.0.0.0)
+    -p, --port PORT                  use PORT (default: 4567)
+    -h, --help                       Prints this help
+```
+
+To start a new (network) node using the default wallet
+address (that is, Anne) and the default server host and port settings
+use:
+
+```
+$ tulipmania
+```
+
+Stand back ten feets :-) while starting up the machinery.
+Ready to exchange tulips on the blockchain?
+In your browser open up the page e.g. `http://localhost:4567`. Voila!
+
+![](tulipmania.png)
+
+
+
+Note: You can start a second node on your computer -
+make sure to use a different port (use the `-p/--port` option)
+and (recommended)
+a different wallet address (use the `-n/--name` option).
+Example:
+
+```
+$ tulipmania -p 5678 -n Vincent
+```
+
+Happy mining!
+
+
+
+## Local Development Setup
 
 For local development - clone or download (and unzip) the tulipmania code repo.
 Next install all dependencies using bundler with a Gemfile e.g.:
@@ -34,8 +85,7 @@ run
 $ bundle       ## will use the Gemfile (see above)
 ```
 
-and now you're ready to run your own hyper ledger tulip exchange server node.
-Use the [`config.ru`](config.ru) script for rack:
+and now you're ready to run your own tulipmania server node. Use the [`config.ru`](config.ru) script for rack:
 
 ``` ruby
 # config.ru
@@ -47,15 +97,13 @@ require 'tulipmania'
 run Tulipmania::Service
 ```
 
-and startup the money printing machine using rackup - the rack command line tool:
+and startup the tulip exchange machinery using rackup - the rack command line tool:
 
 ```
 $ rackup       ## will use the config.ru - rackup configuration script (see above).
 ```
 
-In your browser open up the page e.g. `http://localhost:9292`. Voila!
-
-
+In your browser open up the page e.g. `http://localhost:9292`. Voila! Happy mining!
 
 
 ## License

data/Rakefile

@@ -5,7 +5,7 @@ Hoe.spec 'tulipmania' do
 
   self.version = Tulipmania::VERSION
 
-  self.summary = 'tulipmania - 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 HTTPprint 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'
+  self.summary = 'tulipmania - 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'
   self.description = summary
 
   self.urls    = ['https://github.com/openblockchains/tulipmania']
@@ -20,7 +20,7 @@ Hoe.spec 'tulipmania' do
   self.extra_deps = [
     ['sinatra', '>=2.0'],
     ['sass'],   ## used for css style preprocessing (scss)
-    ['blockchain-lite', '>=1.2'],
+    ['blockchain-lite', '>=1.3.1'],
   ]
 
   self.licenses = ['Public Domain']

data/bin/tulipmania

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# == DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/tulipmania
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/tulipmania
+#
+
+require 'tulipmania'
+
+Tulipmania.main

data/lib/tulipmania.rb

@@ -5,11 +5,14 @@ require 'json'
 require 'digest'
 require 'net/http'
 require 'set'
+require 'optparse'
 require 'pp'
 
 
 ### 3rd party gems
 require 'sinatra/base'                         # note: use "modular" sinatra app / service
+
+require 'merkletree'
 require 'blockchain-lite/proof_of_work/block'  # note: use proof-of-work block only (for now)
 
 
@@ -19,111 +22,89 @@ require 'tulipmania/block'
 require 'tulipmania/cache'
 require 'tulipmania/transaction'
 require 'tulipmania/blockchain'
+require 'tulipmania/pool'
 require 'tulipmania/exchange'
 require 'tulipmania/ledger'
 require 'tulipmania/wallet'
 
 require 'tulipmania/node'
+require 'tulipmania/service'
 
-
+require 'tulipmania/tool'
 
 
 module Tulipmania
 
-class Service < Sinatra::Base
-
-  def self.banner
-    "tulipmania/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] on Sinatra/#{Sinatra::VERSION} (#{ENV['RACK_ENV']})"
-  end
-
-
-## - for now hard-code address e.g. Sepp
-NODE = Node.new( address: 'Sepp' )
+  class Configuration
+     ## user/node settings
+     attr_accessor :address   ## single wallet address (for now "clear" name e.g. Anne, Vincent, etc.)
 
+     WALLET_ADDRESSES = ['Anne', 'Vicent', 'Ruben', 'Julia', 'Luuk',
+                         'Daisy', 'Max', 'Martijn', 'Naomi', 'Mina',
+                         'Isabel'
+                        ]
 
-PUBLIC_FOLDER = "#{Tulipmania.root}/lib/tulipmania/public"
-VIEWS_FOLDER  = "#{Tulipmania.root}/lib/tulipmania/views"
+     ## system/blockchain settings
+     attr_accessor :coinbase
+     attr_accessor :mining_reward
+     attr_accessor :tulips     ## rename to assets/commodities/etc. - why? why not?
 
-puts "[tulipmania] boot - setting public folder to: #{PUBLIC_FOLDER}"
-puts "[tulipmania] boot - setting views folder to: #{VIEWS_FOLDER}"
+     ## note: add a (†) coinbase / grower marker
+     TULIP_GROWERS = ['Dutchgrown†', 'Keukenhof†', 'Flowers†',
+                      'Bloom & Blossom†', 'Teleflora†'
+                     ]
 
-set :public_folder, PUBLIC_FOLDER # set up the static dir (with images/js/css inside)
-set :views, VIEWS_FOLDER # set up the views dir
+     TULIPS = ['Semper Augustus',
+               'Admiral van Eijck',
+               'Admiral of Admirals',
+               'Red Impression',
+               'Bloemendaal Sunset',
+              ]
 
-set :static, true # set up static file routing  -- check - still needed?
+     def initialize
+       ## try default setup via ENV variables
+       ## pick "random" address if nil (none passed in)
+       @address = ENV[ 'TULIPMANIA_NAME'] || rand_address()
 
+       @coinbase      = TULIP_GROWERS   ## use a different name for coinbase - why? why not?
+                                        ##  note: for now is an array (multiple growsers)
 
-set connections: []
+       @tulips        = TULIPS        ## change name to commodities or assets - why? why not?
+       @mining_reward = 5
+     end
 
 
-get '/style.css' do
-  scss :style    ## note: converts (pre-processes) style.scss to style.css
-end
+     def rand_address()      WALLET_ADDRESSES[rand( WALLET_ADDRESSES.size )];  end
+     def rand_tulip()        @tulips[rand( @tulips.size )];      end
+     def rand_coinbase()     @coinbase[rand( @coinbase.size )];  end
 
+     def coinbase?( address )    ## check/todo: use wallet - why? why not? (for now wallet==address)
+       @coinbase.include?( address )
+     end
+  end # class Configuration
 
-get '/' do
-  @node = NODE
-  erb :index
-end
 
-post '/send' do
-  NODE.on_send( params[:to], params[:amount].to_i )
-  settings.connections.each { |out| out << "data: added transaction\n\n" }
-  redirect '/'
-end
+  ## lets you use
+  ##   Tulipmania.configure do |config|
+  ##      config.address = 'Anne'
+  ##   end
 
-
-post '/transactions' do
-  if NODE.on_add_transaction(
-    params[:from],
-    params[:to],
-    params[:amount].to_i,
-    params[:id]
-  )
-    settings.connections.each { |out| out << "data: added transaction\n\n" }
+  def self.configure
+    yield( config )
   end
-  redirect '/'
-end
-
-post '/mine' do
-  NODE.on_mine!
-  redirect '/'
-end
 
-post '/peers' do
-  NODE.on_add_peer( params[:host], params[:port].to_i )
-  redirect '/'
-end
-
-post '/peers/:index/delete' do
-  NODE.on_delete_peer( params[:index].to_i )
-  redirect '/'
-end
-
-
-
-post '/resolve' do
-  data = JSON.parse(request.body.read)
-  if data['chain'] && NODE.on_resolve( data['chain'] )
-    status 202     ### 202 Accepted; see httpstatuses.com/202
-    settings.connections.each { |out| out << "data: resolved\n\n" }
-  else
-    status 200    ### 200 OK
+  def self.config
+    @config ||= Configuration.new
   end
-end
 
 
-get '/events', provides: 'text/event-stream' do
-  stream :keep_open do |out|
-    settings.connections << out
-    out.callback { settings.connections.delete(out) }
+  ## add command line binary (tool) e.g. $ try centralbank -h
+  def self.main
+   Tool.new.run(ARGV)
   end
-end
-
-
-end # class Service
 end # module Tulipmania
 
 
+
 # say hello
 puts Tulipmania::Service.banner

data/lib/tulipmania/blockchain.rb

@@ -3,13 +3,22 @@
 
 class Blockchain
   extend Forwardable
-  def_delegators :@chain, :[], :size, :each, :empty?, :last
+  def_delegators :@chain, :[], :size, :each, :empty?, :any?, :last
 
 
   def initialize( chain=[] )
     @chain = chain
   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 <<( txs )
     ## todo: check if is block or array
     ##   if array (of transactions) - auto-add (build) block
@@ -17,9 +26,9 @@ class Blockchain
     ##  for now just use transactions (keep it simple :-)
 
     if @chain.size == 0
-      block = Block.first( txs )
+      block = Block.first( txs, timestamp: timestamp1637 )
     else
-      block = Block.next( @chain.last, txs )
+      block = Block.next( @chain.last, txs, timestamp: timestamp1637 )
     end
     @chain << block
   end

data/lib/tulipmania/cache.rb

@@ -6,14 +6,14 @@ class Cache
   end
 
   def write( data )
-    File.open( @name, 'w' ) do |f|        ## use utf8 - why? why not??
+    File.open( @name, 'w:utf-8' ) do |f|
       f.write JSON.pretty_generate( data )
     end
   end
 
   def read
     if File.exists?( @name )
-      data = File.read( @name )   ## use utf8 - why? why not??
+      data = File.open( @name, 'r:bom|utf-8' ).read
       JSON.parse( data )
     else
       nil

data/lib/tulipmania/exchange.rb

@@ -5,24 +5,24 @@
 class Exchange
   attr_reader :pending, :chain, :ledger
 
-  COINBASE      = "COINBASE"
-  MINING_REWARD = 5
-
 
   def initialize( address )
     @address = address
 
-    @cache = Cache.new( 'data.json' )
+    @cache = Cache.new( "data.#{address.downcase}.json" )
     h = @cache.read
     if h
       ## restore blockchain
       @chain = Blockchain.from_json( h['chain'] )
       ## restore pending transactions too
-      @pending = h['transactions'].map { |h_tx| Tx.from_h( h_tx ) }
+      @pending = Pool.from_json( h['transactions'] )
     else
       @chain   = Blockchain.new
-      @chain  << [Tx.new( COINBASE, @address, MINING_REWARD )]    # genesis (big bang!) starter block
-      @pending = []
+      @chain  << [Tx.new( Tulipmania.config.rand_coinbase,
+                          @address,
+                          Tulipmania.config.mining_reward,
+                          Tulipmania.config.rand_tulip )]    # genesis (big bang!) starter block
+      @pending = Pool.new
     end
 
     ## update ledger (balances) with confirmed transactions
@@ -32,11 +32,14 @@ class Exchange
 
 
   def mine_block!
-    add_transaction( Tx.new( COINBASE, @address, MINING_REWARD ))
+    add_transaction( Tx.new( Tulipmania.config.rand_coinbase,
+                             @address,
+                             Tulipmania.config.mining_reward,
+                             Tulipmania.config.rand_tulip ))
 
     ## add mined (w/ computed/calculated hash) block
-    @chain << @pending
-    @pending = []
+    @chain << @pending.transactions
+    @pending = Pool.new
 
     ## update ledger (balances) with new confirmed transactions
     @ledger = Ledger.new( @chain )
@@ -45,11 +48,11 @@ class Exchange
   end
 
 
-  def sufficient_funds?( wallet, amount )
+  def sufficient_tulips?( wallet, qty, what )
     ## (convenience) delegate for ledger
     ##  todo/check: use address instead of wallet - why? why not?
     ##   for now single address wallet (that is, wallet==address)
-    @ledger.sufficient_funds?( wallet, amount )
+    @ledger.sufficient_tulips?( wallet, qty, what )
   end
 
 
@@ -76,13 +79,9 @@ class Exchange
       ## update ledger (balances) with new confirmed transactions
       @ledger = Ledger.new( @chain )
 
+      ##  document - keep only pending (unconfirmed) transaction not yet in blockchain ????
+      @pending.update!( @chain.transactions)
 
-      _transactions = @chain.transactions   ## use a copy for reference (optimization) in inner loop
-      ## todo: cleanup ???  -- use tx2 for t ???
-      ##   document - keep only pending transaction not yet in blockchain ????
-      @pending = @pending.select do |tx|
-        _transactions.none? { |tx_confirmed| tx_confirmed.id == tx.id }
-      end
       @cache.write as_json
       return true
     else
@@ -94,7 +93,7 @@ class Exchange
 
   def as_json
     { chain:        @chain.as_json,
-      transactions: @pending.map { |tx| tx.to_h }
+      transactions: @pending.as_json
     }
   end
 
@@ -107,7 +106,7 @@ private
 
     ## todo: use chain.include?  to check for include
     ##   avoid loop and create new array for check!!!
-    (@chain.transactions + @pending).none? { |tx| tx_new.id == tx.id }
+    (@chain.transactions + @pending.transactions).none? { |tx| tx_new.id == tx.id }
   end
 
 end  ## class Exchange

data/lib/tulipmania/ledger.rb

@@ -9,9 +9,12 @@ class Ledger
     end
   end
 
-  def sufficient_funds?( wallet, amount )
-    return true   if wallet == Bank::COINBASE   ### use Config::COINBASE why? why not ???
-    @wallets.has_key?( wallet ) && @wallets[wallet] - amount >= 0
+  def sufficient_tulips?( wallet, qty, what )
+    return true   if Tulipmania.config.coinbase?( wallet )
+
+    @wallets.has_key?( wallet ) &&
+    @wallets[wallet].has_key?( what ) &&
+    @wallets[wallet][what] - qty >= 0
   end
 
 
@@ -19,10 +22,11 @@ private
 
   def apply_transactions( transactions )
     transactions.each do |tx|
-      if sufficient_funds?(tx.from, tx.amount)
-        @wallets[tx.from] -= tx.amount   unless tx.from == Bank::COINBASE   ### use Config::COINBASE why? why not ???
-        @wallets[tx.to] ||= 0
-        @wallets[tx.to] += tx.amount
+      if sufficient_tulips?(tx.from, tx.qty, tx.what)
+        @wallets[tx.from][tx.what] -= tx.qty   unless Tulipmania.config.coinbase?( tx.from )
+        @wallets[tx.to] ||= {}   ## make sure wallet exists (e.g. init with empty hash {})
+        @wallets[tx.to][tx.what] ||= 0
+        @wallets[tx.to][tx.what] += tx.qty
       end
     end
   end

data/lib/tulipmania/node.rb

@@ -1,29 +1,23 @@
 
 
 class Node
-  attr_reader :id, :peers, :wallet, :bank
+  attr_reader :id, :peers, :wallet, :exchange
 
 
-  WALLET_ADDRESSES = %w[Sepp Franz Sissi Maria Eva Ferdl Max Adam]
-
-  def initialize( address: nil )
-    ## pick "random" address if nil (none passed in)
-    address ||= WALLET_ADDRESSES[rand( WALLET_ADDRESSES.size )]
-
-    @id     = SecureRandom.uuid
-    @peers  = []
-    @wallet = Wallet.new( address )
-    @bank   = Bank.new @wallet.address
+  def initialize( address: )
+    @id       = SecureRandom.uuid
+    @peers    = []
+    @wallet   = Wallet.new( address )
+    @exchange = Exchange.new @wallet.address
   end
 
 
-
   def on_add_peer( host, port )
     @peers << [host, port]
     @peers.uniq!
     # TODO/FIX: no need to send to every peer, just the new one
     send_chain_to_peers
-    @bank.pending.each { |tx| send_transaction_to_peers( tx ) }
+    @exchange.pending.each { |tx| send_transaction_to_peers( tx ) }
   end
 
   def on_delete_peer( index )
@@ -31,10 +25,10 @@ class Node
   end
 
 
-  def on_add_transaction( from, to, amount, id )
+  def on_add_transaction( from, to, qty, what, id )
     ## note: for now must always pass in id - why? why not? possible tx without id???
-    tx = Tx.new( from, to, amount, id )
-    if @bank.sufficient_funds?( tx.from, tx.amount ) && @bank.add_transaction( tx )
+    tx = Tx.new( from, to, qty, what, id )
+    if @exchange.sufficient_tulips?( tx.from, tx.qty, tx.what ) && @exchange.add_transaction( tx )
       send_transaction_to_peers( tx )
       return true
     else
@@ -42,9 +36,9 @@ class Node
     end
   end
 
-  def on_send( to, amount )
-    tx = @wallet.generate_transaction( to, amount )
-    if @bank.sufficient_funds?( tx.from, tx.amount ) && @bank.add_transaction( tx )
+  def on_send( to, qty, what )
+    tx = @wallet.generate_transaction( to, qty, what )
+    if @exchange.sufficient_tulips?( tx.from, tx.qty, tx.what ) && @exchange.add_transaction( tx )
       send_transaction_to_peers( tx )
       return true
     else
@@ -54,13 +48,13 @@ class Node
 
 
   def on_mine!
-    @bank.mine_block!
+    @exchange.mine_block!
     send_chain_to_peers
   end
 
   def on_resolve( data )
     chain_new = Blockchain.from_json( data )
-    if @bank.resolve!( chain_new )
+    if @exchange.resolve!( chain_new )
       send_chain_to_peers
       return true
     else
@@ -73,7 +67,7 @@ class Node
 private
 
   def send_chain_to_peers
-    data = JSON.pretty_generate( @bank.as_json )   ## payload in json
+    data = JSON.pretty_generate( @exchange.as_json )   ## payload in json
     @peers.each do |(host, port)|
       Net::HTTP.post(URI::HTTP.build(host: host, port: port, path: '/resolve'), data )
     end

data/lib/tulipmania/pool.rb

@@ -0,0 +1,42 @@
+####################################
+#  pending (unconfirmed) transactions (mem) pool
+
+class Pool
+  extend Forwardable
+  def_delegators :@transactions, :[], :size, :each, :empty?, :any?
+
+
+  def initialize( transactions=[] )
+    @transactions = transactions
+  end
+
+  def transactions() @transactions; end
+
+  def <<( tx )
+    @transactions << tx
+  end
+
+
+  def update!( txns_confirmed )
+    ## find a better name?
+    ##  remove confirmed transactions from pool
+
+    ##   document - keep only pending transaction not yet (confirmed) in blockchain ????
+    @transactions = @transactions.select do |tx_unconfirmed|
+      txns_confirmed.none? { |tx_confirmed| tx_confirmed.id == tx_unconfirmed.id }
+    end
+  end
+
+
+
+  def as_json
+    @transactions.map { |tx| tx.to_h }
+  end
+
+  def self.from_json( data )
+    ## note: assumes data is an array of block records/objects in json
+    transactions = data.map { |h| Tx.from_h( h ) }
+    self.new( transactions )
+  end
+
+end  # class Pool

data/lib/tulipmania/service.rb

@@ -0,0 +1,123 @@
+
+
+module Tulipmania
+
+class Service < Sinatra::Base
+
+  def self.banner
+    "tulipmania/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] on Sinatra/#{Sinatra::VERSION} (#{ENV['RACK_ENV']})"
+  end
+
+
+PUBLIC_FOLDER = "#{Tulipmania.root}/lib/tulipmania/public"
+VIEWS_FOLDER  = "#{Tulipmania.root}/lib/tulipmania/views"
+
+set :public_folder, PUBLIC_FOLDER # set up the static dir (with images/js/css inside)
+set :views, VIEWS_FOLDER # set up the views dir
+
+set :static, true # set up static file routing  -- check - still needed?
+
+
+set connections: []
+
+
+get '/style.css' do
+  scss :style    ## note: converts (pre-processes) style.scss to style.css
+end
+
+
+get '/' do
+  @node = node
+  erb :index
+end
+
+post '/send' do
+  node.on_send( params[:to], params[:qty].to_i, params[:what] )
+  settings.connections.each { |out| out << "data: added transaction\n\n" }
+  redirect '/'
+end
+
+
+post '/transactions' do
+  if node.on_add_transaction(
+    params[:from],
+    params[:to],
+    params[:qty].to_i,
+    params[:what],
+    params[:id]
+  )
+    settings.connections.each { |out| out << "data: added transaction\n\n" }
+  end
+  redirect '/'
+end
+
+post '/mine' do
+  node.on_mine!
+  redirect '/'
+end
+
+post '/peers' do
+  node.on_add_peer( params[:host], params[:port].to_i )
+  redirect '/'
+end
+
+post '/peers/:index/delete' do
+  node.on_delete_peer( params[:index].to_i )
+  redirect '/'
+end
+
+
+
+post '/resolve' do
+  data = JSON.parse(request.body.read)
+  if data['chain'] && node.on_resolve( data['chain'] )
+    status 202     ### 202 Accepted; see httpstatuses.com/202
+    settings.connections.each { |out| out << "data: resolved\n\n" }
+  else
+    status 200    ### 200 OK
+  end
+end
+
+
+get '/events', provides: 'text/event-stream' do
+  stream :keep_open do |out|
+    settings.connections << out
+    out.callback { settings.connections.delete(out) }
+  end
+end
+
+private
+
+#########
+## return network node (built and configured on first use)
+##   fix: do NOT use @@ - use a class level method or something
+def node
+  if defined?( @@node )
+    @@node
+  else
+    puts "[debug] tulipmania - build (network) node (address: #{Tulipmania.config.address})"
+    @@node = Node.new( address: Tulipmania.config.address )
+    @@node
+  end
+  ####
+  ## check why this is a syntax error:
+  ## @node ||= do
+  ##   puts "[debug] tulipmania - build (network) node (address: #{Tulipmania.config.address})"
+  ##   @node = Node.new( address: Tulipmania.config.address )
+  ## end
+end
+
+
+############
+## helpers
+
+def fmt_tulips( hash )
+   lines = []
+   hash.each do |what,qty|
+     lines << "#{what} × #{qty}"
+   end
+   lines.join( ', ' )
+end
+
+end # class Service
+end # module Tulipmania

data/lib/tulipmania/tool.rb

@@ -0,0 +1,66 @@
+# encoding: utf-8
+
+
+module Tulipmania
+
+class Tool
+
+def run( args )
+  opts = {}
+
+  parser = OptionParser.new do |cmd|
+    cmd.banner = "Usage: tulipmania [options]"
+
+    cmd.separator ""
+    cmd.separator "  Wallet options:"
+
+    cmd.on("-n", "--name=NAME", "Address name (default: Anne)") do |name|
+      ## use -a or --adr or --address as option flag - why? why not?
+      ##  note: default now picks a random address from WALLET_ADDRESSES
+      opts[:address] = name
+    end
+
+
+    cmd.separator ""
+    cmd.separator "  Server (node) options:"
+
+    cmd.on("-o", "--host HOST", "listen on HOST (default: 0.0.0.0)") do |host|
+      opts[:Host] = host    ## note: rack server handler expects :Host
+    end
+
+    cmd.on("-p", "--port PORT", "use PORT (default: 4567)") do |port|
+      opts[:Port] = port    ## note: rack server handler expects :Post
+    end
+
+    cmd.on("-h", "--help", "Prints this help") do
+      puts cmd
+      exit
+    end
+  end
+
+  parser.parse!( args )
+  pp opts
+
+
+  ###################
+  ## startup server (via rack interface/handler)
+
+  app_class = Service    ##  use  app = Service.new  -- why? why not?
+  host = opts[:Host] || '0.0.0.0'
+  port = opts[:Port] || '4567'
+
+  Tulipmania.configure do |config|
+    config.address = opts[:address] || 'Anne'
+  end
+
+  Rack::Handler::WEBrick.run( app_class, Host: host, Port: port ) do |server|
+      ## todo: add traps here - why, why not??
+  end
+
+
+end  ## method run
+
+
+end   ## class Tool
+
+end   ## module Tulipmania

data/lib/tulipmania/transaction.rb

@@ -2,21 +2,22 @@
 
 class Transaction
 
-  attr_reader :from, :to, :amount, :id
+  attr_reader :from, :to, :qty, :what, :id
 
-  def initialize( from, to, amount, id=SecureRandom.uuid )
+  def initialize( from, to, qty, what, id=SecureRandom.uuid )
     @from   = from
     @to     = to
-    @amount = amount
+    @qty    = qty
+    @what   = what      # tulip name - change to name or title - why? why not?
     @id     = id
   end
 
   def self.from_h( hash )
-    self.new *hash.values_at( 'from', 'to', 'amount', 'id' )
+    self.new *hash.values_at( 'from', 'to', 'qty', 'what', 'id' )
   end
 
   def to_h
-    { from: @from, to: @to, amount: @amount, id: @id }
+    { from: @from, to: @to, qty: @qty, what: @what, id: @id }
   end
 
 

data/lib/tulipmania/version.rb

@@ -2,7 +2,7 @@
 
 module Tulipmania
 
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 
   def self.root
     "#{File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )}"

data/lib/tulipmania/views/_blockchain.erb

@@ -1,14 +1,14 @@
 <div class="blockchain">
   <h2>
     Blockchain<br>
-    <span><%= @node.bank.chain.size %> blocks</span>
+    <span><%= @node.exchange.chain.size %> blocks</span>
   </h2>
   <form action="/mine" method="post">
     <input type="submit" class="button" value="Mine a Block">
   </form>
 
   <div class="blocks">
-    <% @node.bank.chain.last(10).reverse.each do |block| %>
+    <% @node.exchange.chain.last(10).reverse.each do |block| %>
       <div class="block">
         <div class="header">
           <%= block.index %> — <%= block.timestamp %><br>
@@ -20,10 +20,10 @@
                 <%= tx.id[0..2] %>
               </td>
               <td>
-                $<%= tx.amount %>
+                <%= tx.from[0..15] %> → <%= tx.to[0..15] %>
               </td>
               <td>
-                <%= tx.from[0..7] %> → <%= tx.to[0..7] %>
+                 <%= tx.what %> × <%= tx.qty %> 
               </td>
             </tr>
           <% end %>
@@ -31,4 +31,7 @@
       </div>
     <% end %>
   </div>
+  <p>
+    †: Grower Transaction - New Tulips on the Market!
+  </p>
 </div>

data/lib/tulipmania/views/_ledger.erb

@@ -3,12 +3,12 @@
   <table>
     <tr>
       <th>Address</th>
-      <th>Balance</th>
+      <th>Tulips</th>
     </tr>
-    <% @node.bank.ledger.wallets.each do |address, amount| %>
+    <% @node.exchange.ledger.wallets.each do |address, tulips| %>
       <tr>
         <td><%= address[0..15] %></td>
-        <td>$<%= amount %></td>
+        <td><%= fmt_tulips( tulips ) %></td>
       </tr>
     <% end %>
   </table>

data/lib/tulipmania/views/_pending_transactions.erb

@@ -1,18 +1,20 @@
 <div class="pending-transactions">
   <h2>Pending Transactions</h2>
-  <% if @node.bank.pending.any? %>
+  <% if @node.exchange.pending.any? %>
     <table>
       <tr>
         <th>From</th>
         <th>To</th>
-        <th>$</th>
+        <th>What</th>
+        <th>Qty &nbsp;</th>
         <th>Id</th>
       </tr>
-      <% @node.bank.pending.each do |tx| %>
+      <% @node.exchange.pending.each do |tx| %>
         <tr>
           <td><%= tx.from[0..15] %></td>
           <td><%= tx.to[0..15] %></td>
-          <td><%= tx.amount %></td>
+          <td><%= tx.what %></td>
+          <td>× <%= tx.qty %></td>
           <td><%= tx.id[0..2] %></td>
         </tr>
       <% end %>

data/lib/tulipmania/views/_wallet.erb

@@ -3,14 +3,38 @@
   <div class="details">
     <h2>Address</h2>
     <div><%= @node.wallet.address %></div>
-    <h2>Balance</h2>
-    <div class="balance">$<%= @node.bank.ledger.wallets[@node.wallet.address] || 0 %></div>
+    <h2>Tulips</h2>
+    <div class="balance"><%= fmt_tulips(@node.exchange.ledger.wallets[@node.wallet.address] || {}) %></div>
   </div>
   <form action="/send" method="post" class="transaction-form">
-    <label for="to">To</label>
-    <input type="text" name="to" id="to" placeholder="address" />
-    <label for="amount">Amount</label>
-    <input type="text" name="amount" id="amount" />
-    <input type="submit" class="button" value="Send" /><br>
+
+
+  <div style="display: flex; align-items: center; padding: 4px;">
+     <div>
+       <label for="to">To</label>
+       <input type="text" name="to" id="to" placeholder="address" size="7" />
+     </div>
+      <div>
+      <%  Tulipmania.config.tulips.each_with_index do |tulip,i|
+             enabled = @node.exchange.ledger.sufficient_tulips?( @node.wallet.address, 1, tulip )
+             next unless enabled   ## skip tulips w/o balance for now
+       %>
+       <div style="padding: 2px;">
+         <input type="radio" id="what<%= i %>" name="what" value="<%= tulip %>"
+            <%= enabled ?  '' : 'disabled' %> >
+         <label for="what<%= i %>" style="text-align: left;"
+            <%= enabled ?  '' : 'disabled' %> ><%= tulip %></label>
+       </div>
+      <% end %>
+    </div>
+
+   <div>
+    <label for="qty">Qty</label>
+    <input type="text" name="qty" id="qty" placeholder="1,2,3,..." size="3" />
+  </div>
+    <div style="padding-left: 6px;">
+      <input type="submit" class="button" value="Send" />
+    </div>
+  </div> <!-- inner flex box -->
   </form>
 </div>

data/lib/tulipmania/views/index.erb

@@ -1,12 +1,12 @@
 <!DOCTYPE html>
 <html>
   <head>
-    <title>Central Bank Node</title>
+    <title>Tulipmania (Anno 1637) Node</title>
     <link rel="stylesheet" href="style.css">
   </head>
   <body>
 
-    <h1>Central Bank Node</h1>
+    <h1>Tulipmania (Anno 1637) Node</h1>
 
     <div class="columns">
       <div class="left">

data/lib/tulipmania/views/style.scss

@@ -16,11 +16,11 @@ body {
   display: flex;
 
   .left {
-    width: 66%;
+    width: 50%;
   }
 
   .right {
-    width: 34%;
+    width: 50%;
   }
 }
 
@@ -45,7 +45,7 @@ h2 span {
 
 label {
   display: inline-block;
-  width: 80px;
+  // width: 80px;
   text-align: right;
   padding-right: 10px;
 }
@@ -105,7 +105,7 @@ input[type=submit].small {
  }
 
   .balance {
-   font-size: 30px;
+   font-size: 22px;
   }
 }
 

data/lib/tulipmania/wallet.rb

@@ -8,8 +8,8 @@ class Wallet
     @address = address
   end
 
-  def generate_transaction( to, amount )
-    Tx.new( address, to, amount )
+  def generate_transaction( to, qty, what )
+    Tx.new( address, to, qty, what )
   end
 
 end  # class Wallet

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tulipmania
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-18 00:00:00.000000000 Z
+date: 2017-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sinatra
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: 1.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -83,21 +83,23 @@ dependencies:
 description: tulipmania - 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 HTTPprint 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
+  peer-to-peer over HTTP; revolutionize the world one block at a time
 email: ruby-talk@ruby-lang.org
-executables: []
+executables:
+- tulipmania
 extensions: []
 extra_rdoc_files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 - Rakefile
+- bin/tulipmania
 - lib/tulipmania.rb
 - lib/tulipmania/block.rb
 - lib/tulipmania/blockchain.rb
@@ -105,6 +107,9 @@ files:
 - lib/tulipmania/exchange.rb
 - lib/tulipmania/ledger.rb
 - lib/tulipmania/node.rb
+- lib/tulipmania/pool.rb
+- lib/tulipmania/service.rb
+- lib/tulipmania/tool.rb
 - lib/tulipmania/transaction.rb
 - lib/tulipmania/version.rb
 - lib/tulipmania/views/_blockchain.erb
@@ -143,7 +148,5 @@ specification_version: 4
 summary: tulipmania - 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 HTTPprint 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
+  over HTTP; revolutionize the world one block at a time
 test_files: []