• Table of Contents
• 📖 About
• ✨ Features
• 📦 Structure
• 🔌 Modules
  • Cryptography
• 📚 Libraries
• 🚀 Install & Run
• ❤️ Thanks
• 📜 License

This project is a pure Python implementation of a cryptocurrency inspired by the original concept introduced in Satoshi Nakamoto's whitepaper: Bitcoin: A Peer-to-Peer Electronic Cash System.

• Project

  • 🔄 Reproducible: Built with uv, this configuration can be effortlessly reproduced on other machines, ensuring a consistent setup.

  • 📖 Documented: Most of the parts of my source files are commented and documented with links and explanations if necessary

• Program

Directories

• assets - Resources
• src - Source files and modules
• tests - Test files and modules

This module implements all cryptographic protocols and primitives that are necessary to ensure cryptocurrency's security and integrity. All protocols were implemented from scratch in pure python based on their official description.

Here is the implemented ones :

• Base 58
• Ecdsa
• AES
• Bloom filter
• Murmur hash
• Merkle tree
• Sparse merkle tree
• Ripemd160
• Sha256

First, ensure you have the uv python package manager installed.

If so, then clone the repo

git clone https://github.com/leoraclet/unycoin
cd unycoin

Create a virtual environment for Python if you want to add package in the future

uv venv

Resources that guided me :

• The REPO
• Bitcoin Whitepaper
• Bitcoin Wiki
• This Incredible Blog Post

*and many more hours of research ton internet to finally understand how Bitcoin works (the only TRUE cyrptocurrency btw)

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