A tamper-proof digital logbook where every entry is cryptographically locked using SHA-256 hashing and Merkle Trees. Once saved, entries cannot be silently edited. Any tampering breaks the cryptographic chain and becomes visible.
Built on the same core architecture as Bitcoin — but focused on a single integrity property.
- 🔧 Backend — Complete
- ✅ Frontend — Complete
- ⬜ Tests — Pending
- ✅ Documentation — Added
L_INKBook stores entries in a SQLite database and links each record to the previous one through cryptographic hashing. Each entry hashes its text, images, and table content, combines those values into a Merkle root, then chains to the previous hash.
This design makes any edit detectable by verifying the chain.
L_INKBook/
├── backend/ — hashing, entry creation, verification, database access
├── frontend/ — Flask app, templates, and static assets
├── docs/ — project documentation and API reference
├── tests/ — test suites (pending)
├── config.py — global application configuration
├── main.py — application entry point and startup logic
├── README.md — project overview
├── requirements.txt — Python dependencies
└── user.json — stored username configuration
See the docs/ folder for detailed information:
docs/README.md— documentation indexdocs/api.md— REST API referencedocs/frontend.md— frontend architecture and UI behaviordocs/backend.md— backend modules and chain verificationdocs/setup.md— installation and local run instructions
git clone https://github.com/A-Solo-Engineer/L_INKBook.git
cd L_INKBook
pip install -r requirements.txt
python main.py- On first launch,
main.pyprompts for a username and saves it touser.json. - The app runs on
http://localhost:5000and opens automatically in the browser. - The frontend connects to backend endpoints for user, entries, projects, and chain status.
Aarav (A-Solo-Engineer)