Lendr - Decentralized NFT Rental Marketplace

Lendr is a decentralized platform that allows users to rent NFTs securely using collateralized smart agreements, with an integrated reputation system, support for bidding, and a seamless Web3 login experience via Sign-In With Ethereum (SIWE).

Key Features

• Web3 Authentication

  • Sign-In With Ethereum (SIWE) using MetaMask or WalletConnect
  • Stateless authentication using NextAuth + JWT
  • Wallet-based identity system

• User Profiles

  • Customizable profile with username, bio, and avatar
  • Public profile with owned and listed NFTs
  • Social metrics including reputation score, ratings, and rental history

• NFT Listings

  • List NFTs with price per day and collateral requirements
  • Set rental duration and auto-renewal options
  • Pull NFT metadata from blockchain or IPFS

• Rental Contracts

  • Secure rental agreements with collateral locking
  • Automated NFT return system
  • Smart contract dispute resolution

• Bidding System

  • Optional bidding for high-value NFTs
  • Custom bid parameters (price, duration, message)
  • Owner review and acceptance workflow

Use Cases

• Gamers: Rent rare weapons, skins, or characters
• Collectors: Generate yield from idle NFTs
• DAOs: Offer shared NFT assets to members
• Events: Rent ticket NFTs for gated content

Project Structure

lendr/
├── apps/
│   ├── api/                 # Backend API service (NestJS)
│   └── client/              # Frontend application (Next.js)
│
├── packages/                # Shared packages
│   ├── eslint-config/       # Shared ESLint configuration
│   ├── shared-dtos/         # Shared Data Transfer Objects
│   ├── typescript-config/   # Shared TypeScript configuration
│   └── ui/                  # Shared UI components
│
├── prisma/                  # Database schema and migrations
├── rental-escrow-smart-contract/  # Smart contract implementation
│
├── .env                    # Environment variables
├── .gitignore             # Git ignore rules
├── docker-compose.yml      # Docker Compose configuration
├── package.json            # Root package.json
└── turbo.json             # Turborepo configuration

Tech Stack

• Backend: NestJS, Prisma, PostgreSQL
• Frontend: React, Next.js, TypeScript, RainbowKit
• Smart Contracts: Solidity, Hardhat
• Authentication: SIWE, NextAuth.js
• Database: PostgreSQL
• Orchestration: Docker Compose

Getting Started

Prerequisites

• Node.js (latest LTS version recommended)
• pnpm (v10.13.1 or later)
• Git

Installation

1. Clone the repository

   git clone https://github.com/CS-Martin/lendr.git
   cd lendr

2. Install dependencies

   pnpm install

3. Set up environment variables

   • Copy .env.example to .env in the root directory
   • Update the environment variables with your configuration

4. Generate Prisma client

   npx prisma generate

Running the Application

Start both API and Client (recommended for development)

pnpm run dev

Start applications individually

• Run API server only

  pnpm run dev:api

• Run Client application only

  pnpm run dev:client

Build for production

pnpm run build
pnpm start

Development URLs

• Client: http://localhost:3000
• API: http://localhost:4000

Development

• Live Reload: Nx/Turbo for fast development
• Type Safety: Shared DTOs for frontend/backend
• Dockerized: Fully containerized development environment
• CI/CD Ready: Pre-configured for deployment

Security

• Smart Contracts: Secure implementation of ERC-4907/ERC-5006
• Authentication: Wallet-based identity verification
• Data Protection: End-to-end encryption for sensitive data

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Support

For support, please open an issue in the GitHub repository.

Roadmap

• Basic NFT rental system
• SIWE authentication
• User messaging system
• Multi-chain support
• On-chain dispute resolution