transactionWatch_v1_unwatch - Bittensor RPC Method
Cancel a transaction watch subscription on Bittensor using the new JSON-RPC v2 spec.
Cancels a transaction watch subscription that was started with transactionWatch_v1_submitAndWatch. After calling this method, no further transaction lifecycle notifications will be delivered for that subscription. Always call this method when you are done tracking a transaction to free server-side resources.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
subscriptionId | string | Yes | The subscription ID returned by transactionWatch_v1_submitAndWatch. |
Response
| Field | Type | Description |
|---|---|---|
result | null | Confirms the watch subscription has been cancelled. |
Code Examples
Use Cases
- Subscription cleanup -- Cancel a transaction watch after the transaction has been finalized or after you have received the status you were waiting for.
- Timeout handling -- Stop watching a transaction that has not been included in a block within your expected timeframe.
- Resource management -- Free server-side resources in applications that submit many transactions.
Notes
- This method is part of the new JSON-RPC v2 specification and operates over WebSocket connections.
- Always unwatch when done. Leaving subscriptions open consumes server memory and may count against rate limits.
- If the transaction has already been finalized or dropped, the subscription may already be inactive, but calling
unwatchis still safe.
Related Methods
transaction_v1_broadcast-- Broadcast a transaction without watching (fire-and-forget)author_submitAndWatchExtrinsic-- Legacy method to submit and watch a transactionauthor_submitExtrinsic-- Legacy submission without watching