< RETURN_TO_BASE
HACKMONEY_2026 // CLASSIFIED

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.

šŸŽÆ
Alpha Hunter
Seeks yield opportunities, estimates APY
šŸ›”ļø
Risk Sentinel
Identifies risks, VETO power enabled
šŸ”®
Macro Oracle
Provides market context & sentiment
😈
Devil's Advocate
Challenges assumptions, stress testing
Implementation Sources
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.
Implementation Sources
apps/web/lib/yellow/channel.tsxSessionProvider.tsx

šŸ¦„ Uniswap v4 Integration $10k Track

Agent proposals execute real swaps and LP operations on Uniswap v4.

SWAPS
V4_SWAP command via Universal Router
LIQUIDITY
Concentrated positions via PositionManager
Chain: Base Sepolia (84532)
Pool Manager: 0x05E73354cFDd6745C338b50BcFDfA3Aa6fA03408
Implementation Sources
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
Implementation Sources
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   │
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