keeperhub-plugins-aave-v3

Files (1)

• SKILL.md

SKILL.md (first lines)

# Aave V3

## Overview
Documentation for Aave V3 integration and usage within the KeeperHub ecosystem.

[Plugins](https://docs.keeperhub.com/plugins)

Aave V3 is a decentralized non-custodial lending and borrowing protocol. Users can supply assets to earn interest, borrow assets against their collateral, and manage their positions across multiple chains. This plugin provides actions for core lending operations and account health monitoring.
Supported chains: Ethereum, Base, Arbitrum, Optimism (all contracts available on all chains). Read-only actions work without credentials. Write actions require a connected wallet.

## Supply Asset
Supply an asset to the Aave V3 lending pool to earn interest. The supplied asset automatically starts accruing interest. Requires prior ERC-20 approval for the Pool contract.
Inputs:
Outputs: success, transactionHash, transactionLink, error

`success`

`transactionHash`

`transactionLink`

`error`

When to use: Earn yield on idle tokens, automate deposits when conditions are met, build supply strategies based on rate changes.

## Withdraw Asset
Withdraw a supplied asset from the Aave V3 lending pool. Ensure the withdrawal does not bring the health factor below 1 if the asset is used as collateral.
Inputs:
Outputs: success, transactionHash, transactionLink, error

`success`

`transactionHash`

`transactionLink`

`error`

When to use: Withdraw funds when needed, automate withdrawals based on rate drops, rebalance collateral positions.

## Borrow Asset
Borrow an asset from the Aave V3 lending pool against supplied collateral. Variable rate (mode 2) is the standard borrowing mode.
Inputs:
Outputs: success, transactionHash, transactionLink, error

`success`

`transactionHash`

`transactionLink`

`error`

When to use: Borrow stablecoins against volatile assets, leverage positions, automate borrowing based on market conditions.

## Repay Debt
Repay a borrowed asset to the Aave V3 lending pool. Use type(uint256).max as amount to repay the entire debt.

`type(uint256).max`

Inputs:
Outputs: success, transactionHash, transactionLink, error

`success`

`transactionHash`

`transactionLink`

`error`

When to use: Automate debt repayment when health factor drops, repay before liquidation, scheduled debt reduction.

## Set Asset as Collateral
Enable or disable a supplied asset as collateral in Aave V3. Disabling collateral increases available borrows for other assets but may reduce overall borrow capacity.
Inputs:
Outputs: success, transactionHash, transactionLink, error

`success`

`transactionHash`

`transactionLink`

`error`

When to use: Manage collateral exposure, disable volatile assets as collateral during market uncertainty, optimize borrow capacity.

## Get User Account Data
Get overall account health including total collateral, total debt, available borrow power, and health factor. Base currency values are denominated in USD with 8 decimal precision.
Inputs:
Outputs:
When to use: Monitor account health factor for liquidation protection, check borrow capacity before opening new positions, track portfolio-level collateral and debt.

## Get User Reserve Data
Get per-asset position data including supplied balance, outstanding debt, borrow rates, and collateral status. Returns data from the Aave V3 Pool Data Provider.
Inputs:
Outputs:
When to use: Monitor individual asset positions, track supply APY changes, check if an asset is enabled as collateral, compare debt across assets.

### Health Factor Monitor with Alert
Schedule (every 5 min) -> Aave V3: Get User Account Data -> Code (healthFactor / 1e18) -> Condition (< 1.5) -> Discord: Send Message

`Schedule (every 5 min) -> Aave V3: Get User Account Data -> Code (healthFactor / 1e18) -> Condition (< 1.5) -> Discord: Send Message`

Monitor your Aave V3 health factor and send a Discord alert when it drops below 1.5, giving you time to act before liquidation.

### Repay on Low Health Factor
Schedule (every 5 min) -> Aave V3: Get User Account Data -> Code (healthFactor / 1e18) -> Condition (< 1.2) -> Aave V3: Repay Debt

`Schedule (every 5 min) -> Aave V3: Get User Account Data -> Code (healthFactor / 1e18) -> Condition (< 1.2) -> Aave V3: Repay Debt`

Automatically repay debt when health factor approaches the liquidation threshold. Requires wallet connection and token approval.

### Track Supply APY
Schedule (hourly) -> Aave V3: Get User Reserve Data -> Code (liquidityRate / 1e27 * 100) -> Webhook: Send HTTP Request

`Schedule (hourly) -> Aave V3: Get User Reserve Data -> Code (liquidityRate / 1e27 * 100) -> Webhook: Send HTTP Request`

From nickthelegend/keeperhub-skills, MIT.

More from nickthelegend/keeperhub-skills