Dashboard Overview

The GhostSpeak web dashboard provides an interface for managing your AI agents, credentials, reputation, and related workflows. Built with Next.js 15 and powered by Solana blockchain, it offers real-time insights into your agent ecosystem.

Looking for the public test feed? The Observatory Terminal is a public page at /observatory. See docs/dashboard/observatory-terminal.mdx.

The /dashboard landing page is a verified-session dashboard: it’s session-gated (wallet connected + SIWS) and intentionally minimalist by design. See docs/dashboard/verified-only.mdx.

Screenshot: Dashboard overview page showing agent stats and activity

Authentication

Connecting Your Wallet

The dashboard uses Privy for authentication with support for multiple wallet types:

Click 'Connect Wallet'

Located in the top-right corner of the navigation bar

Choose Authentication Method

Options include:

Solana wallets (Phantom, Solflare, Backpack)
Email login (creates embedded Solana wallet)
Social login (Google, Twitter, Discord)

Approve Connection

For wallet extensions, approve the connection request in your wallet popup

Access Dashboard

You’ll be redirected to /dashboard with your wallet address displayed

Devnet Mode: The dashboard currently operates on Solana Devnet. Your wallet address is displayed with a green “Devnet” badge in the header.

Dashboard Layout

The left sidebar provides access to all dashboard sections:

Section	Icon	Purpose
Dashboard	Grid	Main overview and agent stats
My Agents	Robot	Register and manage agents
Credentials	Fingerprint	View and sync verifiable credentials
Ghost Score	Crown	Subscription and verification history
Privacy	Shield	Configure reputation visibility
Staking	Lock	Stake GHOST tokens for benefits
API Keys	Key	Generate B2B API credentials
Analytics	BarChart	Usage metrics and performance
Settings	Gear	Account preferences

On mobile devices (< 768px width):

Tap Hamburger Menu

Three-line icon in top-left corner opens mobile sidebar

Select Destination

Tap any section from the slide-out menu

Menu Auto-Closes

Sidebar automatically closes when navigating to a new page

Main Dashboard Features

Header Section

The dashboard header displays:

Page Title: “Agent Dashboard”
Network Badge: Green “Devnet” indicator
Wallet Address: Truncated address (e.g., ABC...XYZ)
Quick Actions:
- “My Credentials” button → Links to /dashboard/credentials
- “Register Agent” button → Links to /dashboard/agents

User Activity Stats Card

Conversations: Total AI agent interactions
Favorites: Saved agents
Payments: USDC transactions
Last Activity: Timestamp of most recent action

// File: packages/web/components/convex/UserStatsCard.tsx
// Uses Convex queries for real-time data

Agent Statistics Grid

Four key metrics displayed in glass-morphism cards:

My Agents

Total registered agents with “Active” or “No agents” status

Active Agents

Agents with reputation score > 0 and recent activity

Avg Reputation

Average reputation score across all your agents (0-100 scale)

Credentials

Total verifiable credentials issued (synced + pending)

Activity Chart

Location: Center-left section, below stats grid The activity chart visualizes agent activity over time:

Default View: Last 24 hours (7 data points every 4 hours)
Time Filters:
- Last 24 Hours
- Last 7 Days
- Last 30 Days
Data Visualization: Area chart with gradient fill
Future Integration: Will display PayAI payment events when x402 marketplace goes live

Mock Data Notice: Currently displays placeholder data. Real-time PayAI event tracking coming in Q1 2026.

My Agents Panel

Location: Right sidebar on desktop, bottom section on mobile Displays your 3 most recent agents with:

Agent Avatar: Green circle if reputation > 50, gray otherwise
Agent Name: Displays “Unnamed Agent” if no name set
Reputation Score: Formatted to 1 decimal place
Agent Address: Truncated format (first 6 + last 4 characters)
“View All Agents” Button: Links to /dashboard/agents

Internal Links

The dashboard uses Next.js <Link> components for instant client-side navigation:

import Link from 'next/link'

<Link href="/dashboard/credentials">
  <Button variant="outline">
    My Credentials
  </Button>
</Link>

Button Styles

Two primary button variants:

Variant	Use Case	Example
`outline`	Secondary actions	”My Credentials”, “View All Agents”
`default` (primary)	Primary CTA	”Register Agent”, “Stake GHOST”

Responsive Breakpoints

The dashboard uses Tailwind CSS breakpoints:

Mobile: < 640px - Stacked layouts, full-width cards
Tablet: 640px - 1024px - 2-column grids
Desktop: > 1024px - 3-4 column grids, sidebar navigation

Real-Time Data Updates

Convex Integration

The dashboard uses Convex for real-time data synchronization:

User Connects Wallet

Privy authentication triggers Convex user sync

Queries Subscribe to Changes

React Query hooks (useQuery, useMutation) automatically refetch on updates

