About this project

FlashLoanArbitrage is a Node.js script described in the README as a personal project for DeFi arbitrage using flash loans. One thing worth flagging first: the repository name and short description refer to a price-alert notifier, but the README is entirely about an arbitrage bot, so the documentation and the listing metadata do not match. How it is described as working: a smart contract takes a flash loan in USDC, the local script converts the user's ETH to USDC before the trade, buys ETH at a lower price on one venue and sells it higher on another, repays the loan plus fees and gas, then converts the profit back from USDC to ETH. Monitoring and trigger logic: the script checks ETH/USDC prices on Chainlink (used as the base oracle price), Uniswap V2, SushiSwap, Curve Finance and Balancer, polling roughly every 60 seconds and displaying prices with up/down/unchanged indicators. A trade is only triggered when the price difference is at least 0.9%. Flash-loan sources listed are Aave, dYdX, Uniswap V3 and Balancer, with stated fee rates and liquidity ceilings (for example Aave at 0.05% and up to 10,000,000 USDC, Uniswap V3 at 0.01% and up to 5,000,000 USDC). Setup as documented: download goflash.js and package.json into any folder, run npm install, then node goflash.js. On first launch an interactive CLI (inquirer) asks whether to create a new wallet or import an existing one by private key; the key is validated and saved to wallet.json in the same folder as plain text. A menu then offers protocol selection, loan amount in ETH, recreate wallet, import wallet, start arbitrage, and exit. Dependencies listed are ethers, inquirer and chalk. Caveats the author states directly: a 0.9% spread is rare in real markets, and the script "shows a simulated opportunity occasionally for demonstration"; a wallet balance below about 0.1 ETH limits how large a loan can be selected because of gas; trading fees (~0.1%), slippage (~0.05%) and gas all come out of the result. Security advice includes never committing wallet.json, adding it to .gitignore, keeping private-key backups offline, and using a dedicated test wallet with small amounts first. The project is shared as-is for educational purposes, with use at the user's own risk, and the README invites feedback through issues. No independent performance, profitability or audit evidence is provided, and no test suite or license terms beyond the as-is statement are described.