Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aave/aave-v3-core
This repository contains the core smart contracts of the Aave V3 protocol.
https://github.com/aave/aave-v3-core
blockchain defi ethereum solidity
Last synced: 5 days ago
JSON representation
This repository contains the core smart contracts of the Aave V3 protocol.
- Host: GitHub
- URL: https://github.com/aave/aave-v3-core
- Owner: aave
- License: other
- Created: 2021-07-27T08:54:40.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-09-03T13:56:47.000Z (5 months ago)
- Last Synced: 2025-01-14T17:46:35.109Z (12 days ago)
- Topics: blockchain, defi, ethereum, solidity
- Language: TypeScript
- Homepage: https://aave.com
- Size: 18.4 MB
- Stars: 897
- Watchers: 34
- Forks: 587
- Open Issues: 42
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
- Audit: audits/01-11-2021_OpenZeppelin_AaveV3.pdf
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- best-of-crypto - GitHub - 8% open · ⏱️ 07.03.2024): (Decentralized Finance (DeFi))
README
# ⚠️ This repository is DEPRECATED and no longer maintained ⚠️
For the latest Aave V3 code visit the V3 Origin Repository [here](https://github.com/aave-dao/aave-v3-origin).
[](https://github.com/aave/aave-v3-core/actions/workflows/node.js.yml)
[](https://codecov.io/gh/aave/aave-v3-core)
```
.///. .///. //. .// `/////////////-
`++:++` .++:++` :++` `++: `++:......---.`
`/+: -+/` `++- :+/` /+/ `/+/ `++.
/+/ :+/ /+: /+/ `/+/ /+/` `++.
-::/++::` /+: -::/++::` `/+: `++: :++` `++/:::::::::.
-:+++::-` `/+: --++/---` `++- .++- -++. `++/:::::::::.
-++. .++- -++` .++. .++. .++- `++.
.++- -++. .++. -++. -++``++- `++.
`++: :++` .++- :++` :+//+: `++:----------`
-/: :/- -/: :/. ://: `/////////////-
```
# Aave Protocol v3
This repository contains the smart contracts source code and markets configuration for Aave Protocol V3. The repository uses Docker Compose and Hardhat as development environment for compilation, testing and deployment tasks.
## What is Aave?
Aave is a decentralized non-custodial liquidity markets protocol where users can participate as suppliers or borrowers. Suppliers provide liquidity to the market to earn a passive income, while borrowers are able to borrow in an overcollateralized (perpetually) or undercollateralized (one-block liquidity) fashion.
## Documentation
See the link to the technical paper or visit the Aave Developer docs
- [Technical Paper](./techpaper/Aave_V3_Technical_Paper.pdf)
- [Developer Documentation](https://docs.aave.com/developers/)
## Audits and Formal Verification
You can find all audit reports under the audits folder
V3.0.1 - December 2022
- [PeckShield](./audits/09-12-2022_PeckShield_AaveV3-0-1.pdf)
- [SigmaPrime](./audits/23-12-2022_SigmaPrime_AaveV3-0-1.pdf)
V3 Round 1 - October 2021
- [ABDK](./audits/27-01-2022_ABDK_AaveV3.pdf)
- [OpenZeppelin](./audits/01-11-2021_OpenZeppelin_AaveV3.pdf)
- [Trail of Bits](./audits/07-01-2022_TrailOfBits_AaveV3.pdf)
- [Peckshield](./audits/14-01-2022_PeckShield_AaveV3.pdf)
V3 Round 2 - December 2021
- [SigmaPrime](./audits/27-01-2022_SigmaPrime_AaveV3.pdf)
Formal Verification - November 2021-January 2022
- [Certora](./certora/Aave_V3_Formal_Verification_Report_Jan2022.pdf)
## Connect with the community
You can join the [Discord](http://aave.com/discord) channel or the [Governance Forum](https://governance.aave.com/) to ask questions about the protocol or talk about Aave with other peers.
## Getting Started
You can install `@aave/core-v3` as an NPM package in your Hardhat or Truffle project to import the contracts and interfaces:
`npm install @aave/core-v3`
Import at Solidity files:
```
import {IPool} from "@aave/core-v3/contracts/interfaces/IPool.sol";
contract Misc {
function supply(address pool, address token, address user, uint256 amount) public {
IPool(pool).supply(token, amount, user, 0);
{...}
}
}
```
The JSON artifacts with the ABI and Bytecode are also included in the bundled NPM package at `artifacts/` directory.
Import JSON file via Node JS `require`:
```
const PoolV3Artifact = require('@aave/core-v3/artifacts/contracts/protocol/pool/Pool.sol/Pool.json');
// Log the ABI into console
console.log(PoolV3Artifact.abi)
```
## Setup
The repository uses Docker Compose to manage sensitive keys and load the configuration. Prior to any action like test or deploy, you must run `docker-compose up` to start the `contracts-env` container, and then connect to the container console via `docker-compose exec contracts-env bash`.
Follow the next steps to setup the repository:
- Install `docker` and `docker-compose`
- Create an environment file named `.env` and fill the next environment variables
```
# Add Alchemy or Infura provider keys, alchemy takes preference at the config level
ALCHEMY_KEY=""
INFURA_KEY=""
# Optional, if you plan to use Tenderly scripts
TENDERLY_PROJECT=""
TENDERLY_USERNAME=""
```
## Test
You can run the full test suite with the following commands:
```
# In one terminal
docker-compose up
# Open another tab or terminal
docker-compose exec contracts-env bash
# A new Bash terminal is prompted, connected to the container
npm run test
```