Sobre o projeto

FlashLoanArbitrage é um projeto de README em inglês que descreve um bot de linha de comando em Node.js para arbitragem de flash-loan de ETH/USDC. Ele combina um script executado localmente, goflash.js, com um contrato inteligente que, segundo o README, realiza a etapa on-chain de cada operação. Como o autor descreve o funcionamento - O goflash.js monitora preços de ETH/USDC no Chainlink, Uniswap V2, SushiSwap, Curve Finance e Balancer, exibindo as cotações atuais, indicadores de alta/baixa e o spread máximo entre os locais. - Ele só dispara uma operação quando a diferença entre as plataformas é de 0,9% ou mais, um limite que o README afirma existir para evitar execuções com prejuízo, observando que tais spreads são raros em mercados reais. - O contrato é descrito como alguém que toma um flash loan de USDC, compra ETH barato em um local, vende mais caro em outro, paga o empréstimo mais taxas e gas, e então converte o lucro restante de USDC de volta para ETH. Protocolos de flash-loan e limites declarados O README lista quatro fontes de empréstimo com limites indicativos: Aave (taxa de 0,05%, até 10.000.000 USDC), dYdX (0,05%, 500.000 USDC), Uniswap V3 (0,01%, 5.000.000 USDC) e Balancer (0,02%, 1.000.000 USDC). Os usuários escolhem um protocolo e o tamanho do empréstimo no menu, com o README recomendando dYdX ou Uniswap V3 por taxas menores e alertando que carteiras com menos de aproximadamente 0,1 ETH não devem solicitar empréstimos acima de 10 ETH, pois o gas não seria coberto. Configuração e interface A instalação é convencional: copiar goflash.js e package.json para uma pasta, executar npm install (as dependências são ethers ^6.11.1, inquirer ^8.2.6 e chalk ^4.1.2) e então node goflash.js. No primeiro lançamento, um prompt interativo oferece a criação de uma nova carteira ou a importação de uma via chave privada; de qualquer forma, a chave é gravada no wallet.json no mesmo diretório. O menu principal oferece seleção de protocolo DeFi, valor do empréstimo, recriação/importação de carteira, início da arbitragem e saída. A estrutura do repositório mostrada no README contém apenas goflash.js, package.json, wallet.json e README.md, portanto, o código-fonte do contrato não está incluído. O que é e o que não é evidenciado O README não fornece hashes de transação, backtests, benchmarks ou números de lucro, e afirma explicitamente que o script ocasionalmente mostrará uma oportunidade de arbitragem simulada para demonstração. As alegações de lucratividade devem, portanto, ser tratadas como descrições do autor e não como resultados verificados. Precauções práticas a serem destacadas - A ferramenta solicita uma chave privada e a armazena sem criptografia no wallet.json; o próprio README aconselha o uso de .gitignore, backups offline e uma carteira dedicada. - Qualquer bot deste tipo que detenha chaves e fundos carrega riscos de contraparte e de código; as suposições de taxa/slippage declaradas (taxas de negociação de 0,1%, slippage de 0,05%) não são verificadas. - O README fornece notas de solução de problemas para erros comuns (formato de módulo, formato de chave inválido, fundos insuficientes, interrupções de RPC, pares ETH/USDC ausentes na V2). No geral, este é um experimento CLI interativo e independente para arbitragem de flash-loan no Ethereum, voltado para usuários que desejam executar o loop localmente em vez de como um serviço hospedado. É apresentado no estado em que se encontra para fins educacionais, com uma nota explícita de "use por sua conta e risco".