@dashevo/dapi-grpc 2.0.0-rc.9 → 2.0.1

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;
@@ -346,6 +355,15 @@ type PlatformgetTokenDirectPurchasePrices = {
   readonly responseType: typeof platform_pb.GetTokenDirectPurchasePricesResponse;
 };
 
+type PlatformgetTokenContractInfo = {
+  readonly methodName: string;
+  readonly service: typeof Platform;
+  readonly requestStream: false;
+  readonly responseStream: false;
+  readonly requestType: typeof platform_pb.GetTokenContractInfoRequest;
+  readonly responseType: typeof platform_pb.GetTokenContractInfoResponse;
+};
+
 type PlatformgetTokenPreProgrammedDistributions = {
   readonly methodName: string;
   readonly service: typeof Platform;
@@ -433,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;
@@ -449,6 +468,7 @@ export class Platform {
   static readonly getIdentitiesTokenInfos: PlatformgetIdentitiesTokenInfos;
   static readonly getTokenStatuses: PlatformgetTokenStatuses;
   static readonly getTokenDirectPurchasePrices: PlatformgetTokenDirectPurchasePrices;
+  static readonly getTokenContractInfo: PlatformgetTokenContractInfo;
   static readonly getTokenPreProgrammedDistributions: PlatformgetTokenPreProgrammedDistributions;
   static readonly getTokenPerpetualDistributionLastClaim: PlatformgetTokenPerpetualDistributionLastClaim;
   static readonly getTokenTotalSupply: PlatformgetTokenTotalSupply;
@@ -688,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,
@@ -832,6 +861,15 @@ export class PlatformClient {
     requestMessage: platform_pb.GetTokenDirectPurchasePricesRequest,
     callback: (error: ServiceError|null, responseMessage: platform_pb.GetTokenDirectPurchasePricesResponse|null) => void
   ): UnaryResponse;
+  getTokenContractInfo(
+    requestMessage: platform_pb.GetTokenContractInfoRequest,
+    metadata: grpc.Metadata,
+    callback: (error: ServiceError|null, responseMessage: platform_pb.GetTokenContractInfoResponse|null) => void
+  ): UnaryResponse;
+  getTokenContractInfo(
+    requestMessage: platform_pb.GetTokenContractInfoRequest,
+    callback: (error: ServiceError|null, responseMessage: platform_pb.GetTokenContractInfoResponse|null) => void
+  ): UnaryResponse;
   getTokenPreProgrammedDistributions(
     requestMessage: platform_pb.GetTokenPreProgrammedDistributionsRequest,
     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,
@@ -352,6 +361,15 @@ Platform.getTokenDirectPurchasePrices = {
   responseType: platform_pb.GetTokenDirectPurchasePricesResponse
 };
 
+Platform.getTokenContractInfo = {
+  methodName: "getTokenContractInfo",
+  service: Platform,
+  requestStream: false,
+  responseStream: false,
+  requestType: platform_pb.GetTokenContractInfoRequest,
+  responseType: platform_pb.GetTokenContractInfoResponse
+};
+
 Platform.getTokenPreProgrammedDistributions = {
   methodName: "getTokenPreProgrammedDistributions",
   service: Platform,
@@ -1104,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];
@@ -1600,6 +1649,37 @@ PlatformClient.prototype.getTokenDirectPurchasePrices = function getTokenDirectP
   };
 };
 
+PlatformClient.prototype.getTokenContractInfo = function getTokenContractInfo(requestMessage, metadata, callback) {
+  if (arguments.length === 2) {
+    callback = arguments[1];
+  }
+  var client = grpc.unary(Platform.getTokenContractInfo, {
+    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.getTokenPreProgrammedDistributions = function getTokenPreProgrammedDistributions(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.9",
+  "version": "2.0.1",
   "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.9",
+    "@dashevo/grpc-common": "2.0.1",
     "@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);
@@ -86,6 +87,8 @@ service Platform {
       returns (GetTokenStatusesResponse);
   rpc getTokenDirectPurchasePrices(GetTokenDirectPurchasePricesRequest)
       returns (GetTokenDirectPurchasePricesResponse);
+  rpc getTokenContractInfo(GetTokenContractInfoRequest)
+      returns (GetTokenContractInfoResponse);
   rpc getTokenPreProgrammedDistributions(
       GetTokenPreProgrammedDistributionsRequest)
       returns (GetTokenPreProgrammedDistributionsResponse);
@@ -796,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 {
@@ -1370,6 +1436,27 @@ message GetTokenStatusesResponse {
   oneof version { GetTokenStatusesResponseV0 v0 = 1; }
 }
 
+// Retrieve direct purchase prices defined for one or more tokens.
+//
+// Some tokens can have a direct purchase price defined using
+// `TokenSetPriceForDirectPurchaseTransition` (see `dpp` crate for details).
+// This request retrieves the direct purchase prices for those tokens and
+// returns [GetTokenDirectPurchasePricesResponse].
+message GetTokenDirectPurchasePricesRequest {
+  message GetTokenDirectPurchasePricesRequestV0 {
+    // List of token IDs to get prices for.
+    //
+    // The list must not be empty.
+    // Token IDs must have 32 bytes and be unique.
+    // Results for non-unique token IDs are undefined.
+    repeated bytes token_ids = 1;
+    // Whether to return proofs for the response, or just direct response.
+    bool prove = 2;
+  }
+  oneof version { GetTokenDirectPurchasePricesRequestV0 v0 = 1; }
+}
+
+
 // Response to GetTokenDirectPurchasePricesRequest, containing information about
 // direct purchase prices defined for requested token IDs.
 message GetTokenDirectPurchasePricesResponse {
@@ -1419,24 +1506,49 @@ message GetTokenDirectPurchasePricesResponse {
   oneof version { GetTokenDirectPurchasePricesResponseV0 v0 = 1; }
 }
 
-// Retrieve direct purchase prices defined for one or more tokens.
-//
-// Some tokens can have a direct purchase price defined using
-// `TokenSetPriceForDirectPurchaseTransition` (see `dpp` crate for details).
-// This request retrieves the direct purchase prices for those tokens and
-// returns [GetTokenDirectPurchasePricesResponse].
-message GetTokenDirectPurchasePricesRequest {
-  message GetTokenDirectPurchasePricesRequestV0 {
-    // List of token IDs to get prices for.
-    //
-    // The list must not be empty.
-    // Token IDs must have 32 bytes and be unique.
-    // Results for non-unique token IDs are undefined.
-    repeated bytes token_ids = 1;
-    // Whether to return proofs for the response, or just direct response.
+// Request to retrieve token contract info for a specific token ID.
+message GetTokenContractInfoRequest {
+  message GetTokenContractInfoRequestV0 {
+    // The token ID to retrieve contract info for.
+    // Must be exactly 32 bytes.
+    bytes token_id = 1;
+
+    // Whether to return a cryptographic proof.
     bool prove = 2;
   }
-  oneof version { GetTokenDirectPurchasePricesRequestV0 v0 = 1; }
+
+  oneof version {
+    GetTokenContractInfoRequestV0 v0 = 1;
+  }
+}
+
+// Response to GetTokenContractInfoRequest.
+message GetTokenContractInfoResponse {
+  message GetTokenContractInfoResponseV0 {
+    // Direct token contract info.
+    message TokenContractInfoData {
+      // The ID of the contract associated with the token.
+      bytes contract_id = 1;
+
+      // The position of the token within the contract.
+      uint32 token_contract_position = 2;
+    }
+
+    oneof result {
+      // Direct token contract data
+      TokenContractInfoData data = 1;
+
+      // Cryptographic proof of token contract info
+      Proof proof = 2;
+    }
+
+    // Metadata about the blockchain state at the time of the query
+    ResponseMetadata metadata = 3;
+  }
+
+  oneof version {
+    GetTokenContractInfoResponseV0 v0 = 1;
+  }
 }
 
 message GetTokenPreProgrammedDistributionsRequest {
@@ -1660,7 +1772,8 @@ message GetGroupActionsResponse {
     // Burn event
     message BurnEvent {
       uint64 amount = 1;               // Amount to burn
-      optional string public_note = 2; // Public note
+      bytes burn_from_id = 2;          // The identifier to burn from
+      optional string public_note = 3; // Public note
     }
 
     // Freeze event