Charity Raffle Payout Splitter

WHAT IT DOES

Charity Raffle Payout Splitter is a non-custodial tool that distributes raffle proceeds between winners and designated charity organizations in a single bulk transaction based on configured split ratios. It reads charity raffle payout contract state, user address, token balances, split parameters, raffle ID, prize pool amount, charity split percentage, winner split percentage, charity address list, winner list, payout distribution state, split eligibility, settlement state, and fee structure to structure the optimal split operation. With a single transaction, it calls splitPayout(), executeCharitySplit(), or submitRaffleSplit() on the shared sender contract, distributing funds to both winners and charities simultaneously. The tool supports ERC-20, ERC-721, and ERC-1155 token standards, automatically handling batch transfers with per-recipient fees. This mechanism supports charity raffles, fundraising events, and cause-driven prize distributions.

HOW TO USE

1. Connect your wallet (EVM-compatible).

2. Paste the payout token address.

3. Enter winners (one per line, format: address,amount).

4. Enter charities (one per line, format: address,amount).

5. Select the token standard (ERC-20, ERC-721, or ERC-1155).

6. Review the sender contract address, fee per recipient, total fee, and owner.

7. Click "split payouts" and confirm the transaction in your wallet.

The tool automatically handles token approvals and calculates the total fee based on the number of recipients. After the transaction confirms, funds are distributed to both winners and charities—no centralized custody, no intermediaries. The shared sender contract handles the batch transfer, charging a fee per recipient that is shown before execution.

TECHNICAL MECHANISM: MULTI-FUNCTION FALLBACK WITH BULK DISTRIBUTION

Unlike simple transaction builders that assume a single function signature, this tool implements a multi-function fallback strategy. It first attempts splitPayout(), then falls back to executeCharitySplit() or submitRaffleSplit() if the primary method fails—automatically adapting to different contract implementations without requiring the user to know the exact function name. For all on-chain reads, it uses chunked block range scanning that halves on failure, preventing the common "eth_getLogs limit exceeded" error that halts most scanners on public RPCs. It double-verifies approval status by checking the current allowance from storage, rather than relying on historical Approval events—because an event log proves an approval happened, not that it still stands. Gas estimation uses receipt.effectiveGasPrice for accurate post-EIP-1559 cost accounting. The tool uses the shared BotGentz sender contract registry, looking up the correct contract address by chain ID and token standard (ERC-20/ERC-721/ERC-1155). It reads the fee live from the contract, calculates total fees per sender, and validates that the user's balance covers the total before sending. All batch operations are sequential with concurrency caps to avoid nonce conflicts.

WHAT IT CANNOT SEE

This tool cannot verify that the charity raffle contract is legitimate or has not been compromised. It cannot detect if the raffle has been manipulated. It cannot ensure that split will execute at the optimal gas price due to network conditions. It cannot guarantee that split will succeed if the contract is paused or frozen. It cannot verify that the contract has not been upgraded or modified. It cannot detect if the trade path is optimal or not front-run. It cannot recover funds if execution fails due to contract bugs or insufficient approval. It cannot verify that the split percentages are correct or not. It cannot predict market movements, price gaps, or flash crashes. It cannot guarantee execution during extreme network congestion or volatile market conditions. It cannot detect if the underlying system has been compromised. It cannot prevent the user from canceling or modifying split parameters. It cannot ensure that the split will be processed. It cannot protect against loss if split is rejected. It cannot verify that charity addresses are valid. It cannot guarantee that charities will receive funds. It cannot ensure that winners will be paid correctly. It cannot verify that the split ratio will be honored.

PLEASE NOTE

This tool operates only on EVM-compatible chains (Ethereum, Polygon, Arbitrum, Optimism, etc.). It is non-custodial—you retain full control of your funds at all times. Always verify token addresses, winner lists, and charity lists before executing. Payout distribution is irreversible—once sent, transfers cannot be recalled. The sender contract charges a fee per recipient, which is shown before execution. Charity split ratios are not verified by this tool—ensure you trust the configuration. The tool is provided as-is; use at your own risk.