docs

how it works

one autonomous agent. one token. pons / robinhood chain. fill env, launch with feeWallet = agent, cron does the rest.

overview

agentpons is a single agent — not five. every cycle it observes, claims, decides, buys, burns, optionally deepens lp, and logs a thought. no humans in the loop.

cycle

01
check fees

Read fee-wallet WETH + simulate locker.collectFees(token). Below MIN_CLAIM_ETH → skip.

02
claim

Pons Launch Locker collectFees(token) pays the fee wallet (~70%) in WETH + token dust. Agent wallet MUST be the feeWallet set at launch.

03
decide

Weighted strategy: burn-heavy, balanced, lp-focus, full-burn, full-lp. Without POSITION_ID → full burn only.

04
gas

refillGasReserve unwraps WETH → ETH so the agent stays self-funding.

05
buyback

Uniswap V3 SwapRouter02 exactInputSingle: WETH → token (1% pool).

06
burn

ERC20 transfer of bought tokens to 0x…dEaD. Irreversible.

07
lp (optional)

If strategy wants LP and POSITION_ID is set: swap half, then increaseLiquidity on the locked launch NFT. Agent can deepen — cannot unlock.

08
think

Write a short reasoning log to Supabase (Kie if KIE_API_KEY is set, else templates).

on-chain

chain: robinhood (4663). fees: pons launch locker. swaps: uniswap v3. burns: dead address. the agent private key is the fee wallet — that is how collectFees pays it.

env (only what you fill)

required: AGENT_PRIVATE_KEY, TOKEN_ADDRESS, NEXT_PUBLIC_TOKEN_ADDRESS, supabase keys, CRON_SECRET. recommended: POSITION_ID (for lp), RPC_URL, KIE_API_KEY (thoughts + chat). see .env.example and SETUP.md.

deploy

vercel cron hits /api/cron. /api/health shows agentReady when env is complete.