À propos du projet

FlashLoanArbitrage est présenté dans son README comme un projet personnel d'arbitrage DeFi composé d'un smart contract et d'un script Node.js local, goflash.js, que l'utilisateur exécute sur sa propre machine. Le nom du dépôt (flashloan-roi-calculator) et sa description en une ligne (« Calcule le ROI pour les investissements basés sur les flash-loans ») pointent vers un calculateur de ROI, tandis que le README lui-même documente un bot de trading exécutable — les deux descriptions ne correspondent pas totalement, et le matériel du dépôt n'inclut pas le code source du smart contract dans la structure du projet listée. Fonctionnement selon le README Selon la documentation, le contrat contracte un flash loan libellé en USDC, achète de l'ETH sur la plateforme la moins chère, le revend sur la plus chère, rembourse le prêt plus les frais et le gas, et convertit le profit restant en ETH. Le script est censé interroger les prix ETH/USDC sur Chainlink, Uniswap V2, SushiSwap, Curve Finance et Balancer, les afficher avec des indicateurs de variation à la hausse ou à la baisse, et n'agir que lorsque l'écart entre les plateformes est d'au moins 0,9 %. Les sources de flash-loans listées sont Aave (0,05 %), dYdX (0,05 %), Uniswap V3 (0,01 %) et Balancer (0,02 %), chacune avec un plafond de liquidité indiqué. Configuration et interface Le README propose un flux de travail en quatre étapes : télécharger goflash.js et package.json, exécuter npm install, puis node goflash.js. Au premier lancement, un menu interactif (construit avec inquirer, avec chalk pour la sortie colorée et ethers pour l'accès à Ethereum) propose de créer un nouveau portefeuille ou d'en importer un existant via une clé privée ; la clé est écrite dans wallet.json dans le même dossier. Les menus suivants permettent de sélectionner le protocole, de définir un montant de prêt en ETH (plage indiquée : de 10 ETH jusqu'au maximum du protocole), de recréer ou de réimporter le portefeuille, et de démarrer ou de quitter la surveillance de l'arbitrage. Contraintes et mises en garde Le README avertit que le solde du portefeuille est utilisé uniquement pour le gas, recommande au moins 0,1 ETH pour les prêts supérieurs à 10 ETH, et liste des coûts supposés de 0,1 % de frais de trading et 0,05 % de slippage en plus des frais de flash-loan et du gas. Une section de dépannage couvre les erreurs de format de clé privée, les fonds insuffisants, la disponibilité du RPC et les paires ETH/USDC manquantes. Notamment, il est précisé que les dislocations de 0,9 % sont rares sur les marchés réels et que le script « affiche occasionnellement une opportunité simulée pour démonstration » — ainsi, les résultats affichés peuvent ne pas correspondre à des transactions réellement exécutables. La section licence décrit le projet comme étant partagé en l'état à des fins éducatives, utilisé aux risques et périls de l'utilisateur. À qui cela peut-il s'adresser Les lecteurs intéressés par la manière dont les flux d'arbitrage par flash-loan sont structurés, ou par le modèle d'interface CLI interactive (menu du portefeuille, sélection du protocole, tableau des prix en direct), trouveront dans le README un guide lisible de la conception prévue. Quiconque envisage de l'exécuter doit peser deux points pratiques que le document lui-même rend clairs : le script ne contient pas le code source du contrat déployé dans ce dépôt, et il nécessite de coller une clé privée dans wallet.json, ce que le README signale à plusieurs reprises comme étant sensible et recommande de conserver dans .gitignore avec des sauvegardes hors ligne et un portefeuille dédié.