centralbank 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f068e40d44f33359ab2e4e52a1cc4225a5f8889f
-  data.tar.gz: 9e5e516e4ad710ca788cec1127b38ff195963a4e
+  metadata.gz: 2515cd5ffc9b10106967ee1a9a9debb055f903ed
+  data.tar.gz: 66659648d73015c121fb89fe5e9b1027efd80480
 SHA512:
-  metadata.gz: '0810cd371d9696b64d1e03db898da57878c93f10918f4498742b71cb79e792ba032e8700450636870ba64006b02ca33b8702816c623e6c532fa9a98aa1327b98'
-  data.tar.gz: 7a5fc1f5039caa7b62a3439cbbb47660b905145b92922e363ed9fbd3afadf5db13440096e06dfbee40e3270cb665ac8a53c7ff0d37d5989e92970bb60c26fd59
+  metadata.gz: eddc4d10f787ba4e3822f794f1bcf9fe2eb3fe45d01abddd9a6ec46d19d4d34d6097c7a6d93045d33b5576f8c36d6b8e9594a821a79920d8aa31b185e6792824
+  data.tar.gz: ac3528bc56a2e997e273696e334bfdefa6fc5bd614a6b64cae09cec5bd2cb05011502d229b155c97d50faecd61215e7ce2dc9b1eab11bbcebd34eee82021e981

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/centralbank
 lib/centralbank.rb
 lib/centralbank/bank.rb
 lib/centralbank/block.rb
@@ -9,7 +11,9 @@ lib/centralbank/blockchain.rb
 lib/centralbank/cache.rb
 lib/centralbank/ledger.rb
 lib/centralbank/node.rb
-lib/centralbank/public/style.css
+lib/centralbank/pool.rb
+lib/centralbank/service.rb
+lib/centralbank/tool.rb
 lib/centralbank/transaction.rb
 lib/centralbank/version.rb
 lib/centralbank/views/_blockchain.erb
@@ -18,4 +22,5 @@ lib/centralbank/views/_peers.erb
 lib/centralbank/views/_pending_transactions.erb
 lib/centralbank/views/_wallet.erb
 lib/centralbank/views/index.erb
+lib/centralbank/views/style.scss
 lib/centralbank/wallet.rb

data/README.md

@@ -1,9 +1,67 @@
-# Central Bank
+# centralbank library / gem and command line tool
 
+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
 
 
+* home  :: [github.com/openblockchains/centralbank](https://github.com/openblockchains/centralbank)
+* bugs  :: [github.com/openblockchains/centralbank/issues](https://github.com/openblockchains/centralbank/issues)
+* gem   :: [rubygems.org/gems/centralbank](https://rubygems.org/gems/centralbank)
+* rdoc  :: [rubydoc.info/gems/centralbank](http://rubydoc.info/gems/centralbank)
 
-## Todos
 
-- [ ] add a Pool class (for pending transaction pool) !!!!!
-- [ ] add secure versions with signature e.g. SecureWallet, SecureTransaction, etc.
+
+
+## Development 
+
+For local development - clone or download (and unzip) the centralbank code repo.
+Next install all dependencies using bundler with a Gemfile e.g.:
+
+``` ruby
+# Gemfile
+
+source "https://rubygems.org"
+
+gem 'sinatra'
+gem 'sass'
+gem 'blockchain-lite'
+```
+
+run
+
+```
+$ bundle       ## will use the Gemfile (see above)
+```
+
+and now you're ready to run your own centralbank server node. Use the [`config.ru`](config.ru) script for rack:
+
+``` ruby
+# config.ru
+
+$LOAD_PATH << './lib'
+
+require 'centralbank'
+
+run Centralbank::Service
+```
+
+and startup the money printing machine 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!
+
+![](centralbank.png)
+
+
+Happy mining! 
+
+
+
+## License
+
+![](https://publicdomainworks.github.io/buttons/zero88x31.png)
+
+The `centralbank` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.

data/Rakefile

@@ -18,7 +18,9 @@ Hoe.spec 'centralbank' do
   self.history_file = 'History.md'
 
   self.extra_deps = [
-    ['sinatra', '>=2.0']
+    ['sinatra', '>=2.0'],
+    ['sass'],   ## used for css style preprocessing (scss)
+    ['blockchain-lite', '>=1.3.1'],
   ]
 
   self.licenses = ['Public Domain']

data/bin/centralbank

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

data/lib/centralbank.rb

@@ -6,14 +6,14 @@ require 'digest'
 require 'net/http'
 require 'set'
 require 'pp'
-
-## require 'blockchain-lite'
-## Block = BlockchainLite::Basic::Block
+require 'optparse'    ## note: used for command line tool (see Tool in tool.rb)
 
 
 ### 3rd party gems
-require 'sinatra/base'    # note: use "modular" sinatra app / service
+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)
 
 
 ### our own code
@@ -22,105 +22,64 @@ require 'centralbank/block'
 require 'centralbank/cache'
 require 'centralbank/transaction'
 require 'centralbank/blockchain'
+require 'centralbank/pool'
 require 'centralbank/bank'
 require 'centralbank/ledger'
 require 'centralbank/wallet'
 
 require 'centralbank/node'
+require 'centralbank/service'
 
+require 'centralbank/tool'    ## add (optional) command line tool
 
 
 
-module Centralbank
-
-class Service < Sinatra::Base
-
-  def self.banner
-    "centralbank/#{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' )
-
 
-PUBLIC_FOLDER = "#{Centralbank.root}/lib/centralbank/public"
-VIEWS_FOLDER  = "#{Centralbank.root}/lib/centralbank/views"
 
-puts "[centralbank] boot - setting public folder to: #{PUBLIC_FOLDER}"
-puts "[centralbank] boot - setting views folder to: #{VIEWS_FOLDER}"
+module Centralbank
 
-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?
+  class Configuration
+     ## user/node settings
+     attr_accessor :address   ## single wallet address (for now "clear" name e.g.Sepp, Franz, etc.)
 
+     WALLET_ADDRESSES = %w[Alice Bob Max Franz Maria Ferdl Lisi Adam Eva]
 
-set connections: []
+     ## system/blockchain settings
+     attr_accessor :coinbase
+     attr_accessor :mining_reward
 
 
+     def initialize
+       ## try default setup via ENV variables
+       ## pick "random" address if nil (none passed in)
+       @address = ENV[ 'CENTRALBANK_NAME'] || WALLET_ADDRESSES[rand( WALLET_ADDRESSES.size )]
 
-get '/' do
-  @node = NODE
-  erb :index
-end
+       @coinbase      = 'COINBASE'   ## use a different name - why? why not?
+       @mining_reward = 5
+     end
+  end # class Configuration
 
-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
+  ##   Centralbank.configure do |config|
+  ##      config.address = 'Sepp'
+  ##   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 Centralbank
 
 

data/lib/centralbank/bank.rb

@@ -1,28 +1,27 @@
 
 
-
-
 class Bank
   attr_reader :pending, :chain, :ledger
 
-  COINBASE      = "COINBASE"
-  MINING_REWARD = 5
-
 
   def initialize( address )
     @address = address
 
-    @cache = Cache.new( 'data.json' )
+    ## note: add address name for now to cache
+    ##          allows to start more nodes in same folder / directory
+    @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 ) }
+      ## restore pending (unconfirmed) transactions pool too
+      @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( Centralbank.config.coinbase,
+                          @address,
+                          Centralbank.config.mining_reward )]    # genesis (big bang!) starter block
+      @pending = Pool.new
     end
 
     ## update ledger (balances) with confirmed transactions
@@ -32,11 +31,13 @@ class Bank
 
 
   def mine_block!
-    add_transaction( Tx.new( COINBASE, @address, MINING_REWARD ))
+    add_transaction( Tx.new( Centralbank.config.coinbase,
+                             @address,
+                             Centralbank.config.mining_reward ))
 
     ## add mined (w/ computed/calculated hash) block
-    @chain << @pending
-    @pending = []
+    @chain << @pending.transactions
+    @pending = Pool.new   ## clear out/ empty pool (just create a new one for now)
 
     ## update ledger (balances) with new confirmed transactions
     @ledger = Ledger.new( @chain )
@@ -76,13 +77,8 @@ class Bank
       ## update ledger (balances) with new confirmed transactions
       @ledger = Ledger.new( @chain )
 
-
-      _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
+      ## document - keep only pending transaction not  yet (confirmed) in (new) blockchain ????
+      @pending.update!( @chain.transactions )
       @cache.write as_json
       return true
     else
@@ -94,7 +90,7 @@ class Bank
 
   def as_json
     { chain:        @chain.as_json,
-      transactions: @pending.map { |tx| tx.to_h }
+      transactions: @pending.as_json
     }
   end
 
@@ -107,7 +103,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 Bank

data/lib/centralbank/block.rb

@@ -1,53 +1,41 @@
 
-##################
-# todo: add proof-of-work (nounce calculation) !!!!
-#
-
-class Block
-
-  attr_reader :index, :timestamp, :transactions, :previous_hash, :hash
-
-  def initialize( index, transactions, previous_hash )
-    @index         = index
-    @timestamp     = Time.now.utc    ## note: use coordinated universal time (utc)
-    @transactions  = transactions
-    @previous_hash = previous_hash
-    @hash          = calc_hash
-  end
-
-  def calc_hash
-    sha = Digest::SHA256.new
-    sha.update( @index.to_s + @time.to_s + @transactions.to_s + @previous_hash )
-    sha.hexdigest
-  end
 
+Block = BlockchainLite::ProofOfWork::Block
 
-  def self.first( transactions )    # create genesis (big bang! first) block
-    ## uses index zero (0) and arbitrary previous_hash ('0')
-    self.new( 0, transactions, '0' )
-  end
+## see https://github.com/openblockchains/blockchain.lite.rb/blob/master/lib/blockchain-lite/proof_of_work/block.rb
 
-  def self.next( previous, transactions )
-    self.new( previous.index+1, transactions, previous.hash )
-  end
+######
+## add more methods
 
+class Block
 
 
 def to_h
-  { index:         @index,
-    timestamp:     @timestamp,
-    transactions:  @transactions.map { |tx| tx.to_h },
-    previous_hash: @previous_hash }
+  { index:             @index,
+    timestamp:         @timestamp,
+    nonce:             @nonce,
+    transactions:      @transactions.map { |tx| tx.to_h },
+    transactions_hash: @transactions_hash,
+    previous_hash:     @previous_hash,
+    hash:              @hash }
 end
 
 def self.from_h( h )
   transactions = h['transactions'].map { |h_tx| Tx.from_h( h_tx ) }
+
+  ## todo: use hash and transactions_hash to check integrity of block - why? why not?
+
+  ## parse iso8601 format e.g 2017-10-05T22:26:12-04:00
+  timestamp    = Time.parse( h['timestamp'] )
+
   self.new( h['index'],
-            ## h['timestamp'], -- fix!!!: change use keyword params (make timestamp optional)
             transactions,
-            h['previous_hash'] )
+            h['previous_hash'],
+            timestamp: timestamp,
+            nonce: h['nonce'].to_i )
 end
 
+
 def valid?
   true   ## for now always valid
 end

data/lib/centralbank/blockchain.rb

@@ -3,7 +3,7 @@
 
 class Blockchain
   extend Forwardable
-  def_delegators :@chain, :[], :size, :each, :empty?, :last
+  def_delegators :@chain, :[], :size, :each, :empty?, :any?, :last
 
 
   def initialize( chain=[] )

data/lib/centralbank/ledger.rb

@@ -10,7 +10,7 @@ class Ledger
   end
 
   def sufficient_funds?( wallet, amount )
-    return true   if wallet == Bank::COINBASE   ### use Config::COINBASE why? why not ???
+    return true   if wallet == Centralbank.config.coinbase
     @wallets.has_key?( wallet ) && @wallets[wallet] - amount >= 0
   end
 
@@ -20,7 +20,7 @@ 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.from] -= tx.amount   unless tx.from == Centralbank.config.coinbase
         @wallets[tx.to] ||= 0
         @wallets[tx.to] += tx.amount
       end

data/lib/centralbank/node.rb

@@ -3,13 +3,7 @@
 class Node
   attr_reader :id, :peers, :wallet, :bank
 
-
-  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 )]
-
+  def initialize( address: )
     @id     = SecureRandom.uuid
     @peers  = []
     @wallet = Wallet.new( address )

data/lib/centralbank/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/centralbank/service.rb

@@ -0,0 +1,114 @@
+# encoding: utf-8
+
+module Centralbank
+
+  class Service < Sinatra::Base
+
+    def self.banner
+      "centralbank/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] on Sinatra/#{Sinatra::VERSION} (#{ENV['RACK_ENV']})"
+    end
+
+
+  PUBLIC_FOLDER = "#{Centralbank.root}/lib/centralbank/public"
+  VIEWS_FOLDER  = "#{Centralbank.root}/lib/centralbank/views"
+
+  puts "[centralbank] boot - setting public folder to: #{PUBLIC_FOLDER}"
+  puts "[centralbank] boot - setting views folder to: #{VIEWS_FOLDER}"
+
+  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: []
+
+
+    #########
+    ## 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] centralbank - build (network) node (address: #{Centralbank.config.address})"
+        @@node = Node.new( address: Centralbank.config.address )
+        @@node
+      end
+      ####
+      ## check why this is a syntax error:
+      ## @node ||= do
+      ##   puts "[debug] centralbank - build (network) node (address: #{Centralbank.config.address})"
+      ##   @node = Node.new( address: Centralbank.config.address )
+      ## end
+    end
+
+  get '/style.css' do
+    scss :style    ## note: converts (pre-processes) style.scss to style.css
+  end
+
+
+  get '/' do
+    @node = node   ## todo: pass along node as hash varialbe / assigns to erb
+    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
+
+
+  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" }
+    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
+  
+
+  end # class Service
+
+end # module Centralbank

data/lib/centralbank/tool.rb

@@ -0,0 +1,66 @@
+# encoding: utf-8
+
+
+module Centralbank
+
+class Tool
+
+def run( args )
+  opts = {}
+
+  parser = OptionParser.new do |cmd|
+    cmd.banner = "Usage: centralbank [options]"
+
+    cmd.separator ""
+    cmd.separator "  Wallet options:"
+
+    cmd.on("-n", "--name=NAME", "Address name (default: Alice)") 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'
+
+  Centralbank.configure do |config|
+    config.address = opts[:address] || 'Alice'
+  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 Centralbank

data/lib/centralbank/version.rb

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

data/lib/centralbank/{public/style.css → views/style.scss}

@@ -1,25 +1,30 @@
+
 body {
-  background: #fff;
-  font-family: 'menlo', monospace;
-  color: #2B2D2F;
   padding: 0;
   margin: 0;
-  font-size: 14px;
   min-width: 960px;
+
+  font-family: 'menlo', monospace;
+  font-size: 14px;
+
+  background: #fff;
+  color: #2B2D2F;
 }
 
+
 .columns {
   display: flex;
-}
 
-.left {
-  width: 66%;
-}
+  .left {
+    width: 66%;
+  }
 
-.right {
-  width: 34%;
+  .right {
+    width: 34%;
+  }
 }
 
