Blockchain-based Aadhaar System

A secure, blockchain-based identity management system inspired by India's Aadhaar system, featuring advanced cryptographic security, data encryption, and persistent storage.

What this project does

This project implements a blockchain-based identity management system that provides secure storage and retrieval of personal information. It combines the immutability of blockchain technology with advanced cryptographic security to create a reliable identity verification system.

Core workflows

Enhanced Security

• Cryptographically Secure Keys: Uses secrets module for secure key generation
• Data Encryption: Optional AES encryption using Fernet (cryptography library)
• Key Rotation: Automatic private key rotation after each access
• Timing Attack Protection: Uses secrets.compare_digest() for secure key comparison
• Password-based Encryption: PBKDF2 key derivation for encryption keys

Data Persistence

• Automatic Saving: Blockchain data persists between sessions
• JSON Serialization: Human-readable data storage format
• Integrity Verification: Built-in chain integrity checking
• Cross-session Continuity: Data remains available across application restarts

Input Validation

• Data Format Validation: Ensures proper name, address, contact format
• Contact Number Validation: Validates numeric contact information
• Error Handling: Comprehensive error handling and logging
• Input Sanitization: Prevents malicious input

Monitoring & Logging

• Activity Logging: All operations logged to blockchain.log
• Chain Statistics: View blockchain information and integrity status
• Access Tracking: Monitor data access attempts
• Performance Metrics: Built-in performance monitoring

Quick Start

Prerequisites

• Python 3.7 or higher
• pip package manager

Installation

1. Clone the repository:

   git clone https://github.com/Tuhin-SnapD/Aadhar-Blockchain-Prototype.git
   cd Aadhar-Blockchain-Prototype
   

2. Create virtual environment (recommended):

   python -m venv venv
   
   # On Windows:
   venv\Scripts\activate
   
   # On macOS/Linux:
   source venv/bin/activate
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Run the application:

   python blockchain-based-aadhaar.py
   

Usage Guide

Initial Setup

When you first run the application, you'll be prompted to:

• Choose whether to enable data encryption
• Set an encryption password (if encryption is enabled)

Sample Initial Setup:

🔐 Blockchain-based Aadhaar System
==================================================
Enable data encryption? (y/n): y
Enter encryption password: MySecurePassword123!
✅ Blockchain initialized successfully!
🔒 Data encryption enabled

Main Menu Options

1. Add Data to Blockchain

Add personal information to the blockchain with automatic encryption.

Sample Input:

📝 ADD DATA TO BLOCKCHAIN
------------------------------
Enter Full Name: John Doe
Enter Address: 123 Main Street, New York, NY 10001
Enter Contact Number: 555-123-4567

Sample Output:

✅ Block added successfully
🔑 Your Private Key: XXX
⚠️  IMPORTANT: Save this key securely! You'll need it to access your data.

2. Access Data from Blockchain

Retrieve stored data using your private key.

Sample Input:

🔍 ACCESS DATA FROM BLOCKCHAIN
-----------------------------------
Enter block index: 1
Enter Private Key: XXX

Sample Output:

✅ Data retrieved successfully
📄 Block Data: John Doe, 123 Main Street, New York, NY 10001, 555-123-4567
🔑 New Private Key: XXX
⚠️  Your private key has been rotated for security!

3. Get Current Private Key

Retrieve the current private key using your original key.

Sample Input:

🔑 GET CURRENT PRIVATE KEY
------------------------------
Enter block index: 1
Enter Original Private Key: XXX

Sample Output:

✅ Current key retrieved successfully
🔑 Current Private Key: XXX

4. View Blockchain Information

Display blockchain statistics and status.

Sample Output:

📊 BLOCKCHAIN INFORMATION
------------------------------
📦 Total Blocks: 3
🔒 Encryption: Enabled
🔗 Chain Integrity: ✅ Valid
🏷️  Last Block Hash: a1b2c3d4e5f6...

5. Verify Chain Integrity

Verify the integrity of the blockchain.

Sample Output:

🔍 VERIFYING CHAIN INTEGRITY
------------------------------
✅ Blockchain integrity verified successfully!

How the system is built

Core Components

Block Class

• Purpose: Represents individual blocks in the blockchain
• Features:
  • Secure key generation
  • Data encryption/decryption
  • Access validation
  • Key rotation

