Docs/Batch Settlement

Batch Settlement

Send USDC to up to 500 recipients in a single on-chain transaction. Flux batches all transfers into one contract call, charging a flat 0.1% platform fee on the total amount settled.

How it works

1

Add recipients

Upload a CSV with address and amount columns, or add wallets manually one by one.

2

Review summary

The right panel shows total recipients, total USDC, fee (0.1%), and the exact amount you need in your wallet.

3

Sign two transactions

First: approve USDC spending. Second: execute the batch. Your wallet shows both in sequence.

4

Confirmed on-chain

All payments land in the same block. View the transaction on ArcScan with a full token transfer breakdown.

CSV format

Your CSV must have exactly two columns: address and amount. Header names are case-insensitive.

recipients.csv

address,amount
0x89e6c2...7216F6,0.23
0x1934b9...aD49D6,0.10
0xA2b255...EC2a7a,0.15

Fee structure

Flux charges 0.1% of the total USDC settled per batch. The fee is deducted automatically from the total you approve — you only sign once for the full amount including the fee.

Example

Total USDC to send:  $7.20
Fee (0.1%):          $0.0072
Total you approve:   $7.2072

Limits

Up to 500 recipients per batch. Minimum amount per recipient: any positive value. There is no maximum per batch — the gas limit is set dynamically based on recipient count.

Gas limit formula

gasLimit = 80,000 + (recipients.length × 65,000)

History

The History tab loads all your past batch settlements live from the blockchain — no cache, no local storage. Every settled batch shows timestamp, recipient count, total USDC, fee, and a link to the ArcScan transaction. You can export your full history as a CSV.

Contract

Batch settlement is handled by FluxSettlement.batchSettle(). Full ABI and events are in the Reference page.

FluxSettlement on ArcScan ↗