https://github.com/analitico-771/streamlit_blockchain_ledger

This a blockchain-based ledger system, complete with a user-friendly Streamlit web interface. This ledger allows the user to conduct financial transactions between senders and receivers, and also verify the integrity of the data in the ledger by checking the previous block's hash.
https://github.com/analitico-771/streamlit_blockchain_ledger

blockchain blockchain-demo blockchain-developer blockchain-ledger dataclasses hashlib pandas python3 streamlit typing

Last synced: 2 months ago
JSON representation

This a blockchain-based ledger system, complete with a user-friendly Streamlit web interface. This ledger allows the user to conduct financial transactions between senders and receivers, and also verify the integrity of the data in the ledger by checking the previous block's hash.

• Host: GitHub
• URL: https://github.com/analitico-771/streamlit_blockchain_ledger
• Owner: Analitico-771
• Created: 2022-05-01T18:36:51.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-05-01T18:37:39.000Z (almost 3 years ago)
• Last Synced: 2025-01-03T12:12:15.007Z (4 months ago)
• Topics: blockchain, blockchain-demo, blockchain-developer, blockchain-ledger, dataclasses, hashlib, pandas, python3, streamlit, typing
• Language: Python
• Homepage:
• Size: 282 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


[![Contributors][contributors-shield]][contributors-url]

[![Forks][forks-shield]][forks-url]

[![Stargazers][stars-shield]][stars-url]

[![Issues][issues-shield]][issues-url]

[![LinkedIn][linkedin-shield]][linkedin-url]

  Table of Contents

  


    


      About The Project

      


        
Built With

      

    

    


      Getting Started

      


        
Prerequisites

        
Installation

      

    

    
Usage

    
Roadmap

    
Contributing

	

    
Contact

    
Acknowledgements

  


---

## About The Project

This a blockchain-based ledger system, complete with a user-friendly Streamlit web interface. This ledger allows the user to conduct financial transactions between senders and receivers, and also verify the integrity of the data in the ledger by checking the previous block's hash.

---

### Built With

* [Python](https://www.python.org/)

* [Python pandas](https://pandas.pydata.org/)

* [Python Streamlit](https://streamlit.io/)

* [Python conda](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html)

---

## Getting Started

You don't need Python directly on your system. You can install Anaconda for a virtual environment and JupyterLab normally just like any other application on your computer. Follow the instructions for Anaconda, ensure that its working, then install JupyterLab.

You will need Anaconda Navigator as the preferred tool to install the Streamlit environment.  Go to the Streamlit docs to follow the installation.

I have placed Comments throughout the code so that you can follow the Lambda code and be able to replicate the app on your own. Also, so that you're able to contribute in the future :-)

---

### Prerequisites

A text editor such as [VS Code](https://code.visualstudio.com/) or [Sublime Text](https://www.sublimetext.com/)

### Installation

1. Clone the repo

   ```sh

   git clone https://github.com/AnaIitico/streamlit_blockchain_ledger.git

   ```

2. You don't need to install pip - Conda comes with pip and you can also use the command

    conda install 'package name'

   

3. Install Conda according to the instructions based on your operating system.

    For windows users you MUST use the Administrator PowerShell. Users with AMD Processors MUST use the Administrator PowerShell 7 (X64) version

  

    Once installed Conda has an Admin PowerShell version shortcut - look on your Start menu for it.

    This shortcut will prove very useful at times when you need to install other apps or make adjustments to your installation

    Once installed and you have finished all Conda instructions, you will see (base) on your terminal.  Make sure that you finish the Conda full installation or this will not work!!

   

4. Activate Conda Dev environment

   ```sh

   conda activate dev

   ```

    You should now see (dev) on your terminal (if not go back to step 3)

5. Install Streamlit from the Anaconda Navigator

---

## Usage

  

#### This image shows the entry of the `Sender` and `Receiver` addresses and the first entry after the Genesis block.

  - Pay close attention to the address number.

  - I'm only changing one digit at the end for the second entry but even the slightest change will cause the hash to change.

  - All validation tests passed

![PyChain 1](Images/PyChain_1.png)

---

#### This image shows the entry of the `Sender` and `Receiver` addresses and the second entry after the Genesis block.

  - Did you see the changed digit at the end?

  - You are on your way to learning this blockchain stuff!

  - All validation tests passed

![PyChain 2](Images/PyChain_2.png)

---

#### This image shows the entry of the `Sender` and `Receiver` addresses and the last entry after the Genesis block.

  - Did you see the changed digit at the end again?

  - This is too easy for you now!

  - All validation tests passed

![PyChain 3](Images/PyChain_3.png)

## Note: Any change to the input will cause a change to the hash

---

## Roadmap

  The app is finished

See the [open issues](https://github.com/AnaIitico/streamlit_blockchain_ledger/issues) for a list of proposed features (and known issues).

---

## 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

## Contact

Jose Tollinchi - [@josetollinchi][linkedin-url] - [email protected]

Project Link: [https://github.com/AnaIitico/streamlit_blockchain_ledger](https://github.com/AnaIitico/streamlit_blockchain_ledger)

---

## Acknowledgements

* [Img Shields](https://shields.io)

* [Choose an Open Source License](https://choosealicense.com)

[contributors-shield]: https://img.shields.io/github/contributors/AnaIitico/streamlit_blockchain_ledger.svg?style=for-the-badge

[contributors-url]: https://github.com/AnaIitico/streamlit_blockchain_ledger/graphs/contributors

[forks-shield]: https://img.shields.io/github/forks/AnaIitico/streamlit_blockchain_ledger.svg?style=for-the-badge

[forks-url]: https://github.com/AnaIitico/streamlit_blockchain_ledger/network/members

[stars-shield]: https://img.shields.io/github/stars/AnaIitico/streamlit_blockchain_ledger.svg?style=for-the-badge

[stars-url]: https://github.com/AnaIitico/streamlit_blockchain_ledger/stargazers

[issues-shield]: https://img.shields.io/github/issues/AnaIitico/streamlit_blockchain_ledger/network/members?style=for-the-badge

[issues-url]: https://github.com/AnaIitico/streamlit_blockchain_ledger/issues

[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555

[linkedin-url]: https://www.linkedin.com/in/josetollinchi/

---

## License

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)