simulating-flash-loans

name	simulating-flash-loans
description	Simulate flash loan strategies with profitability calculations and risk assessment across Aave, dYdX, and Balancer. Use when simulating flash loans, analyzing arbitrage profitability, evaluating liquidation opportunities, or comparing flash loan providers. Trigger with phrases like "simulate flash loan", "flash loan arbitrage", "liquidation profit", "compare Aave dYdX", "flash loan strategy", or "DeFi arbitrage simulation".
allowed-tools	Read, Write, Edit, Grep, Glob, Bash(crypto:flashloan-*)
version	1.30.0
author	Jeremy Longshore <[e-mail]>
license	MIT
tags	["crypto","simulating-flash"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Simulating Flash Loans

Contents

Overview | Prerequisites | Instructions | Output | Error Handling | Examples | Resources

Overview

Simulate flash loan strategies across Aave V3, dYdX, and Balancer with profitability calculations, gas cost estimation, and risk assessment. Evaluate flash loan opportunities without executing real transactions.

Prerequisites

1. Install Python 3.9+ with web3, httpx, and rich packages
2. Configure RPC endpoint access (free public RPCs via https://chainlist.org work fine)
3. Optionally add Etherscan API key for better gas estimates
4. Set RPC in ${CLAUDE_SKILL_DIR}/config/settings.yaml or use ETH_RPC_URL env var

Instructions

1. Simulate a two-DEX arbitrage with automatic fee and gas calculation:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 \
     --dex-buy uniswap --dex-sell sushiswap
   

2. Compare flash loan providers to find the cheapest for your strategy:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 --compare-providers
   

3. Analyze liquidation profitability on lending protocols:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py liquidation \
     --protocol aave --health-factor 0.95
   

4. Simulate triangular arbitrage with multi-hop circular paths:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py triangular \
     ETH USDC WBTC ETH --amount 50
   

5. Add risk assessment (MEV competition, execution, protocol, liquidity) to any simulation:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 --risk-analysis
   

6. Run full analysis combining all features:

   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 \
     --full --output json > simulation.json