About this project

## What it is FlashLoanArbitrage is a Node.js CLI bot for DeFi arbitrage built around flash loans. The repository provides a local script, `goflash.js`, plus a `package.json`; the README states the accompanying smart contract performs the on-chain leg of the trade. ## Described workflow 1. The script reads ETH/USDC prices from five sources: Chainlink (oracle), Uniswap V2, SushiSwap, Curve Finance and Balancer. 2. It re-scans roughly every 60 seconds and displays prices with direction indicators (up, down, unchanged) plus the current maximum spread. 3. If the spread reaches 0.9% or more, it triggers arbitrage through the contract; below that threshold it keeps waiting. 4. Per the README, the contract takes a USDC flash loan, buys ETH on the cheaper venue, sells on the more expensive one, repays the loan and fees, then converts remaining profit back to ETH. The README notes real spreads of that size are rare, and that the script occasionally shows a simulated opportunity for demonstration. ## Flash-loan protocols listed Aave, dYdX, Uniswap V3 and Balancer, each with a stated fee rate and a per-protocol USDC borrowing cap. The README recommends dYdX or Uniswap V3 for lower fees. ## Running it Download `goflash.js` and `package.json`, run `npm install`, then `node goflash.js`. On first launch an interactive prompt (via `inquirer`) lets you create a new wallet or import one with a private key. Keys are stored in a local `wallet.json`. A menu then offers protocol selection, loan amount in ETH, wallet recreation, wallet import, starting arbitrage, and exit. Dependencies listed: `ethers`, `inquirer` and `chalk`. The project is described as shared "as-is for educational purposes." ## Points to weigh before using The tool requires placing a private key in a plaintext local file and signing transactions with real funds, so the README's own security advice matters: never commit `wallet.json`, add it to `.gitignore`, keep the key backed up offline, use a dedicated wallet, and test with small amounts first. The README also warns that gas, trading fees (0.1% stated) and slippage (0.05% stated) are costs, and that a low wallet balance limits the loan size you can select. No audit, track record or independent verification of profitability is provided in the README, and profit figures should be treated as unverified claims.