feat: add consumer genesis time query (#2366)

* add query handler for consumer genesis time

* add consumer genesis time command to provider CLI

* update docs

* typo

* typo #2

* typo #3

* add godoc

* nit

* add entry to changelog

* fix tests after main merge

* Update x/ccv/provider/keeper/grpc_query.go

Co-authored-by: insumity <karolos@informal.systems>

---------

Co-authored-by: Marius Poke <marius.poke@posteo.de>
Co-authored-by: insumity <karolos@informal.systems>

.changelog/unreleased/features/2366-add-genesis-time-query.md

@@ -0,0 +1,3 @@
+- `[x/provider]` Add query for consumer genesis time,
+ which corresponds to creation time of consumer clients.
+([\#2366](https://github.com/cosmos/interchain-security/pull/2366))

docs/docs/build/modules/02-provider.md

@@ -1566,6 +1566,29 @@ power_shaping_params:
 
 </details>
 
+##### Consumer Genesis Time
+
+The `consumer-genesis-time` command allows to query the genesis time of the consumer chain associated with the consumer id.
+
+```bash
+interchain-security-pd query provider consumer-genesis-time [consumer-id] [flags]
+```
+
+<details>
+  <summary>Example</summary>
+
+```bash
+interchain-security-pd query provider consumer-genesis-time 0
+```
+
+Output: 
+
+```bash
+genesis_time: "2024-10-18T08:13:23.507178095Z"
+```
+
+</details>
+
 #### Transactions
 
 The `tx` commands allows users to interact with the `provider` module.
@@ -2409,7 +2432,7 @@ Output:
 
 #### Throttle State
 
-The `QueryThrottleState` queries the main on-chain state relevant to slash packet throttling.
+The `QueryThrottleState` endpoint queries the main on-chain state relevant to slash packet throttling.
 
 ```bash
 interchain_security.ccv.provider.v1.Query/QueryThrottleState
@@ -2801,7 +2824,7 @@ Output:
 
 #### Consumer Chain
 
-The `QueryConsumerChain` command allows to query the consumer chain associated with the consumer id.
+The `QueryConsumerChain` endpoint allows to query the consumer chain associated with the consumer id.
 
 ```bash
 interchain_security.ccv.provider.v1.Query/QueryConsumerChain
@@ -2850,6 +2873,29 @@ grpcurl -plaintext -d '{"consumer_id": "0"}' localhost:9090 interchain_security.
 
 </details>
 
+#### Consumer Genesis Time
+
+The `QueryConsumerGenesisTime` endpoint allows to query the genesis time of the consumer chain associated with the consumer id.
+
+```bash
+interchain_security.ccv.provider.v1.Query/QueryConsumerGenesisTime
+```
+
+<details>
+  <summary>Example</summary>
+
+```bash
+grpcurl -plaintext -d '{"consumer_id": "0"}' localhost:9090 interchain_security.ccv.provider.v1.Query/QueryConsumerGenesisTime
+```
+
+```json
+{
+  "genesisTime": "2024-10-18T08:13:23.507178095Z"
+}
+```
+
+</details>
+
 ### REST
 
 A user can query the `provider` module using REST endpoints.
@@ -3524,3 +3570,28 @@ Output:
 ```
 
 </details>
+
+#### Consumer Genesis Time
+
+The `consumer_genesis_time` endpoint allows to query the genesis time of the consumer chain associated with the consumer id.
+
+```bash
+interchain_security/ccv/provider/consumer_genesis_time/{consumer_id}
+```
+
+<details>
+  <summary>Example</summary>
+
+```bash
+curl http://localhost:1317/interchain_security/ccv/provider/consumer_genesis_time/0
+```
+
+Output:
+
+```json
+{
+  "genesis_time":"2024-10-18T08:29:46.153234Z"
+}
+```
+
+</details>

proto/interchain_security/ccv/provider/v1/query.proto

@@ -144,6 +144,14 @@ service Query {
     option (google.api.http).get =
         "/interchain_security/ccv/provider/consumer_chain/{consumer_id}";
   }
+
+  // QueryConsumerGenesisTime returns the genesis time
+  // of the consumer chain associated with the provided consumer id
+  rpc QueryConsumerGenesisTime(QueryConsumerGenesisTimeRequest)
+      returns (QueryConsumerGenesisTimeResponse) {
+    option (google.api.http).get =
+        "/interchain_security/ccv/provider/consumer_genesis_time/{consumer_id}";
+  }
 }
 
 message QueryConsumerGenesisRequest {
@@ -390,3 +398,12 @@ message QueryConsumerChainResponse {
   ConsumerInitializationParameters init_params = 6;
   PowerShapingParameters power_shaping_params = 7;
 }
+
+message QueryConsumerGenesisTimeRequest {
+  string consumer_id = 1;
+}
+
+message QueryConsumerGenesisTimeResponse {
+  google.protobuf.Timestamp genesis_time = 1
+  [ (gogoproto.stdtime) = true, (gogoproto.nullable) = false ];
+}

x/ccv/provider/client/cli/query.go

@@ -41,6 +41,7 @@ func NewQueryCmd() *cobra.Command {
 	cmd.AddCommand(CmdBlocksUntilNextEpoch())
 	cmd.AddCommand(CmdConsumerIdFromClientId())
 	cmd.AddCommand(CmdConsumerChain())
+	cmd.AddCommand(CmdConsumerGenesisTime())
 	return cmd
 }
 
@@ -584,3 +585,30 @@ func CmdConsumerChain() *cobra.Command {
 
 	return cmd
 }
+
+func CmdConsumerGenesisTime() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "consumer-genesis-time [consumer-id]",
+		Short: "Query the genesis time of the consumer chain associated with the consumer id",
+		Args:  cobra.ExactArgs(1),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			clientCtx, err := client.GetClientQueryContext(cmd)
+			if err != nil {
+				return err
+			}
+			queryClient := types.NewQueryClient(clientCtx)
+
+			req := &types.QueryConsumerGenesisTimeRequest{ConsumerId: args[0]}
+			res, err := queryClient.QueryConsumerGenesisTime(cmd.Context(), req)
+			if err != nil {
+				return err
+			}
+
+			return clientCtx.PrintProto(res)
+		},
+	}
+
+	flags.AddQueryFlagsToCmd(cmd)
+
+	return cmd
+}

x/ccv/provider/keeper/grpc_query.go

@@ -6,6 +6,7 @@ import (
 	"encoding/binary"
 	"fmt"
 	"sort"
+	"time"
 
 	"google.golang.org/grpc/codes"
 	"google.golang.org/grpc/status"
@@ -627,3 +628,59 @@ func (k Keeper) QueryConsumerChain(goCtx context.Context, req *types.QueryConsum
 		PowerShapingParams: &powerParams,
 	}, nil
 }
+
+//  QueryConsumerGenesisTime returns the genesis time
+// of the consumer chain associated with the provided consumer id
+func (k Keeper) QueryConsumerGenesisTime(goCtx context.Context, req *types.QueryConsumerGenesisTimeRequest) (*types.QueryConsumerGenesisTimeResponse, error) {
+	if req == nil {
+		return nil, status.Errorf(codes.InvalidArgument, "empty request")
+	}
+
+	consumerId := req.ConsumerId
+	if err := ccvtypes.ValidateConsumerId(consumerId); err != nil {
+		return nil, status.Error(codes.InvalidArgument, err.Error())
+	}
+	ctx := sdk.UnwrapSDKContext(goCtx)
+
+	// Get consumer initialization params. If they aren't found,
+	// it means that there is no consumer for that consumerId.
+	params, err := k.GetConsumerInitializationParameters(ctx, consumerId)
+	if err != nil {
+		return nil, status.Errorf(
+			codes.InvalidArgument,
+			"cannot get consumer genesis time for consumer Id: %s: %s",
+			consumerId, types.ErrUnknownConsumerId,
+		)
+	}
+
+	// Get the consumer clientId. If it isn't found, it means
+	// that the consumer hasn't been launched or has been stopped and deleted.
+	clientID, ok := k.GetConsumerClientId(ctx, consumerId)
+	if !ok {
+		return nil, status.Errorf(
+			codes.InvalidArgument,
+			"cannot get consumer genesis time for consumer Id: %s: consumer hasn't been launched or has been stopped and deleted",
+			consumerId,
+		)
+	}
+
+	// Get the consensus state of the consumer client at the initial height,
+	// for which the timestamps corresponds to the consumer genesis time
+	cs, ok := k.clientKeeper.GetClientConsensusState(
+		ctx,
+		clientID,
+		params.InitialHeight,
+	)
+	if !ok {
+		return nil, status.Errorf(
+			codes.InvalidArgument,
+			"cannot get consumer genesis time for consumer Id: %s: cannot find consensus state for initial height: %s",
+			consumerId,
+			params.InitialHeight,
+		)
+	}
+
+	return &types.QueryConsumerGenesisTimeResponse{
+		GenesisTime: time.Unix(0, int64(cs.GetTimestamp())),
+	}, nil
+}