Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kendricktan/misocoin
Barebones bitcoin-like protocol implemented in Python 3.6
https://github.com/kendricktan/misocoin
Last synced: 3 months ago
JSON representation
Barebones bitcoin-like protocol implemented in Python 3.6
- Host: GitHub
- URL: https://github.com/kendricktan/misocoin
- Owner: kendricktan
- License: mit
- Created: 2017-12-02T00:54:32.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2017-12-06T23:43:00.000Z (over 6 years ago)
- Last Synced: 2024-01-18T17:15:33.857Z (5 months ago)
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 395
- Watchers: 18
- Forks: 27
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- my-awesome-stars - kendricktan/misocoin - Barebones bitcoin-like protocol implemented in Python 3.6 (Python)
- awesome-stars - kendricktan/misocoin - Barebones bitcoin-like protocol implemented in Python 3.6 (Python)
README
Misocoin
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](https://en.bitcoin.it/wiki/Protocol_documentation), 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](https://conda.io/miniconda.html)
2. `git clone [email protected]:kendricktan/misocoin.git`
3. `cd misocoin && pip install -r requirements.txt`
4. To start the misocoin daemon, run
```bash
# 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
```
5. Once you have the daemon running, you can interact with the daemon it via the API
```bash
./misocoin-cli.py get_info
./misocoin-cli.py get_block
./misocoin-cli.py get_balance
./misocoin-cli.py send_misocoin
# To specify which host and port the daemon is located at
# ./misocoin-cli.py -host= -port=<4000> [methods [args..]]
```
6. 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](http://instagram.com/mr.miso.oz/).
- 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
