Skip to content

ndubuisi-ugwuja/DeFi-Liquidity-Network

Repository files navigation

📊 DeFi Liquidity Network

A full DeFi liquidity network built on Aave v3 lending protocol with working contract interfaces, scripts, and a web app to wrap ETH, deposit collateral, borrow stablecoins, repay, and withdraw. Whether you’re building a DeFi dApp, trading bot, or lending dashboard, this repo shows how to wire up real lending mechanics.

📖 Overview

This project serves as both a developer starter kit and an educational playground for understanding DeFi lending

It includes:

• Aave v3 contract interfaces (IPool, IPoolAddressesProvider, ERC20)

• Scripts to interact with Aave pools on Mainnet fork or Sepolia

• A web app for interacting with the protocol

• aToken handling (earning yield on deposits)

• Borrow & repay workflows with variable interest rate debt

• Modular helper scripts (getWeth, approveErc20, getUserData, getAwethBalance)

⚙️ Setup

  • Clone and install
git clone https://github.com/ndubuisi-ugwuja/DeFi-Liquidity-Network.git cd DeFi-Liquidity-Network
  • Configure environment Create .env file:
ALCHEMY_MAINNET_URL=https://eth-mainnet.g.alchemy.com/v2/<API_KEY>
ALCHEMY_SEPOLIA_URL=https://eth-sepolia.g.alchemy.com/v2/<API_KEY>
PRIVATE_KEY=0xYOUR_PRIVATE_KEY

🚀 Running the Workflow

Local (Mainnet Fork)

npx hardhat node --fork $ALCHEMY_MAINNET_URL
npx hardhat run scripts/aaveBorrow.js --network localhost

📜 License

MIT - free to use, modify, and distribute.

About

DeFi liquidity network built on Aave v3 lending protocol. This repo provides working contract interfaces, scripts, and a web app to wrap ETH, deposit collateral, borrow stablecoins, repay, and withdraw assets.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors