What problem does it solve?
Running a throwaway Erigon node for testing or debugging normally requires manually picking non-conflicting ports, creating temp datadirs, and remembering to clean up processes and data afterward. This Skill automates that entire lifecycle so a sandboxed instance can be started and removed safely alongside any existing node.
Core Features & Use Cases
- Ephemeral Datadir Creation: Creates a unique temp datadir via
mktemp, either empty or cloned from an existing datadir using copy-on-write.
- Automatic Port Offsetting: Detects port conflicts with
lsof and offsets all Erigon ports (+100, +200, +300) across HTTP, WebSocket, Engine API, torrent, devp2p, Caplin, and sentinel ports.
- Lifecycle Cleanup: Kills the background process and deletes the datadir on request, and can scan for leftover ephemeral datadirs and processes from previous sessions.
- Use Case: A developer wants to test a new flag against a dev chain without touching their main node. The Skill spins up a second Erigon instance on offset ports, prints the exact launch command, and later tears everything down.
Quick Start
Start a temporary Erigon instance with a fresh datadir for quick testing, using ports that do not conflict with my running node.
