Timelock Cancel Tool

WHAT IT DOES

This tool cancels queued operations in a timelock controller contract. It reads and displays the timelock operation status (pending, ready, executed, or cancelled), operation details (target contract, calldata, value, delay, and execution time), cancellation eligibility (whether the operation can be cancelled), account balance, chain ID, and cancellation history. Beyond read-only access, the tool lets you execute the five key actions: cancel a queued timelock operation, approve a cancellation (if required), batch cancel multiple queued operations in one transaction, claim cancellation confirmation, and cancel a pending cancellation request.

HOW TO USE

Connect your wallet and select the network. Enter the timelock contract address, operation ID, and type "CANCEL" in the confirmation field. Click "Load State" to fetch the operation status, details, queued operations list, and cancellation history. Review the operation status, target, delay, and execution time. If the operation is cancellable and you have confirmed, click "Cancel Operation" to cancel the queued operation. If the contract requires explicit approval, click "Approve" first. To cancel multiple operations at once, click "Batch Cancel." Click "Claim" to confirm a completed cancellation, or "Cancel Request" to cancel a pending cancellation request. Each transaction shows confirmation and gas cost reporting.

TECHNICAL MECHANISM

The tool interacts with a timelock contract that manages time-delayed operations. The cancelOperation() function cancels a queued operation, removing it from the queue and preventing execution. The contract validates that the operation is cancellable (pending or ready) and that the caller is authorized. The approveCancellation() function allows explicit approval of a cancellation before execution. Batch cancellation uses cancelBatch() with an array of operation IDs. The tool fetches operation details via operationDetails() and cancellation history via cancellationHistory().

WHAT IT CANNOT SEE

Cannot verify that cancelling the operation is the correct decision. Relies entirely on the timelock contract's verification and the destination chain's final state. Cannot detect if the cancellation will cause unintended consequences, if the operation was already executed, or if the cancellation is being performed by an unauthorized party.

PLEASE NOTE — EVM CHAINS ONLY

Supports Ethereum, Polygon, Optimism, Arbitrum, Base and similar EVM chains. The timelock contract must implement operationStatus(), operationDetails(), cancelOperation(), approveCancellation(), cancelBatch(), claimCancellation(), cancelCancelRequest(), cancellationHistory(), and queuedOperationAt(). The tool is read-write: it signs transactions for cancellation, approval, batch cancellation, claiming, and cancellation request cancellation. Always verify the contract address and operation ID before submitting. Cancellation requires explicit confirmation.