About this project

FlashLoanArbitrage is a hobby project published with a README that describes a script-driven arbitrage bot for DeFi markets. The main artifact is goflash.js, a Node.js program run locally from a terminal, together with a package.json that lists three dependencies: ethers (Ethereum library), inquirer (interactive CLI prompts) and chalk (colored console output). How it is described as working The README says the bot watches the ETH/USDC price on five sources: Chainlink as an oracle reference, plus Uniswap V2, SushiSwap, Curve Finance and Balancer as venues. Prices are polled on a 60-second cycle, and an arbitrage action is only attempted when the gap between venues reaches 0.9% or more. The README explicitly notes that such spreads are rare in real markets and that the script may display a simulated opportunity for demonstration purposes. When the threshold is met, the README states the flow is: take a flash loan denominated in USDC, buy ETH on the cheaper venue, sell it on the more expensive one, repay the loan plus fees and gas, then convert the remaining USDC profit back to ETH. Four flash-loan sources are listed with their stated fee rates and indicative maximum loan sizes: Aave (0.05%, up to 10,000,000 USDC), dYdX (0.05%, up to 500,000 USDC), Uniswap V3 (0.01%, up to 5,000,000 USDC) and Balancer (0.02%, up to 1,000,000 USDC). These figures are the author's own statements and are not verified by the repository. Setup and interface Usage is a conventional npm flow: place goflash.js and package.json in a folder, run npm install, then node goflash.js. On first launch the bot presents an interactive prompt with two options: create a new wallet or import an existing one by private key. A created wallet's private key is written automatically to wallet.json in the same directory. A text menu then offers DeFi protocol selection, loan amount in ETH (stated range starts at 10 ETH up to the protocol maximum), wallet recreation, wallet import, start arbitrage, and exit. A live price panel shows each venue's ETH/USDC quote with up/down/unchanged indicators. Operational notes and risks The README itself carries several warnings: keep enough ETH for gas (it suggests at least 0.1 ETH for loans above 10 ETH), avoid very large loans with a small balance, add wallet.json to .gitignore, keep private-key backups offline, use a dedicated wallet, and start with small amounts. Fees mentioned include a 0.1% trading fee, 0.05% slippage and gas. A troubleshooting section covers module-format errors, private-key format checks, insufficient funds, unreachable RPC endpoints and missing V2 pairs. One observation from the listed project structure: it enumerates only goflash.js, package.json, wallet.json and README.md, so a companion smart contract is described in prose but not shown as part of the file tree. Anyone evaluating this project should treat the profitability claims, fee figures and loan limits as unverified author statements, and should consider the consequence of storing a wallet private key on disk in plain text.