Skip to content

tools: add searchable EVM error catalog for agents#166

Open
mrtdlgc wants to merge 1 commit into
austintgriffith:masterfrom
mrtdlgc:codex/add-revertwtf-tools-skill
Open

tools: add searchable EVM error catalog for agents#166
mrtdlgc wants to merge 1 commit into
austintgriffith:masterfrom
mrtdlgc:codex/add-revertwtf-tools-skill

Conversation

@mrtdlgc

@mrtdlgc mrtdlgc commented May 29, 2026

Copy link
Copy Markdown

Summary

  • Add revert.wtf to tools/SKILL.md as a searchable EVM/RPC/wallet/ERC-4337/x402 error catalog for agents
  • Document hosted API, read-only MCP, and client SDK entry points
  • Keep SKILL.md, README.md, openclaw-skill/SKILL.md, and the homepage Tools card in sync

Baseline

Tested with Opus 4.8 high and GPT-5.5 Pro on a realistic Ethereum debugging prompt covering:

  • Panic(uint256) code 0x11
  • AA23 reverted or OOG
  • HTTP 402 / insufficient_funds on eip155:8453
  • selector 0x08c379a0

Both models correctly decoded the common cases. So this PR does not try to teach basic revert decoding.

The gap: both models defaulted to hand-rolled app-side decoder tables and troubleshooting prose. Neither mentioned an existing searchable catalog, hosted HTTP API, MCP server, or client SDK.

Triage

  • 🟢 Common decode facts (Panic(0x11), AA23, Error(string), Base chain id): cut
  • 🔴 Current searchable catalog/API/MCP/client path: keep
  • 🔴 “Use the maintained catalog before hand-rolling decoder tables”: keep
  • 🟡 Bounded search / focused lookup / avoid dumping a full catalog into context or browser bundles: compressed into one agent-pattern paragraph

Placement

This belongs in tools/SKILL.md, not a new skill, because the baseline shows the missing piece is tool discovery. The models already know the common decoding concepts; they skip the maintained tool path.

Verification

  • POST https://revert.wtf/api/search returns bounded catalog results
  • POST https://revert.wtf/api/explain returns normalized explanations with evidence and next steps
  • POST /api/revert-decode, /api/aa-decode, and /api/selector return focused decoder results
  • @revertwtf/mcp is published on npm
  • git diff --check

@vercel

vercel Bot commented May 29, 2026

Copy link
Copy Markdown

@mrtdlgc is attempting to deploy a commit to the BuidlGuidl Team on Vercel.

A member of the Team first needs to authorize it.

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.

1 participant