A developer-focused skill for parsing, normalizing, and decoding EVM smart contract reverts and ERC-4337 failures.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install revertwtf-parser-decoder
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install revertwtf-parser-decoder using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is revertwtf-parser-decoder?
The revertwtf-parser-decoder skill provides a highly specialized utility for normalizing, parsing, and decoding Ethereum Virtual Machine (EVM) smart contract reverts, custom ABI errors, and ERC-4337 Account Abstraction failures. It processes raw hexadecimal transaction error payloads and translates them into structured, human-readable explanations.
Optimized for integration within Openclaw Skills, this workflow maintains clear package boundaries to prevent bundle bloat. It ensures that resource-heavy selector catalogs are confined to server and API interfaces while keeping lightweight, browser-safe parser paths safe from accidental catalog inclusions.
revertwtf-parser-decoder Use Cases
- Debugging Solidity reverts (including custom ABI errors, standard
Error(string), andPanic(uint256)codes). - Parsing ERC-4337 Account Abstraction entry-point failure payloads (such as
FailedOporFailedOpWithRevert). - Normalizing complex JSON-RPC provider and simulator errors into a unified data structure.
- Constructing lightweight, browser-safe frontends that leverage EVM error decoding without bundling massive selector indices.
How revertwtf-parser-decoder Works
- Extraction: The skill intercepts nested provider or simulator error payloads and extracts raw revert bytes.
- Normalization: Error codes, trace frames, messages, and method hints are normalized into standard formats.
- Catalog Matching: Revert bytes are matched against signature databases and custom contract ABIs.
- Ranking & Explanation: Decoded results are ranked dynamically (evidence-backed prioritization) and compiled into clear user-facing explanations.
- Safe Bundling: Browser-specific files protect frontend targets from full catalog-backed payloads, prioritizing micro-import subpaths.
revertwtf-parser-decoder Setup
Prerequisites and Installation
Ensure you have configured your monorepo workspace correctly and install dependencies:
pnpm install
Running TypeScript Type Verification
Verify that packages maintain correct boundary types and compile without emitting code:
node node_modules/typescript/bin/tsc -p packages/core/tsconfig.json --noEmit
node node_modules/typescript/bin/tsc -p packages/selectors/tsconfig.json --noEmit
node node_modules/typescript/bin/tsc -p packages/parser/tsconfig.json --noEmit
node node_modules/typescript/bin/tsc -p packages/aa/tsconfig.json --noEmit
Running Unit Tests
Execute the Vitest test suites across different packages:
pnpm --filter @revertwtf/parser test
pnpm --filter @revertwtf/aa test
pnpm --filter @revertwtf/selectors test
Note: If you encounter a spawn EPERM error, report it to your agent runner environment and fall back to direct tsc compilation checks alongside targeted Node smoke tests.
revertwtf-parser-decoder Data Schema & Taxonomy
The codebase is organized as a monorepo leveraging distinct subpaths for optimized imports. The key files and directories manage the following metadata schema:
| Package Subpath | Primary Functionality | Target Files |
|---|---|---|
@revertwtf/parser |
Standardizes, extracts, and decodes EVM revert payloads. | normalizeError.ts, extractRevertData.ts, decodeRevertData.ts |
@revertwtf/selectors |
Resolves function signatures and matches error selectors. | matchCatalog.ts |
@revertwtf/aa |
Decodes ERC-4337 EntryPoint failures and Account Abstraction logs. | packages/aa/src/* |
@revertwtf/core |
Shares core structures and result data types globally. | packages/core/tsconfig.json |
revertwtf-parser-decoder Advanced Features
- Evidence-Based Ranking: Decoded results use rigorous ranking logic to ensure highly specific errors override broad wrappers.
- Browser-Safe Bundle Protections: Implements
browser*.tsentry points to guard client bundlers against accidentally pulling in full-catalog data. - Optimized Micro-Imports: Supports lightweight import subpaths like
@revertwtf/parser/decodeand@revertwtf/aa/explainto minimize execution memory footprints. - Unified Engine Consistency: Guarantees that CLI, API server, and browser clients resolve the same execution patterns identically.
SKILL.md
Loading
Related Openclaw Skills
OPC Three Meetings Governance System Skill
A high-performance multi-agent framework that replicates an executive governance structure with 24 specialized AI agents representing private boards, councils, and expert committees.
opc-technical-due-diligence
A rigorous technical due diligence and risk screening skill designed to evaluate feasibility, cross-check credentials, and uncover artificial hype in tech investments.
OPC M&A Connection Skill
A highly tactical outreach agent workflow designed to identify target public company stakeholders, compile compliant dossiers, and execute step-by-step communication pathways.
OPC Equity Cooperation Mechanism Skill
An advanced operational partnership framework designed to establish virtual Special Purpose Vehicles (SPVs) for temporary teams, legal compliance, and dynamic contribution-based profit distribution.
BibTeX Literature Review
An AI-driven workflow that automatically converts BibTeX, RIS, and other citation formats into professionally formatted Word literature reviews with superscript, clickable cross-references.
Revert.wtf MCP Server
A read-only Model Context Protocol (MCP) server that empowers AI agents to decode, search, and explain EVM, RPC, and Account Abstraction (AA) errors with catalog-backed accuracy.
Featured*
