Solana Local Explorer

A self-hosted Solana blockchain explorer with a test validator, gRPC indexer, PostgreSQL database, and Next.js web UI.

Quick Start

docker compose up --build -d

That's it. All four services start automatically with proper dependency ordering:

1. Validator + PostgreSQL start first
2. Indexer starts after both are healthy
3. Explorer starts after the indexer is running

Open http://localhost:3000 to view the explorer.

Services

Service	Container	Ports	Description
Validator	solana-validator	8899 (RPC), 10000 (gRPC)	Solana test-validator with Yellowstone gRPC Geyser plugin
PostgreSQL	explorer-postgres	5433 (host) → 5432	Stores indexed transactions and failed transactions
Indexer	solana-indexer	—	Streams transactions via gRPC and writes to PostgreSQL
Explorer	solana-explorer	3000	Next.js web UI — dashboard, transaction list, transaction detail

Explorer UI

• Dashboard (/) — stat cards (total txs, failed, success rate, latest slot) + recent transactions table. Auto-refreshes every 5s.
• Transaction List (/transactions) — paginated table of all transactions with a refresh button.
• Transaction Detail (/transactions/[signature]) — full detail: accounts, instructions, fees, memos, error logs.

Common Commands

# Start all services
docker compose up -d

# View logs
docker compose logs -f              # all services
docker compose logs -f indexer      # specific service

# Rebuild after code changes
docker compose up --build -d

# Stop everything
docker compose down

# Send a test transaction (from inside the validator container)
docker exec solana-validator solana-keygen new -o /root/.config/solana/id.json --no-bip39-passphrase --force
docker exec solana-validator solana airdrop 5 --url http://127.0.0.1:8899
docker exec solana-validator solana transfer --allow-unfunded-recipient 11111111111111111111111111111112 0.01 --url http://127.0.0.1:8899

Access from Host

• Explorer UI: http://localhost:3000
• Solana RPC: http://localhost:8899
• gRPC: localhost:10000
• Database: postgresql://postgres:password@localhost:5433/explorer

Using an Existing Ledger

To use your existing test-ledger directory instead of a fresh ledger, update docker-compose.yml:

volumes:
  # Comment out the named volume and use bind mount:
  # - validator-ledger:/ledger
  - ./test-ledger:/ledger

Tech Stack

• Validator: Solana test-validator v1.18.26 + Yellowstone gRPC Geyser plugin v1.15.3
• Indexer: TypeScript, Yellowstone gRPC client, Prisma ORM
• Database: PostgreSQL 15
• Explorer: Next.js 16 (App Router), Tailwind CSS v4, Prisma 5

Demo WIP!

Screencast.from.2026-03-09.00-42-20.webm