Stream Canceller

WHAT IT DOES

Stream Canceller is a DeFi-focused tool that enables senders to cancel active token streams, returning any remaining unstreamed tokens. Unlike simple withdrawal tools that only handle completed streams, this tool allows stream creators or senders to terminate streams before their completion date, refunding the unused portion. It reads stream status, verifies stream parameters (sender, recipient, start time, stop time, total amount), calculates streamed amounts, checks remaining balances, and validates cancellation eligibility. The tool supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, and Base, providing a unified interface to cancel streams across multiple networks. This is essential for users who have created token streams and need to stop them early due to changed circumstances.

HOW TO USE

Connect your wallet using WalletConnect or a compatible browser extension. Ensure your wallet is on the network where the stream contract is deployed. Enter the stream contract address—this is the contract you are interacting with, and you are vouching for its safety. Enter the stream ID of the stream you want to cancel. Click "Check stream" to read the stream details and verify your eligibility to cancel. The tool displays the sender, recipient, total amount, streamed amount, remaining amount, and a progress bar showing how much of the stream has completed. If the stream is active and you are the sender, the "Cancel stream" button appears. Click it to submit the cancellation transaction. The tool sends the remaining unstreamed tokens back to the sender, stops the stream, and logs the transaction. The tool displays a transaction link to your chain's block explorer and logs the final gas cost using receipt.effectiveGasPrice.

ADAPTIVE STREAM STATUS DETECTION AND CANCELLATION ENGINE

The core technical mechanism that distinguishes this tool is its adaptive stream status detection and cancellation engine. Unlike simple claim tools that only check a single condition, this tool performs comprehensive stream validation before allowing cancellation. The engine first reads the full stream data using getStream(streamId), extracting the sender, recipient, start time, stop time, and total amount. It then calculates the streamed amount using streamedAmount(streamId), which factors in the current block timestamp and the stream's start and stop times. The engine checks the stream status using isActive(streamId), isCancelled(streamId), and isCompleted(streamId) to determine if the stream can be cancelled. It verifies that the connected wallet matches the stream sender, as only the sender can cancel a stream. If the stream is active and the user is the sender, the cancellation button is enabled. When executed, the cancellation function stops the stream and sends the remaining balance back to the sender. All RPC calls are wrapped with timeout and retry logic, and the tool automatically falls back to a secondary provider if the primary endpoint fails or rate-limits, ensuring detection completes even during network congestion.

WHAT IT CANNOT SEE

The tool cannot guarantee that a stream will be cancelled correctly if the stream contract's balance is insufficient to refund the remaining tokens, the stream has already fully completed, the cancellation parameters change before execution, or the stream contract's logic is modified after the stream was created. It has no visibility into the stream contract's internal accounting beyond what the contract exposes, nor can it predict if the contract balance will change between checking and cancellation. The tool cannot detect if the stream contract has been upgraded or modified. It does not monitor streams after cancellation—it is a cancellation tool, not a tracking service. The tool cannot interact with non-EVM chains, private networks, or stream contracts that do not implement the standard stream cancellation interface it expects.

PLEASE NOTE

This tool is designed exclusively for EVM-compatible blockchain networks. It supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, Base, and similar chains. Non-EVM networks such as Solana, Cosmos, or Bitcoin are not supported. Always verify the stream contract address and stream ID before cancelling—the tool does not validate contract safety or stream terms beyond basic verification. The tool provides estimates only—actual gas costs are determined at the time of transaction execution. Users are responsible for understanding stream cancellation risks, including the possibility that the contract may not have sufficient balance to refund remaining tokens.