🏠 Land Registration System with Blockchain

A decentralized land registration system built on Ethereum blockchain that ensures transparent, secure, and immutable property ownership records.

📋 Table of Contents

Features
Technology Stack
System Architecture
Prerequisites
Installation
Configuration
Usage
Smart Contracts
API Endpoints
Contributing
License

✨ Features

🔐 Secure Property Registration: Blockchain-based immutable property records
👥 Multi-Role System: Separate interfaces for users and revenue officers
📄 Document Management: Upload and store property documents using GridFS
💰 Property Trading: Built-in marketplace for property buying/selling
🔍 Ownership Verification: Transparent ownership history and verification
⚡ Real-time Updates: Live transaction status and property state changes
🛡️ Smart Contract Security: Automated ownership transfer with built-in validations

🛠️ Technology Stack

Frontend

HTML5/CSS3/JavaScript: User interface
Bootstrap: Responsive design framework
Web3.js: Blockchain interaction

Backend

Python Flask: Web application framework
MongoDB: Database for off-chain data storage
GridFS: File storage system for documents

Blockchain

Solidity: Smart contract development
Truffle: Development framework
Ganache: Local blockchain for testing
Web3.py: Python blockchain integration

🏗️ System Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Users Portal  │    │ Revenue Portal  │    │   Blockchain    │
│   (Port 5000)   │    │   (Port 5001)   │    │   (Port 8545)   │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                    ┌─────────────┴───────────┐
                    │      MongoDB           │
                    │    (Port 27017)        │
                    └─────────────────────────┘

📋 Prerequisites

Before running this project, make sure you have the following installed:

Node.js (v14.0.0 or higher)
Python (v3.8 or higher)
MongoDB (v4.4 or higher)
Git
MetaMask browser extension

🚀 Installation

1. Clone the Repository

git clone https://github.com/deeksha006/Land-Registration-System-with-Blockchain.git
cd Land-Registration-System-with-Blockchain

2. Install Python Dependencies

pip install -r python_package_requirements.txt

3. Install Node.js Dependencies

npm install -g truffle ganache-cli
cd Smart_contracts
npm install

4. Install and Setup MongoDB

Download and install MongoDB from official website
Start MongoDB service on localhost:27017

5. Install Ganache (Choose one)

Option A: Ganache GUI (Recommended)

Download from Truffle Suite
Install and create a new workspace

Option B: Ganache CLI

npm install -g ganache-cli

⚙️ Configuration

1. Ganache Setup

Network ID: 1337
RPC Server: http://127.0.0.1:8545
Accounts: 10 accounts with 100 ETH each

2. Update Configuration Files

The system is pre-configured for local development. Key configuration files:

Revenue/config.json: Revenue department settings
Smart_contracts/truffle-config.js: Blockchain network configuration

3. MetaMask Setup

Install MetaMask browser extension
Add custom network:
- Network Name: Ganache Local
- RPC URL: http://127.0.0.1:8545
- Chain ID: 1337
- Currency Symbol: ETH

🎯 Usage

1. Start MongoDB

Ensure MongoDB is running on localhost:27017

2. Start Ganache

Using Ganache GUI:

Open Ganache and start your workspace

Using Ganache CLI:

ganache-cli -p 8545 -d

3. Deploy Smart Contracts

cd Smart_contracts
truffle migrate --reset

4. Start Applications

Users Portal:

python Users/app.py

Access at: http://localhost:5000

Revenue Portal:

python Revenue/app.py

Access at: http://localhost:5001

📜 Smart Contracts

Contract Overview

Contract	Purpose	Address
Users	User registration and management	Auto-deployed
Property	Property details and state management	Auto-deployed
LandRegistry	Land ownership mapping	Auto-deployed
TransferOwnerShip	Property transfer and sales	Auto-deployed

Key Functions

registerUser(): Register new users
addProperty(): Add property to blockchain
verifyProperty(): Revenue officer verification
makePropertyAvailable(): List property for sale
requestToBuy(): Initiate purchase request
transferOwnership(): Complete ownership transfer

🔗 API Endpoints

Users Portal (Port 5000)

GET /: Home page
GET /register: User registration page
GET /dashboard: User dashboard
POST /uploadPropertyDocs: Upload property documents
GET /availableToBuy: View properties for sale

Revenue Portal (Port 5001)

