📡 Block Monitor 🔍 Block Explorer đŸ’ŗ Transaction Viewer 📊 Network Stats 📈 Activity Chart 👁 Address Monitor đŸ“Ļ Installation

Installation Guide

Complete guide to install and run Akula BSC

⚡ Tech Stack

Next.js 15 React 19 TypeScript Tailwind CSS Viem Chart.js BSC Mainnet

📋 Prerequisites

ℹī¸ Required Software:
  • Node.js version 18.17 or higher
  • npm or yarn or pnpm
  • Git (for cloning repository)

🚀 Installation Steps

Step 1: Clone the Repository

# Clone via HTTPS git clone https://github.com/bnb-chain/akula.git # Or clone via SSH git clone git@github.com:bnb-chain/akula.git # Navigate to project directory cd akula

Step 2: Install Dependencies

# Using npm npm install # Or using yarn yarn install # Or using pnpm pnpm install
💡 Note: This will install all required dependencies including Next.js, React, Viem, Chart.js, and Tailwind CSS.

Step 3: Run Development Server

# Using npm npm run dev # Or using yarn yarn dev # Or using pnpm pnpm dev
✅ Success! Open your browser and navigate to:

http://localhost:3000

You should see the Akula BSC dashboard running!

🏗ī¸ Build for Production

Create Production Build

# Build the application npm run build # Start production server npm run start

đŸšĸ Deployment Options

Option 1: Vercel (Recommended)

Deploy with zero configuration:

  1. Push your code to GitHub
  2. Connect your repository to Vercel
  3. Click "Deploy"
  4. Done! Your app is live
Deploy to Vercel

Option 2: Docker

# Build Docker image docker build -t akula-bsc . # Run container docker run -p 3000:3000 akula-bsc

⚙ī¸ Configuration

RPC Endpoints

Default RPC endpoint: https://bsc-rpc.publicnode.com

Features Configuration

🔧 Troubleshooting

⚠ī¸ Issue: Port 3000 already in use

Solution:
npx kill-port 3000 # Or use different port PORT=3001 npm run dev
⚠ī¸ Issue: Chart not displaying

Solution: Ensure Chart.js dependencies are installed:
npm install chart.js react-chartjs-2

📄 License

The entire code within this repository is licensed under the GNU Affero General Public License v3

Commercial licensing is available. Please contact [email protected] for details.

🤝 Support & Community

Need help? Here's how to get support: