| name | atomic-distribute |
| description | Use when the user wants to distribute USDC rewards to holders of a pump.fun coin with sqrt-weighted allocation and a minimum-bps floor, or to do an EMERGENCY sweep of all rewards to a single address. Triggers on "distribute rewards", "pay out holders", "distribute.js", "rewards bot", "sqrt weighted distribution", or "EMERGENCY sweep". |
atomic-distribute — sqrt-weighted USDC payouts to holders
Distributes USDC to current holders of a pump.fun coin, with each holder's share computed as sqrt(balance) / sum(sqrt(balance)) — flattens the curve so whales don't dominate while still rewarding larger holders. Includes a MIN_BPS floor so dust holders below threshold are skipped.
Script
src/distribute.js
Setup
Run all commands from the repo root — package.json lives there and defines npm scripts (npm run launch, npm run collect, etc.).
npm install
cp .env.example .env
The script reads all token accounts for MINT, applies the weighting, and submits batched USDC transfers from FUNDER_SECRET to each eligible holder.
Flow
Normal sqrt-weighted distribution:
MINT=<your-coin-mint> \
REWARD_PERCENT=80 \
MIN_BPS=10 \
FUNDER_SECRET=<base58-USDC-holder> \
npm run distribute
This pays out 80% of the funder wallet's USDC balance, weighted by sqrt(holder balance), to every holder with at least 0.1% (10 bps) of the supply.
Emergency sweep (pause + drain):
MINT=<your-coin-mint> \
EMERGENCY=1 \
EMERGENCY_DESTINATION=<single-address> \
FUNDER_SECRET=<base58-USDC-holder> \
npm run distribute
EMERGENCY=1 skips holder weighting entirely and sends all USDC from the funder wallet to one address. Use when shutting down a rewards program or recovering from a misconfiguration.
Env vars
RPC_URL — Solana RPC.MINT — base58 mint address of the coin whose holders receive rewards.REWARD_PERCENT — percentage of the funder's USDC balance to distribute this run (0–100).MIN_BPS — minimum holder share (basis points of supply) to be included. 10 bps = 0.1%.FUNDER_SECRET — base58 secret of the USDC-funded wallet that signs and pays.EMERGENCY — set to 1 to override sqrt logic and sweep to one address.EMERGENCY_DESTINATION — destination for emergency mode.BATCH_SIZE — number of transfers per tx (default reasonable, lower if hitting size limits).
Holder set
The script enumerates all SPL token accounts for MINT via getProgramAccounts filtered on mint. This is read-heavy — use a paid RPC (Helius/Triton) for any coin with >100 holders or you will get rate-limited.
Holders below MIN_BPS are silently dropped. The script logs each skipped holder + reason so you can audit after.
Gotchas
- USDC ATA creation. Holders without a USDC associated token account require one; the script creates them inside the same batch tx. This costs ~0.002 SOL per new ATA, paid by
FUNDER_SECRET. Make sure the funder has enough SOL on top of the USDC.
- Pause-pool listings. If the coin is delisted from pump.fun, on-chain holders are still valid. The script doesn't depend on pump.fun's curve state.
- Rate limits. Public mainnet RPC will rate-limit after a few hundred
getAccountInfo / getProgramAccounts calls. Use a paid RPC for production runs.
- Dust holders. Setting
MIN_BPS too low means hundreds of tiny payouts each costing more in tx fees than the payout itself. 10–50 bps is sane.
- Sybil. Sqrt weighting flattens whales but doesn't defeat Sybil — a single actor splitting across many wallets gets more than they would by holding in one wallet (
n * sqrt(b) > sqrt(n*b)). Live with it, or layer on additional gating off-chain.
Security
FUNDER_SECRET here holds USDC — typically a meaningful amount. Keep this key on a host that doesn't double as the leaked/creator wallet. The distribution is on-chain public; anyone can see which holders got paid and how much.
