feat(tck): implement getFileInfo JSON-RPC method (hiero-ledger#2580)

Signed-off-by: achintya2k5 <achintyasin@gmail.com>
Co-authored-by: exploreriii <133720349+exploreriii@users.noreply.github.com>

Author: achintya2k5

src/hiero_sdk_python/file/file_info_query.py

@@ -60,18 +60,16 @@ def _make_request(self) -> query_pb2.Query:
             Query: The protobuf query message.
 
         Raises:
-            ValueError: If the file ID is not set.
-            Exception: If any other error occurs during request construction.
+            Exception: If any error occurs during request construction.
         """
         try:
-            if not self.file_id:
-                raise ValueError("File ID must be set before making the request.")
-
             query_header = self._make_request_header()
 
             file_info_query = file_get_info_pb2.FileGetInfoQuery()
             file_info_query.header.CopyFrom(query_header)
-            file_info_query.fileID.CopyFrom(self.file_id._to_proto())
+
+            if self.file_id is not None:
+                file_info_query.fileID.CopyFrom(self.file_id._to_proto())
 
             query = query_pb2.Query()
             query.fileGetInfo.CopyFrom(file_info_query)

tck/handlers/file.py

@@ -3,17 +3,19 @@
 from hiero_sdk_python.file.file_contents_query import FileContentsQuery
 from hiero_sdk_python.file.file_create_transaction import FileCreateTransaction
 from hiero_sdk_python.file.file_id import FileId
+from hiero_sdk_python.file.file_info import FileInfo
+from hiero_sdk_python.file.file_info_query import FileInfoQuery
 from hiero_sdk_python.hbar import Hbar
 from hiero_sdk_python.response_code import ResponseCode
 from hiero_sdk_python.timestamp import Timestamp
 from hiero_sdk_python.transaction.transaction_receipt import TransactionReceipt
 from tck.errors import JsonRpcError
 from tck.handlers.registry import rpc_method
-from tck.param.file import CreateFileParams, GetFileContentsParams
-from tck.response.file import CreateFileResponse, GetFileContentsResponse
+from tck.param.file import CreateFileParams, GetFileContentsParams, GetFileInfoParams
+from tck.response.file import CreateFileResponse, GetFileContentsResponse, GetFileInfoResponse
 from tck.util.client_utils import get_client
 from tck.util.constants import DEFAULT_GRPC_TIMEOUT
-from tck.util.key_utils import get_key_from_string
+from tck.util.key_utils import get_key_from_string, key_to_string
 from tck.util.param_utils import to_int
 
 
@@ -76,3 +78,31 @@ def get_file_contents(params: GetFileContentsParams) -> GetFileContentsResponse:
     decoded_contents = contents.decode("utf-8", errors="replace") if isinstance(contents, bytes) else str(contents)
 
     return GetFileContentsResponse(contents=decoded_contents)
+
+
+def _build_file_info_response(info: FileInfo) -> GetFileInfoResponse:
+    """Build a GetFileResponse from a FileInfo object."""
+
+    keys = [key_to_string(k) for k in info.keys] if info.keys else []
+
+    return GetFileInfoResponse(
+        fileId=str(info.file_id) if info.file_id is not None else None,
+        size=str(info.size) if info.size is not None else None,
+        expirationTime=str(info.expiration_time.seconds) if info.expiration_time is not None else None,
+        isDeleted=info.is_deleted,
+        keys=keys,
+        memo=info.file_memo,
+        ledgerId=info.ledger_id.hex() if info.ledger_id is not None else None,
+    )
+
+
+@rpc_method("getFileInfo")
+def get_file_info(params: GetFileInfoParams) -> GetFileInfoResponse:
+    client = get_client(params.sessionId)
+    query = FileInfoQuery().set_grpc_deadline(DEFAULT_GRPC_TIMEOUT)
+
+    if params.fileId is not None:
+        query.set_file_id(FileId.from_string(params.fileId))
+
+    info = query.execute(client)
+    return _build_file_info_response(info)

tck/param/file.py

@@ -51,3 +51,15 @@ def parse_json_params(cls, params: dict) -> GetFileContentsParams:
             queryPayment=params.get("queryPayment"),
             maxQueryPayment=params.get("maxQueryPayment"),
         )
+
+
+@dataclass
+class GetFileInfoParams(BaseParams):
+    """Parameters for getting file information."""
+
+    fileId: str | None = None
+
+    @classmethod
+    def parse_json_params(cls, params: dict) -> GetFileInfoParams:
+        """Parse JSON-RPC params into a GetFileInfoParams instance."""
+        return cls(fileId=params.get("fileId"), sessionId=parse_session_id(params))

tck/response/file.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 
 
 @dataclass
@@ -16,3 +16,14 @@ class GetFileContentsResponse:
     """Response payload for getFileContents."""
 
     contents: str | None = None
+
+
+@dataclass
+class GetFileInfoResponse:
+    fileId: str | None = None
+    size: str | None = None
+    expirationTime: str | None = None
+    isDeleted: bool | None = None
+    keys: list[str] = field(default_factory=list)
+    memo: str | None = None
+    ledgerId: str | None = None

tests/unit/file_info_query_test.py

@@ -33,12 +33,11 @@ def test_constructor():
     assert query.file_id == file_id
 
 
-def test_execute_fails_with_missing_file_id(mock_client):
-    """Test request creation with missing File ID."""
+def test_make_request_with_missing_file_id():
+    """Test File ID is omitted from proto when not set."""
     query = FileInfoQuery()
-
-    with pytest.raises(ValueError, match="File ID must be set before making the request."):
-        query.execute(mock_client)
+    proto = query._make_request()
+    assert not proto.fileGetInfo.HasField("fileID")
 
 
 def test_get_method():