Plott Documentation
Everything you need to know about the agent orchestration platform on Solana.
Overview
Plott is an agent orchestration platform on Solana. It gives you a visual, interactive way to deploy, monitor, and manage autonomous agents — rendered as an isometric city.
The core metaphor: your agents are buildings, your pipelines are roads, and you are the mayor. Every agent runs inside the city, connected to others through typed data flows. The dashboard shows real-time PnL, transaction volume, uptime, and system events as a living, breathing cityscape.
Clients
The primary client today is the web dashboard at plott.city/city. The architecture is designed to be client-agnostic — the backend API serves any client type, and the web interface is the first of potentially many front-ends.
Getting Started
- Visit plott.city/city
- Connect a Solana wallet (Phantom or Solflare recommended)
- Start placing agents, drawing roads, and managing your city
Save Behavior
When a wallet is connected, your city state auto-saves to the cloud. Without a wallet, the city persists in your browser's localStorage — functional, but tied to that device and browser.
City Dashboard
Tools
The toolbar along the left edge gives you six modes. Press the shortcut key or click to switch.
Building Types
Twelve agent types are available, each with distinct visual designs, economic stats, and tier requirements.
| Name | Category | Min Size | Tier | Base Cost | PnL Range | Running Cost |
|---|---|---|---|---|---|---|
| Trading Bot | DeFi | 1x1 | Base | 500 | +20 to +80 | 8/tick |
| Copy Trader | DeFi | 1x1 | Base | 600 | +15 to +70 | 10/tick |
| Arbitrage | DeFi | 1x1 | Citizen | 800 | +30 to +120 | 15/tick |
| Price Oracle | Data | 1x1 | Base | 400 | +10 to +40 | 5/tick |
| Data Center | Data | 2x2 | Base | 1200 | +25 to +100 | 18/tick |
| DEX Aggregator | DeFi | 2x2 | Citizen | 1500 | +40 to +150 | 22/tick |
| Liquidity Pool | DeFi | 2x2 | Citizen | 2000 | +50 to +200 | 30/tick |
| MEV Hunter | DeFi | 2x2 | District | 3000 | +80 to +350 | 45/tick |
| AI Research Lab | AI | 3x3 | District | 5000 | +100 to +500 | 60/tick |
| Validator Hub | Infra | 3x3 | District | 4000 | +60 to +250 | 40/tick |
| Yield Farm | DeFi | 3x3 | Metropolis | 8000 | +150 to +600 | 80/tick |
| Alert System | Infra | 1x1 | Base | 300 | +5 to +25 | 3/tick |
Buildings
Buildings range from 1x1 to 4x4 tiles. Larger buildings are placed by zoning a bigger area — effectively upgrading the agent's visual footprint and capabilities. Multi-tile buildings occupy all tiles within their footprint.
City Life
The city features a day/night cycle, vehicles that travel along roads with smooth interpolation, and data packets — particles that fly between running agents to visualize active pipelines.
Each agent tracks its own PnL, transaction count, and uptime. A global treasury tracks overall performance. Quests provide progression objectives, while disasters introduce challenges that test your city's resilience.
Game Economy
The city runs on a closed-loop economy. Agents generate PnL, which feeds the treasury. Deploying and running agents costs treasury credits. Upgrades burn $PLOTT tokens on-chain.
City Levels
Your city levels up as population and infrastructure grow. Each level unlocks new capabilities and increases your treasury cap.
| Level | Title | Population | Buildings | Treasury Cap |
|---|---|---|---|---|
| 1 | Outpost | 0 | 1-3 | 1,000 |
| 2 | Settlement | 100 | 4-8 | 5,000 |
| 3 | Town | 500 | 9-15 | 15,000 |
| 4 | City | 2,000 | 16-25 | 50,000 |
| 5 | Metropolis | 10,000 | 26-40 | 200,000 |
| 6 | Megacity | 50,000 | 41+ | 1,000,000 |
Agent BuilderPreview
The Agent Builder is a visual, drag-and-drop interface for designing and deploying new agents. Currently available at plott.city/builder.
- Visual deployment — configure agent parameters through an interactive canvas
- Pipeline connections — link agents with typed connections: data, signal, token, and alert
- Template marketplace — browse and deploy pre-built agent configurations
Architecture
Frontend
Next.js with App Router. The city dashboard uses SVG-based isometric rendering — no canvas or WebGL. State is managed with useReducer, keeping the entire city state in a single, predictable state tree.
Backend
Hono (TypeScript) handles the API layer. PostgreSQL for persistent storage, Redis for caching and pub/sub, BullMQ for job queues.
Blockchain
Solana integration via Helius RPC. Wallet connections, token queries, and transaction lookups flow through the backend API.
API
REST endpoints live at api.plott.city. Full reference below.
Design principle: Client-agnostic backend — the API serves any client, web or otherwise. The web dashboard is one consumer; the architecture intentionally supports others.
$PLOTT Token
$PLOTT is a Solana SPL token. It unlocks premium tiers, exclusive building skins, and priority access to new features.
Tier System
Hold $PLOTT tokens to unlock higher tiers. Each tier adds cumulative bonuses.
| Feature | Base | Citizen (10K+) | District (100K+) | Metropolis (1M+) |
|---|---|---|---|---|
| Max Agents | 10 | 25 | Unlimited | Unlimited |
| PnL Boost | -- | +10% | +25% | +50% |
| Cost Reduction | -- | -5% | -15% | -30% |
| Quest Boost | -- | +20% | +50% | +100% |
| Burn Access | -- | -- | 3x3 | 3x3 + 4x4 |
| Building Skins | Standard | Premium | Exclusive | Custom themes |
| Special Access | -- | -- | Early access | API + upcoming clients |
Burn Mechanics
Building upgrades to 3x3 and 4x4 require burning $PLOTT tokens on-chain. Burned tokens are permanently removed from circulating supply.
Burn program on Solana mainnet. Treasury credits are still required in addition to the token burn. Base tier users cannot upgrade past 2x2 — connect wallet and hold $PLOTT to unlock.
All PnL figures, tier bonuses, and staking boosts refer to in-game simulated agent performance within the Plott city-builder. They do not represent real financial returns, investment yields, or guaranteed profits.
Token Flow
API Reference
Base URL: https://api.plott.city. Click any endpoint to expand request/response details.
Roadmap
Links
Built by the Plott team. Questions? Open an issue on GitHub.