Merge pull request #36 from Concordium/expand-block-api

Query by block height directly

CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## Unreleased changes
+
+- Expand `BlockHashInput` to support querying by block height.
+- Add `protocol_version` to the return of BlockInfo.

v2/concordium/types.proto

@@ -495,13 +495,27 @@ message AccountInfo {
 
 // Input to queries which take a block as a parameter.
 message BlockHashInput {
+  // Request using a relative block height.
+  message RelativeHeight {
+    // Genesis index to start from.
+    GenesisIndex genesis_index = 1;
+    // Height starting from the genesis block at the genesis index.
+    BlockHeight height = 2;
+     // Whether to return results only from the specified genesis index (`true`),
+    // or allow results from more recent genesis indices as well (`false`).
+    bool restrict = 3;
+  }
   oneof block_hash_input {
     // Query for the best block.
     Empty best = 1;
     // Query for the last finalized block.
     Empty last_final = 2;
     // Query for the block specified by the hash. This hash should always be 32 bytes.
     BlockHash given = 3;
+    // Query for a block at absolute height, if a unique block can be identified at that height.
+    AbsoluteBlockHeight absolute_height = 4;
+    // Query for a block at height relative to a genesis index.
+    RelativeHeight relative_height = 5;
   }
 }
 
@@ -1986,6 +2000,8 @@ message BlockInfo {
   uint32 transactions_size = 15;
   // The hash of the block state after this block.
   StateHash state_hash = 16;
+  // Protocol version to which the block belongs.
+  ProtocolVersion protocol_version = 17;
 }
 
 // Request for GetPoolInfo.