Network Upgrades and Forks
Documents major protocol version releases (v2, v3, v3.x), market migrations, and the activation of Aave on new networks. Includes the technical specifications for core architecture changes such as Portal, eMode, isolation mode, and cross-chain governance bridges. Exchange and custody teams track this group to understand which network deployments are canonical and what migration paths exist for user funds. Differs from Operations and Releases by covering protocol-level architectural shifts rather than client or UI releases.
V1 to V2 Migration
Technical reference for the architectural shift from direct peer-to-lending to the aToken interest-bearing model. Covers the migration tool contract mechanics, the sunsetting of V1 markets, and the state of legacy positions. Custody teams and integrators with stranded V1 assets need this to plan fund recovery or understand historical protocol debt assumptions.
V2 Architecture and Features
Canonical snapshot of the V2 stable architecture documenting flash loans, native credit delegation, debt tokenization, and the collateral swap adapter. Serves as the baseline for teams maintaining V2 forks or auditing pre-V3 integrations. Includes the upgrade path implications for protocols still dependent on V2 interfaces.
V3 Architecture and Core Enhancements
Master specification for the current major version covering the modular Pool.sol, AToken.sol redesign, and RewardsController. Primary landing page for teams migrating from V2 or deploying Aave on a new network. Details breaking contract changes, new event signatures, and integration requirements for exchanges and wallets.
Portal Cross-Chain Liquidity
Technical specification for the Portal feature's burn-and-mint bridge mechanism across whitelisted networks. Documents the trust assumptions of the bridge contracts, the canonical list of supported chains and bridge addresses, and the operational risks for cross-chain arbitrageurs and custody teams managing multi-network positions.
E-Mode Efficiency Mode
Technical documentation for the high-efficiency leverage feature grouping correlated assets into EModeCategories. Covers the category manager contract, the impact on liquidation thresholds and LTV for stablecoin and ETH derivative pairs, and the risk implications for institutional borrowers and risk managers monitoring correlated asset drawdowns.
Isolation Mode
Specification page for the risk-management feature that silos volatile assets with a debt ceiling. Details how isolated assets interact with the main pool, borrowing restrictions, and the technical implementation of the debt ceiling. Essential for risk teams assessing the onboarding of new collateral types and for integrators building on top of isolated markets.
V3.1 and V3.2 Feature Rollouts
Living document tracking post-V3.0 architectural additions including the L2Pool for gas-optimized deployments and dynamic interest rate strategy updates. Covers incremental but breaking contract changes that affect integrators, liquidators, and governance participants. Teams use this to anticipate required client and subgraph updates.
Canonical Network Deployments Registry
Single source of truth for all official Aave V3 market deployments across L1s, L2s, and sidechains. Lists exact contract addresses for the Pool, PoolAddressesProvider, and UiPoolDataProvider on each network. Exchange and custody teams use this page to verify they are interacting with a genuine Aave instance and to configure monitoring.
Aave V3 on Layer 2 Networks
Technical analysis of architectural differences for Aave V3 deployments on optimistic and ZK-rollups. Covers the L2Pool contract, governance message-passing, and the challenges of sequencer finality for liquidators. Required reading for teams operating on Arbitrum, Optimism, Base, or zkSync Era who need to understand gas optimization and cross-chain governance execution.
Avalanche Polygon and Sidechain Deployments
Documents the deployment history and architectural nuances of Aave on non-rollup sidechains and alt-L1s. Covers the initial V2 Polygon market, the migration to V3, and the unique governance bridge configurations for chains like Avalanche C-Chain and BNB Chain. Integrators use this to understand chain-specific risk parameters and bridge dependencies.
Aave V3 on Ethereum Mainnet
Dedicated page for the flagship Ethereum L1 V3 market tracking genesis parameters, the migration path from the V2 mainnet market, and the specific asset listings and eMode categories that define the canonical mainnet instance. Risk teams and large depositors monitor this page for parameter baselines and migration status.
GHO Stablecoin Deployment and Multi-Chain Strategy
Tracks the architectural rollout of the GHO stablecoin across networks. Covers the core GHO contracts, the facilitator model for minting permissions, and the technical mechanics of cross-chain GHO transfers via Portal or CCIP. Essential for integrators and exchanges planning to support GHO on networks beyond Ethereum mainnet.
Cross-Chain Governance Bridge Specification
Technical deep dive into the system executing Aave governance decisions across multiple networks. Documents the BridgeExecutor contract, the message-passing flow from Ethereum mainnet to L2s and sidechains, and the timelock and delay mechanisms protecting cross-chain execution. Critical for governance participants, security auditors, and teams verifying that executed proposals match on-chain state.
Governance V3 and Voting Machine Upgrades
Documents the architectural shift from Aave Governance V2 to the modular Governance V3 system. Covers the new voting machine, proposition power dynamics, and the separation of voting and execution layers. Power users and delegates use this page to understand the new governance flow, voting power calculation, and cross-chain proposal execution.