Blockchain Class

• Purpose: Manages the blockchain and provides core functionality
• Features:
  • Data persistence
  • Integrity verification
  • Key management
  • Encryption handling

BlockchainApp Class

• Purpose: User interface and application logic
• Features:
  • Interactive menu system
  • Input validation
  • Error handling
  • User experience optimization

Data Flow

graph TD
    A[User Input] --> B[Data Validation]
    B --> C[Block Creation]
    C --> D[Encryption]
    D --> E[Hash Calculation]
    E --> F[Block Addition]
    F --> G[Persistence]
    G --> H[Key Generation]
    H --> I[User Notification]

Technical Details

Security Features

1. Cryptographic Security

   • Uses secrets module for secure random number generation
   • SHA-256 hashing for block integrity
   • Fernet encryption for data protection
   • PBKDF2 key derivation for password-based encryption

2. Key Management

   • Automatic key rotation after each access
   • Original key preservation for key recovery
   • Secure key comparison using secrets.compare_digest()

3. Data Protection

   • Optional AES encryption for sensitive data
   • Base64 encoding for safe data storage
   • Input validation and sanitization

Performance Features

• Efficient Storage: JSON-based persistence for fast I/O
• Memory Optimization: Minimal memory footprint
• Fast Retrieval: O(1) block access time
• Scalable Design: Supports large numbers of blocks

Testing

The project includes comprehensive test coverage:

Running Tests

python test_blockchain_aadhaar.py

Test Coverage

• Unit Tests: Individual component testing
• Integration Tests: End-to-end workflow testing
• Performance Tests: Speed and efficiency testing
• Security Tests: Security feature validation

Test Results

BLOCKCHAIN-BASED AADHAAR SYSTEM - COMPREHENSIVE TEST SUITE
================================================================================
RUNNING UNIT TESTS
----------------------------------------
test_block_creation_without_encryption (__main__.TestBlock) ... ok
test_block_creation_with_encryption (__main__.TestBlock) ... ok
test_hash_calculation (__main__.TestBlock) ... ok
...
[SUCCESS] ALL TESTS PASSED! The blockchain system is working correctly.

How files are organized

Aadhar-Blockchain-Prototype/
├── blockchain-based-aadhaar.py    # Main application
├── test_blockchain_aadhaar.py     # Comprehensive test suite
├── requirements.txt               # Python dependencies
├── README.md                     # This file
├── .gitignore                    # Git ignore rules
├── blockchain_data.json          # Persistent blockchain data
├── blockchain.log                # Application logs
└── venv/                         # Virtual environment

Security Considerations

Data Protection

• All sensitive data is encrypted at rest
• Private keys are cryptographically secure
• Access is controlled through private key validation
• Key rotation prevents key reuse attacks

Integrity Verification

• Blockchain integrity is automatically verified
• Hash-based tamper detection
• Chain validation on every operation
• Logging of all access attempts

Best Practices

• Use strong encryption passwords
• Store private keys securely
• Regularly verify chain integrity
• Monitor access logs for suspicious activity

Future Enhancements

Planned Features

• Multi-user support with role-based access
• Web-based interface
• API endpoints for integration
• Advanced analytics and reporting
• Mobile application support
• Distributed blockchain network
• Smart contract integration
• Biometric authentication

Performance Improvements

• Database backend for large-scale deployment
• Caching layer for faster access
• Parallel processing for bulk operations
• Compression for data storage

Contributing

We welcome contributions! Please follow these steps:

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

Development Guidelines

• Follow PEP 8 style guidelines
• Add tests for new features
• Update documentation as needed
• Ensure all tests pass before submitting

License

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

Authors

• Tuhin-SnapD - Initial work - GitHub

Acknowledgments

• Inspired by India's Aadhaar system
• Built with Python's cryptography library
• Uses blockchain principles for data integrity
• Implements industry-standard security practices

Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Include error messages and steps to reproduce

Related Projects

• Blockchain Technology
• Aadhaar System
• Python Cryptography

---

** Important Security Notice**: This is a prototype system for educational purposes. For production use, additional security measures and compliance with local regulations should be implemented.

** Remember**: Always keep your private keys secure and never share them with unauthorized parties!