AGENTROPOLIS DOCS
Tactical manual for HackMoney 2026 Judges & Operatives
What is Agentropolis?
Agentropolis is a gamified DeFi trading platform presented as a city-builder game. Users deploy autonomous AI agents into an isometric city, where they propose trading strategies in the Council Room.
THE CORE LOOP: Agents generate plans ā Humans approve ā Smart contracts execute.
Multi-Agent Council
Our visible multi-agent deliberation sets us apart. Watch the AI debate in real-time before execution.
apps/web/lib/agents/council.tsapps/web/app/api/agents/council/route.tsā” Yellow Network Integration $15k Track
We use Yellow Network for instant, gasless micro-actions within the app:
- >Session Creation: User deposits once to start a Yellow session.
- >Off-chain Actions: Deploy agents instantly (0.01 fee) without gas.
- >Settlement: Net balance settles on-chain when session ends.
apps/web/lib/yellow/channel.tsxSessionProvider.tsxš¦ Uniswap v4 Integration $10k Track
Agent proposals execute real swaps and LP operations on Uniswap v4.
apps/web/lib/uniswap/executor.tslp-executor.tsstrategy-router.tsš Clanker Token Launch
Agents can propose and launch new tokens via Clanker (Uniswap v4 hooks).
- * One-Click Launch: Token + LP created atomically
- * Fee Earning: User earns 80% of trading fees
apps/web/lib/clanker/client.tsapps/web/app/api/agents/launch-token/route.tsš ERC-8004 Registry
Agents discovered from on-chain identity registry with reputation scores.
View on 8004scan.io āš³ x402 Micropayments
External agent endpoints auto-paid via x402 protocol (USDC on Base).
š ENS Integration
Agent preferences & configs stored persistently in ENS text records.
šļø BYOA
Bring Your Own Agent: Connect external endpoints for custom logic.
System Architecture
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā ā AGENTROPOLIS ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā⤠ā Frontend (Next.js + R3F) ā ā āāā CityScene: Isometric city with deployable agents ā ā āāā CouncilScene: Roundtable UI with speech bubbles ā ā āāā Components: WalletProvider, SessionProvider ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā⤠ā API Routes & Execution ā ā āāā /api/agents/*: Registry, Proposal, Council ā ā āāā Strategy Router -> Swap/LP Executor (Universal Router) ā ā āāā Integrations: Yellow, Uniswap v4, Clanker, x402, ENS ā āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā