🪴 PotBot v2

Group Treasury. AI execution. Money tree that grows.

POT = on-chain group treasury · BOT = AI execution through MCP · 🪴 = your wealth expanding.

PotBot is a Solana protocol for groups who prefer on-chain votes over chat-based arguments. It combines group governance, AI automation, creator monetization, and DeFi yield into a single primitive — the pot.

Built for Solana Frontier 2026 · @PotBot_sol · @CryptoYDao · Y-DAO Amsterdam

Links 🏠

🧑‍⚖️ For Judges — Try It in 60 Seconds

No wallet needed — potbot.fun shows a live flagship pot in read-only mode at the top of /vaults.

Lifecycle legend used everywhere on this repo and the site: 🟢 Live/verifiable · 🟡 Devnet · 🔵 Phase 2 Q3 2026 · 🟣 Phase 3 Q4 2026 · ⚪ Vision

Live now (devnet · Explorer-verifiable) 🟡

• pot_vault Anchor program on devnet with 30+ instructions: deposit, propose, vote, execute_swap via Jupiter v6 CPI, withdraw.
• Solana Blinks endpoints — /api/actions/<potPubkey>/{deposit,vote} — render as cards in Phantom / Backpack / X.
• MCP server @potbot/mcp@0.2.0 on npm — 18 tools, HTTP+SSE+stdio transports.
• Squads v4 multisig path for the creator role on high-value pots.
• Helius RPC + webhooks for realtime pot events.
• PWA manifest installable on iOS / Android.

Try it

# 1. Open the live DApp
open https://potbot.fun

# 2. Connect to MCP server (Claude / any AI agent)
npx @potbot/mcp

# 3. Clone and run locally
git clone https://github.com/YD811/potbot-v2.git
cd potbot-v2 && npm install
cd apps/web && npx next dev    # → http://localhost:3000

Test MCP with Claude

list_vaults → get_vault_analytics → create_swap_proposal → vote_on_proposal

Full roadmap with explicit status per feature

→ potbot.fun/roadmap — every Live, Devnet, Phase 2, Phase 3, and Vision item, with chips.

Quick Start

git clone https://github.com/YD811/potbot-v2.git
cd potbot-v2
npm install
cd apps/web && npx next dev   # → http://localhost:3000

For full setup (Anchor, devnet deploy, API server): see docs/operations/development.md

What is PotBot?

PotBot is infrastructure for group capital management on Solana — one primitive that works the same for a 3-friend investment club and a $100M family office.

Governance, AI execution, best-of-breed DEX routing and DeFi yield, all inside a single programmable vault. Think on-chain copy-trading meets tokenized ETF meets Money Tree — configurable from autocratic solo vault up to timelocked institutional-grade treasury.

For different users

What is a POT?

A POT is a shared on-chain vault on Solana, governed by its members. Every SOL and SPL token lives in a program-owned PDA from day one — no custodian, no bot-held keys, no multisig operator. Only the PotBot program can move the funds, and only after a successful on-chain vote.

• Collective ownership — deposit SOL/USDC, receive proportional shares (NAV-based, like an ETF)
• On-chain governance — every trade, withdrawal or strategy change requires a vote (L0–L4 configurable)
• Personal AI Voters — each member can delegate voting to their own AI agent, revocable and auditable on-chain
• AI Agent (BOT) — set rules like "if SOL < $120, propose buying 10% more" — agent creates proposals, humans (or their personal voters) vote
• DeFi yield — idle capital deployed via Kamino / Drift / MarginFi / JLP strategies
• Money Tree mascot — evolves 🌱→🌿→🌳→🌺→🌸→🌴 through 6 stages based on AUM, members and trading volume
• SNS subdomain — each POT gets <name>.potbot.sol
• Optional privacy (STAMPPOT) — ZK proofs via PrivacyCash

Strategy Vaults — Creator Economy

Any trader, influencer, or AI agent can launch a Strategy Vault — a tokenized DeFi strategy open to external investors.

1. Creator launches vault → sets entry/performance/management fees
2. Investors buy in → receive Strategy Shares (SPL tokens, NAV-priced)
3. AI Agent runs the strategy → proposes swaps based on rules
4. Group votes → executes only if quorum reached
5. Money Tree evolves → unlock perks (lower fees, Jupiter Limit Orders, NFT shares)

