A decentralized lending protocol with multi-asset collateral support, automatic rebalancing, and anti-liquidation protection. Built on Arbitrum Sepolia.
- ✅ Multi-Asset Collateral: Deposit USDC, Yield tokens, and RWA tokens
- ✅ Flexible Lending: Borrow USDC with customizable loan durations
- ✅ Risk-Weighted Assets: Different collateral types have different risk weights
- ✅ Real-Time Oracle: Dynamic price feeds for all assets
- ✅ Anti-Liquidation Protection: Automatic protection during market volatility
- ✅ Automated Rebalancing: Portfolio optimization across asset types
- ✅ Yield Management: Earn yield on deposited assets
- 🎨 Modern UI: Clean, responsive interface with dark mode
- 🔐 Wallet Integration: MetaMask, WalletConnect, and more
- 📊 Real-Time Dashboard: Live position tracking and health factor monitoring
- ⚡ Instant Updates: Automatic data refresh every 10 seconds
- 🎯 User-Friendly: Simple deposit, borrow, and repay flows
- 💰 Built-in Faucet: Get test tokens directly from the interface
secp-protocol/
├── smart-contracts/ # Solidity contracts and deployment scripts
│ ├── contracts/ # Smart contract source files
│ ├── scripts/ # Deployment and interaction scripts
│ ├── test/ # Contract tests
│ └── deployments/ # Deployed contract addresses
│
└── frontend/ # Next.js frontend application
├── src/
│ ├── app/ # Next.js pages
│ ├── components/ # React components
│ ├── config/ # Configuration (contracts, wagmi)
│ └── hooks/ # Custom React hooks
└── public/ # Static assets
- Node.js 18 or higher
- Git
- MetaMask or another Web3 wallet
- Arbitrum Sepolia testnet ETH
The contracts are already deployed on Arbitrum Sepolia testnet:
cd smart-contracts
npm install
# View deployment addresses
cat deployments/arbitrum-sepolia.jsonDeployed Contracts:
- SmartVault:
0x2e8026bc45fe0fae2b159a3c82cada12670769e2 - LoanManager:
0xba5be20d3d96e89ffbf20f9812df73cada28e376 - CollateralManager:
0xfa7e1a8e4be412b9c7efcbb5f14ddcc5820da599 - See all 10 contracts
cd frontend
npm install
npm run dev📖 Detailed Guide: See frontend/QUICKSTART.md
-
Connect Wallet
- Click "Connect Wallet" button
- Select MetaMask
- Switch to Arbitrum Sepolia network
-
Get Test Tokens
- Use the Token Faucet on the page
- Click "Get 1,000 tokens" for each token type
- Approve transactions in your wallet
-
Deposit Collateral
- Select a token (USDC, Yield, or RWA)
- Enter amount
- Approve and deposit
-
Borrow USDC
- View your max borrowable amount (75% of collateral)
- Enter borrow amount and duration
- Confirm transaction
-
Monitor Position
- Watch your health factor (keep it above 1.0)
- Track collateral value and debt
- View real-time updates
Your position's safety indicator:
- > 1.5: Safe ✅
- 1.0 - 1.5: Moderate
⚠️ - < 1.0: At Risk ❌ (risk of liquidation)
Different assets have different risk weights affecting their collateral value:
- RWA Token: 100% (best)
- USDC: 90%
- Yield Token: 80%
You can borrow up to 75% of your collateral value, leaving a safety buffer.
Deposit: 1,000 USDC
Collateral Value: $900 (90% weight)
Max Borrow: $675 (75% of collateral)
Health Factor: >2.0 ✅
Deposit: 600 RWA tokens @ $1.50 each
Collateral Value: $900 (100% weight)
Max Borrow: $675
Health Factor: >2.0 ✅
Deposit:
- 400 USDC = $360 collateral
- 300 RWA = $450 collateral
- 200 Yield = $168 collateral
Total Collateral: $978
Max Borrow: $733.50
cd smart-contracts
# Compile contracts
npm run compile
# Run tests
npm test
# Deploy (already done)
npm run deploy:arbitrum
# Setup protocol
npm run setup:arbitrum
# Interact with protocol
npm run interact:arbitrumcd frontend
# Install dependencies
npm install
# Run development server
npm run dev
# Build for production
npm run build
# Start production server
npm start-
Smart Contract Security
- OpenZeppelin battle-tested contracts
- Comprehensive testing
- Access control mechanisms
-
Anti-Liquidation Protection
- Automatic protection activation
- Time-based protection windows
- Gradual debt repayment
-
Risk Management
- Multiple collateral types
- Dynamic risk assessment
- Real-time health factor monitoring
- Network: Arbitrum Sepolia (Testnet)
- Chain ID: 421614
- RPC: https://sepolia-rollup.arbitrum.io/rpc
- Explorer: https://sepolia.arbiscan.io
- Open MetaMask
- Click network dropdown
- "Add Network" → "Add network manually"
- Enter Arbitrum Sepolia details above
cd smart-contracts
npm test- Connect wallet
- Mint test tokens
- Deposit collateral
- Borrow USDC
- Check health factor
- Verify all UI updates correctly
- Solidity 0.8.28
- Hardhat 3.1.8
- OpenZeppelin 5.4.0
- Viem for TypeScript integration
- Next.js 14 (App Router)
- TypeScript
- Tailwind CSS
- Wagmi (React Hooks for Ethereum)
- RainbowKit (Wallet Connection)
- Viem (Ethereum Library)
Issue: Wallet won't connect
- Solution: Refresh page, ensure MetaMask is unlocked
Issue: Transactions failing
- Solution: Check you have testnet ETH for gas fees
Issue: Can't deposit
- Solution: Make sure to approve token spending first
Issue: Data not loading
- Solution: Verify you're on Arbitrum Sepolia network
See QUICKSTART.md for more troubleshooting tips.
- Mainnet deployment
- Additional token support
- Advanced analytics dashboard
- Mobile app
- Governance token
- Cross-chain support
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
MIT License - see LICENSE file for details
- OpenZeppelin for secure contract libraries
- Arbitrum for the L2 infrastructure
- Hardhat for development tools
- Next.js and Vercel for frontend framework
Need help?
- 📖 Check the documentation
- 🐛 Open an issue on GitHub
- 💬 Review troubleshooting guides
- 🔍 Search on Arbitrum Sepolia explorer
Built with ❤️ for the DeFi community
🌟 Star this repo if you found it helpful!