Sobre o projeto

FlashLoanArbitrage é um projeto amador publicado com um README que descreve um bot de arbitragem orientado por script para mercados DeFi. O artefato principal é o goflash.js, um programa Node.js executado localmente via terminal, juntamente com um package.json que lista três dependências: ethers (biblioteca Ethereum), inquirer (prompts interativos de CLI) e chalk (saída de console colorida). Como é descrito seu funcionamento O README afirma que o bot monitora o preço de ETH/USDC em cinco fontes: Chainlink como referência de oráculo, além de Uniswap V2, SushiSwap, Curve Finance e Balancer como locais de negociação. Os preços são consultados em um ciclo de 60 segundos, e uma ação de arbitragem só é tentada quando a diferença entre os locais atinge 0,9% ou mais. O README observa explicitamente que tais spreads são raros em mercados reais e que o script pode exibir uma oportunidade simulada para fins de demonstração. Quando o limite é atingido, o README afirma que o fluxo é: tomar um flash loan denominado em USDC, comprar ETH no local mais barato, vendê-lo no mais caro, pagar o empréstimo acrescido de taxas e gas, e então converter o lucro restante em USDC de volta para ETH. Quatro fontes de flash loan são listadas com suas respectivas taxas e tamanhos máximos de empréstimo indicativos: Aave (0,05%, até 10.000.000 USDC), dYdX (0,05%, até 500.000 USDC), Uniswap V3 (0,01%, até 5.000.000 USDC) e Balancer (0,02%, até 1.000.000 USDC). Esses números são declarações do próprio autor e não são verificados pelo repositório. Configuração e interface O uso segue um fluxo convencional de npm: colocar goflash.js e package.json em uma pasta, executar npm install e depois node goflash.js. No primeiro lançamento, o bot apresenta um prompt interativo com duas opções: criar uma nova carteira ou importar uma existente por meio de chave privada. A chave privada de uma carteira criada é gravada automaticamente em wallet.json no mesmo diretório. Um menu de texto oferece então a seleção do protocolo DeFi, valor do empréstimo em ETH (faixa declarada começando em 10 ETH até o máximo do protocolo), recriação de carteira, importação de carteira, início da arbitragem e saída. Um painel de preços em tempo real mostra a cotação de ETH/USDC de cada local com indicadores de alta/baixa/inalterado. Notas operacionais e riscos O próprio README contém vários avisos: manter ETH suficiente para gas (sugere pelo menos 0,1 ETH para empréstimos acima de 10 ETH), evitar empréstimos muito grandes com saldo pequeno, adicionar wallet.json ao .gitignore, manter backups de chaves privadas offline, usar uma carteira dedicada e começar com quantias pequenas. As taxas mencionadas incluem uma taxa de negociação de 0,1%, 0,05% de slippage e gas. Uma seção de solução de problemas aborda erros de formato de módulo, verificações de formato de chave privada, fundos insuficientes, endpoints RPC inacessíveis e pares V2 ausentes. Uma observação sobre a estrutura do projeto listada: ela enumera apenas goflash.js, package.json, wallet.json e README.md, portanto, um smart contract complementar é descrito em prosa, mas não é mostrado como parte da árvore de arquivos. Qualquer pessoa que avalie este projeto deve tratar as alegações de lucratividade, valores de taxas e limites de empréstimo como declarações não verificadas do autor, e deve considerar a consequência de armazenar uma chave privada de carteira no disco em texto simples.