Workflow Digitization Blockchain

A decentralized platform for secure document notarization using blockchain technology.
Guarantee integrity, traceability, and authenticity in workflows by leveraging smart contracts and cryptographic hashing.

---

📚 Table of Contents

• Getting Started
  • Requirements
  • Installation
  • Configuration
  • Running the Application
• Features
• License

---

Getting Started

Requirements

• Node.js (v14 or higher)
• Docker & Docker Compose
• Hardhat CLI
• Git

---

Installation

git clone https://github.com/Chrisharris1001/workflow-digitization-blockchain.git
cd workflow-digitization-blockchain
npm install
cd frontend && npm install

---

Configuration

Create a .env file in the root, backend/, and frontend/ directories with the following variables:

# Blockchain and API
RPC_URL=http://localhost:8545
CONTRACT_ADDRESS=0x...

# Backend
PORT=5000

# Frontend
REACT_APP_API_URL=http://localhost:5000
REACT_APP_CONTRACT_ADDRESS=0x...

A sample file is available as .env.example if provided.

---

Running the Application

To start all services locally:

# Start blockchain and database (if any)
docker-compose up -d

# Deploy smart contracts
npx hardhat run scripts/deploy.js --network localhost

# Start backend
cd backend && npm run dev

# Start frontend
cd ../frontend && npm start

Visit the app at http://localhost:3000.

---

Features

• 🧾 Document Hashing & Storage Convert files to SHA-256 hashes and anchor them on the Ethereum blockchain.

• ⛓️ Smart Contract Notarization Ensure document authenticity with verifiable, immutable records.

• 👨‍⚖️ Role-Based Access Control Only authorized users can notarize or verify documents.

• 🔍 Blockchain Verification Publicly validate document proofs through transaction hashes.

• 🧪 Testing Suite Unit and integration tests for contracts and backend services.

---

License

This project is licensed under the MIT License.