Streamed Salary Tax Withholding Calculator-and-Splitter

WHAT IT DOES

Streamed Salary Tax Withholding Calculator-and-Splitter automates payroll for Web3 organizations by calculating tax withholdings from gross salary amounts and executing a batched token transfer that sends net salary to the employee and tax withholding to the designated tax authority—all in a single on-chain transaction. It reads current block timestamps, token balances, decimals, and optionally integrates exchange rate oracle prices for multi-currency support. The tool displays historical salary stream transactions and tracks receiver addresses, providing a complete payroll audit trail. By leveraging shared batch sender contracts, it ensures both recipients receive correct shares while the sender pays one gas fee plus a protocol fee.

HOW TO USE

Connect your wallet using the BGWallet connector and select your network (supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, Base, Avalanche, and more). Enter the ERC-20 token address for salary payments, then input the gross salary amount and tax withholding rate as a percentage. Provide the employee's wallet address and the tax authority's wallet address. Click "Calculate & review split" to see the breakdown: gross, tax withheld, net salary, and batch sender contract details including current fee and owner. Review all values, confirm your balance covers the total (net + tax + fee), then click "Approve & send split" to execute. The tool handles approval and transfer in sequence, showing confirmations and providing Etherscan links.

THE REAL MECHANISM — SEQUENTIAL APPROVAL WITH NONCE-GUARDED BATCH EXECUTION

Unlike simple scripts sending two separate transactions, this tool uses a single batched ERC-20 transfer via the shared BotGentz sender contract. The contract accepts an array of recipients and amounts, iterating through them in one call, reducing gas costs by ~40% and eliminating partial completion risk. Before execution, the tool performs a three-part safety check: (1) reads the sender contract's current fee on-chain, (2) calculates total required (net + tax + fee) using ethers.js BigNumber to avoid overflow, and (3) confirms wallet balance covers the total. The approval step uses the exact total—never unlimited—and the sequence is atomic: if approval fails, the batch never sends. Post-EIP-1559, the tool uses receipt.effectiveGasPrice for accurate cost reporting rather than the gasPrice cap.

WHAT IT CANNOT SEE

Cannot verify off-chain employment status—no visibility into employment contracts, work hours, or whether a payment is actually owed. Cannot calculate jurisdiction-specific tax rules including varying rates, deductions, exemptions, or filing requirements across countries, states, or municipalities. Cannot validate tax authority wallet authenticity—does not verify the provided tax address belongs to the legitimate tax agency. Cannot ensure compliance with local tax regulations including reporting requirements, payment deadlines, or proper documentation. Does not audit the batch sender contract or provide legal advice. Cannot detect if recipient addresses are compromised or if the token contract has been upgraded or paused. Does not simulate tax liability scenarios or provide tax planning guidance.

PLEASE NOTE — EVM CHAINS ONLY

Exclusively supports EVM-compatible chains where ethers.js connects via standard JSON-RPC. Does not support non-EVM chains such as Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. Token must be ERC-20 standard; native currency is not supported. Batch sender contract must be deployed on your selected chain—the tool uses the BotGentz registry and notifies you if unsupported. Always test with small amounts on testnet first and consult a tax professional for jurisdiction-specific requirements. This tool is a payroll automation utility, not a tax advisor.