feat(tck): implement createFile JSON-RPC method (hiero-ledger#2500)

Signed-off-by: iron-prog <dt915725@gmail.com>
Signed-off-by: Deepak Tiwari <dt915725@gmail.com>
Co-authored-by: Manish Dait <90558243+manishdait@users.noreply.github.com>

Author: iron-prog

tck/handlers/__init__.py

@@ -5,6 +5,7 @@
 from . import (
     account,
     allowance,
+    file,
     key,
     sdk,  # setup, reset
     token,

tck/handlers/file.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+from hiero_sdk_python.file.file_create_transaction import FileCreateTransaction
+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
+from tck.response.file import CreateFileResponse
+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.param_utils import to_int
+
+
+def _build_create_file_transaction(params: CreateFileParams) -> FileCreateTransaction:
+    transaction = FileCreateTransaction().set_grpc_deadline(DEFAULT_GRPC_TIMEOUT)
+
+    if params.keys is not None:
+        transaction.set_keys([get_key_from_string(key) for key in params.keys])
+
+    if params.contents is not None:
+        transaction.set_contents(params.contents)
+
+    if params.expirationTime is not None:
+        expiration_time = to_int(params.expirationTime)
+        if expiration_time is None:
+            raise JsonRpcError.invalid_params_error("expirationTime must be an integer")
+        transaction.set_expiration_time(Timestamp(seconds=expiration_time, nanos=0))
+
+    if params.memo is not None:
+        transaction.set_file_memo(params.memo)
+
+    return transaction
+
+
+@rpc_method("createFile")
+def create_file(params: CreateFileParams) -> CreateFileResponse:
+    """Create a file."""
+    client = get_client(params.sessionId)
+
+    transaction = _build_create_file_transaction(params)
+
+    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)
+
+    file_id = ""
+    if receipt.status == ResponseCode.SUCCESS and receipt.file_id is not None:
+        file_id = str(receipt.file_id)
+
+    return CreateFileResponse(file_id, ResponseCode(receipt.status).name)

tck/param/file.py

@@ -0,0 +1,35 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from tck.param.base import BaseTransactionParams
+from tck.util.param_utils import parse_common_transaction_params, parse_session_id
+
+
+@dataclass
+class CreateFileParams(BaseTransactionParams):
+    """Parameters for creating a file. Extends BaseTransactionParams to include common transaction parameters."""
+
+    keys: list[str] | None = None
+    contents: str | None = None
+    expirationTime: str | None = None
+    memo: str | None = None
+
+    @classmethod
+    def parse_json_params(cls, params: dict) -> CreateFileParams:
+        keys = params.get("keys")
+        if keys is not None:
+            if not isinstance(keys, list):
+                raise ValueError("keys must be a list")
+            for key in keys:
+                if not isinstance(key, str) or not key.strip():
+                    raise ValueError("keys must be a list of non-empty strings")
+
+        return cls(
+            keys=keys,
+            contents=params.get("contents"),
+            expirationTime=params.get("expirationTime"),
+            memo=params.get("memo"),
+            sessionId=parse_session_id(params),
+            commonTransactionParams=parse_common_transaction_params(params),
+        )

tck/response/file.py

@@ -0,0 +1,11 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class CreateFileResponse:
+    """Response payload for createFile."""
+
+    fileId: str | None = None
+    status: str | None = None