From 0ee8911d8b22c543b89693a3f50cebed941888f3 Mon Sep 17 00:00:00 2001
From: Mansoor <>
Date: Thu, 24 May 2018 11:23:19 +0100
Subject: [PATCH] Updated GetData return value descriptor

Used a JSON returned via RPC to understand the structure of returned object.

Signed-off-by: Mansoor Ahmed <mansoor.ahmed@cl.cam.ac.uk>
---
 docs/specs/api.md | 56 +++++++++++++++++++++++++++++++++++++----------
 1 file changed, 45 insertions(+), 11 deletions(-)

diff --git a/docs/specs/api.md b/docs/specs/api.md
index e0b03bfe..44edfad9 100644
--- a/docs/specs/api.md
+++ b/docs/specs/api.md
@@ -984,23 +984,57 @@ Parameter:
 		chain_id:        <string>
 		height:          <number>
 		time:            <string>
-		fees:            <number>
 		num_txs:         <number>
-		last_block_hash: <string>
-		last_block_parts: {
-			total: <number>
-			hash:  <string>
+		last_block_id: {
+			hash:	<string>
+			parts: {
+				total:	<int>
+				hash:	<string>
+			}
 		}
-		state_hash: <string>
-	}
-	validation: {
-		commits: [<Commit>]
-		TODO those other two.
+		last_commit_hash:	<string>
+		data_hash:			<string>
+		validators_hast:	<string>
+		app_hash:			<string>
 	}
 	data: {
 		txs: [<Tx>]
-		TODO that other field.
 	}
+	last_commit: {
+		blockID: {
+			hash:	<string>
+			parts: {
+				total:	<int>
+				hash:	<string>
+			}
+		}
+		precommits: {
+			validator_address:	<string>
+			validator_index:	<int>
+			height:				<int>
+			round:				<int>
+			type:				<int>
+			block_id: {
+				hash:	<string>
+				parts: {
+					total:	<int>
+					hash:	<string>
+				}
+			}
+			signature: [<signature>]
+		}
+	}
+	id:		 <string>
+	jsonrpc: <string>
+}
+```
+
+The `Signature` object:
+
+```
+{
+	index:		<int>
+	signature:	<string>
 }
 ```
 
-- 
GitLab