feat: implemented wipeToken TCK endpt. (hiero-ledger#2414)

Signed-off-by: Adityarya11 <arya050411@gmail.com>
Signed-off-by: Aditya Arya <arya050411@gmail.com>

Author: Adityarya11

tck/handlers/token.py

@@ -34,6 +34,7 @@
 from hiero_sdk_python.tokens.token_reject_transaction import TokenRejectTransaction
 from hiero_sdk_python.tokens.token_revoke_kyc_transaction import TokenRevokeKycTransaction
 from hiero_sdk_python.tokens.token_type import TokenType
+from hiero_sdk_python.tokens.token_wipe_transaction import TokenWipeTransaction
 from hiero_sdk_python.transaction.transaction_receipt import TransactionReceipt
 from tck.handlers.registry import rpc_method
 from tck.param.custom_fee import CustomFeeParams, FixedFeeParams
@@ -51,6 +52,7 @@
     PauseTokenParams,
     RejectTokenParams,
     RevokeTokenKycParams,
+    WipeTokenParams,
 )
 from tck.response.token import (
     AirdropTokenResponse,
@@ -67,6 +69,7 @@
     PauseTokenResponse,
     RejectTokenResponse,
     RevokeTokenKycResponse,
+    WipeTokenResponse,
 )
 from tck.util.client_utils import get_client
 from tck.util.constants import DEFAULT_GRPC_TIMEOUT
@@ -776,3 +779,41 @@ def reject_token(params: RejectTokenParams) -> RejectTokenResponse:
     return RejectTokenResponse(
         status=ResponseCode(receipt.status).name,
     )
+
+
+def _build_wipe_token_transaction(params: WipeTokenParams) -> TokenWipeTransaction:
+    """Build a TokenWipeTransaction from TCK params."""
+
+    transaction = TokenWipeTransaction().set_grpc_deadline(DEFAULT_GRPC_TIMEOUT)
+
+    if params.tokenId is not None:
+        transaction.set_token_id(TokenId.from_string(params.tokenId))
+
+    if params.accountId is not None:
+        transaction.set_account_id(AccountId.from_string(params.accountId))
+
+    if params.amount is not None:
+        transaction.set_amount(to_int(params.amount))
+
+    if params.serialNumbers is not None:
+        serial_number_list = [int(serial_number) for serial_number in params.serialNumbers]
+        transaction.set_serial(serial_number_list)
+
+    return transaction
+
+
+@rpc_method("wipeToken")
+def wipe_token(params: WipeTokenParams) -> WipeTokenResponse:
+    """Wipes the provided amount of fungible or non-fungible tokens from the specified Hedera account"""
+
+    client = get_client(params.sessionId)
+
+    transaction = _build_wipe_token_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)
+
+    return WipeTokenResponse(status=ResponseCode(receipt.status).name)

tck/param/token.py

@@ -341,3 +341,38 @@ def parse_json_params(cls, params: dict) -> RejectTokenParams:
             sessionId=parse_session_id(params),
             commonTransactionParams=parse_common_transaction_params(params),
         )
+
+
+@dataclass
+class WipeTokenParams(BaseTransactionParams):
+    """Wipes the provided amount of fungible or non-fungible tokens from the specified Hedera account."""
+
+    tokenId: str | None = None
+    accountId: str | None = None
+    amount: str | None = None
+    serialNumbers: list[str] | None = None
+
+    @classmethod
+    def parse_json_params(cls, params: dict) -> WipeTokenParams:
+        """Parse JSON-RPC params into a WipeTokenParams instance."""
+        token_id = params.get("tokenId")
+
+        account_id = params.get("accountId")
+
+        amount = params.get("amount")
+
+        serial_numbers = params.get("serialNumbers")
+        if serial_numbers is not None and (
+            not isinstance(serial_numbers, list)
+            or not all(isinstance(serial_number, str) for serial_number in serial_numbers)
+        ):
+            raise ValueError("serialNumbers must be a list of strings")
+
+        return cls(
+            tokenId=token_id,
+            accountId=account_id,
+            amount=amount,
+            serialNumbers=serial_numbers,
+            sessionId=parse_session_id(params),
+            commonTransactionParams=parse_common_transaction_params(params),
+        )

tck/response/token.py

@@ -117,3 +117,8 @@ class GetTokenInfoResponse:
     maxSupply: str | None = None
     metadata: str | None = None
     ledgerId: str | None = None
+
+
+@dataclass
+class WipeTokenResponse(StatusOnlyResponse):
+    """Response payload for wipeToken."""