BlockSafe: Decentralized Data Framework (DDF)

BlockSafe is an innovative Decentralized Data Framework designed to securely store, share, and manage sensitive data using blockchain technology. It empowers organizations to build decentralized applications (dApps) with robust security, privacy, and transparency. Our first application built on BlockSafe is a Medical Record System, ensuring privacy, security, and seamless accessibility of medical data for patients, healthcare providers, and insurers.

---

🚀 Key Features

• Decentralized Architecture: Eliminates single points of failure, enhancing data availability and security.
• Data Transparency: Immutable records for full traceability and auditability.
• Cryptographic Security: Ensures data integrity and access control through advanced encryption mechanisms.
• Customizable Framework: Adaptable to various use cases, including:
  • Medical Records Management
  • Voting Systems
  • Supply Chain Tracking
  • Certificate Verification

---

---

🛠️ Tech Stack

Layer	Tools/Technologies	Logo
Blockchain	Ethereum
Smart Contracts	Solidity
Data Storage	IPFS (via Pinata)
Backend	Node.js (Express)
Frontend	React + Web3.js
Wallet Integration	MetaMask
Authentication	Appwrite
Development Tools	Hardhat, Remix IDE

---

🔍 How It Works

1. Data Submission: Sensitive data (e.g., medical records) is encrypted and stored off-chain using IPFS via Pinata.
2. Blockchain Logging: The hash of the stored data is securely logged on the Ethereum blockchain, ensuring data integrity and transparency.
3. Access Control: Patients, as data owners, manage access to their records through their wallets, granting/revoking permissions to entities like hospitals or insurers.
4. Transparency & Traceability: All access requests and transactions are recorded immutably on the blockchain, providing complete traceability.

---

🏥 Medical Record System (Use Case)

Overview

The Medical Record System is a decentralized application (dApp) built on BlockSafe to securely manage and share medical records.

• Patients control their records through decentralized identity and wallet integration.
• Hospitals upload records, which are encrypted and stored on IPFS.
• Access permissions are securely managed and logged on the blockchain, ensuring compliance with data privacy regulations.

---

Here’s a more organized and symmetric table for the screenshots:

---

📸 Visual Overview

Application UI	IPFS (Pinata)

Git Graph - Contributions

---

⚙️ Setup Instructions

Prerequisites

• Node.js installed
• MetaMask wallet
• Ethereum development environment (e.g., Hardhat)

Environment Variables

Create a .env file in the project root and add the following environment variables:

VITE_APPWRITE_URL="your-appwrite-url"
VITE_APPWRITE_PROJECT_ID="your-appwrite-project-id"
VITE_APPWRITE_DB_ID="your-appwrite-database-id"
VITE_APPWRITE_COLLECTION_ID="your-appwrite-collection-id"
VITE_APPWRITE_BUCKET_ID="your-appwrite-bucket-id"
VITE_PINATA_SECRET="your-pinata-secret-key"
VITE_API_KEY="your-api-key"

Run the Project

npm install
npm run dev

This will start the development server locally.

---

🤝 Contributing

We welcome contributions to enhance the functionality and features of BlockSafe. To contribute:

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

---

📝 License

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

---