🪴 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

Quick Start

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

No wallet needed to explore. The DApp boots in demo mode with pre-seeded vaults,
proposals, and AI agent activity. Connect Phantom to interact on-chain.

For full setup including Anchor, devnet deploy and API server: see docs/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). The vault is always on-chain; share accounting starts off-chain at Seedling and graduates to an SPL mint at Sprout+ (why)
• 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 (details)
• 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 plant-themed stages based on AUM, members and trading volume. Has a Health stat; at 0 balance the tree dies and NFT shares burn (mechanics)
• SNS subdomain — each POT gets <name>.potbot.sol with reverse lookup
• Optional privacy (STAMPPOT) — ZK proofs via PrivacyCash keep wallet-to-share linkage private while governance stays public

Strategy Vaults — Creator Economy

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

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

Fee model — honest unit economics, no token speculation

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"

Agent runs 24/7 → evaluates rules every 60 seconds
Rule triggers → Agent creates proposal on-chain
Group votes → Quorum required before any execution

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

| Protocol | What we use it for |
|----------|--------------------||
| Jupiter v6 | All swaps (best route, min slippage), Limit Orders (Bud+), DCA (Bloom+) |
| Kamino | Yield strategies (lending APY up to 15%), RWA-backed vaults |
| Drift | Perps exposure + lending rates |
| MarginFi | Lending/borrowing yield |
| Metaplex Core | NFT Strategy Shares for Full Bloom+ vaults |
| MagicBlock | Private USDC referral payouts (confidential transfers via MCP) |
| Privy | Embedded wallet — join vaults by email, no Phantom needed |
| MoonPay | Fiat on-ramp on vault join page |
| Pyth / Switchboard | Price oracle fallback |

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 exposed via API:

• NAV (Net Asset Value = vault_balance / total_shares)
• PnL 24h / 7d / 30d / all-time
• APY estimated (annualized)
• Sharpe ratio, max drawdown
• Win rate (% profitable trades)
• Total volume USD

Monorepo Structure

potbot-v2/
├── apps/
│   ├── web/              # Next.js 14 DApp — main product
│   │   └── src/app/
│   │       ├── /              # Homepage
│   │       ├── /vaults        # Strategy Vault discovery
│   │       ├── /vaults/create # Create vault wizard (5 steps)
│   │       ├── /pots/[pubkey] # Pot detail (7+ tabs incl. AI Agent)
│   │       ├── /leaderboard   # Public vault rankings
│   │       ├── /my-pots       # Your vaults
│   │       └── /for-agents    # MCP documentation for developers
│   ├── api/              # Hono.js backend API
│   │   └── src/
│   │       ├── routes/   # price, pots, vaults, analytics, agent
│   │       ├── services/ # price.ts, pnl.ts, agent.ts, yield.ts
│   │       └── jobs/     # agent-cron.ts, price-poller.ts, crank.ts
│   ├── potbot-mcp/       # MCP Server (solana-agent-kit based)
│   ├── bot/              # Telegram bot (grammy)
│   └── 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/
    ├── ARCHITECTURE.md
    ├── GOVERNANCE.md
    ├── PROGRAM.md
    ├── MOCK_MODE.md
    └── MCP.md            # MCP server guide for AI agent developers

On-chain Program — Instructions

Core Vault

Strategy Vault

Current Status (April 2026)

Tech Stack

Documentation

📖 Read the full project documentation → docs/OVERVIEW.md
The single-page overview of everything PotBot: features, money tree stages, governance levels, STAMPPOT privacy, MCP server, fees, roadmap, and links.

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

For the complete, single-page deep dive on PotBot — architecture, governance, money tree stages, STAMPPOT privacy, MCP server, fee model, and roadmap — see docs/OVERVIEW.md.