EVM Blockchain Explorer

A full-stack monorepo for exploring EVM-based blockchains.

Architecture

• apps/web: React + Vite frontend
• apps/api: NestJS API server
• apps/indexer: NestJS blockchain sync service
• packages/: Shared packages (types, database, configs, etc.)

Quick Start

# 1. Install dependencies
pnpm install

# 2. Start infrastructure services
pnpm docker:up

# 3. Setup database
pnpm db:push

# 4. Start development
pnpm dev

Available Scripts

• pnpm dev - Start all apps in development mode
• pnpm build - Build all packages and apps
• pnpm lint - Lint all packages and apps
• pnpm docker:up - Start PostgreSQL and Redis
• pnpm db:studio - Open Prisma Studio

Environment Variables

Copy .env.example to .env and configure:

# Database
DATABASE_URL="postgresql://explorer:explorer123@localhost:5432/evm_explorer"

# Redis
REDIS_URL="redis://localhost:6379"

# Blockchain RPC (Alchemy, Infura, or custom)
RPC_URL="https://eth-mainnet.g.alchemy.com/v2/YOUR_API_KEY"
CHAIN_ID=1

# API Keys
ALCHEMY_API_KEY="your-alchemy-key"
ETHERSCAN_API_KEY="your-etherscan-key"