Fee model

Referral system (on-chain, automatic)

• Level 1 referrer: 20% of entry fee at transaction time
• Level 2 referrer: 5% of entry fee
• No claiming needed — paid in the same transaction

AI Agent — Autonomous Proposals

Every POT can have an AI Agent that monitors prices and creates governance proposals automatically.

You set the rules:

• "If SOL drops below $120 → propose buying 10% more"
• "Every Monday 9am → DCA 5% into $JUP"
• "If portfolio PnL > +20% → propose taking 30% profit"

AI suggests. Humans decide. Nothing executes without votes.

• Supported triggers: price_above, price_below, time_interval (cron), balance_above, balance_below, pnl_above, pnl_below
• Supported actions: propose_swap, propose_dca, propose_yield_deposit, vote_yes, alert

MCP Server — AI-Native Infrastructure

PotBot is MCP-native. Any AI agent (Claude, GPT, custom LLM) can interact with every vault via the PotBot MCP server.

// Any AI agent can:
await mcp.call('list_pots')                              // browse all public vaults
await mcp.call('get_pot_analytics', { pubkey })          // PnL, NAV, APY, Sharpe
await mcp.call('create_proposal', { pot, swap })         // propose a trade
await mcp.call('vote_on_proposal', { proposal, approve: true })
await mcp.call('get_yield_rates')                        // Kamino/Drift/JLP live APY
await mcp.call('join_vault', { vault, referrer })        // enter a Strategy Vault

Built on solana-agent-kit — extends 60+ native Solana actions with PotBot-specific vault management.

Integrates x402 micropayments — agents pay per API call (0.001 USDC/request), enabling fully autonomous fee-based agent economies.

DeFi Integrations

Backend & Analytics

The apps/api service provides real-time analytics powering all PnL/ROI/APY calculations:

• Price Oracle → Jupiter Price API v2 (5-second polling, Redis cache)
• PnL Engine → entry_price × current_price × shares → unrealized/realized PnL
• APY Engine → annualized from 30d performance: (1 + pnl_30d)^(365/30) - 1
• Yield Aggreg. → Kamino + Drift + JLP APY pulled every 15 minutes
• Agent Cron → evaluates all AI rules every 60s, creates on-chain proposals
• Crank Service → management fees, AUM snapshots, Money Tree evolution, NFT burns on death

Per-vault metrics: NAV, PnL 24h/7d/30d/all-time, APY estimated, Sharpe ratio, max drawdown, win rate, total volume USD.

Monorepo Structure

potbot-v2/
├── apps/
│   ├── web/           # Next.js 14 DApp — main product
│   ├── api/           # Hono.js backend API
│   ├── potbot-mcp/    # MCP Server (solana-agent-kit based)
│   ├── bot/           # Telegram bot (grammy)
│   ├── keeper/        # Executor / crank service
│   └── landing/       # Marketing landing page
├── packages/
│   ├── program/       # Anchor programs (Rust)
│   │   └── programs/
│   │       ├── pot_vault/  # Core: vault, governance, strategy, referral
│   │       └── pot_duel/   # 1v1 duel vaults (Bloom+ unlock)
│   ├── sdk/           # TypeScript SDK
│   └── ui/            # Shared React components
└── docs/
    ├── OVERVIEW.md
    ├── ARCHITECTURE.md
    ├── DEVELOPMENT.md
    ├── PROGRAM.md
    ├── GOVERNANCE.md
    ├── MOCK_MODE.md
    └── MCP.md

On-chain Program — Instructions

Core Vault

Strategy Vault

Current Status (April 2026)

Tech Stack

Documentation

Hackathon

Solana Frontier 2026 · Colosseum · April 6 – May 11, 2026

"PotBot Strategy Vaults: tokenized DeFi strategies for everyone. Any trader, influencer, or AI agent creates their Strategy Vault on Solana. Investors buy shares — and participate in the strategy without trading themselves. Tamagotchi mechanics gamify growth: the bigger the AUM and members, the cheaper to trade. Everything on-chain, everything transparent, everything on Solana."

License

MIT © 2026 Y-DAO Amsterdam — Built with ❤️ for Solana Frontier

📖 Full Documentation → docs/architecture/overview.md