erigon-ci

Runs Erigon CI test groups locally and dispatches GitHub Actions workflows on any branch.

3.6k|1.5k|Updated May 27, 2019
One-click install
npx skills add https://github.com/erigontech/erigon --skill erigon-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: erigon-ci
Source: https://github.com/erigontech/erigon/tree/main/.claude/skills/erigon-ci
Command: npx skills add https://github.com/erigontech/erigon --skill erigon-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Verifying that an Erigon branch passes all CI checks is fragmented across many make targets and GitHub Actions workflows, and branches that do not target main (like bal-devnet-2) never trigger CI automatically on push. This Skill consolidates local test execution and remote workflow dispatch into one repeatable gate.

Core Features & Use Cases

  • Local test orchestration: Maps each CI group (lint, unit, all, race, EEST spec, caplin spec, hive, rpc) to its exact make command, expected runtime, and when to run it.
  • Remote workflow dispatch: Uses gh workflow run to trigger all dispatchable GitHub Actions workflows on any branch, with a support matrix showing which workflows accept workflow_dispatch.
  • Full CI gate workflow: Combines local gates, push, remote dispatch, and run monitoring into a step-by-step pre-review checklist.
  • Use Case: Before marking a devnet branch ready for review, run the local gate, push, dispatch all remote workflows, and monitor runs until every check passes.

Quick Start

Run the full CI gate for my current Erigon branch, including local lint and short tests plus dispatching all GitHub Actions workflows.

Frequently Asked Questions about erigon-ci

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

FAQPage Schema
How do I run Erigon CI checks locally before pushing?

Run make lint first, then make test-short as a quick pre-push gate. Before marking a PR ready for review, run make lint, make erigon integration, and GOGC=80 make test-all for the full local gate.

How to trigger GitHub Actions workflows on a branch that does not target main?

Use gh workflow run with the workflow name and --ref set to your branch. The Skill provides a loop that dispatches all dispatchable workflows including Unit tests, All tests, EEST spec tests, Hive, and the RPC integration tests.

Which Erigon CI workflows support workflow_dispatch?

Most workflows support dispatch, including Unit tests, All tests, EEST spec tests, Lint, Test Hive, Kurtosis Assertoor, and the RPC integration test variants. The Consensus spec workflow does not support dispatch and only fires on pull_request events targeting main or release.

Why should I use make eest-spec instead of the run-eest-spec-test.sh script?

The make target lists evm and evm.race as prerequisites so stale binaries get rebuilt before testing. Invoking the script directly skips this, and a stale binary against current fixtures can inflate failures or hide regressions.

When should I run the race detector tests in Erigon?

Run make test-all-race when your changes involve concurrency-sensitive code. It takes about 60 minutes and is recommended as an additional check after the standard local and remote gates pass.