BLOK

A simple Blockchain implementation written in Python.

     ┌───────────────────────────────────────┐
     │  BLOCKCHAIN                           │
     ├───────────────────────────────────────┤
┌────┤► chain: List[BLOCK]                   │
│    │                                       │
│    │  new_transactions: List[TRANSACTION] ◄├───────────────────────┐
│    │                                       │                       │
│    │  nodes: List[ADDRESS]                ◄├────┐                  │
│    └───────────────────────────────────────┘    │                  │
│                                                 │                  │
│    ┌───────────────────────────────────┐   ┌────┴──────────────┐   │
└────┤  BLOCK                            │   │  ADDRESS: String  │   │
     ├───────────────────────────────────┤   └───────────────────┘   │
     │  index: Integer                   │                           │
     │                                   │   ┌─────────────────────┐ │
     │  proof: Integer                   │ ┌─┤  TRANSACTION        ├─┘
     │                                   │ │ ├─────────────────────┤
     │  previous_hash: String            │ │ │  sender: String     │
     │                                   │ │ │                     │
     │  transactions: List[TRANSACTION] ◄├─┘ │  recipient: String  │
     └───────────────────────────────────┘   │                     │
                                             │  amount: Integer    │
                                             └─────────────────────┘

Installation

$ pip install poetry
$ poetry install

To run unit tests:

$ poetry run coverage run -m pytest
$ poetry run coverage report -m

To run the blockchain server:

$ poetry run python -m blok.main --debug=true

Code Quality

$ poetry run pre-commit install
$ poetry run pre-commit run --all-files

Sources

The best source for me was the blockchain course series in Coursera.

I took advantage of this article.