
Um ofuscador de JavaScript baseado em técnicas de ofuscação de indistinguibilidade criptográfica.
Este projeto não alcança indistinguibilidade de ofuscação. Você não deveria estar usando este produto para proteger segredos. Ele existe para dificultar a engenharia reversa, não para impedi-la
Um ofuscador de JavaScript projetado para tornar o código extremamente difícil de ler e analisar tanto para humanos quanto para LLMs. Escrito em TypeScript. Implementa técnicas de pesquisas revisadas por pares sobre ofuscação criptográfica.
Node.js 24 é o padrão (veja .nvmrc); Node.js 26 também funciona.
O intervalo suportado é ^24.15.0 || ^26.0.0. Node.js 22 e anteriores não
são suportados.
engine-strict=true em .npmrc faz com que npm install rejeite uma versão
não suportada de imediato, em vez de falhar mais tarde com um erro obscuro.
nvm use # picks up .nvmrc
npm install -g egodeath # CLI
npm install egodeath # library
const { obfuscate, obfuscateMultiple } = require('egodeath');
const out = obfuscate(sourceCode, { targetTokens: 10000 });
npm install
npm run build
node dist/cli.js input.js > output.js
# Basic usage
npx egodeath input.js > output.js
# With target token budget (default: 2,000,000)
npx egodeath --target-tokens 500000 input.js > output.js
# Minimal obfuscation (small output)
npx egodeath --target-tokens 10000 input.js > output.js
# Maximum bloat (10M tokens)
npx egodeath --target-tokens 10000000 input.js > output.js
# Using environment variable
INPUT_FILE=input.js npx egodeath > output.js
# Help
npx egodeath --help
| Opção | Padrão | Descrição |
|---|---|---|
--target-tokens <n> | 2000000 | Tamanho alvo da saída em tokens. Entradas pequenas são infladas até esse limite. Entradas grandes produzem menos inflação para permanecer dentro do orçamento. |
--help, -h | Exibir mensagem de ajuda |
npm run build # Compile TypeScript to dist/
npm run start # Run the obfuscator (reads input.js)
npm run test # Run the test suite
npm run typecheck # Type check application, tests, and tools
npm run obfuscate-package # Run compatibility tests against npm packages
const { obfuscate } = require('./dist/obfuscator');
const code = 'function add(a, b) { return a + b; }';
const obfuscated = obfuscate(code);
// With options
const obfuscated = obfuscate(code, { targetTokens: 500000 });
O ofuscador aplica 20 transformações em 4 fases. Cada estágio se baseia no anterior.
| Ordem | Transformação | Arquivo | Descrição |
|---|---|---|---|
| 1 | Armadilhas Anti-Debug | transforms/antiDebug.ts | Injeta instruções eval("debugger") e 10-20 laços setInterval com intervalos de números primos (5s-600s) que acionam repetidamente pontos de interrupção do depurador. Cada instância usa strings codificadas exclusivas. |
| 2 | Fios de Armadilha de Programa Perfurado | transforms/tripwires.ts | Incorpora verificações ocultas que comparam hashes de parâmetros com valores secretos. 5 padrões de hash (impressão digital bit a bit, aritmética modular, charCodeAt, hash numérico, typeof+length). Aciona corrupção silenciosa de estado, laços ocupados ou lança exceções em entradas secretas. [Paper 4] |
| 3 | Injeção de Ruído LPN | transforms/noiseInjection.ts | Adiciona e cancela ruído aleatório por meio de caminhos divididos em cálculos aritméticos. 6 padrões: add/sub, XOR, mul/div, divisão de variável dupla, cadeia de hash computada, rotação de bits. Valores intermediários são sem sentido sem rastrear o cancelamento completo. [Paper 7] |
| Ordem | Transformação | Arquivo | Descrição |
|---|---|---|---|
| 4 | Achatamento de Fluxo de Controle | transforms/controlFlowFlattening.ts | Converte corpos de funções em máquinas de estado while(true) { switch((_s * P) % M) { ... } } com despacho por aritmética modular — os valores dos casos são codificados por meio de (stateId * multiplier) % modulus usando parâmetros primos aleatórios. [Paper 3] |
| 5 | Predicados Opacos | transforms/opaquePredicates.ts | Injeta condições if que sempre avaliam para verdadeiro ou falso, mas são matematicamente difíceis de provar (por exemplo, (x*x+x)%2===0). 15 fórmulas de predicados nas categorias de aritmética modular, bit a bit e verificação de tipo. |
| 6 | Funções Proxy | transforms/proxyFunctions.ts | Roteia todas as chamadas de função por meio de dois despachantes: _fc(fn, ...args) para chamadas simples, _mc(obj, prop)(...args) para chamadas de método, preservando a busca do método antes da avaliação dos argumentos. Usa Function.prototype.apply capturado em uma variável local para resiliência. |
| 7 | Esgotamento da Janela de Contexto | transforms/contextExhaustion.ts | Envolve expressões em ternários profundamente aninhados com condições opacas, cadeias de expressões void e preenchimento condicional void. Força os LLMs a desperdiçar tokens da janela de contexto com ruído. |
| 8 | Mesclagem de Expressões com Vírgula | transforms/commaExpressions.ts | Colapsa instruções de expressão consecutivas em expressões com vírgula únicas: a(); b(); return c() torna-se return a(), b(), c(). |
| Ordem | Passagem | Arquivo | Descrição |
|---|---|---|---|
| 9 | Passagem 1: Catálogo | passes/firstPass.ts | Percorre a AST e cataloga cada identificador, construindo um mapa de globais que atribui a cada um um nome Unicode aleatório de 6 a 16 caracteres extraído de 16 intervalos de escrita (CJK, Hangul, Grego, Cirílico, Devanágari, Tailandês, Árabe, Katakana, etc.). |
| 10 | Passagem 2: Substituição | passes/secondPass.ts | Substitui todos os nomes de identificadores por seus equivalentes Unicode ofuscados. Codifica argumentos de require() como String.fromCharCode(...). Codifica fontes estáticas de import/export como literais de string com escape Unicode. Substitui referências de superClass de classes, expressões de template literal, padrões de desestruturação. |
| 11 | Passagem 3: Parâmetros Fictícios | passes/thirdPass.ts | Injeta de 0 a 15 parâmetros não utilizados com valores padrão, preservando a aridade. Ignora parâmetros rest, diretivas estritas, parâmetros duplicados e corpos que referenciam arguments ou eval. Remove todos os comentários. |