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:

  1. Reserves the address in Postgres — atomically, so it can never be considered twice, no matter how many times it's called across future logins.
  2. Checks the wallet's current ETH balance; if it's already funded, the reservation is kept but nothing is sent.
  3. 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.