skills.rest
erigontech
erigontechOFFICIAL
Explore all skills by this author →
WebsiteGitHub

erigon-test-hive

Runs Erigon Hive simulator tests for EL/CL protocol interoperability locally or via GitHub Actions.

3.6k|1.5k|Updated May 27, 2019
Search Tags:#docker#Testing#Ethereum#erigon#Hive#engine api#eest
One-click install
npx skills add https://github.com/erigontech/erigon --skill erigon-test-hive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: erigon-test-hive
Source: https://github.com/erigontech/erigon/tree/main/.claude/skills/erigon-test-hive
Command: npx skills add https://github.com/erigontech/erigon --skill erigon-test-hive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running Ethereum Hive simulator tests against Erigon requires coordinating Docker, hive builds, EEST fixtures, and CI workflow simulation, and leftover containers and images can exhaust disk space if not cleaned up.

Core Features & Use Cases

  • Multiple run modes: Execute tests via make test-hive (act-based CI simulation), make hive-local (direct hive invocation), or make eest-devnet (Glamsterdam consume-enginex shard).
  • Suite coverage: Runs engine API, withdrawals, Cancun/EIP-4844, JWT auth, rpc-compat, and EEST EngineX simulator suites against the Erigon client.
  • Docker cleanup guidance: Provides mandatory cleanup commands and trap-based scripts to prune containers, images, and volumes after every run.
  • Use Case: A developer modifying Erigon's Engine API runs make hive-local to validate engine and rpc-compat suites locally, then inspects failures in hiveview before pushing to CI.

Quick Start

Run the Hive engine and RPC compatibility tests against Erigon locally using make hive-local, then clean up Docker resources afterward.

Frequently Asked Questions about erigon-test-hive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run Erigon Hive tests locally?▼

Run make hive-local to build the Erigon Docker image and execute engine and rpc-compat suites directly without act. Alternatively, use make test-hive with act installed and GITHUB_TOKEN set to mirror the CI workflow exactly.

How to run EEST EngineX tests against Erigon?▼

Use make eest-hive for the unsharded stable EngineX fixtures or make eest-devnet for the CI-equivalent Glamsterdam devnet shard. The devnet target enables parallel execution, BAL validation, and CI-matching simulator flags.

Why does my disk fill up after running Hive tests?▼

Hive spawns one container per client instance and simulator plus intermediate build images, which accumulate across runs. Run docker system prune -af --volumes after every test run, including failures, to reclaim disk space.

What do I need installed to run make test-hive?▼

You need Docker running, the act tool from nektos installed, and a GITHUB_TOKEN environment variable set. You can export the token with export GITHUB_TOKEN=$(gh auth token) if you use the GitHub CLI.

How do I debug a failing Hive test suite?▼

Hive writes results to temp/*/hive/workspace/logs/, viewable in a browser by running ./hiveview --serve --logdir ./workspace/logs. You can re-run a single failing simulator with ./hive --sim ethereum/engine --sim.limit=<pattern> --client erigon.

Related Skills

Explore More Software Engineering Skills→
erigontecherigontech
3.6k

erigon-build

Build the Erigon binary from source using make erigon.

Official
Advanced
mvillmowmvillmow
18

fix-ci-failures

Diagnose CI failures by inspecting logs and reproducing issues locally.

Community
Advanced
0xBigBoss0xBigBoss
53

playwright-best-practices

Enforce Playwright best practices for locators, page objects, and assertions.

Community
Basic
TencentCloudBaseTencentCloudBase
1.1k

postgresql-development-cloudbase

Manage CloudBase PostgreSQL schemas, migrations, and row-level security policies.

Official
Advanced