Stream Splitter

WHAT IT DOES

Stream Splitter is a DeFi-focused tool that enables senders to split active token streams into multiple streams for different recipients. Unlike single-stream tools that only handle one recipient, this tool allows users to divide a stream's remaining balance proportionally among multiple recipients, creating new streams for each. It reads original stream parameters, validates split ratios, verifies recipient addresses, checks stream status, confirms token balance, and handles approval status. The tool supports Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB Chain, and Base, providing a unified interface to split streams across multiple networks. This is essential for users who need to distribute token streams to multiple beneficiaries without creating separate streams from scratch or manually transferring tokens.

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 original stream ID, token address, and add recipients with their percentage allocations. Percentages must sum to 100%. Click "Check stream & validate" to verify the stream is active, confirm you are the sender, and check the remaining balance. The tool displays the total amount, streamed amount, remaining amount, and a progress bar. If the stream is active and you are the sender, the "Split stream" button appears. The tool automatically handles token approval if needed. Click it to submit the split transaction, which creates new streams for each recipient. The tool displays a transaction link to your chain's block explorer and logs the final gas cost using receipt.effectiveGasPrice.

ADAPTIVE STREAM SPLIT VALIDATION AND EXECUTION ENGINE

The core technical mechanism that distinguishes this tool is its adaptive stream split validation and execution engine. Unlike simple transfer tools that just send tokens, this tool performs comprehensive validation before allowing a split. 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 splitting. The engine verifies that the connected wallet matches the stream sender, as only the sender can split a stream. It calculates the remaining balance (total - streamed) and validates that it is greater than zero. The engine then validates the split parameters: each recipient address must be valid, percentages must be positive, and the sum of all percentages must equal 100%. If all checks pass, the engine calculates each recipient's share and calls the splitStream() function, which creates new streams for each recipient and stops the original stream. 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 stream splits will execute correctly if the original stream is cancelled or completed before the split, the token contract does not support the required transfer methods, the user does not have sufficient balance for gas, or the stream contract's logic changes before the split transaction is confirmed. 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 splitting—it is a split tool, not a tracking service. The tool cannot interact with non-EVM chains, private networks, or stream contracts that do not implement the standard split 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, token address, and recipient addresses before splitting—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 split risks, including the possibility that the contract may not handle splits as expected.