Bitsplorer

A whimsical blockchain analytics tool

📦 Monorepo Structure

This project uses pnpm workspaces to manage multiple packages:

• @bitsplorer/nextjs - Next.js frontend application
• @bitsplorer/hardhat - Hardhat smart contract development environment

🚀 Getting Started

Prerequisites

• Node.js 22.x (pinned by engines.node and .nvmrc)
• pnpm 10.5.2 (pinned by packageManager)

Installation

# Install all dependencies for all packages
pnpm install

📜 Available Scripts

Next.js (Frontend)

# Run development server
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

# Run linter
pnpm lint

Hardhat (Smart Contracts)

# Compile smart contracts
pnpm hardhat:compile

# Run tests
pnpm hardhat:test

# Start local Hardhat node
pnpm hardhat:node

Workspace Management

# Clean all node_modules
pnpm clean

# Reinstall all dependencies
pnpm install:all

🏗️ Working with Packages

Run commands in specific packages:

# Run command in nextjs package
pnpm --filter @bitsplorer/nextjs <command>

# Run command in hardhat package
pnpm --filter @bitsplorer/hardhat <command>

Add dependencies:

# Add to nextjs package
pnpm --filter @bitsplorer/nextjs add <package-name>

# Add to hardhat package
pnpm --filter @bitsplorer/hardhat add -D <package-name>

📁 Project Structure

bitsplorer/
├── packages/
│   ├── nextjs/          # Next.js frontend app
│   │   ├── app/         # Next.js app directory
│   │   ├── public/      # Static assets
│   │   └── package.json
│   └── hardhat/         # Hardhat development
│       ├── contracts/   # Solidity contracts
│       ├── test/        # Contract tests
│       ├── scripts/     # Deployment scripts
│       └── package.json
├── pnpm-workspace.yaml
└── package.json

🚢 Deployment

See DEPLOY.md for the Vercel runbook. Note that the app needs an Ethereum RPC endpoint per chain (RPC_URL_MAINNET, RPC_URL_SEPOLIA, RPC_URL_BASE) — see packages/nextjs/.env.example. Without them it falls back to viem's public defaults, most of which are dead or rate-limited.

🔗 Links

• Next.js Documentation
• Hardhat Documentation
• pnpm Workspaces