Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blleshi/blockchain_based_ledger_system
Blockchain-Based Ledger System
https://github.com/blleshi/blockchain_based_ledger_system
block-data-class blockchain blockchain-validation data-class ledger-system proof-of-work pychain pychain-ledger streamlit
Last synced: about 2 months ago
JSON representation
Blockchain-Based Ledger System
- Host: GitHub
- URL: https://github.com/blleshi/blockchain_based_ledger_system
- Owner: blleshi
- Created: 2024-08-06T05:38:36.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-08-16T21:43:36.000Z (5 months ago)
- Last Synced: 2024-08-16T22:22:55.638Z (5 months ago)
- Topics: block-data-class, blockchain, blockchain-validation, data-class, ledger-system, proof-of-work, pychain, pychain-ledger, streamlit
- Language: Python
- Homepage:
- Size: 259 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blockchain-Based Ledger System
## Instructions
Open the provided `pychain.py` file, which you’ll use to complete the steps for this Challenge. Notice that the PyChain ledger that you built throughout this module already includes the functionality to create blocks, perform the proof of work consensus protocol, and validate blocks in the chain.
The steps for this Challenge are divided into the following sections:
1. [Create a Record Data Class](#step-1-create-a-record-data-class)
2. [Modify the Existing Block Data Class to Store Record Data](#step-2-modify-the-existing-block-data-class-to-store-record-data)
3. [Add Relevant User Inputs to the Streamlit Interface](#step-3-add-relevant-user-inputs-to-the-streamlit-interface)
4. [Test the PyChain Ledger by Storing Records](#step-4-test-the-pychain-ledger-by-storing-records)
### Step 1: Create a Record Data Class
Define a new Python data class named `Record`. Give this new class a formalized data structure that consists of the `sender`, `receiver`, and `amount` attributes. To do so, complete the following steps:
1. Define a new class named `Record`.
2. Add the `@dataclass` decorator immediately before the `Record` class definition.
3. Add an attribute named `sender` of type `str`.
4. Add an attribute named `receiver` of type `str`.
5. Add an attribute named `amount` of type `float`.
### Step 2: Modify the Existing Block Data Class to Store Record Data
Rename the `data` attribute in your `Block` class to `record`, and then set it to use an instance of the new `Record` class that you created in the previous section. To do so, complete the following steps:
1. In the `Block` class, rename the `data` attribute to `record`.
2. Set the data type of the `record` attribute to `Record`.
### Step 3: Add Relevant User Inputs to the Streamlit Interface
Code additional input areas for the user interface of your Streamlit application. Create these input areas to capture the `sender`, `receiver`, and `amount` for each transaction that you’ll store in the Block `record`. To do so, complete the following steps:
1. Delete the `input_data` variable from the Streamlit interface.
2. Add an input area where you can get a value for `sender` from the user.
3. Add an input area where you can get a value for `receiver` from the user.
4. Add an input area where you can get a value for `amount` from the user.
As part of the Add Block button functionality, update `new_block` so that `Block` consists of an attribute named `record`, which is set equal to a `Record` that contains the `sender`, `receiver`, and `amount` values. The updated `Block` should also include the attributes for `creator_id` and `prev_hash`.
### Step 4: Test the PyChain Ledger by Storing Records
Test your completed PyChain ledger and user interface by running your Streamlit application and storing some mined blocks in your PyChain ledger. Then test the blockchain validation process by using your PyChain ledger. To do so, complete the following steps:
1. In the terminal, navigate to the project folder where you've coded the Challenge.
2. In the terminal, run the Streamlit application by using `streamlit run pychain.py`.
3. Enter values for the `sender`, `receiver`, and `amount`, and then click the Add Block button. Do this several times to store several blocks in the ledger.
4. Verify the block contents and hashes in the Streamlit drop-down menu. Take a screenshot of the Streamlit application page, which should detail a blockchain that consists of multiple blocks. Include the screenshot in the README.md file for your Challenge repository.
5. Test the blockchain validation process by using the web interface. Take a screenshot of the Streamlit application page, which should indicate the validity of the blockchain. Include the screenshot in the README.md file for your Challenge repository.
)