🦔🫛 HedgePod Agent

Build your own AI-powered hedge fund

Autonomous cross-chain DeFi that makes 23M World App users their own hedge fund.

TL;DR: Deposit once. AI agents automatically rebalance across 8+ chains for optimal yield. Gasless. Chain-abstracted. Human-readable. Built for non-crypto users.

🌐 Links

🚀 Live Demo: hedgepod.app
🎬 Demo Video: Watch on YouTube
💬 Discord: Join our community
📱 Telegram: t.me/hedgepod
🐦 Twitter/X: @hedgepod
📸 Instagram: @hedgepod_app
💻 GitHub: mollybeach/hedgepod

📚 Table of Contents

What Is HedgePod?
Key Integrations
Architecture
Multi-Language Support 🌍 19 languages
Quick Start
- Prerequisites
- Installation
- Environment Setup ⚡ Start here!
- Deploy Contracts
- Run Frontend
Tech Stack
Documentation
Contact

🎯 What Is HedgePod Agent?

HedgePod Agent is a World mini app that solves crypto's biggest UX problem: chain fragmentation.

Users deposit USDC/ETH/USDT once, and autonomous AI agents:

Monitor yields across 8+ chains in real-time using Pyth Network price feeds and APR calculations
Move funds via LayerZero omnichain fungible tokens (OFTs) with custom APR-aware routing logic
Execute optimal swaps through 1inch aggregation across 50+ DEXs when profitable
Trade on Uniswap v4 with dynamic fee hooks that adjust (0.1%-0.3%) based on real-time Pyth volatility data
Access real pool data from The Graph's Uniswap v3 subgraphs for liquidity and volume information
Ensure fair rewards using Pyth Entropy for verifiable randomness in agent selection
Operate 24/7 autonomously powered by Coinbase CDP server wallets with x402 authorization
All gasless (Privy sponsorship), all transparent (ENS names), all automated

Built for the 23M World App users who don't know what an RPC is—and never should.

✨ HedgePod's consumer-grade UI with Animal Crossing-inspired design

💡 What Makes HedgePod Unique?

Real-Time Data: All prices, volatility, liquidity, and volume from live APIs (Pyth, The Graph, 1inch)—no mock data
True Cross-Chain: LayerZero OFT extended with custom logic—only moves funds if APR improvement justifies gas
Dynamic Pricing: Uniswap v4 hook adjusts swap fees automatically based on market volatility to protect liquidity providers
Autonomous Agents: Coinbase CDP server wallets execute rebalances 24/7 without user approval (via x402 authorization)
Consumer UX: Animal Crossing-themed UI, ENS names everywhere, gasless transactions, World ID verification
Multi-Language: Available in 19 languages to serve World App's global 23M user base

🔗 Key Integrations

Cross-Chain Infrastructure

LayerZero V2 - Extended OFT contracts with custom APR-aware routing logic. Only transfers funds cross-chain if yield improvement exceeds threshold. Deployed across 8 chains with automated peer configuration.

DeFi & Swaps

Uniswap v4 - Dynamic fee hooks (VolatilityFeeHook.sol) that adjust swap fees (0.1%-0.3%) based on real-time Pyth volatility. Protects LPs from impermanent loss during high volatility.
1inch Aggregation Protocol - Swap, Quote, Price, and Liquidity Source APIs for optimal routing across 50+ DEXs. Used by agents for best execution and portfolio valuation.

Real-Time Data & Oracles

Pyth Network - Pull-based price feeds via Hermes API for ETH/USD, BTC/USD, USDC/USD. Volatility calculations from confidence intervals power dynamic fees.
Pyth Entropy - Verifiable randomness for fair agent selection and weekly lottery rewards. MEV protection through random rebalancing order. PR Submitted
The Graph - GraphQL queries to Uniswap v3 subgraphs across 5 chains. Real liquidity ($245.8M+ TVL) and 24h volume data—no mocks.

UX & Identity

World (MiniKit) - Full SDK integration for 23M user distribution. MiniKitProvider, wallet auth, SIWE, transactions via sendTransactionViaMiniKit().
World ID (IDKit) - Orb-level verification for sybil resistance on agent deployment. Zero-knowledge proofs verify humanity without revealing identity.
ENS - Human-readable addresses everywhere (jane.eth not 0x...). No crypto jargon visible to end users.
Privy - Gas sponsorship for gasless transactions. Users never pay fees, maximizing accessibility.

Autonomous Operations

Coinbase CDP - Server wallets for 24/7 agent autonomy. x402 authorization pattern allows recurring rebalances without user approval.
Supabase - PostgreSQL database for agent performance tracking, rebalance history, and portfolio analytics.

Development & Testing

Hardhat 3 - Smart contract development, testing (94% coverage), and multi-chain deployment automation.

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│ WORLD MINI APP (Next.js + MiniKit SDK)                      │
│  • Privy gas sponsorship (gasless UX)                       │
│  • ENS resolution (jane.eth not 0x...)                      │
│  • Octav widget (portfolio dashboard)                       │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ├──> Deposit USDC/ETH/USDT (any chain)
                      │
┌─────────────────────▼───────────────────────────────────────┐
│ HedgePod VAULT (Smart Contracts)                            │
│  • Deployed on: World Chain, Base, Celo, Zircuit, Polygon  │
│  • Issues AutoYield Tokens (LayerZero OFT)                  │
│  • Grants x402 authorization to agent wallet                │
│  • Integrated with Uniswap v4 pools (custom hook)           │
└─────────────────────┬───────────────────────────────────────┘
                      │
                      ├──> Agent monitors & rebalances 24/7
                      │
┌─────────────────────▼───────────────────────────────────────┐
│ YIELD AGENT (CDP Server Wallet)                             │
│  • Autonomous wallet with x402 authorization                │
│  • Monitors: Pyth APRs, 1inch liquidity                     │
│  • Rebalances via: LayerZero OFT, 1inch Fusion+, Uniswap v4 │
│  • Redundancy: Chainlink CCIP for critical ops              │
└─────────────────────────────────────────────────────────────┘

📊 Real-time portfolio tracking across 8+ chains with autonomous agents

🌍 Multi-Language Support

HedgePod is available in 19 languages to serve users worldwide (all World Coin supported languages):

Language	Code	Status
🇬🇧 English	`en`	✅ Complete
🇨🇳 中文 (简体) (Chinese Simplified)	`zh`	✅ Complete
🇪🇸 Español (Spanish)	`es`	✅ Complete
🇸🇦 العربية (Arabic)	`ar`	✅ Complete
🇧🇷 Português (Portuguese)	`pt`	✅ Complete
🇮🇩 Bahasa Indonesia (Indonesian)	`id`	✅ Complete
🇫🇷 Français (French)	`fr`	✅ Complete
🇯🇵 日本語 (Japanese)	`ja`	✅ Complete
🇷🇺 Русский (Russian)	`ru`	✅ Complete
🇩🇪 Deutsch (German)	`de`	✅ Complete
🇮🇳 हिन्दी (Hindi)	`hi`	✅ Complete
🇰🇷 한국어 (Korean)	`ko`	✅ Complete
🇵🇱 Polski (Polish)	`pl`	✅ Complete
🇪🇸 Català (Catalan)	`ca`	✅ Complete
🇲🇾 Bahasa Melayu (Malay)	`ms`	✅ Complete
🇹🇭 ไทย (Thai)	`th`	✅ Complete
🇹🇼 中文 (繁體) (Chinese Traditional - Taiwan)	`zh-TW`	✅ Complete
🇳🇱 Nederlands (Dutch)	`nl`	✅ Complete
🇲🇽 Español (América Latina) (Spanish - Latin America)	`es-419`	✅ Complete

Language auto-detection: The app automatically detects your browser's preferred language and displays content accordingly.

Manual switching: Use the language selector in the header to switch between languages at any time.

Access any language directly:

English: https://hedgepod.app/en
Spanish: https://hedgepod.app/es
Chinese: https://hedgepod.app/zh
And so on...

🚀 Quick Start

Prerequisites

