revertwtf-parser-decoder para Openclaw

Uma skill focada em desenvolvedores para analisar, normalizar e decodificar reverts de smart contracts EVM e falhas no ERC-4337.

mrtdlgc
v0.1.0
May 28, 2026
0
587
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install revertwtf-parser-decoder

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o revertwtf-parser-decoder usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é revertwtf-parser-decoder?

A skill revertwtf-parser-decoder fornece um utilitário altamente especializado para normalizar, analisar e decodificar reverts de smart contracts da Ethereum Virtual Machine (EVM), erros personalizados de ABI e falhas de Account Abstraction do ERC-4337. Ela processa payloads brutos de erro de transação hexadecimal e os traduz em explicações estruturadas e legíveis por humanos.

Otimizado para integração dentro do Openclaw Skills, este fluxo de trabalho mantém limites de pacote claros para evitar inchaço no bundle. Ele garante que catálogos de selector pesados em recursos fiquem restritos às interfaces de servidor e API, mantendo caminhos de parser leves e seguros para navegadores a salvo de inclusões acidentais de catálogo.

Casos de uso do revertwtf-parser-decoder

  • Depuração de reverts Solidity (incluindo erros de ABI personalizados, Error(string) padrão e códigos Panic(uint256)).
  • Análise de payloads de falha de entry-point de Account Abstraction do ERC-4337 (como FailedOp ou FailedOpWithRevert).
  • Normalização de erros complexos de provedor JSON-RPC e simulador em uma estrutura de dados unificada.
  • Construção de frontends leves e seguros para navegadores que aproveitam a decodificação de erro EVM sem agrupar índices de selector massivos.

Como o revertwtf-parser-decoder funciona

  1. Extração: A skill intercepta payloads de erro de provedor ou simulador aninhados e extrai bytes brutos de revert.
  2. Normalização: Códigos de erro, frames de rastreamento, mensagens e dicas de método são normalizados para formatos padrão.
  3. Correspondência de Catálogo: Bytes de revert são comparados com bancos de dados de assinatura e ABIs de contrato personalizados.
  4. Classificação e Explicação: Os resultados decodificados são classificados dinamicamente (priorização baseada em evidências) e compilados em explicações claras voltadas para o usuário.
  5. Bundling Seguro: Arquivos específicos para navegador protegem alvos de frontend contra payloads de catálogo completos, priorizando subcaminhos de micro-importação.

Configuração do revertwtf-parser-decoder

Pré-requisitos e Instalação

Certifique-se de ter configurado seu monorepo workspace corretamente e instale as dependências:

pnpm install

Executando Verificação de Tipos TypeScript

Verifique se os pacotes mantêm tipos de limite corretos e compile sem 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

Executando Testes Unitários

Execute as suítes de teste Vitest em diferentes pacotes:

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

Nota: Se você encontrar um erro spawn EPERM, relate ao seu ambiente de execução de agente e retorne para verificações de compilação tsc diretas juntamente com testes de fumaça Node direcionados.

Esquema de Dados e Taxonomia de revertwtf-parser-decoder

O codebase é organizado como um monorepo que aproveita subcaminhos distintos para importações otimizadas. Os principais arquivos e diretórios gerenciam o seguinte esquema de metadados:

Subcaminho do Pacote Funcionalidade Principal Arquivos de Destino
@revertwtf\parser Padroniza, extrai e decodifica payloads de revert EVM. normalizeError.ts, extractRevertData.ts, decodeRevertData.ts
@revertwtf\selectors Resolve assinaturas de função e corresponde selectors de erro. matchCatalog.ts
@revertwtf\aa Decodifica falhas de EntryPoint do ERC-4337 e logs de Account Abstraction. packages\aa\src\*
@revertwtf\core Compartilha estruturas principais e tipos de dados de resultado globalmente. packages\core\tsconfig.json

Recursos avançados do revertwtf-parser-decoder

  • Classificação Baseada em Evidências: Resultados decodificados usam lógica de classificação rigorosa para garantir que erros altamente específicos substituam wrappers genéricos.
  • Proteções de Bundle Seguras para Navegador: Implementa pontos de entrada browser*.ts para proteger bundlers de cliente contra a inclusão acidental de dados de catálogo completos.
  • Micro-Imports Otimizados: Suporta subcaminhos de importação leves como @revertwtf\parser\decode e @revertwtf\aa\explain para minimizar pegadas de memória de execução.
  • Consistência de Engine Unificada: Garante que CLI, servidor API e clientes de navegador resolvam os mesmos padrões de execução de forma idêntica.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*