diff --git a/protobuf/flow/execution/execution.proto b/protobuf/flow/execution/execution.proto index 675b101a0..90f984164 100644 --- a/protobuf/flow/execution/execution.proto +++ b/protobuf/flow/execution/execution.proto @@ -85,7 +85,8 @@ service ExecutionAPI { returns (BlockHeaderResponse); // GetTransactionExecutionMetricsAfter gets the transaction execution metrics - // for blocks after the given block height. + // for blocks after the given block height. The blocks will be sorted by + // descending block height. // If no data is available for the given block height, the response will be // empty. The execution node will only store metrics for a limited number of // blocks,  so the request may return an empty response if the requested @@ -234,6 +235,7 @@ message BlockHeaderResponse { // The request for GetTransactionExecutionMetricsAfter message GetTransactionExecutionMetricsAfterRequest { // Block height after which to get transaction execution metrics. + // this block height will not be included in the response. uint64 block_height = 1; } @@ -270,6 +272,7 @@ message GetTransactionExecutionMetricsAfterResponse { repeated Transaction transactions = 2; } - // a list of results for each block + // a list of results for each block sorted by block height in + // descending order repeated Result results = 1; } diff --git a/protobuf/go/flow/execution/execution.pb.go b/protobuf/go/flow/execution/execution.pb.go index 88acfd6fc..50e7200f1 100644 --- a/protobuf/go/flow/execution/execution.pb.go +++ b/protobuf/go/flow/execution/execution.pb.go @@ -1170,6 +1170,7 @@ func (m *BlockHeaderResponse) GetBlock() *entities.BlockHeader { // The request for GetTransactionExecutionMetricsAfter type GetTransactionExecutionMetricsAfterRequest struct { // Block height after which to get transaction execution metrics. + // this block height will not be included in the response. BlockHeight uint64 `protobuf:"varint,1,opt,name=block_height,json=blockHeight,proto3" json:"block_height,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` @@ -1219,7 +1220,8 @@ func (m *GetTransactionExecutionMetricsAfterRequest) GetBlockHeight() uint64 { // blocks. Only finalized and executed blocks will be in the response. // The blocks are sorted by block height in descending order. type GetTransactionExecutionMetricsAfterResponse struct { - // a list of results for each block + // a list of results for each block sorted by block height in + // descending order Results []*GetTransactionExecutionMetricsAfterResponse_Result `protobuf:"bytes,1,rep,name=results,proto3" json:"results,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` diff --git a/protobuf/go/flow/execution/execution_grpc.pb.go b/protobuf/go/flow/execution/execution_grpc.pb.go index a3fc0109c..7cec5def6 100644 --- a/protobuf/go/flow/execution/execution_grpc.pb.go +++ b/protobuf/go/flow/execution/execution_grpc.pb.go @@ -73,7 +73,8 @@ type ExecutionAPIClient interface { // GetBlockHeaderByID gets a block header by ID. GetBlockHeaderByID(ctx context.Context, in *GetBlockHeaderByIDRequest, opts ...grpc.CallOption) (*BlockHeaderResponse, error) // GetTransactionExecutionMetricsAfter gets the transaction execution metrics - // for blocks after the given block height. + // for blocks after the given block height. The blocks will be sorted by + // descending block height. // If no data is available for the given block height, the response will be // empty. The execution node will only store metrics for a limited number of // blocks,  so the request may return an empty response if the requested @@ -256,7 +257,8 @@ type ExecutionAPIServer interface { // GetBlockHeaderByID gets a block header by ID. GetBlockHeaderByID(context.Context, *GetBlockHeaderByIDRequest) (*BlockHeaderResponse, error) // GetTransactionExecutionMetricsAfter gets the transaction execution metrics - // for blocks after the given block height. + // for blocks after the given block height. The blocks will be sorted by + // descending block height. // If no data is available for the given block height, the response will be // empty. The execution node will only store metrics for a limited number of // blocks,  so the request may return an empty response if the requested