feat: implemented wipeToken TCK endpt.

[Adityarya11]

Description:
This PR introduce the wipeToken method to tck module.

Changes Made:

• Follows as intended from Official Specs

Related issue(s):

Fixes #2398

Notes for reviewer:

Checklist

• Documented (Code comments, README, etc.)
• Tested (unit, integration, etc.) (No Need)
• Ruff formatted.

[Copilot]

Pull request overview

This PR adds TCK support for the wipeToken JSON-RPC endpoint, aligning the Python SDK’s TCK module with the TokenWipeTransaction specification.

Changes:

• Added WipeTokenParams request model and JSON param parsing for the new endpoint.
• Added WipeTokenResponse response model.
• Implemented the wipeToken RPC handler and transaction builder using TokenWipeTransaction.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 4 comments.

File	Description
tck/response/token.py	Adds a status-only response dataclass for wipeToken.
tck/param/token.py	Adds request params dataclass + JSON parsing for wipeToken.
tck/handlers/token.py	Adds wipeToken RPC method and constructs/executes TokenWipeTransaction.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[coderabbitai]

Warning

Review limit reached

@Adityarya11, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 36 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 0be4ce32-f99c-4632-ae84-3dfa681d2999

📥 Commits

Reviewing files that changed from the base of the PR and between 96165da and edd4b5c.

📒 Files selected for processing (3)

• tck/handlers/token.py
• tck/param/token.py
• tck/response/token.py

Walkthrough

Adds the wipeToken RPC endpoint to the TCK module, including parameter parsing, response modeling, transaction construction, execution, receipt retrieval, and status mapping.

Changes

wipeToken endpoint

Layer / File(s)	Summary
Request and response contracts tck/param/token.py, tck/response/token.py	Adds WipeTokenParams with serial-number list validation and shared transaction fields, plus WipeTokenResponse.
Transaction construction and RPC execution tck/handlers/token.py	Adds the wipeToken RPC handler, builds and executes TokenWipeTransaction, retrieves the receipt, and returns the mapped status.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant JSONRPCClient
  participant wipe_token
  participant TokenWipeTransaction
  participant TransactionReceipt
  JSONRPCClient->>wipe_token: WipeTokenParams
  wipe_token->>TokenWipeTransaction: build transaction
  wipe_token->>TokenWipeTransaction: execute
  wipe_token->>TransactionReceipt: get_receipt(validate_status=True)
  TransactionReceipt-->>wipe_token: receipt.status
  wipe_token-->>JSONRPCClient: WipeTokenResponse

Loading

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly identifies the main change: adding the wipeToken TCK endpoint.
Description check	✅ Passed	The description matches the changeset and references the wipeToken addition and spec source.
Linked Issues check	✅ Passed	The PR adds the handler and the new params/response dataclasses required by issue #2398.
Out of Scope Changes check	✅ Passed	The changes are tightly scoped to the wipeToken endpoint with no obvious unrelated additions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📋 Issue Planner

Built with CodeRabbit's Coding Plans for faster development and fewer bugs.

View plan used: #2398

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[coderabbitai]

Actionable comments posted: 4

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 3201578c-9494-407f-b06a-7558c2cbc0b2

📥 Commits

Reviewing files that changed from the base of the PR and between deb64f3 and 4be1827.

📒 Files selected for processing (3)

• tck/handlers/token.py
• tck/param/token.py
• tck/response/token.py

[manishdait]

Hi @Adityarya11, Please update the branch and resolve the conflicts

[github-actions]

Hi, this is WorkflowBot.
Your pull request cannot be merged as it is not passing all our workflow checks.
Please click on each check to review the logs and resolve issues so all checks pass.
To help you:

• DCO signing guide
• Merge conflicts guide
• Rebase guide
• Testing guide
• Discord
• Community Calls
  Thank you for contributing!
  From the Hiero Python SDK Team

[codecov]

Codecov Report

❌ Patch coverage is 75.00000% with 1 line in your changes missing coverage. Please review.

❌ Your patch check has failed because the patch coverage (75.00%) is below the target coverage (92.00%). You can increase the patch coverage or adjust the target coverage.

@@            Coverage Diff             @@
##             main    #2414      +/-   ##
==========================================
- Coverage   94.99%   94.98%   -0.01%     
==========================================
  Files         164      164              
  Lines       10449    10452       +3     
==========================================
+ Hits         9926     9928       +2     
- Misses        523      524       +1     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Hello, this is the OfficeHourBot.

This is a reminder that the Hiero Python SDK Office Hours will begin in approximately 3 hours and 28 minutes (14:00 UTC).

This session provides an opportunity to ask questions regarding this Pull Request.

Details:

• Time: 14:00 UTC
• Join Link: Zoom Meeting

Disclaimer: This is an automated reminder. Please verify the schedule here for any changes.

From,
The Python SDK Team

[manishdait]

is this ready to review again

[Adityarya11]

is this ready to review again

Yeah sure

[manishdait]

just small change rest looks good to me.

[coderabbitai]

Actionable comments posted: 1

♻️ Duplicate comments (1)

tck/handlers/token.py (1)

795-796: 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win

Use int() instead of to_int() to properly surface validation errors.

The to_int helper suppresses ValueError and returns None for invalid numeric strings. If a user provides an invalid amount string, to_int silently returns None, resulting in set_amount(None) being called instead of failing the request with a clear validation error. This also violates the set_amount method signature, which expects an int.

Use int() directly so that invalid strings properly raise an exception.

🐛 Proposed fix

     if params.amount is not None:
-        transaction.set_amount(to_int(params.amount))
+        transaction.set_amount(int(params.amount))

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 1371e1d4-2604-4704-83b0-021c231a171a

📥 Commits

Reviewing files that changed from the base of the PR and between 27ee2bc and 96165da.

📒 Files selected for processing (3)

• tck/handlers/token.py
• tck/param/token.py
• tck/response/token.py

outdated

[github-actions]

👋 Hi @Adityarya11! Great work completing a Advanced issue! 🎉

Thanks for your contribution! 🚀

Here are some issues you might want to explore next:

• [Advanced]: Add CI Pipeline for Example Validation
• [Advanced]: Integrate Code Coverage for C++ SDK
• [Advanced]: Upgrade gRPC and protobuf dependencies

🌟 Stay connected:

• ⭐ Star this repository
• 👀 Watch for new issues
• 💬 Join us on Discord

Happy coding! 🚀
— Hiero Python SDK Team