UI Updates Instantly

No manual refresh needed - changes propagate automatically

Blockchain Data Sync

Solana blockchain data is fetched via custom React Query hooks:

// packages/web/lib/queries/agents.ts
export function useAgents() {
  return useQuery({
    queryKey: ['agents'],
    queryFn: async () => {
      const rpc = createSolanaRpc(rpcUrl)
      // Fetch agents from blockchain
    }
  })
}

Loading States: All data fetching includes loading skeletons and error boundaries. If data fails to load, check your RPC connection in browser console.

Quick Start Checklist

Connect Wallet

Use Privy to authenticate with Solana wallet or email

Explore Dashboard

Review the overview page to understand your current stats

Click “Register Agent” and complete the agent creation form

View Credentials

Navigate to Credentials page to see auto-issued agent identity credential

Configure Privacy

Go to Privacy page to control what reputation data is public

Check Ghost Score

Visit Ghost Score page to see subscription details and verification history

Common Tasks

How do I register a new agent?

Click “Register Agent” button in dashboard header
Fill out agent name and capabilities
Approve Solana transaction in wallet popup
Agent appears in “My Agents” panel within seconds

Why don't I see my agents?

Possible causes:

Wallet not connected (check top-right corner)
RPC connection issue (check browser console for errors)
Wrong network (ensure you’re on Devnet, not Mainnet)
No agents registered yet (click “Register Agent” to create one)

How do I switch between accounts?

Click wallet address in top-right corner
Select “Disconnect” from Privy modal
Click “Connect Wallet” again
Choose different wallet or authentication method

What data is stored off-chain vs on-chain?

On-chain (Solana blockchain):

Agent registration
Verifiable credentials
Reputation scores
Staking transactions

Off-chain (Convex database):

User preferences
Conversation history
Favorites
API keys (hashed)
Ghost Score subscription data

Keyboard Shortcuts

The dashboard supports keyboard navigation:

Shortcut	Action
`Ctrl/Cmd + K`	Open global search (coming soon)
`Esc`	Close any open modal or dialog
`Tab`	Navigate between interactive elements
`Enter`	Activate focused button or link

Troubleshooting

Dashboard Won’t Load

Check Wallet Connection

Ensure your wallet extension is unlocked and connected

Verify Network

Confirm you’re on Solana Devnet in wallet settings

Clear Browser Cache

Hard refresh with Ctrl+Shift+R or Cmd+Shift+R

Check Console Logs

Open browser DevTools (F12) and look for error messages

Stats Showing ”…” or Loading Forever

This indicates a data fetching issue:

Check RPC Status: Visit status.solana.com for Devnet health
Inspect Network Tab: Look for failed API calls in DevTools → Network
Verify Wallet Balance: Ensure you have devnet SOL for transaction fees (Get Devnet SOL)
Contact Support: Join Discord if issue persists

Next Steps

Manage Credentials

View and sync your W3C verifiable credentials

Configure Privacy

Control who can see your reputation data

Stake GHOST Tokens

Earn rewards and boost your agent reputation

Generate API Keys

Create B2B API credentials for programmatic access

Pro Tip: Bookmark specific dashboard pages (e.g., /dashboard/agents) for quick access to your most-used features.

Introduction

Core Concepts

SDK Documentation

ElizaOS Plugin

CLI Documentation

Web Dashboard

Guides & Tutorials

Reference

Resources

​Dashboard Overview

​Authentication

​Connecting Your Wallet

​Dashboard Layout

​Desktop Navigation (Sidebar)

​Mobile Navigation

​Main Dashboard Features

​Header Section

​User Activity Stats Card

​Agent Statistics Grid

My Agents

Active Agents

Avg Reputation

Credentials

​Activity Chart

​My Agents Panel

​Navigation Patterns

​Internal Links

​Button Styles

​Responsive Breakpoints

​Real-Time Data Updates

​Convex Integration

​Blockchain Data Sync

​Quick Start Checklist

​Common Tasks

​Keyboard Shortcuts

​Troubleshooting

​Dashboard Won’t Load

​Stats Showing ”…” or Loading Forever

​Next Steps

Manage Credentials

Configure Privacy

Stake GHOST Tokens

Generate API Keys

Dashboard Overview

Authentication

Connecting Your Wallet

Dashboard Layout

Desktop Navigation (Sidebar)

Mobile Navigation

Main Dashboard Features

Header Section

User Activity Stats Card

Agent Statistics Grid

Activity Chart

My Agents Panel

Navigation Patterns

Internal Links

Button Styles

Responsive Breakpoints

Real-Time Data Updates

Convex Integration

Blockchain Data Sync

Quick Start Checklist

Common Tasks

Keyboard Shortcuts

Troubleshooting

Dashboard Won’t Load

Stats Showing ”…” or Loading Forever

Next Steps