RandCoin 🪙

The Apex of African Digital Excellence

RandCoin is a robust, Python-based blockchain implementation designed to demonstrate the power and potential of African digital currency innovation. Built by the founders of the Apex of African Digital Excellence, this project serves as a testament to engineering precision, financial security, and open-source collaboration.

Explicitly linked to the South African Rand (ZAR), RandCoin prioritizes financial accuracy through strict decimal.Decimal usage and implements core blockchain features including Proof of Work mining, transaction validation, and replay protection.

🚀 Features

• ZAR Currency Integration: All transactions and rewards are denominated in ZAR.
• Precision Engineering: Utilizes Python's decimal module for zero-error financial calculations.
• Proof of Work: Secure mining algorithm with adjustable difficulty.
• Replay Protection: O(N) history scanning to prevent duplicate transactions.
• Zero External Dependencies: Pure Python implementation using only standard libraries (hashlib, json, time, typing, unittest).
• Interactive CLI: A user-friendly command-line interface for interacting with the blockchain.

🛠️ Installation & Usage

RandCoin is built to be accessible and easy to run.

Prerequisites

• Python 3.8 or higher.

Running the App

1. Clone the repository:

   git clone https://github.com/rmngqibisa/Eagle-s-Choice.git
   cd Eagle-s-Choice

2. Run the application:

   python3 main.py

3. Interact: Follow the on-screen menu to:

   • View the blockchain state.
   • Create ZAR transactions.
   • Mine pending transactions (and earn mining rewards!).
   • Verify chain integrity.

Running Tests

To ensure system stability, run the comprehensive test suite:

python3 -m unittest discover tests

🛡️ Governance & Security

We take code quality and security seriously.

• Branch Protection: The master branch is protected. Direct commits are blocked.
• Code Review: All changes require a Pull Request (PR) and must be reviewed and approved by @rmngqibisa.
• Verification: All PRs must pass automated tests before merging.

🌍 Connect & Support

• Project Website: Azanian Eagle

• Founder/Maintainer: rmngqibisa

• Support the Vision:

  

🤝 Contributing

We welcome contributions from the community! Please read our CONTRIBUTING.md and Code of Conduct to get started.

---

🏷️ Topics & Tags

blockchain cryptocurrency python zar finance fintech open-source south-africa digital-currency decimal-precision proof-of-work educational reference-implementation azania

---

Built with ❤️ in Azania.