str-coding-club/robcoin

Proof of Work Cryptocurrency written in Python.

STR Robcoin

A Proof of Work Cryptocurrency Written in Python
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • DISCLAIMER
   • Built With
2. Usage
   • Prerequisites
   • Initialization
   • Wallet
3. Forking
   • Prerequisites
   • Installation
4. Contributing
5. License
6. Contact
7. Acknowledgements

About The Project

Developed by St. Robert CHS' Coding Club in 2021, RobCoin (Symbol: $TR) is a proof-of-work cryptocurrency written in Python. As a project, RobCoin's development was used to guide and educate club members about cryptocurrencies and provide real-world programming experience.

DISCLAIMER

This project is an independent project pursued by St. Robert Catholic High School's Coding Club. This project is not affiliated, sponsored, or supported by St. Robert Catholic High School or the York Catholic District School Board. St. Robert Catholic High School's Coding Club is not liable for any loss or damage of whatever nature (direct, indirect, consequential, or other) that may be incurred through the use of the project.

AS A PROJECT DESIGNED AROUND EDUCATION, ROBCOIN HAS NO MONETARY VALUE. THE USE OF THIS COIN SHOULD ONLY BE FOR EDUCATIVE/EXPLORATORY PURPOSES. ST. ROBERT CHS CODING CLUB HIGHLY DISCOURAGES THE USE OF ROBCOIN AS A MEDIUM OF TRANSACTION FOR MATTERS SUCH AS, BUT NOT LIMITED TO: (1)TRANSACTIONS OF MONETARY VALUE, (2)EXCHANGE FOR SERVICES AND/OR GOODS, (3)ILLEGAL/ILLICIT ACTIVITIES. ANY EVIDENCE OF SUCH ACTION WILL BE REPRIMANDED. ROBCOIN'S SOURCE CODE IS DISTRIBUTED UNDER THE MIT LICENSE. SEE LICENSE FOR MORE INFORMATION.

Built With

• Python 3.9
• Flask 2.0.0
• Cryptography 3.4.7

Usage

Prerequisites

• Python 3.9, pip3

Windows

1. Install the latest release of Python 3.9
   • https://www.python.org/downloads/

Ubuntu

1. Update before installing new packages

   sudo apt-get update

2. Check Python version

   python3 --version

3. If Python version < 3.9

   sudo apt install python3.9

4. Validate

   python3.9 --version

5. Install pip3

   sudo apt-get -y install python3-pip

6. Validate

   pip3 --version

Initialization

Download and extract client.zip (NOT THE SOURCE CODE!) from the latest release.

• Download here: https://github.com/STR-Coding-Club/RobCoin/releases

1. Install Required Libraries

   pip3 install -r requirements.txt

   In some cases, pip3 may be pip in PATH

   pip install -r requirements.txt

2. Using your IDE of choice, open the extracted RobCoin folder.

3. Run run_wallet.py to generate private & public keys; wallet address.

4. Run run_miner.py to start mining to earn RobCoin!

Wallet (Transactions)

After mining for a while, you should have some RobCoin to spend! run_wallet.py will allow you to send, recieve and check your balance through the use of commands.

Commands

1. address

   • Returns your receiving address so that others can send you Robcoin

2. balance

   • Returns your balance of Robcoin.

     • Pending refers to transactions that have yet to be mined onto the blockchain.

3. balance <address>

   • Returns the balance of inputted address

4. send <recipient> <amount>

   • recipient -> The recipient's address

   • amount -> The amount of Robcoin you wish to send

Forking

Using RobCoin's source code, you may choose to fork RobCoin by creating your own blockchain. To do so, you will need to run your own node

Prerequisites

• Python 3.9, pip3

1. Update before installing new packages

   sudo apt-get update

2. Check Python version

   python3 --version

3. If Python version < 3.9

   sudo apt install python3.9

4. Validate

   python3.9 --version

5. Install pip3

   sudo apt-get -y install python3-pip

6. Validate

   pip3 --version

Installation

1. Clone the repo

   git clone https://github.com/STR-Coding-Club/RobCoin

2. cd into repo directory

   cd RobCoin

3. Install Required Libraries

   pip3 install -r requirements.txt

4. Open Port 5000 on host domain
5. Add host domain to wallet.py, node.py
6. Run node.py

   python3 node.py

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

St. Robert CHS Coding Club - @strcodingclub - [email protected]

Project Link: https://github.com/STR-Coding-Club/RobCoin

Acknowledgements

• "Learn Blockchains by Building One" by Daniel van Flymen

robcoin's Issues

[Feature] RobCoin 2.0.0: Update Tracker

RobCoin 2 - Decentralization

RobCoin was written to be an exercise to develop our knowledge and understanding in blockchain technology. As of version 1.x.x, RobCoin is a functional cryptocurrency that employs cryptographic methods in the form of private-public key cryptography and a proof of work algorithm to advance and secure the blockchain, but fundamentally lacks the property of being decentralized. This means that the central ledger, the file that stores all of the transactions made on the blockchain, is stored on a single, centralized server and therefore contradicts the conventional interpretation that a cryptocurrency must be decentralized.

That's what RobCoin 2.0 aims to fix, among a list of other smaller features. Following through with our commitment to maintaining this project, St. Robert CHS Coding Club Alumni will be working to develop a hard fork of RobCoin that is decentralized.

---

This issue acts as a tracker for our progress towards a completed version of RobCoin 2.0.0.

• Better Blockchain File - Store transactions in a more time/space-efficient file format
• Blockchain Verification - Create a 'Full Node' that independently validates the entire blockchain from the genesis block.
• Distributed Ledger - Implement a peer-to-peer network that distributes copies of the blockchain
• Proof of Work - Adjust the proof-of-work (mining) code to work with the decentralized code
• . . .

QoL Fixes

• Light Node + Wallet - Create a 'Light' wallet/node that does not need to store the entire blockchain
• Blockchain Explorer - Create a website to explore RobCoin's blockchain - i.e: https://etherscan.io/
• More TBD

[Node] /submitproof creates empty blocks when there are multiple miners

Running multiple miners with different wallet addresses will create empty blocks.

Add some feature that will handle valid proofs that are submitted for the same block (prioritize first one maybe)

blockchain.txt - local

    {
        "index": 123,
        "transactions": [
            {
                "sender": "0",
                "recipient": "4649c59ff5f6dd002ecfbf02860d80f41e06efa1bf3420a23a94cca5510f8673",
                "amount": 1
            }
        ],
        "previous_hash": "7cd6763e40dce80af47f0435e4872852ebd5754c6e4ec13b4bdf1039fbe4d012",
        "proof": "39427024696956976979262218939797012612196755764679404258441955526806639805849"
    },
    {
        "index": 124,
        "transactions": [],
        "previous_hash": "3a93ba6ced8091c8d392d7408b0a66efc1e36c60ab92072ff1f11a5730c15b07",
        "proof": "71330985398107940637605047443717434880872804322901588832710320728156419801845"
    },
    {
        "index": 125,
        "transactions": [
            {
                "sender": "0",
                "recipient": "7b0ec3c65978379b0dfd7ac6513043f5a4a3002d46a648c7e8a95f1626bf92e0",
                "amount": 1
            }
        ],
        "previous_hash": "5cbe849f56f77f6aeff74377992917465b5b02dc236e9f5868fcca9ce10aff2b",
        "proof": "74747740189430710078219023708386936330560170928943432384584088051496739488838"
    },