casper_network 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5690859dc418eff2224b41b3001cb2c61bd3ec34df10249a4a5d13d42fba979d
-  data.tar.gz: d5faa5ae453065ddae80766f33332c24c4b6f3fe9a6aa530a007f5fc806d1f38
+  metadata.gz: 3446db6dad9ec70e0ad842479120abfe4cb919a7c65be7af300da5473a6e342f
+  data.tar.gz: d101cdc5acccc2ea222fb41a36baf819499cea70faaad98c8cbeb35a7955a833
 SHA512:
-  metadata.gz: 7c7f495af10f0ea7c22a392ac6401e57545d748b52adf8d6b987592646d42eb67b8ca2155d9ed7d43e7ac808819bcd5d754c393fb747bd12d6e53b87d6e1477c
-  data.tar.gz: fa704d9f40f44c1099aa2b08ea2452b8e4731fd01356a3d574bb17f9d982de494117ef50aaf7cd92dab65117c6d05ff33b1429c29607f269dc1388350f1633ef
+  metadata.gz: eb48b8c657010cfd2327c2d6ce1b060b29742084a0df40b682b03819f958c0c4c25aacc31c7049a5f749ad97aa92b53318274ae9cca98e3774d15c4e8db03ba7
+  data.tar.gz: 5e14e5e989ff7078464ff63caafccf41c38bd3fc4c0b378a2119da76a92481c06783f4a34a5e578baed18568086935398ffbe1555ee7889c140e0d25a5f551fa

data/README.md

@@ -42,28 +42,24 @@ gem build casper_network.gemspec
 # Install RSpec
 gem install rspec
 # Run the test
-rspec spec/testnet_spec.rb
-rspec spec/mainnet_spec.rb
+bundle exec rspec
+# To see the test results in detail
+bundle exec rspec -fd
 ```
 
-## Testnet Tests
+## How run each test file individually 
 ```bash
 git checkout main
 # Run the test
-rspec spec/testnet_spec.rb
+rspec spec/file_name.rb
 # To see the test results in detail
+rspec -fd spec/file_name.rb
+# Example:
+rspec spec/testnet_spec.rb
+# To see results in details
 rspec -fd spec/testnet_spec.rb
-# Test for cltypes
-rspec -fd spec/cl_types_spec.rb
 ```
 
-## Mainnet Tests
-```bash
-# Run the test
-rspec spec/mainnet_spec.rb
-# To see the test results in detail
-rspec -fd spec/mainnet_spec.rb
-```
 
 ## How to generate docs
 ```bash
