About this project

The README is written in English and presents a project titled FlashLoanArbitrage, although the repository name and description refer to an Ethereum dashboard. The documented material describes a Node.js CLI bot for DeFi flash-loan arbitrage, using a smart contract and the local script goflash.js. According to the README, the contract takes a flash loan in USDC, converts the user's ETH to USDC before the trade, buys ETH at a lower price on one venue, sells at a higher price on another, repays the loan, pays fees and gas, converts remaining USDC profit back to ETH, and returns net profit in ETH. The script checks ETH/USDC prices on Chainlink, Uniswap V2, SushiSwap, Curve Finance, and Balancer, and waits for a price difference of at least 0.9% before triggering arbitrage. Flash-loan protocols listed are 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). Setup steps: download goflash.js and package.json, run npm install, then node goflash.js. On first launch, an interactive menu offers creating a new wallet or importing an existing private key; the private key is saved to wallet.json. The main menu lets users choose a DeFi protocol, set a loan amount in ETH from 10 up to the protocol limit, recreate or import a wallet, start arbitrage, or exit. While monitoring, the README says the script scans every 60 seconds and displays prices with up/down indicators. The README warns that users need ETH for gas, that a wallet balance below 0.1 ETH should not take loans over 10 ETH, and that fees include trading fees (0.1%), slippage (0.05%), gas, and flash-loan fees. It lists troubleshooting notes for module format, private key format, insufficient funds, RPC availability, and missing trading pairs. It also states that a 0.9% spread is rare in real markets and that the script may occasionally show a simulated opportunity for demonstration. Security advice includes never committing wallet.json to Git, using a dedicated wallet, keeping backups, and testing with small amounts. Dependencies are ethers ^6.11.1, inquirer ^8.2.6, and chalk ^4.1.2. The README labels the project as shared as-is for educational purposes and use at the user's own risk.