About this project

FlashLoanArbitrage is the English-language README of a personal project of the same name, distributed as a repository containing a local Node.js script (goflash.js) together with a package.json. According to the documentation the script runs on the user's own computer rather than as a hosted service, and works in combination with a smart contract that performs the on-chain steps of a flash-loan arbitrage. Documented workflow: the contract is said to take a flash loan in USDC, convert the user's ETH to USDC before the trade, buy ETH on one venue and sell it on another, repay the loan plus fees and gas, convert the remaining USDC profit back to ETH, and leave the remainder as profit. The local script is described as checking ETH/USDC prices across five sources — Chainlink as the base oracle, Uniswap V2, SushiSwap, Curve Finance and Balancer — and only triggering the contract when the spread between venues is at least 0.9%. Prices are reported on roughly a 60-second cycle and printed with up, down or unchanged indicators, along with the maximum observed difference between platforms. Flash-loan sources listed in the README are Aave (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 user selects one from a menu and sets a loan size in ETH between 10 and the protocol maximum. Wallet handling is part of the tool: a new wallet can be generated, or an existing one imported by private key. A newly generated key is written in plaintext to wallet.json in the working directory, and the README repeatedly warns to store it securely, not to commit it, and to add it to .gitignore. The interface is an interactive command-line menu built with inquirer and chalk, offering protocol selection, loan amount, wallet creation and import, starting arbitrage, and exit. The documentation notes gas requirements (a balance below 0.1 ETH is said to prevent choosing larger loans), mentions trading fees around 0.1% and slippage around 0.05%, and includes a troubleshooting section covering private-key format errors, insufficient funds, automatic RPC reconnection attempts, and trading pairs that are not present on a given venue. Points worth flagging for an independent reader: the documentation states the project is shared as-is for educational purposes and used at the user's own risk, and it acknowledges that a 0.9% cross-venue spread is rare in real markets, with a simulated opportunity occasionally shown for demonstration. The material provided offers no independent evidence of profitability, and it describes storing a private key on disk in plaintext. Both the described returns and the wallet-handling approach should therefore be treated as claims of the author rather than verified results. The README also refers to a smart contract as part of the system, but no contract source is described in the text supplied.