convez.ai
SkillDevOps & InfraestruturaAvançado
MysticRyuujin

RPCwright — Skill para Testes de Conformidade Ethereum JSON-RPC

MysticRyuujin/rpcwright

Orquestra testes de conformidade RPC cross-client no Ethereum

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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/rpcwright

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 6 dias
Versão
—
Issues abertas
0
Contribuidores
1

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:

reporole
the client (go-ethereum, Nethermind, Besu, Erigon, Reth, ethrex)implements the method
execution-apisthe OpenRPC spec (the contract)
testgen / rpctestgengenerates .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 the required semantics.
  • references/testgen.md — rpctestgen, make fill, the .io format, generating fixtures with a local client, determinism.
  • references/hive.md — the rpc-compat simulator, local fixtures, building clients from source, client-files, the --sim.limit trap, 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 to latest), 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.

Ver o original no GitHub

Bom para

Relacionados