Need help with misocoin?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

404 Stars 23 Forks MIT License 29 Commits 3 Opened issues


Barebones bitcoin-like protocol implemented in Python 3.6

Services available


Need anything else?

Contributors list

# 103,173
23 commits
# 600,483
1 commit
# 15,618
1 commit
# 11,971
1 commit


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

  1. Make sure you're in a Python 3.x environment. I recommend using miniconda
  2. git clone [email protected]:kendricktan/misocoin.git
  3. cd misocoin && pip install -r requirements.txt
  4. To start the misocoin daemon, run
# To start it on localhost:4000 with a random private key

** [Welcome] Your misocoin address is 610d2657b8c4df8da493bbe0671e7406d2bee7a6

To start it on localhost:4001 with a specific private key

./ -host=localhost -port=4001 -priv_key=60c8cb60c21143fffdd682f399ef3baa4b67c56a1f83a274284cfe7c57e007ed

  1. Once you have the daemon running, you can interact with the daemon it via the API
./ get_info
./ get_block 
./ get_balance
./ send_misocoin  

To specify which host and port the daemon is located at

./ -host= -port=<4000> [methods [args..]]

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

    ./ -port=4001
  • Terminal 2:

    ./ -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


  • [ ] 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


  • 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?


misocoin logo

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.