Decentralized lending protocols allow users to lend and borrow cryptocurrencies directly on the blockchain through smart contracts, without the need for intermediaries such as banks. In this tutorial, you will learn how to build your own decentralized lending protocol from scratch using Solidity.By the end of this tutorial, you will have a solid understanding of the fundamental principles behind decentralized lending protocols, including how to add liquidity, borrow funds, and repay loans. You will also gain hands-on experience in writing and deploying smart contracts on the Ethereum blockchain.Let’s get started!<h1 style="margin-left:0px;">Prerequisites</h1>Before getting started, please ensure that you have the following prerequisites installed on your system:<ul><li><a href="https://nodejs.org/en/download/">NodeJS</a> (version &gt;= 10)</li><li><a href="https://classic.yarnpkg.com/en/docs/install/">Yarn</a></li><li><a href="https://git-scm.com/downloads">Git</a></li></ul><h1 style="margin-left:0px;">Getting Started</h1>This tutorial was developed using scaffold-eth x BuildBear repository, which has now been archived. For updated tutorials, please refer to the <a href="https://github.com/BuildBearLabs/Scaffold-Eth-2-BuildBear">scaffold Eth2 x Buildbear</a> repo. You can find the latest code and instructions in the updated repository.Here’s why we recommend using scaffold-eth2 x BuildBear:<ol><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></ol>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-javascript">git clone &lt;paste the URL you fork repo&gt;
cd Scaffold-Eth-2-BuildBear</code></pre>To install all the required packages, execute the following command:<pre><code class="language-javascript">yarn install</code></pre>To fork the Mainnet, use the following command: Choose your desired blockchain and enter the block number from which you wish to fork. Alternatively, you can leave the default value as is.<pre><code class="language-javascript">yarn fork-bb</code></pre><figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*JKjt4Lut0DSnKcgHaPjL5g.gif" alt="" loading="lazy"></figure>Deploying the contracts<pre><code class="language-javascript">yarn deploy</code></pre><figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*sPUhW11ot7xSM3IbWi8bXA.png" alt="" loading="lazy"></figure>Starting the frontend<pre><code class="language-javascript">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:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_01_09_55_26_4daff5f007.png" alt="Screenshot from 2024-04-01 09-55-26.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_01_09_55_26_4daff5f007.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_01_09_55_26_4daff5f007.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_04_01_09_55_26_4daff5f007.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_04_01_09_55_26_4daff5f007.png 1000w," sizes="100vw"></figure>Before diving deeper into the smart contract, let’s start by exploring the functionalities of Lending. To begin, navigate to the Lending page.<figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_01_10_16_57_8b48618c48.png" alt="Screenshot from 2024-04-01 10-16-57.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_01_10_16_57_8b48618c48.png 245w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_01_10_16_57_8b48618c48.png 500w,https://strapi.buildbear.io/uploads/medium_Screenshot_from_2024_04_01_10_16_57_8b48618c48.png 750w,https://strapi.buildbear.io/uploads/large_Screenshot_from_2024_04_01_10_16_57_8b48618c48.png 1000w," sizes="100vw"></figure>To claim free ETH, Connect your wallet and grab funds from the faucet.<h2 style="margin-left:0px;">Add, Borrow, withdraw, and repay Functions</h2><figure class="image image_resized" style="width:50%;"><img src="https://strapi.buildbear.io/uploads/Screenshot_from_2024_04_01_10_18_08_f396cb9f56.png" alt="Screenshot from 2024-04-01 10-18-08.png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Screenshot_from_2024_04_01_10_18_08_f396cb9f56.png 150w,https://strapi.buildbear.io/uploads/small_Screenshot_from_2024_04_01_10_18_08_f396cb9f56.png 480w," sizes="100vw"></figure>Adding liquidity<ul style="list-style-type:disc;"><li>Enter the desired token amount.</li><li>Once you’ve entered the token amount, click on approve token and then proceed with the Adding liquidity</li><li>Approve the transaction on Metamask: A Metamask prompt will appear, requesting your approval. The Total Liquidity and liquidity provided will be updated.</li></ul>&nbsp;Withdraw liquidity<ul style="list-style-type:disc;"><li>Enter the amount you want to withdraw.</li><li>Once you’ve entered the token amount, click on Withdraw!</li><li>Approve the transaction on Metamask: A Metamask prompt will appear, requesting your approval. The Total Liquidity and liquidity provided will be updated.</li></ul>&nbsp;Borrow liquidity<ul style="list-style-type:disc;"><li>Enter the amount you want to borrow.</li><li>Once you’ve entered the token amount, click on Borrow!</li><li>Approve the transaction on Metamask: A Metamask prompt will appear, requesting your approval. The Total Liquidity, the liquidity provided, and borrowed Amount will be updated.</li></ul>&nbsp;Repay Loan<ul style="list-style-type:disc;"><li>Enter the amount you want to Repay.</li><li>Once you’ve entered the token amount, click on Repay!</li><li>Approve the transaction on Metamask: A Metamask prompt will appear, requesting your approval. The Total Liquidity, the liquidity provided, and borrowed Amount will be updated.</li></ul>&nbsp;Let’s dive deep into the Smart contractWe can find <code>lending.sol</code> contract in <code>packages/hardhat/contracts</code>:<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*5ah614H-6WUr3JqoMepKcw.png" alt="" loading="lazy"></figure><ul><li>The contract uses the Solidity version pragma ^<code>0.8.0</code>and is licensed under the MIT license.</li><li>The contract imports one external contract: <code>IERC20.sol</code> from the OpenZeppelin library. These contracts provide standardized ERC20 token functionality.</li><li><code>addLiquidity(uint256 _amount)</code>: This function allows users to deposit collateral tokens into the contract. The <code>_amount</code> parameter specifies the number of collateral tokens to deposit. The function first transfers the collateral tokens from the user to the contract and then adds the collateral tokens to the contract's liquidity. This function emits the <code>LiquidityAdded</code> event.</li><li><code>borrow(uint256 _amount)</code>: This function allows users to borrow lending tokens from the contract using their deposited collateral tokens as collateral. The <code>_amount</code> parameter specifies the number of lending tokens to borrow. The function first calculates the required collateral amount based on the collateral ratio and lending token amount, and then ensures that the user has sent enough ETH to cover the collateral and fee. The function then transfers the lending tokens to the user and updates the borrow amount for that user. This function emits the <code>Borrow</code> event.</li><li><code>repay(uint256 _amount)</code>: This function allows users to repay borrowed lending tokens and retrieve their collateral tokens. The <code>_amount</code> parameter specifies the number of lending tokens to repay. The function first transfers the lending tokens from the user to the contract, and then decreases the contract's liquidity by the amount of collateral tokens that the user should retrieve. Finally, the function transfers the collateral tokens from the contract to the user. This function emits the <code>Repay</code> event.</li><li><code>withdraw(uint256 _amount)</code>: This function allows users to withdraw their deposited collateral tokens from the contract. The <code>_amount</code> parameter specifies the number of collateral tokens to withdraw. The function first checks that the requested amount is available in the contract and that the user has enough balance, then transfers the collateral tokens from the contract to the user, and finally decreases the contract's liquidity by the amount of collateral tokens that were withdrawn. This function emits the <code>Withdrawal</code> event.</li><li><code>getLiquidity()</code>: This function returns the current amount of collateral tokens held by the contract.</li><li><code>getCollateralRatio()</code>: This function returns the current collateral ratio required by the contract, which is the amount of collateral tokens required per lending token borrowed.</li><li><code>getCollateralToken()</code>: This function returns the address of the collateral token contract used by the contract.</li><li><code>getOwner()</code>: This function returns the address of the owner of the contract.</li><li><code>getBorrowAmount(address _user)</code>: This function returns the current amount of lending tokens borrowed by the specified <code>_user</code>.</li><li><code>getBalance(address _user)</code>: This function returns the current balance of collateral tokens deposited by the specified <code>_user</code>.</li></ul>CongratulationsWe have successfully developed a basic lending protocol that enables users to perform lending and borrowing.Share your project on Twitter and LinkedIn and tag BuildBear.If you appreciate what we are doing, please follow us on <a href="https://twitter.com/_BuildBear">Twitter</a>, and <a href="https://www.linkedin.com/company/build-bear/">LinkedIn</a> and <a href="https://t.me/+6mjOnBFUR9xjN2U1">Join the Telegram</a> group if you haven’t done yet.And please give us a clap 👏 if you like our work.Github Repo : <a href="https://github.com/BuildBearLabs/Scaffold-Eth-2-BuildBear">Buildbear Tutorials</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>Author: <a href="https://twitter.com/chandan1_">chandan</a>

Template for Tutorials.png

Decentralized lending protocols allow users to lend and borrow cryptocurrencies directly on the blockchain through smart contracts, without the need for intermediaries such as banks. In this tutorial, you will learn how to build your own decentralized lending protocol from scratch using Solidity.

Build Your Own Decentralized Lending Protocol

BUILDBEAR // TUTORIALS

Build Your Own Decentralized Lending Protocol

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.