Side Ledger Protocol

First install Mongo DB and run the mongodb service:

sudo systemctl start mongod.service

Install python-slp node via easy installation script:

bash <(curl -s https://raw.githubusercontent.com/Solar-network/python-slp/sxp-devnet/slp-install.sh)

python-slp node will then run as a background service on your system. Status and logs are accessible from systemctl and journalctl commands.

python-slp can also be launched on server startup:

sudo systemctl enable mongod.service
sudo systemctl enable slp.service

• webhook has to be enabled on relay node
• set webhook peer in sxp.json file

if python-slp is running on a standalone node

• node ip where python-slp is installed has to be whitelisted by the relay

python-slp runs in its own environment. To interact with it, it has to be activated:

. .local/share/slp/venv/bin/activate

Remove secondary databases:

python -c "import app;app.clean('sxp')"

Remove all databases:

python -c "import app;app.reset('sxp')"

Webhook subscription is done on python-slp launch. It can also be created/removed with:

python -c "import app;app.init('sxp');app.sync.chain.subscribe()"
python -c "import app;app.init('sxp');app.sync.chain.unsubscribe()"

An endpoint is available to get data from mongo database with the pattern:

/<table_name>/find[?field=value&..][&operator_field=op:value&..][&orderBy=field_i:direction_i,..][&page=number]

Where:

• op is one of eq, neg, gt, gte, lt, lte
• direction desc or reversed (default is asc)

curl http://127.0.0.1:5100/slp2/find?tokenId=0c1b5ed5cff799a0dee2cadc6d02ac60

{
  "status": 200,
  "meta": {
    "page": 1,
    "totalPage": 1,
    "count": 2,
    "totalCount": 2
  },
  "data": [
    {
      "address": "ARypXg91KdTCFxUCtjktZMdDEne3AcA8A7",
      "tokenId": "0c1b5ed5cff799a0dee2cadc6d02ac60",
      "blockStamp": "17902732#1",
      "owner": false,
      "metadata": {
        "trait_background": "ice",
        "trait_base": "zombie",
        "trait_clothing": "astronaut",
        "trait_face": "angry",
        "trait_hat": "beanie"
      }
    },
    {
      "address": "AR2xF13MYMnTKGiqF5Z6oNp1nMue9Qpp84",
      "tokenId": "0c1b5ed5cff799a0dee2cadc6d02ac60",
      "blockStamp": "17902732#1",
      "owner": true,
      "metadata": {}
    }
  ]
}

python-slp is configured on port 5200 and 5100. To deploy node and api with a specific Ark-fork, create and edit <name>.json and milestones.json in package directory accordingly. Then, to deploy on custom port 5243 and 5143:

python -c "import app;app.deploy(host='0.0.0.0', port=5243, blockchain='name')"

Where name is the basename of json configuration used to store specific blockchain parameters.

• ubuntu install script
• full SLP1 contract execution
• full SLP2 contract execution
• SIGTEMR securely handled
• run slp API separately
• blockchain syncer
• mongo db api
• TODO:
  • test suite
  • documentation
  • use websocket to sync slp database
  • slp database rebuild before sync process
  • p2p messaging
  • improve logging messages