Merge pull request #1401 from AndriiDiachuk/AndriiDiachuk/4869-get-pr…

…otocol-snapshot-from-any-block-endpoint
onflow · Nov 21, 2023 · 8e40789 · 8e40789
2 parents e9e9314 + c3fb628
commit 8e40789
Show file tree

Hide file tree

Showing 3 changed files with 314 additions and 122 deletions.
diff --git a/protobuf/flow/access/access.proto b/protobuf/flow/access/access.proto
@@ -130,6 +130,18 @@ service AccessAPI {
   rpc GetLatestProtocolStateSnapshot(GetLatestProtocolStateSnapshotRequest)
       returns (ProtocolStateSnapshotResponse);
 
+  // GetProtocolStateSnapshotByBlockID retrieves the latest sealed protocol state
+  // snapshot by block ID. Used by Flow nodes joining the network to bootstrap a
+  // space-efficient local state.
+  rpc GetProtocolStateSnapshotByBlockID(GetProtocolStateSnapshotByBlockIDRequest)
+      returns (ProtocolStateSnapshotResponse);
+
+  // GetProtocolStateSnapshotByHeight retrieves the latest sealed protocol state
+  // snapshot by block height. Used by Flow nodes joining the network to bootstrap a
+  // space-efficient local state.
+  rpc GetProtocolStateSnapshotByHeight(GetProtocolStateSnapshotByHeightRequest)
+      returns (ProtocolStateSnapshotResponse);
+
   // GetExecutionResultForBlockID returns Execution Result for a given block.
   // At present, Access Node might not have execution results for every block
   // and as usual, until sealed, this data can change
@@ -348,6 +360,14 @@ message GetNetworkParametersResponse {
 
 message GetLatestProtocolStateSnapshotRequest {}
 
+message GetProtocolStateSnapshotByBlockIDRequest {
+  bytes block_id = 1;
+}
+
+message GetProtocolStateSnapshotByHeightRequest {
+  uint64 block_height = 1;
+}
+
 message ProtocolStateSnapshotResponse {
   bytes serializedSnapshot = 1;
   entities.Metadata metadata = 2;