Skip to content

claude: add erigon-network-ports skill#18992

Merged
wmitsuda merged 1 commit into
mainfrom
wmitsuda/teach-claude-about-erigon-ports
Feb 6, 2026
Merged

claude: add erigon-network-ports skill#18992
wmitsuda merged 1 commit into
mainfrom
wmitsuda/teach-claude-about-erigon-ports

Conversation

@wmitsuda

@wmitsuda wmitsuda commented Feb 5, 2026

Copy link
Copy Markdown
Member

Summary

  • Adds a new Claude Code skill documenting all Erigon network ports that must differ when running multiple instances on the same machine
  • Covers 12 always-on ports and 2 conditional ports (pprof, metrics) with CLI flags, defaults, and protocols
  • Includes a ready-to-use two-instance example with +100 port offsets

Test plan

  • Verified by running two Erigon instances simultaneously with offset ports — both synced for 2+ minutes with zero errors
  • Confirmed the second instance fails with bind: address already in use when using the same ports as the first

🤖 Generated with Claude Code

…ment

Documents all 12 always-on and 2 conditional network ports that must
differ when running multiple Erigon instances on the same machine.
Includes CLI flag reference, defaults, protocols, and a ready-to-use
two-instance example with +100 port offsets.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@wmitsuda wmitsuda enabled auto-merge (squash) February 5, 2026 23:20
@wmitsuda

wmitsuda commented Feb 5, 2026

Copy link
Copy Markdown
Member Author

This skill teaches Claude to run erigon and solve port conflicts automatically. Useful when I already have other erigon instances running on my machine and want to spinoff an ephemeral instance to validate some plan.

@wmitsuda wmitsuda merged commit 19f010a into main Feb 6, 2026
18 checks passed
@wmitsuda wmitsuda deleted the wmitsuda/teach-claude-about-erigon-ports branch February 6, 2026 00:36
@AskAlexSharov

Copy link
Copy Markdown
Collaborator

@wmitsuda

wmitsuda commented Feb 6, 2026

Copy link
Copy Markdown
Member Author

I think the next step should be to have AI update our docs by scrapping our code instead of telling it to look at the (maybe outdated) docs.

mattevans added a commit to ethpandaops/erigone-legacy that referenced this pull request Feb 6, 2026
* upstream/main: (91 commits)
  perf(cl/block_collector): optimize encodeBlock buffer allocation (erigontech#18980)
  db/kv: fix code cache hash key computation (erigontech#18965)
  Fix hive tests 0302 (erigontech#18986)
  perf(execution/types): optimize EIP-7685 request encoding (erigontech#18985)
  refactor: replace interface{} with any for clarity and modernization (erigontech#18978)
  refactor: replace interface{} with any for clarity and modernization (erigontech#18977)
  Rework Dockerhub API call authorization mechanism. (erigontech#18989)
  claude: add erigon-network-ports skill (erigontech#18992)
  PersistentBlockCollector: assert on inserting gap (erigontech#18979)
  qa-tests: add Geth test to the RPC Historic Performance Tests (erigontech#18895)
  a bit less debug logs (erigontech#18974)
  ProcessFrozenBlocks: to support `isDomainAheadOfBlocks` (which we have in `fcu`) (erigontech#18981)
  qa-tests: fix summary in RPC Performance Tests Latest (erigontech#18984)
  handle edge case for genesis block in SeekCommitment (erigontech#18960)
  db/preverified: remove redundant assertSorted in Get (erigontech#18967)
  txnprovider/shutter: fix identity preimage DecodeSSZ error length (erigontech#18938)
  perf(cl/sentinel): use stack allocation for light_client response prefix (erigontech#18961)
  Add debug.SetupSimple, and improve torrent client status info log (erigontech#18953)
  Refactor worker count calculation to remove redundant bounds check (erigontech#18415)
  fix: remove duplicate TxPoolBlobPriceBumpFlag check in setTxPool (erigontech#18472)
  ...
Giulio2002 pushed a commit that referenced this pull request Feb 6, 2026
## Summary
- Adds a new Claude Code skill documenting all Erigon network ports that
must differ when running multiple instances on the same machine
- Covers 12 always-on ports and 2 conditional ports (pprof, metrics)
with CLI flags, defaults, and protocols
- Includes a ready-to-use two-instance example with +100 port offsets

## Test plan
- [x] Verified by running two Erigon instances simultaneously with
offset ports — both synced for 2+ minutes with zero errors
- [x] Confirmed the second instance fails with `bind: address already in
use` when using the same ports as the first

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants