Hive UI

A web interface for Hive - the integration testing framework of Ethereum.

An example of the UI can be found at the ethPandaops hive address: https://hive.ethpandaops.io

Overview

Hive UI provides a user-friendly interface for viewing and analyzing test results from the Ethereum Hive testing framework. It allows users to browse test runs, filter results, and view detailed information about test performance across different Ethereum clients.

Features

• Browse and filter test runs from multiple hive result directories
• Visualize test results and status
• Compare test runs
• View test run logs

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• npm

Installation

1. Clone the repository

git clone https://github.com/ethpandaops/hive-ui.git
cd hive-ui

2. Install dependencies

make setup

3. Start the development server

make dev

4. Open your browser and navigate to http://localhost:5173

Building for Production

make build

The build artifacts will be stored in the dist/ directory.

Test results endpoint configuration

We use the discovery.json file to determine the available result directories.

The following example shows the format of the discovery.json file:

[
  {
    "name": "pectra",
    "address": "https://hive.ethpandaops.io/pectra/"
  }
]

The address should be the directory where the Hive results are stored.

The UI expects the following files to be there:

• listing.jsonl file which contains a list of recent test results separated by newlines.
• results/ directory that contains more information about specific test results.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the GNU GPL-3.0.