feat(tck): implement deleteFile JSON-RPC method

Signed-off-by: Siddhartha Ganguly <gangulysiddhartha22@gmail.com>

Author: gangulysiddhartha22-cmyk

src/hiero_sdk_python/file/file_delete_transaction.py

@@ -1,7 +1,8 @@
 """Transaction to delete a file on the network."""
-
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from hiero_sdk_python.channels import _Channel
 from hiero_sdk_python.executable import _Method
 from hiero_sdk_python.file.file_id import FileId
@@ -13,93 +14,77 @@
 from hiero_sdk_python.transaction.transaction import Transaction
 
 
-DEFAULT_TRANSACTION_FEE = Hbar(2).to_tinybars()
-
+if TYPE_CHECKING:
+    from hiero_sdk_python.hapi.services.transaction_pb2 import TransactionBody
 
+DEFAULT_TRANSACTION_FEE = Hbar(2).to_tinybars()
 class FileDeleteTransaction(Transaction):
     """
     Represents a file deletion transaction on the network.
-
     This transaction deletes a specified file, rendering it inactive.
-
     Inherits from the base Transaction class and implements the required methods
     to build and execute a file deletion transaction.
     """
-
     def __init__(self, file_id: FileId | None = None):
         """
         Initializes a new FileDeleteTransaction instance with optional file_id.
-
         Args:
             file_id (FileId, optional): The ID of the file to be deleted.
         """
         super().__init__()
         self.file_id = file_id
         self._default_transaction_fee = DEFAULT_TRANSACTION_FEE
-
     def set_file_id(self, file_id: FileId) -> FileDeleteTransaction:
         """
         Sets the ID of the file to be deleted.
-
         Args:
             file_id (FileId): The ID of the file to be deleted.
-
         Returns:
             FileDeleteTransaction: Returns self for method chaining.
         """
         self._require_not_frozen()
         self.file_id = file_id
         return self
-
-    def _build_proto_body(self):
+    def _build_proto_body(self) -> FileDeleteTransactionBody:
         """
         Returns the protobuf body for the file delete transaction.
 
+        If file_id is not set, the fileID field is left unset so the network
+        responds with INVALID_FILE_ID rather than failing locally.
+
         Returns:
             FileDeleteTransactionBody: The protobuf body for this transaction.
-
-        Raises:
-            ValueError: If file_id is not set.
         """
-        if self.file_id is None:
-            raise ValueError("Missing required FileID")
-
-        return FileDeleteTransactionBody(fileID=self.file_id._to_proto())
-
-    def build_transaction_body(self):
+        return FileDeleteTransactionBody(
+            fileID=self.file_id._to_proto() if self.file_id is not None else None
+        )
+    def build_transaction_body(self) -> TransactionBody:
         """
         Builds and returns the protobuf transaction body for file deletion.
-
         Returns:
             TransactionBody: The protobuf transaction body containing the file deletion details.
         """
         file_delete_body = self._build_proto_body()
         transaction_body = self.build_base_transaction_body()
         transaction_body.fileDelete.CopyFrom(file_delete_body)
         return transaction_body
-
     def build_scheduled_body(self) -> SchedulableTransactionBody:
         """
         Builds the scheduled transaction body for this file delete transaction.
-
         Returns:
             SchedulableTransactionBody: The built scheduled transaction body.
         """
         file_delete_body = self._build_proto_body()
         schedulable_body = self.build_base_scheduled_body()
         schedulable_body.fileDelete.CopyFrom(file_delete_body)
         return schedulable_body
-
     def _get_method(self, channel: _Channel) -> _Method:
         """
         Gets the method to execute the file delete transaction.
-
         This internal method returns a _Method object containing the appropriate gRPC
         function to call when executing this transaction on the network.
-
         Args:
             channel (_Channel): The channel containing service stubs
-
         Returns:
             _Method: An object containing the transaction function to delete a file.
         """

tck/handlers/file.py

@@ -2,15 +2,16 @@
 
 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_delete_transaction import FileDeleteTransaction
 from hiero_sdk_python.file.file_id import FileId
 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, DeleteFileParams, GetFileContentsParams
+from tck.response.file import CreateFileResponse, DeleteFileResponse, GetFileContentsResponse
 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
@@ -76,3 +77,22 @@ 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)
+
+
+@rpc_method("deleteFile")
+def delete_file(params: DeleteFileParams) -> DeleteFileResponse:
+    """Delete a file."""
+    client = get_client(params.sessionId)
+
+    transaction = FileDeleteTransaction().set_grpc_deadline(DEFAULT_GRPC_TIMEOUT)
+
+    if params.fileId is not None:
+        transaction.set_file_id(FileId.from_string(params.fileId))
+
+    if params.commonTransactionParams is not None:
+        params.commonTransactionParams.apply_common_params(transaction, client)
+
+    response = transaction.execute(client, wait_for_receipt=False)
+    receipt: TransactionReceipt = response.get_receipt(client, validate_status=True)
+
+    return DeleteFileResponse(ResponseCode(receipt.status).name)

tck/param/file.py

@@ -51,3 +51,19 @@ def parse_json_params(cls, params: dict) -> GetFileContentsParams:
             queryPayment=params.get("queryPayment"),
             maxQueryPayment=params.get("maxQueryPayment"),
         )
+
+
+@dataclass
+class DeleteFileParams(BaseTransactionParams):
+    """Parameters for deleting a file. Extends BaseTransactionParams to include common transaction parameters."""
+
+    fileId: str | None = None
+
+    @classmethod
+    def parse_json_params(cls, params: dict) -> DeleteFileParams:
+
+        return cls(
+            fileId=params.get("fileId"),
+            sessionId=parse_session_id(params),
+            commonTransactionParams=parse_common_transaction_params(params),
+        )

tck/response/file.py

@@ -2,6 +2,8 @@
 
 from dataclasses import dataclass
 
+from tck.response.base import StatusOnlyResponse
+
 
 @dataclass
 class CreateFileResponse:
@@ -16,3 +18,8 @@ class GetFileContentsResponse:
     """Response payload for getFileContents."""
 
     contents: str | None = None
+
+
+@dataclass
+class DeleteFileResponse(StatusOnlyResponse):
+    """Response payload for deleteFile."""