GET /: Revenue officer login
GET /dashboard: Revenue dashboard
POST /verifyProperty: Verify property details
GET /allProperties: View all registered properties

🔄 Workflow

Property Registration Process

User Registration: Users register on the platform
Property Submission: Users submit property details and documents
Revenue Verification: Revenue officers verify property authenticity
Blockchain Recording: Verified properties are recorded on blockchain
Marketplace Listing: Approved properties can be listed for sale
Ownership Transfer: Secure transfer of ownership through smart contracts

User Roles

Property Owners: Register and manage their properties
Buyers: Browse and purchase available properties
Revenue Officers: Verify and approve property registrations

🧪 Testing

Run Smart Contract Tests

cd Smart_contracts
truffle test

Manual Testing Steps

Register a new user
Add a property with documents
Verify property as revenue officer
List property for sale
Complete a property purchase transaction

📁 Project Structure

Land-Registration-System-with-Blockchain/
├── Users/                          # User portal application
│   ├── app.py                     # Flask application
│   ├── web/                       # Frontend files
│   │   ├── templates/             # HTML templates
│   │   └── static/                # CSS, JS, images
│   └── Property_Docs/             # Uploaded documents
├── Revenue/                        # Revenue department portal
│   ├── app.py                     # Flask application
│   ├── config.json                # Configuration file
│   ├── templates/                 # HTML templates
│   ├── static/                    # Static files
│   └── utility/                   # Helper functions
├── Smart_contracts/                # Blockchain contracts
│   ├── contracts/                 # Solidity contracts
│   │   ├── Users.sol              # User management
│   │   ├── Properties.sol         # Property management
│   │   ├── LandRegistry.sol       # Land registry
│   │   └── TransferOfOwnership.sol # Ownership transfer
│   ├── migrations/                # Deployment scripts
│   ├── build/                     # Compiled contracts
│   └── truffle-config.js          # Truffle configuration
├── python_package_requirements.txt # Python dependencies
├── deploy_contracts.bat           # Contract deployment script
└── README.md                      # Project documentation

✅ Recent Fixes (2025-07-22)

Fixed Issues:

Bootstrap Integrity Errors - Removed incorrect SHA-384 hashes
Contract Details 500 Errors - Fixed file paths for Smart_contracts
JavaScript JSON Parsing - Added comprehensive error handling
Python 3.9 Compatibility - Created app_simple.py versions without web3 conflicts
Missing Login Endpoints - Added proper FormData handling for Revenue portal
File Upload Issues - Enhanced document upload functionality

Python 3.9 Compatibility:

If you encounter TypeError: unhashable type: 'list' errors with web3/aiohttp:

Use Users/app_simple.py instead of Users/app.py
Use Revenue/app_simple.py instead of Revenue/app.py
These simplified versions avoid the typing module conflicts

Current Working Setup:

Users Portal: python app_simple.py (Port 5001)
Revenue Portal: python app_simple.py (Port 5002)
MongoDB: localhost:27017
Ganache: localhost:8545 (Chain ID: 1337)

🚨 Troubleshooting

Common Issues

1. Port Already in Use

# Kill process using port
netstat -ano | findstr :8545
taskkill /PID <PID> /F

2. Contract Deployment Failed

Ensure Ganache is running
Check network configuration in truffle-config.js
Verify sufficient ETH in deployment account

3. MongoDB Connection Error

Start MongoDB service
Check connection string in application files

4. MetaMask Connection Issues

Verify custom network settings
Import Ganache account using private key
Reset MetaMask account if needed

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

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

🙏 Acknowledgments

Ethereum Foundation for blockchain technology
Truffle Suite for development tools
MongoDB for database solutions
Flask community for web framework

📞 Support

For support and questions:

Create an issue in the GitHub repository
Contact: [your-email@example.com]

⭐ If you found this project helpful, please give it a star!

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
Revenue		Revenue
Smart_contracts		Smart_contracts
Users		Users
readme_assests		readme_assests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
ReadMe.md		ReadMe.md
SETUP_GUIDE.md		SETUP_GUIDE.md
flowchart.png		flowchart.png
package.json		package.json
python_package_requirements.txt		python_package_requirements.txt
start_system.py		start_system.py

License

deeksha006/Land-Registration-System-with-Blockchain

Folders and files

Latest commit

History

Repository files navigation