From 6d0578e19c5b5442ccdb42d695fb6a70238cf6ce Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tomasz=20Drwi=C4=99ga?= <tomasz@ethcore.io>
Date: Thu, 10 Mar 2016 11:16:54 +0100
Subject: [PATCH] Additional explanation for ordering of commit/insert_block

---
 ethcore/src/client.rs | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ethcore/src/client.rs b/ethcore/src/client.rs
index 874fc9646..aaf5fd728 100644
--- a/ethcore/src/client.rs
+++ b/ethcore/src/client.rs
@@ -396,7 +396,8 @@ impl<V> Client<V> where V: Verifier {
 				.commit(header.number(), &header.hash(), ancient)
 				.expect("State DB commit failed.");
 
-			// And update the chain
+			// And update the chain after commit to prevent race conditions
+			// (when something is in chain but you are not able to fetch details)
 			self.chain.write().unwrap()
 				.insert_block(&block.bytes, receipts);