Skip to content
MysticRyuujinPublic

About

A Claude Skill for engineering & conformance-testing Ethereum JSON-RPC (execution-apis) changes across EL clients — go-ethereum, Nethermind, Besu, Erigon, Reth, ethrex.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

rpcwright 🔧

A wright is a maker — a shipwright builds ships, a playwright builds plays. A rpcwright builds (and proves) Ethereum JSON-RPC.

rpcwright is an agent skill that teaches an AI agent how to implement and conformance-test a change to the Ethereum execution-layer JSON-RPC API — across the four repos that have to agree:

repo role
the client (go-ethereum, Nethermind, Besu, Erigon, Reth, ethrex, Nimbus) implements the method
execution-apis the OpenRPC spec (the contract)
testgen / rpctestgen generates .io fixtures from a real client
hive (rpc-compat) replays fixtures against every client

The one-line behavior change is easy. The hard part is the build/test plumbing and the dozen places a silent failure hides — a green hive run that executed zero tests, a fixture that passes validation only because the param was still "required", a harness quietly testing the upstream image instead of your change. This skill encodes the exact commands and those gotchas so future sessions don't rediscover them the slow way.

What's inside

Install

Claude Code and Codex both read the same format — a directory with a SKILL.md — so one copy serves both. Only the directory each one scans differs:

tool personal scope repo scope explicit call
Claude Code ~/.claude/skills/ .claude/skills/ /rpcwright
Codex ~/.agents/skills/ .agents/skills/ $rpcwright, or /skills

Claude Code plugin (no clone)

/plugin marketplace add MysticRyuujin/rpcwright
/plugin install rpcwright@rpcwright

Manual (personal skill)

Clone once, then symlink it into the tools you use. Both follow a symlinked skill directory, so a single git pull updates every tool:

git clone https://github.com/MysticRyuujin/rpcwright.git
mkdir -p ~/.claude/skills ~/.agents/skills
ln -s "$PWD/rpcwright" ~/.claude/skills/rpcwright   # Claude Code
ln -s "$PWD/rpcwright" ~/.agents/skills/rpcwright   # Codex

Either tool discovers the skill from its SKILL.md frontmatter and loads it when a task involves the Ethereum JSON-RPC API, execution-apis, rpctestgen/testgen, .io fixtures, speccheck, openrpc.json, or hive rpc-compat.

AGENTS.md, CLAUDE.md, and llms.txt are symlinks to SKILL.md, so a repo that vendors rpcwright at its root also picks it up as plain project instructions.

Scope

The skill covers changes and reviews across six execution clients, execution-apis, testgen, and Hive. Use only the stages required by the task. Confirm paths, toolchain pins, and historical observations against the selected revisions.

License

MIT — see LICENSE.

About

A Claude Skill for engineering & conformance-testing Ethereum JSON-RPC (execution-apis) changes across EL clients — go-ethereum, Nethermind, Besu, Erigon, Reth, ethrex.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages