RPCwright — Skill para Testes de Conformidade Ethereum JSON-RPC
MysticRyuujin/rpcwright
Orquestra testes de conformidade RPC cross-client no Ethereum
Ver no GitHubSkill Claude que ensina como implementar e testar mudanças na API JSON-RPC da camada de execução do Ethereum, coordenando testes entre clientes (go-ethereum, Nethermind, Besu, Erigon, Reth, ethrex), especificações e fixtures. Codifica a receita dourada, padrões de build/teste e armadilhas silenciosas que consomem horas de debug.
Instalação
npx convez-ai MysticRyuujin/rpcwright1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Implementar mudanças na API JSON-RPC da execution layer
- Gerar e validar fixtures de teste .io para compatibilidade entre clientes
- Executar testes de conformidade RPC em múltiplos clientes Ethereum
Veredito

Ferramental muito específico e técnico para engenheiros trabalhando em protocolos Ethereum. Valor alto para esse nicho, mas escopo restrito — excelente documentação e exemplos práticos de end-to-end.
README
A tradução para o português deste README ainda está na fila.
rpcwright 🔧
A wright is a maker — a shipwright builds ships, a playwright builds plays. A rpcwright builds (and proves) Ethereum JSON-RPC.
rpcwright is a Claude 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) | 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
SKILL.md— the mental model, the golden-path recipe, and the gotchas that cost hours.references/go-ethereum.md— build, test, RPC method & optional-parameter patterns, in-process RPC test harness.references/execution-apis.md— OpenRPC YAML,specgen/openrpc.json,speccheck, and therequiredsemantics.references/testgen.md—rpctestgen,make fill, the.ioformat, generating fixtures with a local client, determinism.references/hive.md— therpc-compatsimulator, local fixtures, building clients from source, client-files, the--sim.limittrap, reading results.references/clients.md— per-client handler locations and local-build notes (go-ethereum & Nethermind verified; Besu, Erigon, Reth, ethrex guidance).references/gotchas.md— the full catalog.references/worked-example.md— a complete change end to end (default an omitted block param tolatest), including a real cross-client bug found and fixed.
Install
Claude Code plugin (no clone)
/plugin marketplace add MysticRyuujin/rpcwright
/plugin install rpcwright@rpcwright
Manual (personal skill)
Personal skills live under ~/.claude/skills/. Clone into place:
git clone https://github.com/MysticRyuujin/rpcwright.git ~/.claude/skills/rpcwright
Or symlink a working copy:
git clone https://github.com/MysticRyuujin/rpcwright.git
ln -s "$PWD/rpcwright" ~/.claude/skills/rpcwright
Claude 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 other
agent tooling discovers the same content.
Scope
The execution-apis + testgen + hive workflow is client-agnostic. The client-specific guidance is verified for go-ethereum and Nethermind and is best-effort guidance for Besu, Erigon, Reth, and ethrex — contributions to verify and extend those are welcome.
License
MIT — see LICENSE.