+
 h1 {
   font-size: 24px;
   font-weight: normal;
@@ -27,6 +32,7 @@ h1 {
   margin-bottom: 20px;
 }
 
+
 h2 {
   font-size: 16px;
 }
@@ -55,17 +61,18 @@ input[type=text] {
 table {
   border-spacing: 0;
   border-collapse: collapse;
-}
 
-th {
-  text-align: left;
-}
+  th {
+    text-align: left;
+  }
 
-td {
-  vertical-align: top;
-  padding: 5px 15px 5px 0;
+  td {
+    vertical-align: top;
+    padding: 5px 15px 5px 0;
+  }
 }
 
+
 ul {
   list-style: none;
   padding: 0;
@@ -87,77 +94,79 @@ input[type=submit].small {
   padding: 4px 10px;
 }
 
-.wallet,
-.pending-transactions,
-.peers,
-.ledger,
-.blockchain {
-  padding: 15px;
-}
+
 
 .wallet {
+  padding: 15px;
   background: #7FDBFF;
-}
 
-.wallet h2 {
-  margin-bottom: 0;
-}
+  h2 {
+   margin-bottom: 0;
+ }
 
-.balance {
-  font-size: 30px;
+  .balance {
+   font-size: 30px;
+  }
 }
 
+
 .pending-transactions {
+  padding: 15px;
   background: #A3E6FF;
 }
 
 .peers {
+  padding: 15px;
   background: #C6EFFF;
-}
 
-.peers li form {
-  display: inline;
+  li form {
+    display: inline;
+  }
+
+  li {
+    padding: 5px 0px;
+  }
 }
 
+
 .ledger {
+  padding: 15px;
   background: #E3F7FF;
 }
 
+
 .blockchain {
+  padding: 15px;
   position: relative;
   background: #001F3F;
   color: #fff;
-}
-
-.blockchain form {
-  position: absolute;
-  top: 30px;
-  right: 15px;
-}
-
-.blocks {
-  border: 1px solid #597898;
-  border-bottom: 0;
-}
-
-.block {
-  margin: 0;
-  border-bottom: 2px dashed #597898;
-  padding: 10px;
-}
-
-.block .header {
-  text-align: center;
-  padding: 0 8px 8px 8px;
-  color: #597898;
-  border-bottom: 1px solid #354c63;
-  margin-bottom: 10px;
-}
-
-.block .id {
-  color: #597898;
-}
 
-.peers li {
-  padding: 5px 0px;
+  form {
+    position: absolute;
+    top: 30px;
+    right: 15px;
+  }
+
+  .blocks {
+    border: 1px solid #597898;
+    border-bottom: 0;
+
+     .block {
+      margin: 0;
+      border-bottom: 2px dashed #597898;
+      padding: 10px;
+
+      .header {
+        text-align: center;
+        padding: 0 8px 8px 8px;
+        color: #597898;
+        border-bottom: 1px solid #354c63;
+        margin-bottom: 10px;
+      }
+
+      .id {
+        color: #597898;
+      }
+    }
+  }
 }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: centralbank
 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-14 00:00:00.000000000 Z
+date: 2017-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sinatra
@@ -24,6 +24,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: blockchain-lite
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -56,17 +84,21 @@ description: centralbank - print your own money / cryptocurrency; run your own f
   central bank nodes on the blockchain peer-to-peer over HTTP; revolutionize the world
   one block at a time
 email: ruby-talk@ruby-lang.org
-executables: []
+executables:
+- centralbank
 extensions: []
 extra_rdoc_files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 files:
 - HISTORY.md
+- LICENSE.md
 - Manifest.txt
 - README.md
 - Rakefile
+- bin/centralbank
 - lib/centralbank.rb
 - lib/centralbank/bank.rb
 - lib/centralbank/block.rb
@@ -74,7 +106,9 @@ files:
 - lib/centralbank/cache.rb
 - lib/centralbank/ledger.rb
 - lib/centralbank/node.rb
-- lib/centralbank/public/style.css
+- lib/centralbank/pool.rb
+- lib/centralbank/service.rb
+- lib/centralbank/tool.rb
 - lib/centralbank/transaction.rb
 - lib/centralbank/version.rb
 - lib/centralbank/views/_blockchain.erb
@@ -83,6 +117,7 @@ files:
 - lib/centralbank/views/_pending_transactions.erb
 - lib/centralbank/views/_wallet.erb
 - lib/centralbank/views/index.erb
+- lib/centralbank/views/style.scss
 - lib/centralbank/wallet.rb
 homepage: https://github.com/openblockchains/centralbank
 licenses: