vchain_client 1.0.1 → 1.0.6

data/lib/vchain_client.rb

@@ -4,8 +4,8 @@ module VChainClient
 
   	require 'rest-client'
   	require 'base64'
-    gem "openssl"
   	require 'openssl'
+    require 'log4r'
 
     require 'vchain_client/blockchain_adapter'
     require 'vchain_client/bitcoind_blockchain_adapter'
@@ -18,9 +18,12 @@ module VChainClient
     FIELD_TYPE_HASHED = "fbb6889f44061c2a91e17a411cf168f9457981257a5e0a31fb706cd5cd1e64c263780a42a1fd858ee69429869ab2e2c53b9d94c4a26946f2b0c12f8ce2812d6b"
 
     @config = nil
+    @log = nil
 
     def initialize(config)
       @config = config
+
+      @log = Log4r::Logger["vchain_client"]
     end 
 
   	def hash(arr)
@@ -36,6 +39,10 @@ module VChainClient
   			return Digest::SHA512.hexdigest(what_to_hash)
   		end
 
+      if @log.error?
+        @log.error("[get_credentials_hash] unknown document type: '"+ document["type"] +"'")
+      end
+
   		return nil
   	end
 
@@ -45,6 +52,11 @@ module VChainClient
   		tree.each { |tree_level|
   			if previous_parent != nil
   				if previous_parent != tree_level["left"] && previous_parent != tree_level["right"]
+
+            if @log.error?
+              @log.error("[build_merkle_tree] wrong tree consequence - no parent in next level")
+            end
+
   					return nil
   				end
   			end
@@ -60,6 +72,11 @@ module VChainClient
   			level_hash = Digest::SHA256.hexdigest(what_to_hash);
 
   			if level_hash != tree_level["parent"]
+
+          if @log.error?
+            @log.error("[build_merkle_tree] level hash not equal to its parent")
+          end
+
   				return nil
   			end
 
@@ -77,24 +94,63 @@ module VChainClient
       document = input
       document = self.hash(document)
 
+      if @log.debug?
+        @log.debug("[use] will call "+ api_url +" using vchain_client_id "+ client_id)
+        @log.debug("[use] hashed input:")
+        @log.debug(document)
+      end
+
       document["client_id"] = client_id
       document["ignore_possible_matches"] = ignore_possible_matches
 
-      req = RestClient.post(api_url, 
-      					            document.to_json, 
-      					            {'Content-Type' => 'application/json'})
+      if @log.debug?
+        @log.debug("[use] send_data:")
+        @log.debug(document)
+      end
 
-      if req.code != 200
-      	return false
+      begin
+
+        req = RestClient.post(api_url, 
+        					            document.to_json, 
+        					            {'Content-Type' => 'application/json'})
+
+        if req.code != 200
+
+          if @log.error?
+            @log.error("[use] response with code "+ req.code.to_s)
+            @log.error("-> ignore_possible_matches: #{ignore_possible_matches}")
+            @log.error("-> client_id: #{client_id}")
+            @log.error("-> api_url: #{api_url}")
+            @log.error("-> document:")
+            @log.error(document)
+          end
+
+        	return false
+
+        end
+
+        return true
+
+      rescue => e
+        if @log.error?
+          @log.error("[use] RestClient.post raised exception")
+          @log.error("#{e.class}, #{e.message}")
+          @log.error("-> ignore_possible_matches: #{ignore_possible_matches}")
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")
+          @log.error("-> document:")
+          @log.error(document)
+        end
+
+        raise e
       end
 
-      return true
   	end
 
   	def do_verify(verification_type, input)
 
     	client_id = @config["client_id"]
-    	api_url = @config["api"]["url"] + "v0.1/verify/";
+    	api_url = @config["api"]["url"] + "v0.1/verify/"
 
 	  	time = Time.now.getutc
 	  	timestamp = time.to_i
@@ -102,13 +158,107 @@ module VChainClient
 	    document = input
 	    document = self.hash(document)
 
+      if @log.debug?
+        @log.debug("[verify] will call "+ api_url +" using vchain_client_id "+ client_id)
+        @log.debug("-> verification_type: "+ verification_type)
+        @log.debug("-> timestamp: "+ timestamp.to_s)
+        @log.debug("-> hashed input:")
+        @log.debug(document)
+      end
+
       signaturesHelper = VChainClient::Signatures.new(@config)
 
-	    verifications_data = signaturesHelper.signVerification(verification_type, document, timestamp)
+      verifications_data = nil
+
+      begin
+
+        verifications_data = signaturesHelper.signVerification(verification_type, document, timestamp)
+
+      rescue => e
+        if @log.error?
+          @log.error("[verify] Signatures.signVerification raised exception")
+          @log.error("#{e.class}, #{e.message}")
+          @log.error("-> verification_type: "+ verification_type)
+          @log.error("-> timestamp: "+ timestamp.to_s)
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")
+          @log.error("-> document:")
+          @log.error(document)
+        end
+
+        raise e
+      end
+
+      if verifications_data == nil
+        if @log.error?
+          @log.error("[verify] failed to Signatures.signVerification")
+          @log.error("-> verification_type: "+ verification_type)
+          @log.error("-> timestamp: "+ timestamp.to_s)
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")
+          @log.error("-> document:")
+          @log.error(document)
+        end
+
+        return false
+      end
+
+      if @log.debug?
+        @log.debug("[verify] verifications_data:")
+        @log.debug(document)
+      end
 
 	    document = Hash[document.sort]
 
-      whole_signature = signaturesHelper.signRequest(document, timestamp)
+      if @log.debug?
+        @log.debug("[verify] hashed input after sort:")
+        @log.debug(document)
+      end
+
+      whole_signature = nil
+
+      begin
+
+        whole_signature = signaturesHelper.signRequest(document, timestamp)
+
+      rescue => e
+
+        if @log.error?
+          @log.error("[verify] Signatures.signRequest raised exception:")
+          @log.error("#{e.class}: #{e.message}")
+          @log.error("-> verification_type: #{verification_type}")
+          @log.error("-> timestamp: "+ timestamp.to_s)
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")
+          @log.error("-> document:")
+          @log.error(document)
+        end
+
+        raise e
+
+      else
+
+        if whole_signature == nil
+
+          if @log.error?
+            @log.error("[verify] failed to sign request")
+            @log.error("-> verification_type: #{verification_type}")
+            @log.error("-> timestamp: "+ timestamp.to_s)
+            @log.error("-> client_id: #{client_id}")
+            @log.error("-> api_url: #{api_url}")
+            @log.error("-> document:")
+            @log.error(document)
+          end
+
+          return false
+        end
+
+        if @log.debug?
+          @log.debug("[verify] signaturesHelper.signRequest went well, whole_signature:")
+          @log.debug(whole_signature)
+        end
+
+      end
 
 		  send_data = {}
 		  send_data["client_id"] = client_id
@@ -118,15 +268,52 @@ module VChainClient
 		  send_data["verifications_signatures"] = verifications_data
 		  send_data["signature"] = whole_signature
 
-    	req = RestClient.post(api_url, 
-      					            send_data.to_json, 
-      					            {'Content-Type' => 'application/json'})
-
-    	if req.code != 200
-    		return false
-    	end
+      if @log.debug?
+        @log.debug("[verify] send_data:")
+        @log.debug(send_data)
+      end
 
-    	return true
+      begin
+      	req = RestClient.post(api_url, 
+        					            send_data.to_json, 
+        					            {'Content-Type' => 'application/json'})
+
+      	if req.code != 200
+
+          if @log.error?
+            @log.error("[verify] response with code "+ req.code.to_s)
+            @log.error("-> client_id: #{client_id}")
+            @log.error("-> api_url: #{api_url}")
+            @log.error("-> verification_type: #{verification_type}")
+            @log.error("-> timestamp: "+ timestamp.to_s)
+            @log.error("-> send_data:")
+            @log.error(send_data)
+          end
+
+      		return false
+      	end
+
+        if @log.debug?
+          @log.debug("[verify] response code is 200:")
+          @log.debug(req.body)
+        end
+
+      	return true
+
+      rescue => e
+        if @log.error?
+          @log.error("[verify] RestClient.post raised exception")
+          @log.error("#{e.class}, #{e.message}")
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")
+          @log.error("-> verification_type: #{verification_type}")
+          @log.error("-> timestamp: "+ timestamp.to_s)
+          @log.error("-> send_data:")
+          @log.error(send_data)
+        end
+
+        raise e
+      end
   	end
 
     def do_check(input, is_already_hashed=false)
@@ -142,27 +329,81 @@ module VChainClient
 
       document["client_id"] = client_id
 
-      req = RestClient.post(api_url, 
-      					            document.to_json, 
-      					            {'Content-Type' => 'application/json'})
+      if @log.debug?
+        @log.debug("[check] will call "+ api_url +" using vchain_client_id "+ client_id)
+        @log.debug("-> is_already_hashed: #{is_already_hashed}")
+        @log.debug("-> hashed input:")
+        @log.debug(document)
+      end
 
-      if req.code != 200
-      	return false
+      req = nil
+
+      begin
+
+        req = RestClient.post(api_url, 
+        					            document.to_json, 
+        					            {'Content-Type' => 'application/json'})
+
+        if req.code != 200
+          
+          if @log.error?
+            @log.error("[check] response with code "+ req.code.to_s)
+            @log.error("-> client_id: #{client_id}")
+            @log.error("-> api_url: #{api_url}")            
+            @log.debug("-> is_already_hashed: #{is_already_hashed}")
+            @log.error("-> sent data:")
+            @log.error(document)
+          end
+
+        	return false
+
+        end
+
+      rescue => e
+        if @log.error?
+          @log.error("[check] RestClient.post raised exception:")
+          @log.error("#{e.class}, #{e.message}")
+          @log.error("-> client_id: #{client_id}")
+          @log.error("-> api_url: #{api_url}")            
+          @log.debug("-> is_already_hashed: #{is_already_hashed}")
+          @log.error("-> sent data:")
+          @log.error(document)
+        end
+
+        raise e
+      end
+
+      if @log.debug?
+        @log.debug("[check] response code is 200:")
+        @log.debug(req.body)
       end
 
       res = JSON.parse req.body
 
       if res["status"] == "ERROR" || res["status"] == "error"
 
-      	raise res["error_reason_code"] 
+      	return {
+          "status" => "error",
+          "reason" => res["error_reason_code"] 
+        }
 
       else
+        # success result
+
       	res_document = res["document"]
 
+        if @log.debug?
+          @log.debug("[check] recieved verifications")
+        end
+
 		    validated_verifications = {}
 
 		    credentials_hash = self.get_credentials_hash(document)
 
+        if @log.debug?
+          @log.debug("[check] credentials_hash: "+ credentials_hash)
+        end
+
         blockchainConnection = VChainClient::BlockchainConnection.new(@config)
 
         blockstackClient = VChainClient::BlockstackClient.new(@config)
@@ -171,40 +412,144 @@ module VChainClient
 
     		res_document.each { |field, v|
     			if v["verifications"].length > 0 && field != "type"
+            
+            if @log.debug?
+              @log.debug("[check] check recieved verifications for '"+ field +"', number of recieved verifications: "+ v["verifications"].length.to_s)
+            end
+
     				v["verifications"].each { |verification|
 
-    					next if !verification.key?("blockchain_reciepts")
+              if @log.debug?
+                @log.debug("[check] field '"+ field +"', verification:")
+                @log.debug(verification)
+              end
+
+    					if !verification.key?("blockchain_reciepts")
+                if @log.error?
+                  @log.error("[check] not a valid verification - no blockchain_reciepts key")
+                  @log.error(verification)
+                  @log.error(document)
+                end
+
+                next
+              end
+
+    					if verification["blockchain_reciepts"].length <= 0
+                if @log.error?
+                  @log.error("[check] not a valid verification - blockchain_reciepts is empty")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                end
 
-    					next if verification["blockchain_reciepts"].length <= 0
+                next
+              end
 
     					# 1a. check credentials_hash
-    					next if credentials_hash != verification["credentials_hash"]
+    					if credentials_hash != verification["credentials_hash"]
+                if @log.error?
+                  @log.error("[check] not a valid verification - credentials_hash mismatch ("+ credentials_hash +")")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                end
+
+                next
+              end
 
     					# 1b. check field_hash
     					field_hash = Digest::SHA512.hexdigest(field)
-    					next if field_hash != verification["field_hash"]
+    					if field_hash != verification["field_hash"]
+                if @log.error?
+                  @log.error("[check] not a valid verification - field_hash mismatch ("+ field_hash +")")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                end
+
+                next
+              end
 
     					# 1c. check data_hash
     					data_hash = Digest::SHA512.hexdigest(document[field])
-    					next if data_hash != verification["data_hash"]
+    					if data_hash != verification["data_hash"]
+                if @log.error?
+                  @log.error("[check] not a valid verification - data_hash mismatch ("+ data_hash +")")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                end
+
+                next
+              end
 
     					# 1d. check checksum
     					checksum_to_hash = credentials_hash + field_hash + data_hash
     					checksum = Digest::SHA512.hexdigest(checksum_to_hash)
-    					next if checksum != verification["checksum"]
+    					if checksum != verification["checksum"]
+                if @log.error?
+                  @log.error("[check] not a valid verification - checksum mismatch ("+ checksum +")")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                  @log.error(credentials_hash)
+                  @log.error(field_hash)
+                  @log.error(data_hash)
+                end
+
+                next
+              end
 
     					verification_hash = verification["verification_hash"]
+              if @log.debug?
+                @log.debug("[check] verification_hash: "+ verification_hash)
+              end
 
     					# 2. check verification_hash to be in target_proof's
     					# first element
     					reciepts_validated = 0
     					verification["blockchain_reciepts"].each { |reciept|
 
-    						break if !reciept.key?("target_proof")
-
-    						break if reciept["target_proof"].length <= 0
-
-    						break if reciept["target_proof"][0]["left"] != verification_hash && reciept["target_proof"][0]["right"] != verification_hash
+                if @log.debug?
+                  @log.debug("reciept to check:")
+                  @log.debug(reciept)
+                end
+
+    						if !reciept.key?("target_proof")
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - no target_proof")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+
+    						if reciept["target_proof"].length <= 0
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - target_proof length is <= 0")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+
+    						if reciept["target_proof"][0]["left"] != verification_hash && reciept["target_proof"][0]["right"] != verification_hash
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - no target element in target_proof.0")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
 
     						# verification_hash is in tree
     						# and in right position
@@ -213,44 +558,282 @@ module VChainClient
     						# 3. check tree convergence to root hash
     						# and compare this computed root hash
     						# with merkle_tree_root_hash from response
-    						computed_tree_root_hash = self.build_merkle_tree(reciept["target_proof"], reciept["timestamp"])
+                if @log.debug?
+                  @log.debug("will now build merkle tree with")
+                  @log.debug(reciept["target_proof"])
+                  @log.debug(reciept["timestamp"])
+                end
 
-    						break if computed_tree_root_hash == nil
-    						break if computed_tree_root_hash != reciept["merkle_tree_root_hash"]
+    						computed_tree_root_hash = self.build_merkle_tree(reciept["target_proof"], reciept["timestamp"])
+                
+                if @log.debug?
+                  @log.debug("computed tree root hash = "+ computed_tree_root_hash)
+                end
+
+    						if computed_tree_root_hash == nil
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - failed to compute tree root hash")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+    						if computed_tree_root_hash != reciept["merkle_tree_root_hash"]
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - merkle tree root hash mismatch ("+ computed_tree_root_hash +", "+ reciept["merkle_tree_root_hash"] +")")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
 
     						last_proof_index = reciept["target_proof"].length - 1
     						reciept_stored_last_parent = reciept["target_proof"][last_proof_index]["parent"]
-    						break if reciept_stored_last_parent != computed_tree_root_hash
+    						if reciept_stored_last_parent != computed_tree_root_hash
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - last stored parent != computed_tree_root_hash ("+ reciept_stored_last_parent +", "+ computed_tree_root_hash +")")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
 
     						# 4. check OP_RETURN in Bitcoin's tx,
     						# compare it to computed root hash of a tree
     						# retrieve some info from tx to verify signature
-    						tx = blockchainConnection.getTx(reciept["blockchain_txid"])
-
-    						break if tx == nil
-    						break if tx["block_hash"] != reciept["blockchain_block_hash"]
-    						break if tx["block_timestamp"] != reciept["blockchain_timestamp"]
-    						break if tx["op_return"] != computed_tree_root_hash
+                tx = nil
+    						
+                begin
+                  
+                  tx = blockchainConnection.getTx(reciept["blockchain_txid"])
+
+                rescue => e
+                  if @log.error?
+                    @log.error("[check] BlockchainConnection.getTx raised exception:")
+                    @log.error("#{e.class}, #{e.message}")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> blockchain_txid: "+ reciept["blockchain_txid"])
+                  end
+
+                  raise e
+                end
+
+
+                if @log.debug?
+                  @log.debug("[check] tx ["+ reciept["blockchain_txid"] +"]:")
+                  @log.debug(tx)
+                end
+
+    						if tx == nil
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - failed to retrieve TX from Blockchain")
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+
+    						if tx["block_hash"] != reciept["blockchain_block_hash"]
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - block_hash mismatch")
+                    @log.error(tx)
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+
+    						if tx["block_timestamp"] != reciept["blockchain_timestamp"]
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - timestamp mismatch")
+                    @log.error(tx)
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
+
+    						if tx["op_return"] != computed_tree_root_hash
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - op_return mismatch")
+                    @log.error(computed_tree_root_hash)
+                    @log.error(tx)
+                    @log.error(reciept)
+                    @log.error("field '"+ field +"'")
+                    @log.error(verification)
+                    @log.error(document)
+                  end
+
+                  break
+                end
 
     						blockchain_txid = reciept["blockchain_txid"];
     						blockchain_block_hash = tx["block_hash"];
     						blockchain_timestamp = tx["block_timestamp"];
+                
+                if @log.debug?
+                  @log.debug(blockchain_txid)
+                  @log.debug(blockchain_block_hash)
+                  @log.debug(blockchain_timestamp)
+                end
 
     						# 5. check tree signature:
     						# a) federative server record in Blockstack (recursive)
     						# b) tree_signature
 
     						# a) federative server record in Blockstack (recursive)
-    						break if !blockstackClient.checkFederativeServer(reciept["federative_server_id"])
+                begin
+
+      						if !blockstackClient.checkFederativeServer(reciept["federative_server_id"])
+                    if @log.error?
+                      @log.error("[check] not a valid blockchain reciept - failed to check federative server")
+                      @log.error("-> client_id: #{client_id}")
+                      @log.error("-> api_url: #{api_url}")            
+                      @log.error("-> is_already_hashed: #{is_already_hashed}")
+                      @log.error("-> sent data:")
+                      @log.error(document)
+                      @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                    end
+
+                    break
+                  end
+
+                rescue => e
+                  if @log.error?
+                    @log.error("[check] Blockstack.checkFederativeServer raised exception:")
+                    @log.error("#{e.class}, #{e.message}")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                  end
+
+                  raise e
+                end
 
     						# b) check tree signature
-    						federative_server_pubkey = blockstackClient.getPublicKey(reciept["federative_server_id"])
-
-    						break if !signaturesHelper.checkTreeSignature(computed_tree_root_hash, blockchain_txid, blockchain_block_hash, blockchain_timestamp, reciept["federative_server_id"], reciept["federative_server_version"], Base64.decode64(reciept["tree_signature"]), federative_server_pubkey)
+                federative_server_pubkey = nil
+
+                begin
+    						  
+                  federative_server_pubkey = blockstackClient.getPublicKey(reciept["federative_server_id"])
+
+                rescue => e
+                  if @log.error?
+                    @log.error("[check] Blockstack.getPublicKey raised exception:")
+                    @log.error("#{e.class}, #{e.message}")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                  end
+
+                  raise e
+                end
+
+                if federative_server_pubkey == nil
+                  if @log.error?
+                    @log.error("[check] not a valid blockchain reciept - failed to retrieve public key for federative server '"+ reciept["federative_server_id"] +"'")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                  end
+
+                  break
+                end
+                
+                if @log.debug?
+                  @log.debug("federative server pubkey:")
+                  @log.debug(federative_server_pubkey)
+                end
+
+                begin
+
+      						if !signaturesHelper.checkTreeSignature(computed_tree_root_hash, blockchain_txid, blockchain_block_hash, blockchain_timestamp, reciept["federative_server_id"], reciept["federative_server_version"], Base64.decode64(reciept["tree_signature"]), federative_server_pubkey)
+                    if @log.error?
+                      @log.error("[check] not a valid blockchain reciept - failed to verify tree signature")
+                      @log.error("-> client_id: #{client_id}")
+                      @log.error("-> api_url: #{api_url}")            
+                      @log.debug("-> is_already_hashed: #{is_already_hashed}")
+                      @log.error("-> sent data:")
+                      @log.error(document)
+                      @log.error("--> computed_tree_root_hash: #{computed_tree_root_hash}")
+                      @log.error("--> blockchain_txid: #{blockchain_txid}")
+                      @log.error("--> blockchain_block_hash: #{blockchain_block_hash}")
+                      @log.error("--> blockchain_timestamp: #{blockchain_timestamp}")
+                      @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                      @log.error("--> federative_server_version: "+ reciept["federative_server_version"])
+                      @log.error("--> tree_signature: "+ Base64.decode64(reciept["tree_signature"]))
+                      @log.error("--> federative_server_pubkey: #{federative_server_pubkey}")
+                    end
+
+                    break
+                  end
+
+                rescue => e
+                  if @log.error?
+                    @log.error("[check] Blockstack.checkTreeSignature raised exception:")
+                    @log.error("#{e.class}, #{e.message}")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.debug("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> computed_tree_root_hash: #{computed_tree_root_hash}")
+                    @log.error("--> blockchain_txid: #{blockchain_txid}")
+                    @log.error("--> blockchain_block_hash: #{blockchain_block_hash}")
+                    @log.error("--> blockchain_timestamp: #{blockchain_timestamp}")
+                    @log.error("--> federative_server_id: "+ reciept["federative_server_id"])
+                    @log.error("--> federative_server_version: "+ reciept["federative_server_version"])
+                    @log.error("--> tree_signature: "+ Base64.decode64(reciept["tree_signature"]))
+                    @log.error("--> federative_server_pubkey: #{federative_server_pubkey}")
+                  end
+
+                  raise e
+                end
 
     						reciepts_validated += 1
     					}
-    					next if reciepts_validated != verification["blockchain_reciepts"].length
+
+    					if reciepts_validated != verification["blockchain_reciepts"].length
+                if @log.error?
+                  @log.error("[check] not a valid verification - not every reciept were validated")
+                  @log.error("field '"+ field +"'")
+                  @log.error(verification)
+                  @log.error(document)
+                end
+
+                next
+              end
 
     					# 6. check verification signatures:
     					# a) check verificator record in Blockstack (recursive)
@@ -259,31 +842,259 @@ module VChainClient
     					# d) validtor_sig
     					
     					# a) check verificator record in Blockstack (recursive)
-    					next if !blockstackClient.checkVerificator(verification["verificator_id"])
+              begin
+
+      					if !blockstackClient.checkVerificator(verification["verificator_id"])
+                  if @log.error?
+                    @log.error("[check] not a valid verification - failed to check verificator record")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> verificator_id: "+ verification["verificator_id"])
+                  end
+
+                  next
+                end
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Blockstack.checkVerificator raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> verificator_id: "+ verification["verificator_id"])
+                end
+
+                raise e
+              end
 
     					# b) check validator record in Blockstack (recursive)
-    					next if !blockstackClient.checkValidator(verification["validator_id"])
+              begin
+
+      					if !blockstackClient.checkValidator(verification["validator_id"])
+                  if @log.error?
+                    @log.error("[check] not a valid verification - failed to check validator record")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> validator_id: "+ verification["validator_id"])
+                  end
+
+                  next
+                end
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Blockstack.checkValidator raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> validator_id: "+ verification["validator_id"])
+                end
+
+                raise e
+              end
 
     					# c) check verificator's signature
-    					verificator_pubkey = blockstackClient.getPublicKey(verification["verificator_id"])
-
-    					next if !signaturesHelper.checkVerificationSignature(field_hash, data_hash, verification["type"], verification["timestamp"], verification["verificator_id"], verificator_pubkey, Base64.decode64(verification["verificator_sig"]))
+              verificator_pubkey = nil
+
+              begin
+
+                verificator_pubkey = blockstackClient.getPublicKey(verification["verificator_id"])
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Blockstack.getPublicKey raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> verificator_id: "+ verification["verificator_id"])
+                end
+
+                raise e
+              end
+
+              if verificator_pubkey == nil
+                if @log.error?
+                  @log.error("[check] failed to retrieve public key for verificator")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> verificator_id: "+ verification["verificator_id"])
+                end
+
+                next
+              end
+
+              if @log.debug?
+                @log.debug("verificator pubkey:")
+                @log.debug(verificator_pubkey)
+              end
+
+              begin
+
+      					if !signaturesHelper.checkVerificationSignature(field_hash, data_hash, verification["type"], verification["timestamp"], verification["verificator_id"], verificator_pubkey, Base64.decode64(verification["verificator_sig"]))
+                  if @log.error?
+                    @log.error("[check] not a valid verification - failed to check verificator signature")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> field_hash: #{field_hash}")
+                    @log.error("--> data_hash")
+                    @log.error("--> verification_type: "+ verification["type"])
+                    @log.error("--> verification_timestamp: "+ verification["timestamp"].to_s)
+                    @log.error("--> verificator_id: "+ verification["verificator_id"])
+                    @log.error("--> verificator_pubkey: "+ verificator_pubkey)
+                    @log.error("--> verificator_sig: "+ Base64.decode64(verification["verificator_sig"]))
+                  end
+
+                  next
+                end
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Signatures.checkVerificationSignature raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> field_hash: #{field_hash}")
+                  @log.error("--> data_hash")
+                  @log.error("--> verification_type: "+ verification["type"])
+                  @log.error("--> verification_timestamp: "+ verification["timestamp"].to_s)
+                  @log.error("--> verificator_id: "+ verification["verificator_id"])
+                  @log.error("--> verificator_pubkey: "+ verificator_pubkey)
+                  @log.error("--> verificator_sig: "+ Base64.decode64(verification["verificator_sig"]))
+                end
+
+                raise e
+              end
 
     					# d) check validator's signature
-    					validator_pubkey = blockstackClient.getPublicKey(verification["validator_id"])
-
-    					next if !signaturesHelper.checkVerificationSignature(field_hash, data_hash, verification["type"], verification["timestamp"], verification["validator_id"], validator_pubkey, Base64.decode64(verification["validator_sig"]))
+              validator_pubkey = nil
+
+              begin
+
+    					 validator_pubkey = blockstackClient.getPublicKey(verification["validator_id"])
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Blockstack.getPublicKey raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> validator_id: "+ verification["validator_id"])
+                end
+
+                raise e
+              end
+
+              if validator_pubkey == nil
+                if @log.error?
+                  @log.error("[check] failed to retrieve pubic key for validator")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> validator_id: "+ verification["validator_id"])
+                end
+
+                next
+              end
+
+              if @log.debug?
+                @log.debug("validator pubkey:")
+                @log.debug(validator_pubkey)
+              end
+
+              begin
+
+      					if !signaturesHelper.checkVerificationSignature(field_hash, data_hash, verification["type"], verification["timestamp"], verification["validator_id"], validator_pubkey, Base64.decode64(verification["validator_sig"]))
+                  if @log.error?
+                    @log.error("[check] not a valid verification - failed to check verificator signature")
+                    @log.error("-> client_id: #{client_id}")
+                    @log.error("-> api_url: #{api_url}")            
+                    @log.error("-> is_already_hashed: #{is_already_hashed}")
+                    @log.error("-> sent data:")
+                    @log.error(document)
+                    @log.error("--> field_hash: #{field_hash}")
+                    @log.error("--> data_hash")
+                    @log.error("--> verification_type: "+ verification["type"])
+                    @log.error("--> verification_timestamp: "+ verification["timestamp"].to_s)
+                    @log.error("--> validator_id: "+ verification["validator_id"])
+                    @log.error("--> validator_pubkey: "+ validator_pubkey)
+                    @log.error("--> validator_sig: "+ Base64.decode64(verification["validator_sig"]))
+                  end
+
+                  next
+                end
+
+              rescue => e
+                if @log.error?
+                  @log.error("[check] Signatures.checkVerificationSignature raised exception:")
+                  @log.error("#{e.class}, #{e.message}")
+                  @log.error("-> client_id: #{client_id}")
+                  @log.error("-> api_url: #{api_url}")            
+                  @log.error("-> is_already_hashed: #{is_already_hashed}")
+                  @log.error("-> sent data:")
+                  @log.error(document)
+                  @log.error("--> field_hash: #{field_hash}")
+                  @log.error("--> data_hash")
+                  @log.error("--> verification_type: "+ verification["type"])
+                  @log.error("--> verification_timestamp: "+ verification["timestamp"].to_s)
+                  @log.error("--> validator_id: "+ verification["validator_id"])
+                  @log.error("--> validator_pubkey: "+ validator_pubkey)
+                  @log.error("--> validator_sig: "+ Base64.decode64(verification["validator_sig"]))
+                end
+
+                raise e
+              end
 
     					# 7. timestamps checking
     					# TODO
+
+
     					if !validated_verifications.key?(field)
     						validated_verifications[field] = 0
     					end
     					validated_verifications[field] = validated_verifications[field] + 1
     				}
+
+          else
+            if @log.debug?
+              @log.debug("[check] skip '"+ field +"', number of recieved verifications: "+ v["verifications"].length.to_s)
+            end
     			end 
     		}
 
+        if @log.debug?
+          @log.debug("[check] temp validated verifications:")
+          @log.debug(validated_verifications)
+        end
+
     		# check input fields
     		input.each_with_index { |field,index|
     			if field[0] != 'type' && field[0] != 'client_id'
@@ -293,6 +1104,11 @@ module VChainClient
     			end
     		}
 
+        if @log.debug?
+          @log.debug("[check] resulted validated verifications:")
+          @log.debug(validated_verifications)
+        end
+
     		return validated_verifications
       end
     end