aave-v4

Aave V4 Progressive Disclosure Skills

Progressive disclosure skills for Aave V4 protocol development. These skills provide context-aware guidance for building on Aave V4's unified liquidity layer and modular hub-and-spoke architecture.

Installation

Claude Code

claude mcp add-json cyotee-plugins '{"type":"stdio","command":"npx","args":["@anthropic-ai/claude-code-mcp-server"],"env":{"CLAUDE_PLUGINS_DIRECTORY":"/path/to/cyotee-claude-plugins/plugins"}}'

OpenCode

Copy the .opencode/skills/ directory to your project.

Skills

Skill	Trigger Keywords	Description
aave-v4-architecture	hub-and-spoke, Hub, Spoke, unified liquidity	High-level protocol architecture overview
aave-v4-hub	Hub contract, liquidity hub, add, draw, restore	Hub operations and liquidity management
aave-v4-spoke	Spoke contract, supply, borrow, repay, withdraw, reserve	User-facing Spoke operations
aave-v4-risk-premium	risk premium, collateral risk, premium debt, collateral quality	Risk-based interest system
aave-v4-liquidation	liquidation, target health factor, Dutch auction	Redesigned liquidation engine
aave-v4-dynamic-config	dynamic configuration, configKey, collateral factor	Dynamic Risk Configuration system
aave-v4-position-manager	position manager, gateway, NativeTokenGateway, meta-transactions	Gateway contracts and authorization

Aave V4 Key Concepts

Hub-and-Spoke Architecture

Liquidity Providers ──► Spoke 1 ──┐
                                  │
Borrowers ────────────► Spoke 2 ──┼──► Hub (Liquidity)
                                  │
                       Spoke 3 ──┘

Risk Premium

Interest rate = Base Rate × (1 + User Risk Premium)

Users with higher-quality collateral (like ETH) pay lower rates.

Dynamic Risk Configuration

Multiple risk parameter sets can coexist. Positions bind to specific configurations, protecting users from unexpected parameter changes.

Target Health Factor Liquidation

V4 liquidates just enough to restore users to a configurable Target HF, rather than a fixed 50% close factor.

Repository Structure

aave-v4/
├── src/
│   ├── hub/                      # Hub contracts
│   │   ├── Hub.sol              # Central liquidity coordinator
│   │   └── HubConfigurator.sol
│   ├── spoke/                    # Spoke contracts
│   │   ├── Spoke.sol            # User-facing operations
│   │   └── SpokeConfigurator.sol
│   ├── position-manager/         # Gateway contracts
│   │   ├── NativeTokenGateway.sol
│   │   └── SignatureGateway.sol
│   └── libraries/                # Shared math libraries
├── tests/                        # Test suite
└── docs/                         # Documentation

Version Differences from V3

Feature	V3	V4
Architecture	Single Pool	Hub + multiple Spokes
Tokens	aTokens + DebtTokens	Share-based accounting
Interest	Fixed per asset	Base Rate + Risk Premium
Risk Params	Single global config	Dynamic Config Keys
Liquidation	50% close factor	Target Health Factor
Bonus	Static per asset	Dutch-auction style

License

UNLICENSED (matching Aave V4 license)