Skip to main content

Hive Auxiliary Helpers

Tools extending Ethereum's Hive testing framework with web UI, CI/CD automation, and test suites.

About Hive​

Hive is an integration testing framework for validating Ethereum client implementations. It provides comprehensive protocol compliance testing across consensus mechanisms, P2P networking, RPC interfaces, and more.

The Hive Auxiliary Helpers are a collection of complementary tools maintained by ethPandaOps that significantly extend Hive's accessibility and operationalization.

Core Components​

Hive UI​

Repository
hive-ui

A web-based visualization interface for browsing, analyzing, and comparing Hive test results. The dashboard at hive.ethpandaops.io provides an intuitive interface where developers can:

  • View test runs across multiple clients
  • Filter outcomes by client, test suite, and status
  • Examine detailed performance metrics
  • Compare client implementations side-by-side
  • Track historical test results

Hive GitHub Action​

Repository
hive-github-action

An automation wrapper that enables seamless integration of Hive tests into GitHub CI/CD workflows. Features include:

  • Automatic Hive test execution on pull requests
  • Configurable test parameters and client selection
  • Cloud storage integration (S3) for results
  • Automatic web dashboard generation
  • Support for both GitHub-hosted and self-hosted runners
  • Easy-to-use GitHub Actions YAML configuration

Hive Tests​

Repository
hive-tests

A repository containing automated testing workflows for Ethereum clients. The tests are run on a regular basis and the results are aggregated on the public dashboard. Some of the benefits are:

  • Automated testing workflows for 8+ Ethereum clients
  • Scheduled and on-demand test execution
  • CI/CD pipelines for continuous validation
  • Results aggregation on the public dashboard
  • Custom test suite configurations

Use Cases​

  • Client Implementation Validation: Test new Ethereum client implementations for protocol compliance before production deployment.

  • Protocol Compliance Verification: Verify that clients correctly implement Ethereum protocol specifications and EIPs.

  • Hardfork Testing: Validate client behavior during protocol upgrades and network hardforks.

  • CI/CD Integration: Automatically test Ethereum clients as part of development workflows with every pull request.

  • Multi-Client Compatibility: Compare behavior across different client implementations to identify inconsistencies.

  • Bug Detection: Discover and diagnose bugs in production Ethereum clients through comprehensive testing.

  • Quality Assurance: Hive has proven its value by detecting bugs in major Ethereum implementations, making it an essential tool for the ecosystem's security and reliability.