About this project

FlashLoanArbitrage is presented in its README as a personal DeFi arbitrage bot consisting of two described parts: a smart contract and a local Node.js script named goflash.js that is run on the user's own computer. Documented workflow According to the README, the script polls ETH/USDC prices roughly every 60 seconds across Chainlink (as an oracle reference), Uniswap V2, SushiSwap, Curve Finance and Balancer, and compares the spread between platforms. When the difference reaches 0.9% or more, the described contract logic takes a USDC flash loan, converts the wallet's ETH to USDC beforehand, buys ETH on the cheaper venue, sells on the more expensive one, repays the loan plus fees and gas, converts the resulting USDC profit back to ETH, and leaves the remainder as net profit. Flash-loan sources listed Aave (stated 0.05% fee, 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). The README recommends dYdX or Uniswap V3 for lower fees and warns that a wallet balance below roughly 0.1 ETH may not cover gas for loans of 10 ETH or more. Setup and interface Installation is via npm install followed by node goflash.js. On first run the script offers an interactive menu (built with inquirer) to create a new wallet or import an existing one by private key, then to choose a lending protocol, set the loan amount, recreate or re-import a wallet, start arbitrage, or exit. Dependencies named in the README are ethers ^6.11.1, inquirer ^8.2.6 and chalk ^4.1.2. Console output is described as showing live prices with up/down indicators and the maximum spread. Repository contents and limitations visible from the README Only goflash.js, package.json, an auto-generated wallet.json and README.md are listed in the documented project structure, so the smart contract referenced throughout the workflow is not shown as part of this repository. The README itself states that a 0.9% spread is rare in real markets and that the script occasionally displays a simulated opportunity for demonstration purposes, so no evidence of profitable live execution is provided. There are no benchmarks, audits, test results or transaction references in the material. Operational cautions By design, the private key is written to a plain wallet.json file next to the script; the README repeats several times that this file must never be committed or shared and should be backed up offline, and recommends a dedicated wallet and small test amounts. Anyone evaluating this project should treat funding such a wallet as high risk, keep the key handling isolated, and verify the contract bytecode independently, since the README does not include it. Licensing is described as "shared as-is for educational purposes, use at your own risk".