Automation/Starter gas for new members
Starter gas for new members
A one-time, automatic ETH drip so a brand-new wallet never has to find an external faucet first.
Why this exists#
Almost everything on Cadence is gas-sponsored — except the one-time USDC approval a new circle needs (see the one exception). Rather than sending every new member out to an external faucet before they can do anything, Cadence sends a small amount of Base Sepolia ETH automatically, the first time a wallet connects.
How it works#
On first connect, the app calls /api/gas-drip with the wallet address. That route:
- Reserves the address in Postgres — atomically, so it can never be considered twice, no matter how many times it's called across future logins.
- Checks the wallet's current ETH balance; if it's already funded, the reservation is kept but nothing is sent.
- Otherwise triggers the New Member Gas Drip workflow, which sends a fixed 0.0005 ETH — the amount is hardcoded in the workflow itself, never taken from the request, so a bug in the calling route could never turn this into an arbitrary-amount drain.
Why there's no wallet signature#
Every other write in Cadence requires a signed message proving wallet control. This one deliberately doesn't — requiring a signature would pop an unrequested wallet prompt the instant a brand-new visitor lands on the app, and a signature wouldn't actually stop abuse anyway (anyone can sign for a throwaway address they just generated). Since this only ever moves a tiny, fixed, one-shot amount of worthless testnet ETH, the protection is entirely server-side instead: one reservation per address, forever.