Misocoin

misocoin logo

Misocoin is a barebones bitcoin-like protocol implemented in Python 3.x. It was written as a challenge for myself to see if I could implement a bitcoin clone from scratch.

This project doesn't follow the full bitcoin-protocol, but rather implements a barebones version that (with enough nodes) can still act as a trust-less third party for storing and ensuring the integrity of arbitrary data.

WARNING: Misocoin is not production ready and should only be used as an educational tool.

Quick start

Make sure you're in a Python 3.x environment. I recommend using miniconda
git clone git@github.com:kendricktan/misocoin.git
cd misocoin && pip install -r requirements.txt
To start the misocoin daemon, run

# To start it on localhost:4000 with a random private key
./misocoind.py

** [Welcome] Your misocoin address is 610d2657b8c4df8da493bbe0671e7406d2bee7a6
 * Running on http://localhost:4000/ (Press CTRL+C to quit)

# To start it on localhost:4001 with a specific private key
# ./misocoind.py -host=localhost -port=4001 -priv_key=60c8cb60c21143fffdd682f399ef3baa4b67c56a1f83a274284cfe7c57e007ed

Once you have the daemon running, you can interact with the daemon it via the API

./misocoin-cli.py get_info
./misocoin-cli.py get_block <block_number>
./misocoin-cli.py get_balance
./misocoin-cli.py send_misocoin <to_address> <amount>

# To specify which host and port the daemon is located at
# ./misocoin-cli.py -host=<localhost> -port=<4000> [methods [args..]]

To connect misocoin with other nodes, try running ./misocoind.py -nodes=host1:port1,host2:port2. E.g:

Terminal 1:
```
./misocoind.py -port=4001
```

Terminal 2:

./misocoind.py -port=4002 -nodes=localhost:4001

What's in misocoin

[x] EDCSA
[x] Dynamic difficulty (based on network hashing power)
[x] Proof-of-Work
[x] Consensus

Todo?

[ ] Automatically prunes chain in favor of a longer chain
[ ] Persistent storage for blockchain (currently all in memory)
[ ] Separate out tx and block logic to fit in a set amount of txs in a block
[ ] Nicer exception handling
[ ] Enforce functional paradigm

FAQ

Who's miso?

Miso is my cat. You can find out about him more on his instagram page.

Why did you make this?

I made it to understand more about bitcoin. Jks. I made it for Miso's birthday (15 December). I love my cat.

Can I have a picture of your cat in a taco outfit?

Sure

misocoin logo