Metadata-Version: 2.1
Name: lamden
Version: 1.0.0.2
Summary: Lamden Blockchain
Home-page: https://github.com/Lamden/lamden
Author: Lamden
Author-email: team@lamden.io
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6.5
Description-Content-Type: text/markdown
Requires-Dist: sanic
Requires-Dist: coloredlogs
Requires-Dist: pymongo
Requires-Dist: pyzmq
Requires-Dist: requests
Requires-Dist: contracting
Requires-Dist: checksumdir
Requires-Dist: pynacl
Requires-Dist: stdlib-list

## Lamden Blockchain
### Get a computer with Ubuntu 18.04.
* DigitalOcean droplets are our favorites if you are new.

* * *

### Install Pip3
```bash
sudo apt-get update
sudo apt-get install python3-pip -y
```

### Install MongoDB
As copied from here: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/
```bash
wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list
sudo apt-get install -y mongodb-org
echo "mongodb-org hold" | sudo dpkg --set-selections
echo "mongodb-org-server hold" | sudo dpkg --set-selections
echo "mongodb-org-shell hold" | sudo dpkg --set-selections
echo "mongodb-org-mongos hold" | sudo dpkg --set-selections
echo "mongodb-org-tools hold" | sudo dpkg --set-selections
sudo systemctl start mongod
```

### Install Haveged (Recommended)
For some reason, DigitalOcean droplets, and perhaps other cloud providers, have `/dev/random` blocking problems. This probably is because they are running many small computers on a single Linux instance and the entropy pool dries up pretty quickly. If this doesn't make sense, install Haveged and don't worry about it.

If it does, `libsodium`, which is the public-private key cryptography library we use, uses `/dev/random` with no option to use `/dev/urandom`. Haveged solves this problem.

```bash
sudo apt-get install haveged -y
systemctl start haveged
systemctl enable haveged
```

### Install Lamden
```
pip3 install lamden
```

### Make a Constitution
```
nano ~/constitution.json

{
  "masternodes": [<list of vks here>],
  "masternode_min_quorum": <int>,
  "delegates": [<list of vks here>],
  "delegate_min_quorum": <int>
}

Ctrl+X, save the file.
```

### Start your node
```
lamden <masternode | delegate> -k <sk in hex format> -bn <list of ip addresses that are currently online>
```

### Autoinstall
You can install a script to install the entire software.
```
wget https://raw.githubusercontent.com/Lamden/lamden/dev/INSTALL.sh
```
Always practice good saftey and examine the bash file before executing it.


