Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Aave

Heat supports a focused Aave V3 phase-1 integration for:

  • Ethereum
  • Arbitrum
  • Base

What you can do today

heat aave markets --chain ethereum
heat aave positions --chain arbitrum --account main
heat aave health --chain base --account main
heat aave supply USDC 1000 --chain ethereum --account main --dry-run
heat aave withdraw USDC 500 --chain arbitrum --account main --dry-run

Native ETH support

Heat supports supplying and withdrawing native ETH via Aave's WrappedTokenGatewayV3. Use ETH as the asset symbol:

# Supply native ETH (wraps to WETH via gateway in one tx, no approval needed)
heat aave supply ETH 0.5 --chain ethereum --account main --dry-run
 
# Withdraw as native ETH (unwraps from WETH via gateway, approves aWETH automatically)
heat aave withdraw ETH 0.5 --chain ethereum --account main --dry-run
  • ETH means native ETH routed through the WETH Gateway (one transaction).
  • WETH means the ERC-20 WETH token directly via the Pool (standard approve + supply/withdraw).
  • For native ETH withdraw, Heat automatically approves the gateway to spend your aWETH tokens.
  • JSON output includes execution_path ("native_gateway" or "erc20") and gateway_address for transparency.

Current scope

Supported now:

  • markets
  • positions
  • health
  • supply (ERC-20 tokens and native ETH)
  • withdraw (ERC-20 tokens and native ETH)

Not supported yet:

  • borrow
  • repay
  • collateral toggles
  • eMode
  • rewards

Notes

  • Heat resolves contract addresses through Aave's PoolAddressesProvider at runtime.
  • Use --dry-run before any live write.
  • For writes, Heat uses your normal Heat account and heat-evm signer flow.

Example

# Inspect available reserves
heat aave markets --chain ethereum
 
# Check account health
heat aave health --chain base --account main
 
# Preview a supply transaction
heat aave supply USDC 1000 --chain arbitrum --account main --dry-run
 
# Supply native ETH
heat aave supply ETH 1.0 --chain ethereum --account main
 
# Withdraw as native ETH
heat aave withdraw ETH 0.5 --chain ethereum --account main

Output

  • TTY defaults to pretty output
  • piped output defaults to JSON
  • -q / --quiet is useful for scalar health-factor output on health