@dashevo/dapi-grpc 2.0.0-rc.15 → 2.0.0-rc.16

package/clients/platform/v0/web/platform_pb_service.d.ts

@@ -202,6 +202,15 @@ type PlatformgetEpochsInfo = {
   readonly responseType: typeof platform_pb.GetEpochsInfoResponse;
 };
 
+type PlatformgetFinalizedEpochInfos = {
+  readonly methodName: string;
+  readonly service: typeof Platform;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof platform_pb.GetFinalizedEpochInfosRequest;
+  readonly responseType: typeof platform_pb.GetFinalizedEpochInfosResponse;
+};
+
 type PlatformgetContestedResources = {
   readonly methodName: string;
   readonly service: typeof Platform;
@@ -442,6 +451,7 @@ export class Platform {
   static readonly getProtocolVersionUpgradeState: PlatformgetProtocolVersionUpgradeState;
   static readonly getProtocolVersionUpgradeVoteStatus: PlatformgetProtocolVersionUpgradeVoteStatus;
   static readonly getEpochsInfo: PlatformgetEpochsInfo;
+  static readonly getFinalizedEpochInfos: PlatformgetFinalizedEpochInfos;
   static readonly getContestedResources: PlatformgetContestedResources;
   static readonly getContestedResourceVoteState: PlatformgetContestedResourceVoteState;
   static readonly getContestedResourceVotersForIdentity: PlatformgetContestedResourceVotersForIdentity;
@@ -698,6 +708,15 @@ export class PlatformClient {
     requestMessage: platform_pb.GetEpochsInfoRequest,
     callback: (error: ServiceError|null, responseMessage: platform_pb.GetEpochsInfoResponse|null) => void
   ): UnaryResponse;
+  getFinalizedEpochInfos(
+    requestMessage: platform_pb.GetFinalizedEpochInfosRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: platform_pb.GetFinalizedEpochInfosResponse|null) => void
+  ): UnaryResponse;
+  getFinalizedEpochInfos(
+    requestMessage: platform_pb.GetFinalizedEpochInfosRequest,
+    callback: (error: ServiceError|null, responseMessage: platform_pb.GetFinalizedEpochInfosResponse|null) => void
+  ): UnaryResponse;
   getContestedResources(
     requestMessage: platform_pb.GetContestedResourcesRequest,
     metadata: grpc.Metadata,

package/clients/platform/v0/web/platform_pb_service.js

@@ -208,6 +208,15 @@ Platform.getEpochsInfo = {
   responseType: platform_pb.GetEpochsInfoResponse
 };
 
+Platform.getFinalizedEpochInfos = {
+  methodName: "getFinalizedEpochInfos",
+  service: Platform,
+  requestStream: false,
+  responseStream: false,
+  requestType: platform_pb.GetFinalizedEpochInfosRequest,
+  responseType: platform_pb.GetFinalizedEpochInfosResponse
+};
+
 Platform.getContestedResources = {
   methodName: "getContestedResources",
   service: Platform,
@@ -1113,6 +1122,37 @@ PlatformClient.prototype.getEpochsInfo = function getEpochsInfo(requestMessage,
   };
 };
 
+PlatformClient.prototype.getFinalizedEpochInfos = function getFinalizedEpochInfos(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Platform.getFinalizedEpochInfos, {
+    request: requestMessage,
+    host: this.serviceHost,
+    metadata: metadata,
+    transport: this.options.transport,
+    debug: this.options.debug,
+    onEnd: function (response) {
+      if (callback) {
+        if (response.status !== grpc.Code.OK) {
+          var err = new Error(response.statusMessage);
+          err.code = response.status;
+          err.metadata = response.trailers;
+          callback(err, null);
+        } else {
+          callback(null, response.message);
+        }
+      }
+    }
+  });
+  return {
+    cancel: function () {
+      callback = null;
+      client.close();
+    }
+  };
+};
+
 PlatformClient.prototype.getContestedResources = function getContestedResources(requestMessage, metadata, callback) {
   if (arguments.length === 2) {
     callback = arguments[1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dashevo/dapi-grpc",
-  "version": "2.0.0-rc.15",
+  "version": "2.0.0-rc.16",
   "description": "DAPI GRPC definition file and generated clients",
   "browser": "browser.js",
   "main": "node.js",
@@ -45,7 +45,7 @@
   },
   "homepage": "https://github.com/dashevo/dapi-grpc#readme",
   "dependencies": {
-    "@dashevo/grpc-common": "2.0.0-rc.15",
+    "@dashevo/grpc-common": "2.0.0-rc.16",
     "@dashevo/protobufjs": "6.10.5",
     "@grpc/grpc-js": "1.4.4",
     "@improbable-eng/grpc-web": "^0.15.0",

package/protos/platform/v0/platform.proto

@@ -49,6 +49,7 @@ service Platform {
       GetProtocolVersionUpgradeVoteStatusRequest)
       returns (GetProtocolVersionUpgradeVoteStatusResponse);
   rpc getEpochsInfo(GetEpochsInfoRequest) returns (GetEpochsInfoResponse);
+  rpc getFinalizedEpochInfos(GetFinalizedEpochInfosRequest) returns (GetFinalizedEpochInfosResponse);
   // What votes are currently happening for a specific contested index
   rpc getContestedResources(GetContestedResourcesRequest)
       returns (GetContestedResourcesResponse);
@@ -798,6 +799,69 @@ message GetEpochsInfoResponse {
   oneof version { GetEpochsInfoResponseV0 v0 = 1; }
 }
 
+message GetFinalizedEpochInfosRequest {
+  message GetFinalizedEpochInfosRequestV0 {
+    uint32 start_epoch_index = 1;          // The starting epoch index
+    bool start_epoch_index_included = 2;   // Whether to include the start epoch
+    uint32 end_epoch_index = 3;            // The ending epoch index  
+    bool end_epoch_index_included = 4;     // Whether to include the end epoch
+    bool prove = 5;                        // Flag to request a proof as the response
+  }
+
+  oneof version { GetFinalizedEpochInfosRequestV0 v0 = 1; }
+}
+
+message GetFinalizedEpochInfosResponse {
+  message GetFinalizedEpochInfosResponseV0 {
+    // FinalizedEpochInfos holds a collection of finalized epoch information entries
+    message FinalizedEpochInfos {
+      repeated FinalizedEpochInfo finalized_epoch_infos = 
+          1; // List of finalized information for each requested epoch
+    }
+
+    // FinalizedEpochInfo represents finalized information about a single epoch
+    message FinalizedEpochInfo {
+      uint32 number = 1; // The number of the epoch
+      uint64 first_block_height = 2
+          [ jstype = JS_STRING ]; // The height of the first block in this epoch
+      uint32 first_core_block_height = 
+          3; // The height of the first Core block in this epoch
+      uint64 first_block_time = 4
+          [ jstype = JS_STRING ]; // The timestamp of the first block (milliseconds)
+      double fee_multiplier = 5;  // The fee multiplier (converted from permille)
+      uint32 protocol_version = 6; // The protocol version for this epoch
+      uint64 total_blocks_in_epoch = 7
+          [ jstype = JS_STRING ]; // Total number of blocks in the epoch
+      uint32 next_epoch_start_core_block_height = 8; // Core block height where next epoch starts
+      uint64 total_processing_fees = 9
+          [ jstype = JS_STRING ]; // Total processing fees collected
+      uint64 total_distributed_storage_fees = 10
+          [ jstype = JS_STRING ]; // Total storage fees distributed
+      uint64 total_created_storage_fees = 11
+          [ jstype = JS_STRING ]; // Total storage fees created
+      uint64 core_block_rewards = 12
+          [ jstype = JS_STRING ]; // Rewards from core blocks
+      repeated BlockProposer block_proposers = 13; // List of block proposers and their counts
+    }
+
+    // BlockProposer represents a block proposer and their block count
+    message BlockProposer {
+      bytes proposer_id = 1; // The proposer's identifier
+      uint32 block_count = 2; // Number of blocks proposed
+    }
+
+    oneof result {
+      FinalizedEpochInfos epochs = 
+          1; // The actual finalized information about the requested epochs
+      Proof proof = 
+          2; // Cryptographic proof of the finalized epoch information, if requested
+    }
+    ResponseMetadata metadata = 3; // Metadata about the blockchain state
+  }
+
+  oneof version { GetFinalizedEpochInfosResponseV0 v0 = 1; }
+}
+
 message GetContestedResourcesRequest {
   message GetContestedResourcesRequestV0 {
     message StartAtValueInfo {