node >= 18.0.0
npm >= 9.0.0

Installation

# Clone the repository
git clone https://github.com/mollybeach/hedgepod.git
cd hedgepod

# Install dependencies
npm install

Environment Setup

REQUIRED - Create your .env file:

# Copy the example file
cp .env.example .env

Then edit .env with your actual values. Minimum required for deployment:

# 1. Your deployer wallet private key (from MetaMask)
DEPLOYER_PRIVATE_KEY=your_private_key_here

# 2. Alchemy RPC for Base Sepolia (get free at https://www.alchemy.com/)
BASE_SEPOLIA_RPC=https://base-sepolia.g.alchemy.com/v2/YOUR_ALCHEMY_API_KEY

# 3. WalletConnect for frontend (get free at https://cloud.walletconnect.com/)
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id_here

Optional but recommended for full functionality:

# Block explorer verification
BASESCAN_API_KEY=your_basescan_api_key_here

# Additional networks
POLYGON_AMOY_RPC=https://rpc-amoy.polygon.technology
CELO_ALFAJORES_RPC=https://alfajores-forno.celo-testnet.org

🔑 Getting API Keys

Service	URL	Purpose	Cost
Alchemy	https://www.alchemy.com/	RPC endpoints for all chains	Free tier
WalletConnect	https://cloud.walletconnect.com/	Frontend wallet connection	Free
BaseScan	https://basescan.org/apis	Contract verification	Free
MetaMask	Your wallet → Account Details → Export Private Key	Deployer wallet	Free

🪙 Getting Testnet Funds

You'll need testnet ETH before deploying:

Network	Faucet	Amount Needed
Base Sepolia	https://www.alchemy.com/faucets/base-sepolia	~0.05 ETH
Polygon Amoy	https://faucet.polygon.technology/	~0.1 MATIC
Celo Alfajores	https://faucet.celo.org/alfajores	~0.5 CELO
Multi-chain	https://faucet.quicknode.com/	Various

⚠️ Security Notes

Never commit your .env file (already in .gitignore)
Use a separate deployer wallet, not your main wallet
Only fund what you need for deployment
See docs/ENV_TEMPLATE.md for complete documentation

Run Tests

# Compile contracts
npx hardhat compile

# Run test suite
npx hardhat test

# Check coverage
npx hardhat coverage

Deploy Contracts

Before deploying, make sure:

✅ You've created your .env file (see Environment Setup above)
✅ You have testnet funds in your deployer wallet
✅ You've compiled contracts: npx hardhat compile

# Deploy to Base Sepolia (recommended first deployment)
npx hardhat run scripts/deploy/deployer.ts --network baseSepolia

# Or use Makefile shortcuts
make deploy-base-sepolia

# Deploy to all testnets
make deploy-all

After deployment, verify your contracts:

# Verify on BaseScan
make verify-base-sepolia

📚 Detailed deployment guide: docs/DEPLOYMENT_QUICKSTART.md

Run Frontend

Before starting the frontend, create frontend/.env.local:

# frontend/.env.local
NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=your_walletconnect_project_id_here

# Supabase (for agent performance tracking - optional for local dev)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here

📚 Database setup: See docs/DATABASE_SETUP.md for Supabase configuration (5 min setup)

Then start the development server:

# Install frontend dependencies (first time only)
cd frontend
npm install

# Start development server
npm run dev
# Open http://localhost:3000/en (or your locale)

Your frontend will automatically connect to deployed contracts using data from:

frontend/lib/data/contracts_data.json (auto-generated on deployment)

🎨 Frontend features:

🦔 Animal Crossing-themed UI
💰 RainbowKit wallet connection (100+ wallets)
🌐 Multi-chain support (World, Base, Celo, Polygon, etc.)
⚡ Responsive design for mobile and desktop

Run Agent

# Start yield monitoring agent
cd backend
npm run agent:start

📍 Deployment Addresses

Local Development (Hardhat)

Contract	Address
YieldOracle	`0x5FbDB2315678afecb367f032d93F642f64180aa3`
AutoYieldToken	`0xe7f1725E7734CE288F8367e1Bb143E90bb3F0512`
HedgePodVault	`0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9`
VolatilityFeeHook	`0x0165878A594ca255338adfa4d48449f69242Eb8F`

Testnet Deployments

Status: 🚧 Ready for deployment to Base Sepolia, Polygon Amoy, Celo Alfajores

To deploy to testnets:

# Deploy to Base Sepolia (recommended first)
make deploy-base-sepolia

# Deploy to all testnets
make deploy-all

See deployments/ for full deployment history, ABIs, and verification commands.

📚 Deployment guide: docs/DEPLOYMENT_QUICKSTART.md

🧪 Tech Stack

Smart Contracts: Solidity 0.8.24, Hardhat 3, OpenZeppelin, LayerZero OFT, Uniswap v4

Frontend: Next.js 14, TypeScript, TailwindCSS, World MiniKit, Privy SDK, wagmi, RainbowKit, next-intl (i18n)

Backend: Node.js, TypeScript, Coinbase CDP SDK, Pyth Hermes API, 1inch API, Supabase (PostgreSQL)

Oracle & Data:

Pyth Network - Real-time price feeds & volatility for dynamic fees
The Graph - Uniswap v3 liquidity & volume data via GraphQL subgraphs

Infrastructure: Alchemy, Vercel, Railway, Supabase

Integrations: LayerZero, Pyth Network, The Graph, 1inch, Uniswap v4, World, Coinbase CDP, Privy, ENS, Chainlink, Zircuit, Octav

Languages: 10 languages supported (English, Chinese, Spanish, Arabic, Portuguese, Indonesian, French, Japanese, Russian, German)

📚 Documentation

Comprehensive guides and documentation:

Document	Description
Partner Prize Submission	🏆 Completed form for LayerZero, World, CDP prizes
Submission Guide	ETHGlobal submission checklist
Environment Setup	Complete guide for all environment variables
Database Setup	Supabase integration for agent tracking (5 min setup)
Localisations	App content in all 19 languages for World submission
Deployment Quickstart	Step-by-step deployment instructions
Full Deployment Guide	Advanced deployment documentation
Scripts Documentation	All deployment and utility scripts
Config Documentation	Network and price feed configurations

Key Directories

hedgepod/
├── contracts/          # Solidity smart contracts
│   ├── HedgePodVault.sol
│   ├── AutoYieldToken.sol
│   ├── YieldOracle.sol
│   └── VolatilityFeeHook.sol
├── frontend/           # Next.js frontend application
│   ├── app/           # Pages and routes
│   ├── components/    # Reusable UI components
│   └── lib/           # Utilities and contract data
├── backend/           # Agent backend (Node.js)
├── scripts/           # Deployment and utility scripts
│   ├── deploy/        # Deployment scripts
│   └── verify/        # Contract verification
├── config/            # Network and price configurations
├── deployments/       # Deployed contract addresses & ABIs
└── docs/             # Documentation

📞 Contact & Community

🚀 Live Demo: hedgepod.app
📧 Email: mollybeach@hedgepod.app
💻 GitHub: mollybeach/hedgepod
💬 Discord: Join our community
📱 Telegram: t.me/hedgepod
🐦 Twitter/X: @hedgepod
📸 Instagram: @hedgepod_app

📄 License

MIT License - see LICENSE for details

🙏 Acknowledgments

Built for ETHGlobal Buenos Aires 2025 with:

LayerZero for omnichain infrastructure
World for 23M user distribution
Coinbase CDP for autonomous agents
And many other amazing sponsors!

🦔 Making DeFi accessible for everyone!

Name		Name	Last commit message	Last commit date
Latest commit History 233 Commits
agent		agent
backend		backend
config		config
contracts		contracts
deployments		deployments
docs		docs
frontend		frontend
scripts		scripts
test		test
.env.example		.env.example
.gitignore		.gitignore
.prettierrc		.prettierrc
DEMO_SETUP.md		DEMO_SETUP.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
START_DEMO.md		START_DEMO.md
hardhat.config.ts		hardhat.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation