Stream Top-Up Tool

WHAT IT DOES

Stream Top-Up Tool is a DeFi-focused tool that enables senders to add tokens to active streams, increasing the total stream amount. Unlike simple transfer tools that only send tokens, this tool specifically handles stream top-ups, allowing users to extend the duration or increase the payout of an existing token stream. It reads stream status, verifies stream parameters, checks current stream balance, validates token approval status, confirms user's token balance, and verifies top-up eligibility. The tool supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, and Base, providing a unified interface to top up streams across multiple networks. This is essential for users who need to add more tokens to an active stream, extending its duration or increasing the total payout to the recipient.

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, token address, and the amount to add. Click "Check stream & balance" to verify the stream is active, confirm you are the sender, and check your token balance and approval status. The tool displays the current total, top-up amount, new total, and a progress bar showing stream completion. If the stream is active, you are the sender, and you have sufficient balance, the "Top up stream" button appears. The tool automatically handles token approval if needed. Click it to submit the top-up transaction. The tool displays a transaction link to your chain's block explorer and logs the final gas cost using receipt.effectiveGasPrice.

ADAPTIVE STREAM VALIDATION AND TOP-UP ENGINE

The core technical mechanism that distinguishes this tool is its adaptive stream validation and top-up engine. Unlike simple token transfers that just send funds, this tool performs comprehensive validation before allowing a top-up. The engine first reads the full stream data using getStream(streamId), extracting the sender, recipient, start time, stop time, and total amount. It then checks the stream status using isActive(streamId), isCancelled(streamId), and isCompleted(streamId) to confirm the stream is in a state that supports top-ups. The engine verifies that the connected wallet matches the stream sender, as only the sender can add tokens to a stream. It then checks the user's token balance using the ERC-20 balanceOf() method, ensuring sufficient tokens are available. The engine also checks the token allowance using allowance(address, spender), and if the allowance is insufficient, it requests approval before the top-up. If all checks pass, the top-up transaction increases the total stream amount and updates the stop time accordingly. 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 validation completes even during network congestion.

WHAT IT CANNOT SEE

The tool cannot guarantee that a stream will be topped up correctly if the token contract does not support the required transfer and allowance methods, the user does not have sufficient token balance, the stream has already ended or been cancelled, or the stream contract's logic changes before the top-up is submitted. It has no visibility into the stream contract's internal accounting beyond what the contract exposes, nor can it predict if the contract logic will be modified. The tool cannot detect if the stream contract has been upgraded. It does not monitor streams after top-up—it is a top-up tool, not a tracking service. The tool cannot interact with non-EVM chains, private networks, or stream contracts that do not implement the standard top-up 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, stream ID, and token address before topping up—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 top-up risks, including the possibility that the contract may not handle top-ups as expected.