https://github.com/hamzoo0/blocksafe-ddf
BlockSafe is a blockchain-based project designed to provide secure data storage and verification solutions. Leveraging the decentralized nature of blockchain technology, this project aims to ensure data integrity, authenticity, and accessibility for various applications.
https://github.com/hamzoo0/blocksafe-ddf
Last synced: about 1 month ago
JSON representation
BlockSafe is a blockchain-based project designed to provide secure data storage and verification solutions. Leveraging the decentralized nature of blockchain technology, this project aims to ensure data integrity, authenticity, and accessibility for various applications.
- Host: GitHub
- URL: https://github.com/hamzoo0/blocksafe-ddf
- Owner: HAMZOO0
- License: mit
- Created: 2024-10-30T16:17:17.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-16T08:46:16.000Z (3 months ago)
- Last Synced: 2025-03-24T11:54:02.903Z (about 2 months ago)
- Language: JavaScript
- Size: 1.25 MB
- Stars: 0
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# **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](https://nodejs.org/) installed
- [MetaMask](https://metamask.io/) wallet
- Ethereum development environment (e.g., [Hardhat](https://hardhat.org/))
### **Environment Variables**
Create a `.env` file in the project root and add the following environment variables:
```plaintext
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**
```bash
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](LICENSE) file for details.
---