B
BulkSend.xyz

v1.0.0-beta

Developer & User Portal

BulkSend.xyz Documentation

Everything you need to integrate, deploy, and batch send native gas tokens and ERC-20 tokens across EVM chains with up to 40% gas savings.

1. System Overview

BulkSend is a non-custodial batch transfer protocol. It replaces individual wallet transfer operations with optimized smart contract executions. By packing multiple recipient transfers into a single transaction loop, users reduce blockchain overhead and save up to 40% in gas fees.

Batch Capacity

Up to 500 / tx

Gas Optimization

~30-40% Saved

Security Model

SIWE + Non-Custodial

2. Quickstart Guide

  1. Connect Wallet: Click the RainbowKit button in the top bar to connect MetaMask, Rabby, Coinbase, or WalletConnect.
  2. Authenticate (SIWE): Sign the standard SIWE cryptographic prompt to authenticate your session.
  3. Prepare Data: Upload a CSV file or paste addresses and amounts in the manual entry box.
  4. Review & Validate: Inspect duplicate checks, gas estimations, and address formatting.
  5. Execute Batch: Confirm the contract transaction in your wallet.

3. CSV & File Preparation Format

The BulkSend parser accepts CSV, TSV, or plain text formats. Headers are automatically recognized and ignored.

Sample Valid Format

0x71C7656EC7ab88b098defB751B7401B5f6d8976F, 1.5

0x2546BcD3c84621e9027B2528E66676074a60134a, 2.4

0x90F8bf6A479f320ead074411a4B0e7944Ecf8690, 0.75

4. Smart Contracts & Verification

BulkSend contracts expose disperseEther and disperseToken functions.

NetworkChain IDDeployed Contract Address
Ethereum Mainnet10xD152f549545093347A162Dce210e7293f1452150
Base84530xD152f549545093347A162Dce210e7293f1452150
Arbitrum One421610xD152f549545093347A162Dce210e7293f1452150
Optimism100xD152f549545093347A162Dce210e7293f1452150
Polygon1370xD152f549545093347A162Dce210e7293f1452150
BNB Chain560xD152f549545093347A162Dce210e7293f1452150

5. Supported Blockchain Networks

BulkSend supports all EVM-compatible chains out of the box including Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, and custom EVM RPC networks.

6. SIWE (Sign-In with Ethereum) Integration

Authentication uses the EIP-4361 standard powered by viem/siwe and jose for JWT minting.

7. REST API Endpoints

GET /api/auth/nonce — Generates SIWE session nonce cookie
POST /api/auth/verify — Validates signature and returns JWT
POST /api/transaction/log — Logs dispersal to global ledger

8. Developer FAQ

Are contracts non-custodial?

Yes, BulkSend contracts never hold user funds. Tokens flow directly from the sender wallet to recipient addresses within the same transaction execution.

Is there a maximum number of recipients?

While the UI limits to 500 per batch for gas safety, the contract can process as many recipients as block gas limits allow.