Sobre el proyecto

FlashLoanArbitrage se presenta en su README como un proyecto personal de arbitraje DeFi que consiste en un contrato inteligente más un script local de Node.js, goflash.js, que el usuario ejecuta en su propia máquina. El nombre del repositorio (flashloan-roi-calculator) y su descripción de una sola línea ("Calculates ROI for flashloan-based investments") apuntan a una calculadora de ROI, mientras que el README documenta un bot de trading ejecutable; las dos descripciones no coinciden plenamente y el material del repositorio no incluye el código fuente del contrato inteligente en la estructura del proyecto enumerada. Cómo dice el README que funciona Según la documentación, el contrato toma un flash loan denominado en USDC, compra ETH en la plataforma más barata, lo vende en la más cara, devuelve el préstamo más las comisiones y el gas, y convierte el beneficio restante de nuevo a ETH. Se dice que el script consulta los precios de ETH/USDC en Chainlink, Uniswap V2, SushiSwap, Curve Finance y Balancer, los muestra con indicadores de cambio al alza/baja y actúa solo cuando el diferencial entre plataformas es de al menos el 0.9%. Las fuentes de flash-loan enumeradas son Aave (0.05%), dYdX (0.05%), Uniswap V3 (0.01%) y Balancer (0.02%), cada una con un techo de liquidez establecido. Configuración e interfaz El README detalla un flujo de trabajo de cuatro pasos: descargar goflash.js y package.json, ejecutar npm install y luego node goflash.js. En el primer lanzamiento, un menú interactivo (construido con inquirer, con chalk para la salida en color y ethers para el acceso a Ethereum) ofrece crear una nueva billetera o importar una existente mediante una clave privada; la clave se escribe en wallet.json en la misma carpeta. Los menús posteriores permiten seleccionar el protocolo, establecer un monto de préstamo en ETH (rango indicado: desde 10 ETH hasta el máximo del protocolo), recrear o reimportar la billetera, e iniciar o salir del monitoreo de arbitraje. Restricciones y advertencias declaradas El README advierte que el saldo de la billetera se utiliza solo para el gas, recomienda al menos 0.1 ETH para préstamos superiores a 10 ETH y enumera costos asumidos de 0.1% en comisiones de trading y 0.05% de slippage, además de la comisión del flash-loan y el gas. Una sección de resolución de problemas cubre errores de formato de clave privada, fondos insuficientes, disponibilidad de RPC y pares ETH/USDC faltantes. Notablemente, afirma que las dislocaciones del 0.9% son raras en los mercados reales y que el script "muestra ocasionalmente una oportunidad simulada para demostración", por lo que los resultados mostrados pueden no corresponder a operaciones ejecutables genuinas. La sección de licencia describe el proyecto como compartido tal cual para fines educativos, utilizado bajo el propio riesgo del usuario. Para quién puede ser adecuado Los lectores interesados en cómo se conectan los flujos de arbitraje de flash-loans, o en el patrón de CLI interactiva (menú de billetera, selección de protocolo, tabla de precios en vivo), encontrarán en el README una guía legible del diseño previsto. Cualquiera que considere ejecutarlo debe sopesar dos puntos prácticos que el propio documento deja claros: el script no tiene el código fuente del contrato desplegado en este repositorio y requiere pegar una clave privada en wallet.json, lo cual el README señala repetidamente como sensible y recomienda mantener en .gitignore con copias de seguridad fuera de línea y una billetera dedicada.