daxeel / blockshell

🎉 Minimal Blockchain Learning CLI

📖 README.md just includes installation guide. You can find detailed guide in this wiki page

BlockShell

A command line utility for learning Blockchain technical concepts likechaining, mining, proof of work etc.

ℹ️ About

Anyone who wants to understand how blockchain technology works, then BlockShell should be a great start. Because I have created BlockShell keeping blockchain fundamentals in the center of development. With BlockShell you will actually create a tiny blockchain in your system where you can create blocks with data, explore blocks etc.

So, by using BlockShell anyone can learn following blockchain concepts,

• Block & Chaining
• Hashing
• Mining
• Proof of Work

🌐 BlockShell Web Explorer

BlockShell comes with built-in blockchain explorer by which you can actully see how blocks are mined and what is stored and where.

Latest Mined Blocks	Block Details

📦 Installation

Step 1 - Create project directory

mkdir <project_name> && cd project_name

Step 2 - Create new virtual environment with python version 2.7.

virtualenv venv

Step 3 - Activate virtual environment

source venv/bin/activate

or

source venv/Scripts/activate

Step 4 - Clone this repo

git clone https://github.com/daxeel/blockshell.git

Step 5 - Change directory to cloned one

cd blockshell

Step 6 - Install blockshell

pip install --editable .

Step 7 - Try "blockshell" command and test installation!

blockshell

Output in terminal after calling BlockShell command

blockshell's Issues

Can any information be added to the blocks?

If so, what could be possibly added?

I get an error on running blockshell

I have followed the installation instructions and installed it sucessfully but on running blockshell it gives the following error

(venv) palash25@Lenovo-G50:~/Dev/bshell/blockshell$ blockshell
Traceback (most recent call last):
  File "/home/palash25/Dev/bshell/venv/bin/blockshell", line 11, in <module>
    load_entry_point('blockshell', 'console_scripts', 'blockshell')()
  File "/home/palash25/Dev/bshell/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 572, in load_entry_point
    return get_distribution(dist).load_entry_point(group, name)
  File "/home/palash25/Dev/bshell/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2755, in load_entry_point
    return ep.load()
  File "/home/palash25/Dev/bshell/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2408, in load
    return self.resolve()
  File "/home/palash25/Dev/bshell/venv/lib/python3.6/site-packages/pkg_resources/__init__.py", line 2414, in resolve
    module = __import__(self.module_name, fromlist=['__name__'], level=0)
  File "/home/palash25/Dev/bshell/blockshell/bscli.py", line 60
    """
      ^
SyntaxError: invalid syntax

Change 127.0.0.1 by server ip

Hello,

How can i change "127.0.0.1:5000" by "mylocalip:5000" ?

Blockshell is on my linux server and I would like access to web page from my windows client.

thanks !

python web.py reports ImportError

Hello,

I'm quite new to this. Don't understand python very well. Just followed the instructions here and everything worked well until i tried opening the web using 'pyton web.py' ,which reported the below error [attached png]. Can you let me know how to fix this ?

I run Windows 7, with python 2.7.13.

You guys doing a great job. Very useful stuff for beginners like me.

Thanks
Ashwin

Don't you have to add self.previousHash?

I'm sorry in advance if I'm wrong, but don't you also need to add self.previousHash to hashData at

blockshell/blockchain/chain.py

Line 19 in 6aa5eec

hashData = str(self.index) + str(self.data) + self.timestamp + str(self.nonce)

?

Exit from Blockshell

While inside the virtualenv, it'd be good to have an option to exit the blockshell prompt without really closing the virtualenv altogether. control + C (Mac OS) merely aborts the process and does not shut it down properly.

404 on web viewer

Hello,

I just cloned project and wanted to see with the web viewer but got some 404 error on bootstrap/jquery.

Python3 Json.loads value type error

When i try to click the web.py file, it run successfully to display the index page , however, when i tried to click the allblocks url page it gives me an error saying saying:
json.loads(...) ValueError: Expecting value: line 1 column 1 (char 0)

** the code for part of the file bringing the error is**

@app.route('/allblocks') def mined_blocks(): """ Endpoint to list all mined blocks. """ with open('chain.txt', 'r') as jsonfile: data = json.loads(jsonfile) jsonfile.close() return render_template('blocks.html', data=data)

Python 3 version

"Simple" request :).

Thanks!

pkg_resources.DistributionNotFound: The 'blockshell' distribution was not found and is required by the application

I installed blockshell by copying all the commands in the readme and when I run blockshell I get

Traceback (most recent call last):
  File "/usr/bin/blockshell", line 6, in <module>
    from pkg_resources import load_entry_point
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 3241, in <module>
    @_call_aside
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 3225, in _call_aside
    f(*args, **kwargs)
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 3254, in _initialize_master_working_set
    working_set = WorkingSet._build_master()
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 583, in _build_master
    ws.require(__requires__)
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 900, in require
    needed = self.resolve(parse_requirements(requirements))
  File "/usr/lib/python3.7/site-packages/pkg_resources/__init__.py", line 786, in resolve
    raise DistributionNotFound(req, requirers)
pkg_resources.DistributionNotFound: The 'blockshell' distribution was not found and is required by the application

Can I store the result?

Hello!

Thank you for this software! It's impressive :)
Can I store the result to transfer between hosts and usage for something else?

Thank you.