revertwtf-parser-decoder para Openclaw

Una skill centrada en el desarrollador para analizar, normalizar y decodificar reverts de smart contracts de EVM y fallos de ERC-4337.

mrtdlgc
v0.1.0
May 28, 2026
0
587
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install revertwtf-parser-decoder

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar revertwtf-parser-decoder usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es revertwtf-parser-decoder?

La skill revertwtf-parser-decoder proporciona una utilidad altamente especializada para normalizar, analizar y decodificar reverts de smart contracts de Ethereum Virtual Machine (EVM), errores de ABI personalizados y fallos de Account Abstraction de ERC-4337. Procesa payloads brutos de errores de transacción en hexadecimal y los traduce a explicaciones estructuradas y legibles para humanos.

Optimizado para la integración dentro de Openclaw Skills, este flujo de trabajo mantiene límites de paquetes claros para evitar el aumento del tamaño del bundle. Asegura que los catálogos de selector intensivos en recursos se limiten a interfaces de servidor y API, mientras mantiene las rutas del parser ligeras y seguras para el navegador, a salvo de inclusiones accidentales del catálogo.

Casos de uso de revertwtf-parser-decoder

  • Depuración de reverts de Solidity (incluyendo errores de ABI personalizados, Error(string) estándar y códigos Panic(uint256)).
  • Análisis de payloads de fallos en entry-point de Account Abstraction de ERC-4337 (como FailedOp o FailedOpWithRevert).
  • Normalización de errores complejos de proveedor JSON-RPC y simulador en una estructura de datos unificada.
  • Construcción de frontends ligeros y seguros para el navegador que aprovechan la decodificación de errores de EVM sin empaquetar índices de selector masivos.

Cómo funciona revertwtf-parser-decoder

  1. Extracción: La skill intercepta payloads de error anidados de proveedores o simuladores y extrae los bytes brutos de revert.
  2. Normalización: Los códigos de error, los frames de seguimiento, los mensajes y las sugerencias de métodos se normalizan a formatos estándar.
  3. Coincidencia de catálogo: Los bytes de revert se comparan con bases de datos de firmas y ABIs de contrato personalizados.
  4. Ranking y explicación: Los resultados decodificados se clasifican dinámicamente (priorización basada en evidencia) y se compilan en explicaciones claras orientadas al usuario.
  5. Bundling seguro: Los archivos específicos para el navegador protegen los destinos frontend contra payloads de catálogo completos, priorizando subrutas de micro-importación.

Configuración de revertwtf-parser-decoder

Requisitos previos e instalación

Asegúrese de haber configurado correctamente su monorepo workspace e instale las dependencias:

pnpm install

Ejecución de verificación de tipos TypeScript

Verifique que los paquetes mantengan tipos de límites correctos y compile sin emitir código:

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

Ejecución de pruebas unitarias

Ejecute los conjuntos de pruebas de Vitest en los diferentes paquetes:

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

Nota: Si encuentra un error spawn EPERM, infórmelo a su entorno de ejecución del agente y vuelva a las comprobaciones de compilación tsc directas junto con pruebas de humo de Node específicas.

Esquema de datos y taxonomía de revertwtf-parser-decoder

La base de código está organizada como un monorepo que aprovecha subrutas distintas para importaciones optimizadas. Los archivos y directorios clave gestionan el siguiente esquema de metadatos:

Subruta del paquete Funcionalidad principal Archivos de destino
@revertwtf\parser Estandariza, extrae y decodifica payloads de revert de EVM. normalizeError.ts, extractRevertData.ts, decodeRevertData.ts
@revertwtf\selectors Resuelve firmas de funciones y coincide selectors de errores. matchCatalog.ts
@revertwtf\aa Decodifica fallos de EntryPoint de ERC-4337 y logs de Account Abstraction. packages\aa\src\*
@revertwtf\core Comparte estructuras principales y tipos de datos de resultados globalmente. packages\core\tsconfig.json

Funciones avanzadas de revertwtf-parser-decoder

  • Ranking basado en evidencia: Los resultados decodificados utilizan una lógica de ranking rigurosa para garantizar que los errores altamente específicos anulen a los envoltorios genéricos.
  • Protecciones de bundle seguras para el navegador: Implementa puntos de entrada browser*.ts para proteger a los bundlers del cliente contra la inclusión accidental de datos de catálogo completos.
  • Micro-imports optimizados: Admite subrutas de importación ligeras como @revertwtf\parser\decode y @revertwtf\aa\explain para minimizar la huella de memoria de ejecución.
  • Consistencia de motor unificada: Garantiza que el CLI, el servidor de API y los clientes de navegador resuelvan los mismos patrones de ejecución de forma idéntica.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Github Stars: 0
forks: 0

Presentado*