@@ -74,7 +70,269 @@ yardoc lib/**/*.rb lib/*.rb - README.md LICENSE CONTRIBUTING.md SECURITY.md
 yardoc --help 
 ```
 
+## Documentation:
+### Casper-Ruby-Sdk RPC
+* [info_get_peers](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#info_get_peers)
+* [chain_get_StateRootHash](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-state_root_hash)
+* [info_get_deploy](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-deploy)
+* [info_get_status](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-status)
+* [chain_get_block_transfers](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-block-transfers)
+* [chain_get_block](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-block-by-hash)
+* [chain_get_eraInfo_by_SwitchBlock](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-era-summary-by-switch-block-hash)
+* [state_get_item](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get--state-item)
+* [state_get_dictionary_item](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-dictionary-item)
+* [state_get_balance](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-account-balance)
+* [state_get_AuctionInfo](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#get-auction-state)
+* [put_deploy](https://github.com/saitgulmez/casper-ruby-sdk/blob/main/docs/rpc.md#put-deploy)
+
+
 ## Usage examples
+
+## Include 'casper_network' gem into the source file
+
+```ruby
+require 'casper_network'
+```
+## Create a Client
+
+Pass the node ip address to constructor
+
+```ruby
+node_ip_address = "5.9.23.55" # IP is taken from "testnet"
+client = Casper::CasperClient.new(node_ip_address)
+```
+## RPC Calls
+
+### Get network peers list
+
+Retrieves the list of connected peers.
+
+```ruby
+peers = client.info_get_peers
+# Retrieve to the first peer object
+peer = peers[0]
+# Retrieve to info of the first peer object
+node_id = peer[0].get_node_id
+address = peer[0].get_address
+```
+
+### Get State Root Hash
+
+Retrieves  the state root hash String.
+
+```ruby
+state_root_hash = client.chain_get_StateRootHash
+```
+
+### Get Deploy
+
+Retrieves a Deploy object from the network.
+
+call parameters :
+- deploy hash
+
+```ruby
+deploy_hash = "0806cc477a5282574bc5302d7598cd33a09875704c5fef9264d984535c945e31"
+deploy =  client.info_get_deploy(deploy_hash)
+# Deploy members
+hash = Casper::Entity::DeployHash.new(deploy.get_hash)
+header = Casper::Entity::DeployHeader.new(deploy.get_header)
+payment = deploy.get_payment
+session = deploy.get_session
+```
+
+### Get Node Status
+
+Retrieves the current status of the node.
+
+```ruby
+node_status = client.info_get_status
+# Examples of retrieving and printing the members of node status
+puts node_status.get_api_version
+puts node_status.get_chainspec_name
+puts node_status.get_starting_state_root_hash
+puts node_status.get_peers
+puts node_status.get_last_added_block_info
+puts node_status.get_our_public_signing_key
+puts node_status.get_round_length
+puts node_status.get_next_upgrade
+puts node_status.get_build_version
+puts node_status.get_uptime
+```
+
+### Get BlockTransfers
+
+Retrieve all transfers for a Block from the network
+
+```ruby
+# block_Hash taken from Testnet
+block_hash = "ff2ad232c3efc22a385fce44df844fc696e904ce8ba78599a576aa68c76889c4"
+transfers = client.chain_get_block_transfers(block_hash)
+# Examples of accessing and printing the members of each transfer object
+transfers.each do |transfer|
+  puts transfer.get_deploy_hash
+  puts transfer.get_from
+  puts transfer.get_to
+  puts transfer.get_source
+  puts transfer.get_target
+  puts transfer.get_amount
+  puts transfer.get_gas
+  puts transfer.get_id
+end
+```
+
+### Get Block
+
+Retrieve a Block object from the network
+
+```ruby
+block_hash = "ff2ad232c3efc22a385fce44df844fc696e904ce8ba78599a576aa68c76889c4"
+block = client.chain_get_block(block_hash)
+puts block # => It is an instance of Block
+# To retrieve BlockHeader object
+block_header =  block.get_header
+puts block_header
+# To access and print members of the block_header object (block_header is an instance of BlockHeader )
+puts block_header.get_parent_hash
+puts block_header.get_state_root_hash
+puts block_header.get_body_hash
+puts block_header.get_random_bit
+puts block_header.get_accumulated_seed
+puts block_header.get_era_end
+puts block_header.get_timestamp
+puts block_header.get_era_id
+puts block_header.get_height
+puts block_header.get_protocol_version
+
+# To retrieve BlockBody object
+block_body = block.get_body
+# To access and print members of the block_body object (block_body is an instance of BlockBody )
+puts block_body
+puts block_body.get_proposer
+puts block_body.get_deploy_hashes
+puts block_body.get_transfer_hashes
+
+# To retrieve an array of BlockProof objects
+proofs = block.get_proofs
+# To access and print members of the block_proof objects (block_proof is an instance of BlockProof )
+puts proofs
+# To access and print each proof object and its members
+i = 0
+proofs.each do |proof|
+  puts "proofs[#{i}]: #{proof}"
+  puts "public_key: " + proof.get_public_key
+  puts "signature: "  + proof.get_signature
+  i += 1
+end
+```
+
+### Get EraInfo By Switch Block
+
+Retrieves an EraSummury object.
+
+```ruby
+block_hash = "d2077716e5b8796723c5720237239720f54e6ada54e3357f2c4896f2a51a6d8f"
+era_summary = client.chain_get_eraInfo_by_SwitchBlock(block_hash)
+puts era_summary # => It is an instance of EraSummary
+puts era_summary.get_block_hash
+puts era_summary.get_era_id
+puts era_summary.get_stored_value # => Retrieve and print the instance of StoredValue
+puts era_summary.get_stored_value.get_stored_value
+puts era_summary.get_state_root_hash
+puts era_summary.get_merkle_proof
+```
+
+### Get StateItem
+
+Retrieves a StoredValue object.
+
+```ruby
+node_ip_address = "65.108.78.120" # => Taken from the Mainnet
+client = Casper::CasperClient.new(node_ip_address)
+# Retrieve the stored_value object which is an instance of StoredValue
+stored_value = client.state_get_item("647C28545316E913969B032Cf506d5D242e0F857061E70Fb3DF55980611ace86", "bid-24b6D5Aabb8F0AC17D272763A405E9CECa9166B75B745Cf200695E172857c2dD", [])
+puts stored_value # => #<Casper::Entity::StoredValue:0x0000000003767a48>
+puts stored_value.get_key # => Bid
+puts stored_value.get_bid # => Retrieve and print Bid object related data
+# or
+puts stored_value.get_stored_value # => Retrieve and print Bid object related data
+```
+
+### Get DictionaryItem
+
+Retrieves a CLValue object.
+
+```ruby
+node_ip_address = "65.108.78.120" # => Taken from Mainnet
+client = Casper::CasperClient.new(node_ip_address)
+state_root_hash = "7b605ad991c949832fd966495afc3f97a2b8122a1a6afc2610b545a8c07e3456"
+item_key = "f870e3cadfde21d7d7686fdf3d1a8413838274d363ca7b27ae71fc9125eb6743"
+uref = "uref-0d689e987db7ee5be246282c3a7badf0411e34baeeab8e9d73c1223ae4ad02e5-007"
+# Retrieve folowing data from the network and convert it into its proper CLValue 
+# {"CLValue"=>{"cl_type"=>"String", "bytes"=>"1a00000068747470733a2f2f636173706572636f6d6d756e6974792e696f", "parsed"=>"https://caspercommunity.io"}}
+stored_value = client.state_get_dictionary_item(state_root_hash, item_key, uref)
+puts stored_value # => #<CLString:0x0000000002b3c8e0>
+puts stored_value.get_cl_type # => String
+puts stored_value.get_value # => https://caspercommunity.io
+puts CLValueBytesParsers::CLStringBytesParser.to_bytes(stored_value.get_value) # => 1a00000068747470733a2f2f636173706572636f6d6d756e6974792e696f
+```
+
+### Get Balance
+
+Retrieves the balances(in motes) of an account
+
+Parameters :
+
+- state root hash
+- account uref hash
+
+```ruby
+node_ip_address = "65.108.78.120" # => Taken from Mainnet
+client = Casper::CasperClient.new(node_ip_address)
+state_root_hash = "610e932aef10d3e1fa04940c79a4a2789ee79c17046f1a9b45a2919f3600f3d5"
+uref = "uref-7de5e973b7d70bc2b328814411f2009aafd8dba901cfc2c588ba65088dcd22bb-007"
+balance = client.state_get_balance(state_root_hash, uref)
+puts balance # => 29269647684075  (current balance  9/24/2022)
+```
+
+### Get current auction state
+
+Retrieves an AutionState object.
+
+call parameters :
+- block hash
+
+```ruby
+# block_Hash taken from MainNet
+block_hash = "5fdbdf3fa70d37821aa2d1752743e9653befc15e65e40c2655e1ce93a807260f"
+node_ip_address = "65.108.78.120" # => Taken from Mainnet
+client = Casper::CasperClient.new(node_ip_address)
+auction = client.state_get_AuctionInfo
+# Retrieve and print an instance of AuctionState entity
+puts auction # => #<Casper::Entity::AuctionState:0x0000000003306bc0>
+# Retrieve and print state root hash as a String value
+puts auction.get_state_root_hash # => "6448b55f1dd7c9ad337f4fd4c77586d7ae30da146e0b340932aba7e7efa9cbcb"
+# Retrieve and print block height as an Integer value
+puts auction.get_block_height    # => 1128800
+# Retrieve and print an array of instances of EraValidor entity
+puts auction.get_era_validators # => [#<Casper::Entity::EraValidator:0x0000000002b69980>, #<Casper::Entity::EraValidator:0x0000000002b68940>]
+# Retrieve and print an array of instances of Bid entity
+puts auction.get_bids # => [#<Casper::Entity::Bid:0x000000000430bcf0>, #<Casper::Entity::Bid:0x000000000430b6d8>....]
+
+# Retrieve and print an instance of BidInfo, which is also the member of bid object
+bids = auction.get_bids
+bid =  bids[0] # => #<Casper::Entity::Bid:0x0000000003773dc0>
+bid_info = bid.get_bid_info # => #<Casper::Entity::BidInfo:0x00000000042cffc0>
+# Retrieve and print an array of delegator objects, which are instance of Delegator entity
+delegators = bid_info.get_delegators
+puts delegators # => [#<Casper::Entity::Delegator:0x000000000396c550>, #<Casper::Entity::Delegator:0x000000000396c500>.....]
+# How to access members of one of the above delegator instances
+# For instance, access to stake amount at first delegator    
+delegator = delegators[0]
+stake_amount = delegator.get_staked_amount # => 27871095039894
+```
+
+
 ### Get 5 peer IP addresses randomly
 ```ruby
 require 'casper_network'
@@ -157,9 +415,9 @@ end
 
 
 ## TODO
-- [ ] Ruby version of CLType primitives
-- [ ] Ruby version for Casper domain-specific objects
-- [ ] Serialization of Casper domain-specific objects
+- [x] Ruby version of CLType primitives
+- [x] Ruby version for Casper domain-specific objects
+- [x] Serialization of Casper domain-specific objects
 - [ ] ED25519/SECP256K1 key pairs  Wrappers implemented
 - [ ] PutDeploy call implemented and tested
-- [ ] SDK calls will return Casper domain-specific objects
+- [x] SDK calls will return Casper domain-specific objects

data/lib/casper_network.rb

@@ -10,14 +10,13 @@ require 'net/http'
 # require "./rpc/rpc.rb"
 require_relative './rpc/rpc_error.rb'
 require_relative './rpc/rpc_client.rb'
-
+require_relative './serialization/deploy_serializer.rb'
 # Dir["./entity/*.rb"].each {|file|  require  file }
 # Dir["./serialization/*.rb"].each {|file|  require file }
 # Dir["./types/*.rb"].each {|file|  require file }
 require_relative './include.rb'
-# Class for interacting with the network via RPC
-# puts "Hello"
 module Casper
+   # Interacting with the network
   class CasperClient 
     attr_accessor :ip_address, :port, :url, :state_root_hash
 
@@ -142,6 +141,8 @@ module Casper
         status = Timeout::timeout(10) {
           client = Jimson::Client.new(@url)
           @node_status = client.info_get_status
+          @node_status.deep_symbolize_keys!
+          Casper::Entity::Status.new(@node_status)
         }
       rescue
         @rpc_error = Casper::RpcError::ErrorHandle.new
@@ -177,7 +178,8 @@ module Casper
           if (!@block_info.empty?() && @block_info["hash"] != block_hash)
             raise("Returned block does not have a matching hash.")
           else
-            @block_info
+            @block_info.deep_symbolize_keys!
+            Casper::Entity::Block.new(@block_info[:hash], @block_info[:header], @block_info[:body], @block_info[:proofs])
           end
         }
       rescue
@@ -197,7 +199,8 @@ module Casper
         if @era_summary == nil
           Casper::RpcError::InvalidParameter.error
         else
-          @era_summary
+          @era_summary.deep_symbolize_keys!
+          Casper::Entity::EraSummary.new(@era_summary)
         end
         }
       rescue
@@ -218,7 +221,8 @@ module Casper
             "path" => path
           })
           @stored_value = response["stored_value"]
-          @stored_value
+          @stored_value.deep_symbolize_keys!
+          Casper::Entity::StoredValue.new(@stored_value)
         }
       rescue
         Casper::RpcError::InvalidParameter.error
@@ -237,7 +241,10 @@ module Casper
             "dictionary_identifier" => {'URef' => 
               {'seed_uref' => uref, 'dictionary_item_key' => item_key} }})
             @stored_value = response["stored_value"]
-            @stored_value
+            @stored_value.deep_symbolize_keys!
+            # cl_type = @stored_value[:CLValue][:cl_type]
+            # bytes = @stored_value[:CLValue][:bytes]
+            DeploySerializer.new().build_cl_value(@stored_value[:CLValue])
         }
       rescue
         Casper::RpcError::InvalidParameter.error
@@ -264,13 +271,19 @@ module Casper
 
     # Returns current auction system contract information.
     # @return [Hash] auction_state
-    def state_get_AuctionInfo
+    def state_get_AuctionInfo(block_hash = "")
       begin 
         state = Timeout::timeout(50) {
         client = Jimson::Client.new(@url)
         response = client.state_get_auction_info
         @auction_state = response['auction_state']
+        @auction_state.deep_symbolize_keys!
+        state_root_hash = @auction_state[:state_root_hash]
+        block_height = @auction_state[:block_height]
+        era_validators = @auction_state[:era_validators]
         @auction_state
+        bids = @auction_state[:bids]
+        Casper::Entity::AuctionState.new(state_root_hash, block_height, era_validators, bids)
         }
       rescue
         @rpc_error = Casper::RpcError::ErrorHandle.new
@@ -278,6 +291,7 @@ module Casper
       end
     end
     
+    # @param [Deploy] deploy
     def put_deploy(deploy)
       client = Jimson::Client.new(url)
       response = client.account_put_deploy(deploy)

data/lib/crypto/00_asymmetric_key.rb

@@ -56,7 +56,7 @@ class AsymmetricKey
     bytes = prefix + @public_key.get_value
     result_array = Utils::HashUtils.byte_hash(bytes)
     @public_key.get_value.length == 0 ? [] : result_array
-    # @public_key.to_account_hash_byte_array
+    #** @public_key.to_account_hash_byte_array
   end
  
   # @param [String] path_to_private_key

data/lib/crypto/asymmetric_key.rb

@@ -56,7 +56,7 @@ class AsymmetricKey
     bytes = prefix + @public_key.get_value
     result_array = Utils::HashUtils.byte_hash(bytes)
     @public_key.get_value.length == 0 ? [] : result_array
-    # @public_key.to_account_hash_byte_array
+    #*** @public_key.to_account_hash_byte_array
   end
  
   # @param [String] path_to_private_key

data/lib/entity/account.rb

@@ -5,7 +5,7 @@ module Casper
      
       # @param [CLAccountHash] account_hash
       # @param [Array] named_keys
-      # @param [CLUref] main_purse, The account's main purse URef
+      # @param [CLUref] main_purse  The account's main purse URef
       # @param [Array] associated_keys
       # @param [Array<ActionThresHolds>] action_thresholds
       def initialize(account_hash, named_keys, main_purse, associated_keys, action_thresholds)

data/lib/entity/action_thresholds.rb

@@ -4,8 +4,8 @@ module Casper
     # @note The minimum weight thresholds that have to be met when executing an action of a certain type. 
     class ActionThresholds
 
-      # @param [Integer] deployment, threshold required to perform deployment actions.
-      # @param [Integer] key_management, threshold required to perform key management actions.
+      # @param [Integer] deployment  Threshold required to perform deployment actions.
+      # @param [Integer] key_management  Threshold required to perform key management actions.
       def initialize(deployment, key_management)
         @deployment = deployment
         @key_management = key_management

data/lib/entity/associated_key.rb

@@ -1,6 +1,6 @@
 module Casper
   module Entity
-
+    # A key granted limited permissions to an Account, for purposes such as multisig.
     class AssociatedKey
 
       # @param [CLAccountHash] account_hash

data/lib/entity/auction_state.rb

@@ -1,35 +1,84 @@
 module Casper
   module Entity
+    # Data structure summarizing auction contract data.
     class AuctionState
       # @param [String] state_root_hash
       # @param [Integer] block_height
-      # @param [Array] era_validators
-      # @param [Array]  bids
+      # @param [Array<Hash>] era_validators
+      # @option era_validators [Integer] :era_id
+      # @option era_validators [Array<Hash>] :validator_weights
+      # @param [Array<Hash>] bids
       def initialize(state_root_hash, block_height, era_validators, bids)
         @state_root_hash = state_root_hash
         @block_height = block_height
-        @era_validators = era_validators
+
+        @era_validators = []
+        era_validators.each do |era_validator|
+          @validators_weights = []
+          era_validator[:validator_weights].each do |validator_weight|
+            @validators_weights << Casper::Entity::ValidatorWeight.new(validator_weight[:public_key], validator_weight[:weight])
+          end
+          @era_validators << Casper::Entity::EraValidator.new(era_validator[:era_id], @validators_weights)
+          @validators_weights = []
+          # puts Casper::Entity::EraValidator.new(era_validator[:era_id], @validators_weights).get_era_id
+          # puts Casper::Entity::EraValidator.new(era_validator[:era_id], @validators_weights).get_validator_weights
+        end
+
+        # @era_validators.each do |era_validator| 
+        #   puts era_validator.get_validator_weights[0].get_era_id
+        #   puts era_validator.get_validator_weights[0].get_weight
+        # end
+
         @bids = bids
+        @bids_list = []
+        
+        bids.each do |bid|
+          bid_info = bid[:bid]
+          @delegators_list = []
+          delegators = bid_info[:delegators]
+
+          delegators.each do |delegator| 
+            @delegators_list << Casper::Entity::Delegator.new(
+              delegator[:public_key], 
+              delegator[:staked_amount], 
+              delegator[:bonding_purse], 
+              delegator[:delegatee]
+              )
+            # puts delegator
+            # puts delegator[:public_key]
+          end
+          
+          bid_info = Casper::Entity::BidInfo.new(
+            bid_info[:bonding_purse], 
+            bid_info[:staked_amount], 
+            bid_info[:delegation_rate],
+            bid_info[:vesting_schedule],
+            # bid_info[:delegators],
+            @delegators_list,
+            bid_info[:inactive]
+            )
+          @bids_list << Casper::Entity::Bid.new(bid[:public_key], bid_info)
+        end
       end
 
-      # @return [String] returns state root hash as a String
+      # @return [String] state root hash as a String
       def get_state_root_hash
         @state_root_hash
       end
 
-      # @return [Integer] returns block height as an Integer 
+      # @return [Integer] block height as an Integer 
       def get_block_height
         @block_height
       end
 
-      # @return [Array<Hash>] returns array of hashes
+      # @return [Array<EraValidator>] array of EraValidator
       def get_era_validators
         @era_validators
       end
 
-      # @return [Array<Hash>] returns array of hashes
+      # @return [Array<Bid>] array of Bid
       def get_bids
-        @bids
+        @bids_list
       end
     end
   end

data/lib/entity/bid.rb

@@ -1,12 +1,13 @@
 module Casper
   module Entity
+    # An entry in the validator map.
     class Bid
 
       # @param [String] public_key
       # @param [BidInfo] bid_info
       def initialize(public_key, bid_info)
         @public_key = public_key
-        @BidInfo = bid_info
+        @bid_info = bid_info
 
       end
 

data/lib/entity/bid_info.rb

@@ -1,12 +1,13 @@
 module Casper
   module Entity
+    # BidInfo
     class BidInfo  
 
       # @param [String] bonding_purse
       # @param [String] staked_amount
       # @param [Integer] delegation_rate
       # @param [VestingSchedule] vesting_schedule
-      # @param [Hash<Delegator>] delegators
+      # @param [Array<Delegator>] delegators
       # @param [Boolean] inactive
       def initialize(bonding_purse, staked_amount, delegation_rate, vesting_schedule, delegators, inactive)
         @bonding_purse = bonding_purse

data/lib/entity/block.rb

@@ -0,0 +1,39 @@
+module Casper
+  module Entity
+    # Block 
+    class Block
+
+      # @param [String] hash
+      # @param [Hash] header
+      # @param [Hash] body
+      # @param [Array<Hash>] proofs
+      def initialize(hash, header = {}, body = {}, proofs = [])
+        @hash = hash
+        @header = Casper::Entity::BlockHeader.new(header)
+        @body = Casper::Entity::BlockBody.new(body)
+        @proofs = []
+        proofs.each { |proof| @proofs << Casper::Entity::BlockProof.new(proof) }
+      end
+
+      # @return [String] block hash
+      def get_hash
+        @hash
+      end
+
+      # @return [BlockHeader] block header
+      def get_header
+        @header
+      end
+
+      # @return [BlockBody] block body
+      def get_body
+        @body
+      end
+
+      # @return [Array<BlockProof>] list of proofs for this block
+      def get_proofs
+        @proofs
+      end
+    end
+  end
+end

data/lib/entity/block_body.rb

@@ -0,0 +1,35 @@
+module Casper
+  module Entity
+    # BlockBody entity 
+    class BlockBody
+
+      # @param [Hash] body
+      # @option [String] :proposer
+      # @option [Array] :deploy_hashes
+      # @option [Array] :transfer_hashes
+      def initialize(body =  {})
+        @proposer = body[:proposer]
+        @deploy_hashes = body[:deploy_hashes]
+        @transfer_hashes = body[:transfer_hashes]
+      end
+
+      # @return [String] a hex-encoded cryptographic public key, 
+      #   including the algorithm tag prefix.
+      def get_proposer
+        @proposer
+      end
+
+      # @return [Array] hex-encoded Deploy hashes.
+      def get_deploy_hashes
+        @deploy_hashes
+      end
+
+      # @return [Array] a vector of hex-encoded hashes 
+      #   identifying Transfers included in this block.
+      def get_transfer_hashes
+        @transfer_hashes
+      end
+
+    end
+  end
+end