{
  "id": "trail.aave.leveraged_position",
  "schemaVersion": "0.1.0",
  "name": "Open leveraged position on Aave V3 (flashloan)",
  "summary": "Aave V3 equivalent of trail.morpho.leveraged_position. Flashloan borrowedAsset → swap to collateral → supply collateral → borrow back to repay. Atomic.",
  "family": "btc-carry",
  "chains": ["ethereum", "base", "arbitrum", "optimism"],
  "params": [
    { "name": "borrowedAsset",    "type": "address", "required": true,  "description": "Asset to flashloan + ultimately borrow on Aave (e.g. USDC)." },
    { "name": "collateralAsset",  "type": "address", "required": true,  "description": "Aave-supported collateral asset (e.g. cbBTC, WBTC, wstETH)." },
    { "name": "flashAmount",      "type": "uint256", "required": true,  "description": "Flashloan size in borrowedAsset base units." },
    { "name": "interestRateMode", "type": "uint16",  "required": false, "default": 2, "description": "Aave V3 interest rate mode: 1=stable, 2=variable. Default 2 (variable)." }
  ],
  "execution": {
    "mode": "atomic",
    "flashloanStep": 0,
    "steps": [
      {
        "kind": "leaf",
        "id": "fl",
        "description": "Aave V3 simpleFlashLoan of borrowedAsset.",
        "protocol": "aaveFlashloanAdapter",
        "action": "flashloan",
        "args": { "asset": "$borrowedAsset", "amount": "$flashAmount" }
      },
      {
        "kind": "leaf",
        "description": "Approve the DEX adapter to spend borrowedAsset.",
        "protocol": "magpie",
        "action": "approve",
        "args": { "asset": "$borrowedAsset" }
      },
      {
        "kind": "leaf",
        "id": "swap",
        "description": "Swap borrowedAsset → collateralAsset via the DEX adapter.",
        "protocol": "magpie",
        "action": "swap_or_mint",
        "args": { "in": "$borrowedAsset", "out": "$collateralAsset", "amountIn": "$flashAmount" }
      },
      {
        "kind": "leaf",
        "description": "Approve Aave V3 Pool to pull the collateral.",
        "protocol": "erc20",
        "action": "approve",
        "args": { "asset": "$collateralAsset", "spender": "aaveV3Pool" }
      },
      {
        "kind": "leaf",
        "description": "Supply collateral to Aave V3.",
        "protocol": "aaveV3",
        "action": "supply",
        "args": { "asset": "$collateralAsset", "amount": "$swap.amountOut", "onBehalfOf": "$vault" }
      },
      {
        "kind": "leaf",
        "description": "Borrow borrowedAsset back from Aave to repay the flashloan.",
        "protocol": "aaveV3",
        "action": "borrow",
        "args": { "asset": "$borrowedAsset", "amount": "$flashAmount", "interestRateMode": "$interestRateMode", "onBehalfOf": "$vault" }
      }
    ]
  },
  "preconditions": [
    "Vault has aaveFlashloanAdapter clone for $borrowedAsset.",
    "Vault has approve+swap+supply+borrow leaves enabled for both assets on Aave V3.",
    "Aave V3 has the borrowedAsset/collateralAsset pair enabled (most majors are; check on chain)."
  ],
  "risks": [
    "Aave V3 oracle staleness or e-mode misconfig can cause borrow to revert or land at unexpected HF.",
    "Variable interest rate (mode 2) can spike if utilization jumps. Mode 1 (stable) is opt-in but typically capped."
  ],
  "llm_doc": "Aave V3 flavor of leveraged-position-open. Use this for BTC/ETH carry trades where the collateral side is on Aave (cbBTC, WBTC, wstETH, etc.) and the borrowed side is a stable. Same mental model as trail.morpho.leveraged_position but routes through aaveFlashloanAdapter + aaveV3 pool. Available on all 4 chains; Morpho-only chains can't use this."
}