erigon-implement-eip

Implements a new EIP for an Erigon hardfork from spec lookup through tests and wrap-up.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Implementing a new Ethereum Improvement Proposal in the Erigon client requires navigating EIP specs, fork meta documents, devnet deltas, and both execution-layer and consensus-layer test suites. This Skill structures that entire workflow so nothing is missed.

Core Features & Use Cases

  • Spec and dependency analysis: Fetches the EIP spec, referenced EIPs, hardfork meta EIPs, and optional devnet specs, then maps them to Erigon packages.
  • Guided implementation and validation: Checks for prior work, implements the change, runs make lint, and executes EEST spec test shards plus CL spectest suites.
  • Documented wrap-up: Produces a summary of touched files, design decisions, and test coverage saved to agentspecs/.
  • Use Case: Ask to implement EIP-7892 for the Amsterdam fork on devnet-3, and the Skill walks through spec analysis, code changes, devnet test shards, and a final summary.

Quick Start

Implement EIP-7892 for the Amsterdam fork using the devnet-3 specification and run the relevant devnet test shards.

Frequently Asked Questions about erigon-implement-eip

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

FAQPage Schema
How do I implement a new EIP in the Erigon client?

Provide the fork name, EIP number, and optionally a devnet name. The workflow fetches the EIP spec, maps it to Erigon packages, checks for prior implementations, makes the code changes, runs lint and spec tests, and saves a summary to agentspecs/.

Which tests should I run when implementing an EIP in Erigon?

Run the EEST spec test shards via make eest-spec-* targets, prioritizing the -devnet shards for the fork under development. If the EIP touches the consensus layer, also run the cl/spectest suite with the per-fork make target.

Does Erigon EIP implementation cover both execution and consensus layers?

Yes. Erigon contains both an EL implementation under the execution package and a CL implementation under the cl package, so EIPs affecting either or both layers are handled, including CL spec tests via cl/spectest.

Why do EEST devnet test shards show unexpected failures in Erigon?

A common cause is a stale evm binary when invoking tools/run-eest-spec-test.sh directly instead of the make target, which skips the rebuild. Always run shards via make eest-spec-<shard> so a fresh binary is built first.

What happens when a spec test contradicts the EIP specification?

The workflow instructs not to silently fix such tests. Instead it documents the discrepancy, since upstream reference implementations can contain bugs, and asks for review and new guidance before proceeding.