About this project

FlashLoanArbitrage is an English-language README project describing a Node.js command-line bot for ETH/USDC flash-loan arbitrage. It pairs a locally run script, goflash.js, with a smart contract that the README says performs the on-chain leg of each trade. How the author describes it working - goflash.js polls ETH/USDC prices on Chainlink, Uniswap V2, SushiSwap, Curve Finance and Balancer, showing the current quotes plus up/down indicators and the maximum spread between venues. - It only triggers a trade when the difference between platforms is 0.9% or more, a threshold the README says exists to avoid loss-making executions, and notes that such spreads are rare in real markets. - The contract is described as taking a USDC flash loan, buying ETH cheaply on one venue, selling it higher on another, repaying the loan plus fees and gas, then converting the remaining USDC profit back to ETH. Flash-loan protocols and stated limits The README lists four lending sources with indicative caps: Aave (0.05% fee, up to 10,000,000 USDC), dYdX (0.05%, 500,000 USDC), Uniswap V3 (0.01%, 5,000,000 USDC) and Balancer (0.02%, 1,000,000 USDC). Users pick a protocol and a loan size from the menu, with the README recommending dYdX or Uniswap V3 for lower fees and warning that wallets below about 0.1 ETH should not request loans above 10 ETH because gas would not be covered. Setup and interface Installation is conventional: copy goflash.js and package.json into a folder, run npm install (dependencies are ethers ^6.11.1, inquirer ^8.2.6 and chalk ^4.1.2), then node goflash.js. On first launch an interactive prompt offers to create a new wallet or import one by private key; either way the key is written to wallet.json in the same directory. The main menu offers DeFi protocol selection, loan amount, wallet recreate/import, start arbitrage and exit. The repository structure shown in the README contains only goflash.js, package.json, wallet.json and README.md, so the contract source is not included there. What is and is not evidenced The README gives no transaction hashes, backtests, benchmarks or profit figures, and explicitly states that the script will occasionally show a simulated arbitrage opportunity for demonstration. Profitability claims should therefore be treated as the author's descriptions rather than verified results. Practical cautions worth flagging - The tool asks for a private key and stores it unencrypted in wallet.json; the README itself advises .gitignore, offline backups and a dedicated wallet. - Any bot of this shape that holds keys and funds carries counterparty and code risk; the stated fee/slippage assumptions (0.1% trading fees, 0.05% slippage) are unverified. - The README supplies troubleshooting notes for common errors (module format, invalid key format, insufficient funds, RPC outages, missing ETH/USDC pairs on V2). Overall, this is a self-contained, interactive CLI experiment for Ethereum flash-loan arbitrage, aimed at users who want to run the loop locally rather than as a hosted service. It is presented as-is for educational purposes with an explicit "use at your own risk" note.