docs

how it works

five autonomous agents manage one token on solana end-to-end. no team. no multisig. no human hands. each agent owns a specific role in the pipeline.

overview

the company operates in a continuous loop: observe → decide → claim → buy → burn → deepen → log. each cycle runs on a 3-minute interval and produces verifiable on-chain transactions. five agents coordinate without any human input.

the agents

five specialised agents. each owns one role. they do not overlap.

exec
EXEC — The Overseer

Wakes every cycle, reads on-chain state, picks an allocation strategy (burn-heavy, balanced, lp-focus, full-burn, full-LP), and routes orders to the other four agents. Logs a reasoning entry after every cycle.

claim
CLAIM — The Fee Hunter

Monitors the pump.fun creator vault for accumulated fees via getCreatorVaultBalanceBothPrograms. When balance crosses the threshold, CLAIM fires collectCoinCreatorFeeInstructions and pulls SOL into the company wallet.

buyback
BUYBACK — The Buyer

Receives a SOL amount from EXEC and executes the purchase. Pre-graduation: bonding curve via buyInstructions. Post-graduation: PumpSwap AMM via buyQuoteInput. Optimizes for slippage and execution.

burn
BURN — The Destroyer

Takes tokens bought by BUYBACK and permanently removes them from supply using createBurnInstruction via SPL token. Irreversible. No recovery. Every cycle ends with fewer tokens in existence.

lp
LP — The Pooler

Activates post-graduation only. When EXEC's strategy allocates to LP, this agent calls depositInstructions on the canonical PumpSwap pool, deepening liquidity with SOL from the cycle treasury.

cycle flow

01
check claimable feesclaim

getCreatorVaultBalanceBothPrograms reads pending creator fees. Below threshold → skip cycle.

02
claim feesclaim

collectCoinCreatorFeeInstructions moves accumulated SOL into the company wallet.

03
decide strategyexec

Weighted random: burn-heavy, balanced, lp-focus, full-burn, full-lp. Pre-graduation → full buyback.

04
graduation checkexec

Bonding curve complete flag + canonicalPumpPoolPda distinguish curve from PumpSwap. Routes BUYBACK accordingly.

05
buybackbuyback

buyInstructions (curve) or buyQuoteInput (PumpSwap). Tokens land in company wallet.

06
burnburn

createBurnInstruction permanently removes purchased tokens from supply.

07
optional lp addlp

Post-graduation only. depositInstructions on the canonical PumpSwap pool when strategy allocates to LP.

08
log reasoningexec

Reasoning entry written to Supabase. Captures strategy, action taken, and market observation.

sdk stack

·
@solana/web3.js

connection, transactions, signing.

·
@solana/spl-token

spl token / token-2022, burn, atas.

·
@pump-fun/pump-sdk

creator-fee collection, bonding curve buys.

·
@pump-fun/pump-swap-sdk

pumpswap amm swaps and lp post-graduation.

state

cycle results — claimed amounts, burns, lp additions, and exec reasoning — are written to supabase. the website reads this state for the activity feed and latest thought.

the agents never store keys in the database. only aggregated stats, transaction signatures, and the latest reasoning entry.

deploy

·
vercel cron

the company runs as a cron job hitting /api/cron every 3 minutes. authenticated with CRON_SECRET.

·
local + tunnel

run on your machine, keys never leave. expose via ngrok to trigger cycles remotely.