In this tutorial, we will use Scaffold-ETH and BuildBear to provide an interactive demonstration of how Aave v3 operates on a fork of the Ethereum Mainnet.Overview of Aave V3At its core, the Aave Protocol serves as a non-custodial decentralized liquidity platform, facilitating secure and efficient lending and borrowing of digital assets. The protocol involves three key participant roles:<ul><li>Suppliers - These individuals contribute liquidity to the protocol and, in return, earn interest on the assets they provide.</li><li>Borrowers - Participants who borrow assets from the protocol, doing so in an over-collateralized manner.</li><li>Liquidators - These users are responsible for identifying under-collateralized positions and initiating the liquidation process. Essentially, they serve as the guardians of borrower behavior, ensuring the overall health of the protocol's liquidity.</li></ul>These three parties maintain the protocol's functionality.Let's get started!To begin, navigate to the <a href="https://github.com/BuildBearLabs/scaffold-eth">scaffold-eth x BuildBear</a> repository.Here's why we recommend using scaffold-eth x BuildBear:<ul style="list-style-type:disc;"><li>It allows you to easily fork EVM-compatible chains (such as Ethereum, Polygon, Binance Smart Chain, Fantom, Optimism, and Arbitrum Mainnet) directly from the CLI. Saving you valuable time that would otherwise be spent searching for working RPCs.</li><li>You can mint native and ERC20 tokens effortlessly using the CLI, eliminating the need to waste time searching for functional faucets.</li></ul>To get started, click on the "Fork" button to create a copy of the repository on your own GitHub account. Please wait for the forking process to complete before proceeding.Next, open a terminal and clone the forked repository, which includes all the necessary components for building a decentralized application:<pre><code class="language-plaintext">git clone &lt;paste the URL you fork repo&gt;
cd scaffold-eth
</code></pre>To install all the required packages, execute the following command:<pre><code class="language-plaintext">yarn install
</code></pre>To execute the Flashloan Arbitrage, we can leverage the existing Aave Protocol and DEXs by forking the Ethereum Mainnet instead of redeploying these protocols.use the following command:<pre><code class="language-plaintext">yarn fork-bb
</code></pre><figure class="image"><img src="https://strapi.buildbear.io/uploads/Untitled_0c2cb74d6c.gif" alt="Untitled.gif"></figure>Deploying the contracts<pre><code class="language-plaintext">yarn deploy
</code></pre><figure class="image image_resized" style="width:75%;"><img src="https://strapi.buildbear.io/uploads/Untitled_190c35599c.png" alt="Untitled.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_190c35599c.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_190c35599c.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_190c35599c.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_190c35599c.png 1000w," sizes="100vw"></figure>🚨&nbsp;If you are using a Node version &lt; v18 you will need to remove&nbsp;<code>openssl-legacy-provider</code>&nbsp;from the&nbsp;<code>start</code>&nbsp;script in&nbsp;<code>package.json</code> Starting the frontend<pre><code class="language-plaintext">yarn start 
</code></pre>Once the application is running, you can access it at <a href="http://localhost:3000">http://localhost:3000</a> and you should see the following:<figure class="image image_resized" style="width:75%;"><img src="https://strapi.buildbear.io/uploads/Untitled_1_cf21b31055.png" alt="Untitled 1.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_1_cf21b31055.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_1_cf21b31055.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_1_cf21b31055.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_1_cf21b31055.png 1000w," sizes="100vw"></figure>Before diving deeper into the smart contract, let's start by exploring the functionalities of Aave. To begin, navigate to the Aave page.<figure class="image image_resized" style="width:75%;"><img src="https://strapi.buildbear.io/uploads/Untitled_2_d446b3fa8a.png" alt="Untitled 2.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_2_d446b3fa8a.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_2_d446b3fa8a.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_2_d446b3fa8a.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_2_d446b3fa8a.png 1000w," sizes="100vw"></figure>On the Aave page, you are presented with the options to add liquidity, withdraw, borrow, and repay.Let's delve deeper into the Smart contract.In Aave V3, the core functionality of the protocol is implemented in several contracts. Let's analyze each of these contracts:Pool.sol: ◦ The&nbsp;<code>Pool.sol</code>&nbsp;contract is the main contract in the Aave v3 protocol that serves as the interaction point for users with the Aave market. ◦ It allows users to perform actions such as supply, withdraw, borrow, repay, swap borrow rate mode, enable/disable collateral, liquidation, and flash loans. ◦ The contract manages reserves, which represent the individual assets in the protocol, and users' accounts. ◦ It implements various functions for each action, which are executed based on the input parameters. ◦ The contract includes modifiers to restrict access to certain functions to authorized parties such as the pool configurator and admin.L2Pool.sol: ◦ <code>L2Pool.sol</code>&nbsp;is an extension of the&nbsp;<code>Pool.sol</code>&nbsp;contract, optimized for L2 (Layer 2) rollup solutions. ◦ It reduces transaction costs on rollups by allowing users to pass compact calldata representations of function parameters.PoolConfigurator.sol: ◦ The&nbsp;<code>PoolConfigurator.sol</code>&nbsp;contract is responsible for configuring and initializing the Aave market parameters. ◦ It has access to the pool admin functions and handles the initialization of reserves, interest rate strategies, and other pool configurations. ◦ Only the pool configurator contract defined in the&nbsp;<code>PoolAddressesProvider</code>&nbsp;can call the functions marked by the&nbsp;<code>onlyPoolConfigurator</code>&nbsp;modifier in the Pool contract.PoolStorage.sol: ◦ The&nbsp;<code>PoolStorage.sol</code>&nbsp;contract defines the storage layout for the&nbsp;<code>Pool.sol</code>&nbsp;contract. ◦ It includes mappings to store reserves data, user configuration data, eMode categories data, and bridge protocol fee data.DefaultReserveInterestRateStrategy.sol: ◦ The&nbsp;<code>DefaultReserveInterestRateStrategy.sol</code>&nbsp;contract provides the default interest rate strategy for reserves in the Aave protocol. ◦ It calculates the interest rate based on the utilization rate of the reserve and other factors. ◦ The interest rate strategy can be customized by implementing a different interest rate strategy contract and updating it in the&nbsp;<code>Pool.sol</code>&nbsp;contract.These contracts work together to provide the core functionalities of the Aave v3 protocol, including managing reserves, user accounts, interest rates, and various operations like lending, borrowing, and liquidation.Most user interactions with the Aave Protocol occur via the Pool contract. let's dive deeper into pool contracts.In the code snippet below, we have included only the key functions that users utilize. You can locate the complete <code>Aave.sol</code> contract in <code>packages/hardhat/contracts</code>:<figure class="image"><img src="https://strapi.buildbear.io/uploads/carbon_9_5012eb2db2.svg" alt="carbon_(9).svg"></figure>Let's break down the key components and functionalities of the contract:The&nbsp;<code>Supply</code>&nbsp;function allows users to supply assets to the Aave protocol. It first checks if the asset can be enabled as collateral. If it can be enabled as collateral and the user is not already using it as collateral, it emits the&nbsp;<code>ReserveUsedAsCollateralEnabled</code>&nbsp;event. It then transfers the assets from the user to the protocol's contract and updates the user's supply balance. Finally, it emits the&nbsp;<code>Supply</code>&nbsp;event.The&nbsp;<code>Withdraw</code>&nbsp;function allows users to withdraw their assets from the Aave protocol. It transfers the specified amount of assets from the protocol's contract to the user's wallet and updates the user's supply balance. It also emits the&nbsp;<code>Withdraw</code>&nbsp;event.The&nbsp;<code>Borrow</code>&nbsp;function allows users to borrow assets from the Aave protocol. It first checks if the user is eligible to borrow, and if so, transfers the borrowed assets to the user's wallet and updates the user's borrow balance. It also emits the&nbsp;<code>Borrow</code>&nbsp;event.The&nbsp;<code>Repay</code>&nbsp;function allows users to repay their borrowings. It transfers the specified amount of assets (either directly or using aTokens) from the user's wallet to the protocol's contract, and updates the user's borrow balance. It also emits the&nbsp;<code>Repay</code>&nbsp;event.Here is a breakdown of the <code>flashloan</code> function:The function starts by validating the flashloan request, ensuring that the requested assets and amounts are valid.It then initializes local variables and calculates the total premiums for each flashloaned asset.Next, it transfers the requested amounts of each asset to the receiver's address (the borrower).It calls the&nbsp;<code>executeOperation</code>&nbsp;function on the&nbsp;<code>receiver</code>&nbsp;contract, which is the borrower's smart contract.The borrower's contract must implement the&nbsp;<code>IFlashLoanReceiver</code>&nbsp;interface and define the&nbsp;<code>executeOperation</code>&nbsp;function, which is where the borrower can perform actions with the flashloaned fundsAfter the borrower's contract completes the operation, the function continues to handle the repayment of the flashloan.If the flashloan premium is set to zero (indicating that the borrower will repay the exact amount borrowed), it calls the&nbsp;<code>_handleFlashLoanRepayment</code>&nbsp;function to handle the repayment and update the state of the reserve.If the flashloan premium is non-zero, indicating that the user wants to open a debt position with the borrowed funds, it calls the&nbsp;<code>executeBorrow</code>&nbsp;function from the&nbsp;<code>BorrowLogic</code>&nbsp;library to open the debt position. No premium is paid when taking on the flashloan as debt.Let’s interact with the protocol:Supply Token:First, select the token you wish to supply. Enter the desired amount and make sure to approve the tokens before adding liquidity. In our example, we've supplied 1000 DAI, resulting in the receipt of 1000 aETHDAI, representing our supply position.<figure class="image image_resized" style="width:25%;"><img src="https://strapi.buildbear.io/uploads/Untitled_3_299d39a839.png" alt="Untitled 3.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_3_299d39a839.png 245w," sizes="100vw"></figure><figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Untitled_4_151ba63665.png" alt="Untitled 4.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_4_151ba63665.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_4_151ba63665.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_4_151ba63665.png 750w," sizes="100vw"></figure>Withdraw:To withdraw, select the token you want to withdraw and specify the amount. Then, click on the Withdraw button.<figure class="image image_resized" style="width:25%;"><img src="https://strapi.buildbear.io/uploads/Untitled_5_2429f172ce.png" alt="Untitled 5.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_5_2429f172ce.png 245w," sizes="100vw"></figure>As illustrated, when we withdraw, we return the A token of what we supplied and receive back our initial token.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Untitled_6_f0398d0723.png" alt="Untitled 6.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_6_f0398d0723.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_6_f0398d0723.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_6_f0398d0723.png 750w," sizes="100vw"></figure>Borrow :Given that we've supplied tokens, we now have the option to borrow tokens with a value lower than our supplied amount.<figure class="image image_resized" style="width:25%;"><img src="https://strapi.buildbear.io/uploads/Untitled_7_205bebf902.png" alt="Untitled 7.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_7_205bebf902.png 245w," sizes="100vw"></figure>Since we are borrowing, we receive variable debt tokens that represent our borrowing position.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Untitled_8_d03b256c61.png" alt="Untitled 8.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_8_d03b256c61.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_8_d03b256c61.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_8_d03b256c61.png 750w," sizes="100vw"></figure>Repay:<figure class="image image_resized" style="width:25%;"><img src="https://strapi.buildbear.io/uploads/Untitled_9_e202a57072.png" alt="Untitled 9.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_9_e202a57072.png 245w," sizes="100vw"></figure>When we repay our borrowed amount, the variable debt tokens are burned.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Untitled_10_df2f193c6d.png" alt="Untitled 10.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_10_df2f193c6d.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_10_df2f193c6d.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_10_df2f193c6d.png 750w," sizes="100vw"></figure>🎉🎉 Congratulations!We have successfully added liquidity, withdraw, borrow, and repay on Aave v3.If you appreciate what we are doing, please follow us on&nbsp;<a href="https://twitter.com/_BuildBear">Twitter</a>, and&nbsp;<a href="https://www.linkedin.com/company/build-bear/">LinkedIn</a>&nbsp;and&nbsp;<a href="https://t.me/+6mjOnBFUR9xjN2U1">Join the Telegram</a>&nbsp;group if you haven’t done yet.Github Repo :&nbsp; <a href="https://github.com/BuildBearLabs/scaffold-eth">scaffold-eth x BuildBear</a>About BuildBear:BuildBear is a platform for testing dApps at scale, for teams. It provides users with their own private Testnet to test their smart contracts and dApps, which can be forked from any EVM chain. It also provides a Faucet, Explorer, and RPC for testing purposes.<blockquote>BuildBear aims to build an ecosystem of tools for testing dApps at scale for the teams.</blockquote>Check out the projects we build on <a href="https://github.com/BuildBearLabs/scaffold-eth">scaffold-eth x BuildBear</a> and keep learning :<ul style="list-style-type:disc;"><li><a href="https://www.buildbear.io/resources/guides-and-tutorials/Build_Your_Own_Decentralized_Lending_Protocol">Build Your Own Decentralized Lending Protocol</a></li><li><a href="https://www.buildbear.io/resources/guides-and-tutorials/Build_your_own_Decentralized_Exchange">Build your own Decentralized Exchange</a></li><li><a href="https://www.buildbear.io/resources/guides-and-tutorials/Flashloan_Arbitrage_BoT">A Comprehensive Step-by-Step Guide for Building a Flashloan Arbitrage Bot</a></li></ul>Author: <a href="https://twitter.com/chandan1_">chandan</a>

Template for Tutorials.png

Aave Protocol serves as a non-custodial decentralized liquidity platform, facilitating secure and efficient lending and borrowing of digital assets. In this tutorial, we will use Scaffold-ETH and BuildBear to provide an interactive demonstration of how Aave v3 operates on a fork of the Ethereum Mainnet.

Understanding the Mechanics of Aave V3

BUILDBEAR // TUTORIALS

Understanding the Mechanics of Aave V3

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.