https://github.com/mollybeach/hedgepod

🦔🫛 HedgePod is a ⚛️ 🏆 ETHGlobal Buenos Aires 🇦🇷 Prize Pool Winner 🌎 World Mini App that solves crypto's biggest UX problem: chain fragmentation. Autonomous cross-chain DeFi that makes 23M World App users their own hedge fund. Deposit once. AI agents automatically rebalance across 8+ chains for optimal yield. Gasless. Built for non-crypto use
https://github.com/mollybeach/hedgepod
1inch autonomous-agent cdp cross-chain defi layerzero oft omnichain privy pyth-network rebalancing uniswap-v4 world-mini-app yield-aggregator
Last synced: 14 days ago
JSON representation
Host: GitHub
URL: https://github.com/mollybeach/hedgepod
Owner: mollybeach
License: mit
Created: 2025-11-22T00:40:08.000Z (7 months ago)
Default Branch: master
Last Pushed: 2025-11-30T04:29:56.000Z (7 months ago)
Last Synced: 2025-12-02T09:31:29.411Z (7 months ago)
Topics: 1inch, autonomous-agent, cdp, cross-chain, defi, layerzero, oft, omnichain, privy, pyth-network, rebalancing, uniswap-v4, world-mini-app, yield-aggregator
Language: TypeScript
Homepage: https://hedgepod.app
Size: 45.3 MB
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

          




# 🦔🫛 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.

[![Live Demo](https://img.shields.io/badge/demo-live-green)](https://hedgepod.app)

[![Video Demo](https://img.shields.io/badge/▶️_Demo_Video-Watch-red)](https://youtu.be/lSkDzICg0vg)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Discord](https://img.shields.io/badge/Discord-Join-7289da)](https://discord.com/invite/5C7yYrsR)

[![Twitter](https://img.shields.io/badge/Twitter-Follow-1DA1F2)](https://x.com/hedgepod)

[![Telegram](https://img.shields.io/badge/Telegram-Join-26A5E4)](https://t.me/hedgepod)



## 🌐 Links

- 🚀 **Live Demo**: [hedgepod.app](https://hedgepod.app)

- 🎬 **Demo Video**: [Watch on YouTube](https://youtu.be/lSkDzICg0vg)

- 💬 **Discord**: [Join our community](https://discord.com/invite/5C7yYrsR)

- 📱 **Telegram**: [t.me/hedgepod](https://t.me/hedgepod)

- 🐦 **Twitter/X**: [@hedgepod](https://x.com/hedgepod)

- 📸 **Instagram**: [@hedgepod_app](https://www.instagram.com/hedgepod_app/)

- 💻 **GitHub**: [mollybeach/hedgepod](https://github.com/mollybeach/hedgepod)

## 📚 Table of Contents

- [What Is HedgePod?](#-what-is-hedgepod-agent)

- [Key Integrations](#-key-integrations)

- [Architecture](#️-architecture)

- [Multi-Language Support](#-multi-language-support) 🌍 **19 languages**

- [Quick Start](#-quick-start)

  - [Prerequisites](#prerequisites)

  - [Installation](#installation)

  - [Environment Setup](#environment-setup) ⚡ **Start here!**

  - [Deploy Contracts](#deploy-contracts)

  - [Run Frontend](#run-frontend)

- [Tech Stack](#-tech-stack)

- [Documentation](#-documentation)

- [Contact](#-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](https://github.com/pyth-network/pyth-examples/pull/82)**

- **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

```bash

node >= 18.0.0

npm >= 9.0.0

```

### Installation

```bash

# Clone the repository

git clone https://github.com/mollybeach/hedgepod.git

cd hedgepod

# Install dependencies

npm install

```

### Environment Setup

**REQUIRED** - Create your `.env` file:

```bash

# Copy the example file

cp .env.example .env

```

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

```bash

# 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:

```bash

# 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

```bash

# Compile contracts

npx hardhat compile

# Run test suite

npx hardhat test

# Check coverage

npx hardhat coverage

```

### Deploy Contracts

**Before deploying**, make sure:

1. ✅ You've created your `.env` file (see Environment Setup above)

2. ✅ You have testnet funds in your deployer wallet

3. ✅ You've compiled contracts: `npx hardhat compile`

```bash

# 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:

```bash

# Verify on BaseScan

make verify-base-sepolia

```

📚 **Detailed deployment guide**: `docs/DEPLOYMENT_QUICKSTART.md`

### Run Frontend

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

```bash

# 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](./docs/DATABASE_SETUP.md) for Supabase configuration (5 min setup)

Then start the development server:

```bash

# 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

```bash

# 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:

```bash

# Deploy to Base Sepolia (recommended first)

make deploy-base-sepolia

# Deploy to all testnets

make deploy-all

```

See **[deployments/](./deployments/)** for full deployment history, ABIs, and verification commands.

📚 **Deployment guide**: [docs/DEPLOYMENT_QUICKSTART.md](./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](docs/PARTNER_PRIZE_SUBMISSION.md)** | 🏆 Completed form for LayerZero, World, CDP prizes |

| **[Submission Guide](docs/SUBMISSION.md)** | ETHGlobal submission checklist |

| **[Environment Setup](docs/ENV_TEMPLATE.md)** | Complete guide for all environment variables |

| **[Database Setup](docs/DATABASE_SETUP.md)** | Supabase integration for agent tracking (5 min setup) |

| **[Localisations](docs/LOCALISATIONS.md)** | App content in all 19 languages for World submission |

| **[Deployment Quickstart](docs/DEPLOYMENT_QUICKSTART.md)** | Step-by-step deployment instructions |

| **[Full Deployment Guide](docs/DEPLOYMENT.md)** | Advanced deployment documentation |

| **[Scripts Documentation](scripts/README.md)** | All deployment and utility scripts |

| **[Config Documentation](config/README.md)** | 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](https://hedgepod.app)

- 📧 **Email**: [mollybeach@hedgepod.app](mailto:mollybeach@hedgepod.app)

- 💻 **GitHub**: [mollybeach/hedgepod](https://github.com/mollybeach/hedgepod)

- 💬 **Discord**: [Join our community](https://discord.com/invite/5C7yYrsR)

- 📱 **Telegram**: [t.me/hedgepod](https://t.me/hedgepod)

- 🐦 **Twitter/X**: [@hedgepod](https://x.com/hedgepod)

- 📸 **Instagram**: [@hedgepod_app](https://www.instagram.com/hedgepod_app/)

---

## 📄 License

MIT License - see [LICENSE](./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!**
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/mollybeach/hedgepod

Awesome Lists containing this project

README
