HiveTool - Hive Blockchain Explorer

A modern, fast, and responsive block explorer for the Hive blockchain, built with SvelteKit and HafSQL. This application connects directly to a HafSQL PostgreSQL database to query real-time blockchain data.

Features

🔍 Explorer

• Real-time Transfer Monitoring: View the latest HIVE and HBD transfers as they happen
• Auto-Polling: Live updates without page refreshes
• Account Filtering: Filter transfers by specific accounts

📝 Posts Search

• Advanced Filtering: Search posts by author, tags, date range, payout, word count, and more
• Author Reputation Filter: Filter by minimum/maximum author reputation
• Image Count Filter: Filter posts by number of images
• Sort Options: Sort by various criteria including payout and date

👥 Witnesses

• Witness Rankings: View top Hive witnesses and their details
• Voting Information: See current witness votes and rankings

💰 Rich List

• Top Accounts: View the wealthiest Hive accounts
• Balance Breakdown: See HIVE, HBD, and vesting shares

🏘️ Communities

• Community Browser: Explore Hive communities
• Community Stats: View subscriber counts and activity

📊 Stats

• Blockchain Statistics: General Hive network statistics

✨ General

• 🌓 Modern UI: Clean, dark-themed interface built with shadcn-svelte and Tailwind CSS
• 📱 Responsive: Fully optimized for desktop and mobile devices
• ⏱️ Relative Timestamps: Human-readable time formats (e.g., "just now", "5m ago")
• 🔗 Direct Links: Links to accounts and posts on PeakD

Tech Stack

• Framework: SvelteKit with Svelte 5
• Styling: Tailwind CSS v4
• UI Components: shadcn-svelte + bits-ui
• Icons: Lucide Svelte
• Database: HafSQL (PostgreSQL)
• Database Client: postgres.js

Getting Started

Prerequisites

• Node.js 18+
• npm or pnpm

Installation

1. Clone the repository:

   git clone https://github.com/gibic/hivetool.git
   cd hivetool

2. Install dependencies:

   npm install

3. Configure environment variables:

   Copy .env.example to .env:

   cp .env.example .env

   Set your DATABASE_URL with the PostgreSQL connection string. You can find connection details for the public HafSQL instance in the HafSQL documentation.

4. Start the development server:

   npm run dev

5. Open your browser:

   Navigate to http://localhost:5173

Building for Production

npm run build
npm run preview

Project Structure

src/
├── lib/
│   ├── components/ui/   # shadcn-svelte UI components
│   └── server/          # Database connection & helpers
├── routes/
│   ├── api/             # API endpoints
│   ├── explorer/        # Transfer explorer page
│   ├── posts/           # Posts search page
│   ├── witnesses/       # Witnesses page
│   ├── rich-list/       # Rich list page
│   ├── communities/     # Communities page
│   ├── stats/           # Stats page
│   └── +page.svelte     # Home page
└── app.css              # Global styles & Tailwind

Database Info

This project uses the public HafSQL instance provided by @mahdiyari.

• Host: hafsql-sql.mahdiyari.info
• Database: haf_block_log
• User: hafsql_public
• Documentation: HafSQL Docs

Credits

Created by @gibic, a Curie curator.

License

MIT