适用于 Openclaw 的 revertwtf-parser-decoder

一个面向开发者的技能,用于解析、标准化和解码 EVM 智能合约 revert 和 ERC-4337 失败信息。

mrtdlgc
v0.1.0
2026年5月28日
0
587
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install revertwtf-parser-decoder

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 revertwtf-parser-decoder。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 revertwtf-parser-decoder?

revertwtf-parser-decoder 技能提供了一种高度专业化的工具,用于标准化、解析和解码以太坊虚拟机 (EVM) 智能合约 revert、自定义 ABI 错误以及 ERC-4337 账户抽象失败。它处理原始十六进制交易错误载荷,并将其转换为结构化、人类可读的解释。

针对 Openclaw Skills 集成进行了优化,此工作流保持了清晰的包边界以防止 bundle 膨胀。它确保资源密集型的 selector 目录仅限于服务器和 API 接口,同时保护轻量级、浏览器友好的解析器路径免受意外的目录包含影响。

revertwtf-parser-decoder 应用场景

  • 调试 Solidity revert(包括自定义 ABI 错误、标准 Error(string) 和 Panic(uint256) 代码)。
  • 解析 ERC-4337 账户抽象入口点失败载荷(如 FailedOp 或 FailedOpWithRevert)。
  • 将复杂的 JSON-RPC 提供程序和模拟器错误标准化为统一的数据结构。
  • 构建轻量级、浏览器友好的前端,利用 EVM 错误解码功能,而无需打包庞大的 selector 索引。

revertwtf-parser-decoder 工作原理

  1. 提取: 该技能拦截嵌套的提供程序或模拟器错误载荷并提取原始 revert 字节。
  2. 标准化: 错误代码、追踪帧、消息和方法提示被标准化为标准格式。
  3. 目录匹配: 将 revert 字节与签名数据库和自定义合约 ABI 进行匹配。
  4. 排序与解释: 解码结果经过动态排序(基于证据的优先级),并编译成清晰的用户可读解释。
  5. 安全打包: 浏览器专用文件保护前端目标免受完整目录载荷的影响,优先使用微导入子路径。

revertwtf-parser-decoder 配置指南

前提条件与安装

确保您已正确配置 monorepo 工作空间并安装依赖:

pnpm install

运行 TypeScript 类型验证

验证包是否保持正确的边界类型并进行编译而不输出代码:

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

运行单元测试

在不同包中执行 Vitest 测试套件:

pnpm --filter @revertwtf\parser test
pnpm --filter @revertwtf\aa test
pnpm --filter @revertwtf\selectors test

注意:如果遇到 spawn EPERM 错误,请向您的代理运行环境报告,并回退到直接的 tsc 编译检查以及针对性的 Node smoke 测试。

revertwtf-parser-decoder 数据架构与分类体系

代码库被组织为一个 monorepo,利用不同的子路径进行优化导入。关键文件和目录管理以下元数据模式:

包子路径 主要功能 目标文件
@revertwtf\parser 标准化、提取并解码 EVM revert 载荷。 normalizeError.ts, extractRevertData.ts, decodeRevertData.ts
@revertwtf\selectors 解析函数签名并匹配错误 selector。 matchCatalog.ts
@revertwtf\aa 解码 ERC-4337 EntryPoint 失败和账户抽象日志。 packages\aa\src\*
@revertwtf\core 全局共享核心结构和结果数据类型。 packages\core\tsconfig.json

revertwtf-parser-decoder 高级特性

  • 基于证据的排序: 解码结果使用严格的排序逻辑,确保高度具体的错误优先于宽泛的包装器。
  • 浏览器安全打包保护: 实现 browser*.ts 入口点,保护客户端 bundler 免于意外引入完整目录数据。
  • 优化微导入: 支持轻量级导入子路径,如 @revertwtf\parser\decode 和 @revertwtf\aa\explain,以最小化执行内存占用。
  • 统一引擎一致性: 确保 CLI、API 服务器和浏览器客户端以相同方式解析执行模式。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*