| name | erigon-ci |
| description | Run Erigon CI checks locally and/or trigger them remotely on a branch via GitHub Actions workflow_dispatch.
Use this when you need to verify a branch passes all CI before or after pushing — especially for branches
like bal-devnet-2 that don't auto-trigger on push/PR events.
|
Erigon CI Skill
Orchestrates CI verification: run test groups locally and/or dispatch GitHub Actions on any branch.
Each test group has its own dedicated skill for drill-down on failures. Use those when a specific group fails and you need to re-run individual tests.
Local Test Groups
| Group | Skill | Command | Speed | Use When |
|---|
| lint | (inline) | make lint | ~1 min | Before every push |
| unit | erigon-test-unit | make test-short | ~5 min | Pre-push gate |
| all | erigon-test-all | GOGC=80 make test-all | ~30 min | Before PR review |
| race | erigon-test-race | make test-all-race | ~60 min | Concurrency changes |
| eest-spec | (inline) | make eest-spec-<suite>-<fixtures>[-{sequential,parallel}] | varies | EEST state/blockchain/engine-x changes (most shards split into -sequential / -parallel pairs that pin ERIGON_EXEC3_PARALLEL; see tools/eest-spec-shards.yml) |
| caplin spec | (inline) | cd cl/spectest && make tests && make mainnet | ~15 min | CL/consensus changes |
| hive | erigon-test-hive | make test-hive | ~20 min | EL/CL interop changes |
| rpc | erigon-test-rpc | (requires synced DB) | ~10 min | RPC API changes |
| assertoor | (remote only) | dispatch only | — | Kurtosis network test |
make test-all no longer covers the EEST spec tests or the cl/spectest consensus spec test — run those via their dedicated targets above when relevant.
Pitfall: prefer make eest-spec-<shard> over bash tools/run-eest-spec-test.sh <shard>. The make target lists evm / evm.race as a prereq so stale binaries get rebuilt; the script invoked directly does not, and a stale binary against current fixtures will inflate failures or hide regressions.
Lint (run first — non-deterministic, may need multiple runs)
make lint
Quick gate (before pushing a fix)
make lint && make test-short
Full gate (before marking PR ready for review)
make lint && make erigon integration && GOGC=80 make test-all
Race check (for concurrency-sensitive changes)
make lint && make test-all-race
Part 2: Remote Dispatch (trigger CI on any branch)
Use gh workflow run to trigger workflows on a branch. Required for branches not targeting main (e.g. bal-devnet-2).
Dispatch all workflows on a branch
BRANCH=$(git branch --show-current)
for wf in \
"Unit tests" \
"All tests" \
"EEST spec tests" \
"Lint" \
"Test Hive" \
"Kurtosis Assertoor GitHub Action" \
"QA - RPC Integration Tests" \
"QA - RPC Integration Tests Remote" \
"QA - RPC Integration Tests (Gnosis)" \
"Windows downloader tests"; do
echo "Dispatching: $wf"
gh workflow run "$wf" --ref $BRANCH
done
Workflow dispatch support
| Workflow name (GitHub) | dispatch? | Local skill | File |
|---|
| Unit tests | yes | erigon-test-unit | ci.yml |
| All tests | yes | erigon-test-all | test-all-erigon.yml |
| EEST spec tests | yes | (make eest-spec-…) | test-eest-spec.yml |
| Lint | yes | (make lint) | lint.yml |
| Test Hive | yes | erigon-test-hive | test-hive.yml |
| Kurtosis Assertoor GitHub Action | yes | (remote only) | test-kurtosis-assertoor.yml |
| QA - RPC Integration Tests | yes | erigon-test-rpc | qa-rpc-integration-tests.yml |
| QA - RPC Integration Tests Remote | yes | erigon-test-rpc | qa-rpc-integration-tests-remote.yml |
| QA - RPC Integration Tests (Gnosis) | yes | erigon-test-rpc | qa-rpc-integration-tests-gnosis.yml |
| Windows downloader tests | yes | (remote) | test-win-downloader.yml |
| Consensus spec | no | (PR-only) | test-integration-caplin.yml |
Note: Consensus spec has no workflow_dispatch — only fires on pull_request events targeting main/release.
Monitor runs
BRANCH=$(git branch --show-current)
gh run list --branch $BRANCH --limit 15
Check for failures:
gh run list --branch $BRANCH --limit 20 | grep -E "failure|cancelled"
Watch a specific run:
gh run watch <run-id>
Part 3: Full CI Gate (local + remote)
When preparing a devnet/feature branch for review:
-
Local gate — fast feedback before pushing:
make lint && make erigon integration && make test-short
-
Push branch:
git push origin <branch>
-
Dispatch all remote workflows (use the loop from Part 2).
-
Monitor until all pass:
gh run list --branch $(git branch --show-current) --limit 15
-
Race check (for concurrency-heavy changes):
make test-all-race
