# WhoEarns

> WhoEarns — AI-assisted Solana validator income intelligence.
> Open-source explorer tracking per-epoch slot production, block fees
> (base + priority), and on-chain Jito tips for validators on Solana
> mainnet, with stored leader-slot facts for watched validators. Data
> is indexed from Solana RPC block data. Maintained by 0base.vc, all
> data released under CC0.

## Core pages

- https://whoearns.live/: Leaderboard — top validators by live-trend income per slot
- https://whoearns.live/income/{vote}: Per-validator surface — tier strip, per-epoch income table, slot stats, freshness. Primary public entry for a single validator; accepts both vote and identity pubkeys.
- https://whoearns.live/compare: Side-by-side comparison of two validators
- https://whoearns.live/glossary: Plain-language definitions of Solana validator terms
- https://whoearns.live/faq: Frequently asked questions
- https://whoearns.live/api/docs: HTTP API reference
- https://whoearns.live/about: Project mission and self-hosting instructions

## Machine-readable assets

- https://whoearns.live/openapi.yaml: OpenAPI 3.1 spec (full schema + examples)
- https://whoearns.live/llms-full.txt: Full reference for AI agents (extended doc)
- https://whoearns.live/.well-known/ai-plugin.json: Agent plugin manifest
- https://whoearns.live/mcp: Model Context Protocol server (Streamable HTTP)

## API endpoints

GET unless noted. Full descriptions + query params in /llms-full.txt.

- https://whoearns.live/v1/epoch/current: Running epoch metadata
- https://whoearns.live/v1/leaderboard: Validators ranked by income window
- https://whoearns.live/v1/validators/search: DB-only validator name/pubkey search
- https://whoearns.live/v1/validators/{idOrVote}/history: Per-epoch income history
- https://whoearns.live/v1/validators/{idOrVote}/current-epoch: Single running-epoch record
- https://whoearns.live/v1/validators/{idOrVote}/epochs/{epoch}/leader-slots: Leader-slot facts for one epoch
- https://whoearns.live/v1/validators/{idOrVote}/tier: Node Tier composite (10-epoch window)
- https://whoearns.live/v1/validators/{idOrVote}/badges: Tenure + client + tier badge bundle
- https://whoearns.live/v1/validators/{idOrVote}/operator-activity-index: Operator Activity Index (governance + wallet)
- https://whoearns.live/v1/validators/{idOrVote}/scoring: Aggregate scoring bundle — tier + badges + OAI in one round-trip
- https://whoearns.live/v1/claims/{vote}?includeActivity=1: Claim status — folds in each registered operator wallet's 365-day daily activity
- https://whoearns.live/v1/simd-proposals: Human-reviewed AI-curated SIMD proposal feed
- https://whoearns.live/badge/{vote}.svg: Embeddable SVG performance badge
- https://whoearns.live/v1/validators/current-epoch/batch: POST — bulk current-epoch lookup
- https://whoearns.live/v1/claims/{vote}/github: PUT — link a GitHub identity via a signed Gist
- https://whoearns.live/v1/claims/{vote}/wallets: POST — register an operator wallet via dual-signature proof
- https://whoearns.live/v1/claims/{vote}/wallets/{walletRef}: DELETE — unregister an operator wallet by its opaque ref

## AI-assisted operations

AI helps 0base.vc monitor freshness, detect unusual income patterns,
and draft public explanations. The source of truth remains Solana block
data and closed-epoch API fields.