Blockchain written in Rust for low-orbit satellites

This is a project to set-up a blockchain over a Low-Orbit satellite as part of a proof of concept for the paper:

Blockchain and radio communications over suborbital spaceflights: Watchtowers and Mystics

Table of Contents

• Technology used
• MySQL tune-up
• MySQL database credentials
• MongoDB tune-up
• Compile Rust Blockchain
• Run Rust Blockchain
• Blockchain Users CRUD
• Blockchain services
• Configuration file
• Python script for data extraction
• Postman collection
• Docker for Rust Blockchain

Technology used

• Cargo 1.38.0

• Rustc 1.38.0

• MariaDB Server 5.5.57

• MongoDB Server 3.4.15

MySQL tune-up

The users management uses MySQL as main engine.

Execute the script present in DDL/mysql/sensordb_DDL.sql to fill the tables, structure, triggers and procedures:

mysql -u root -p < sensordb_DDL.sql

MySQL database credentials

Username	Password
admin	admin1234
api_user	api_user1234

MongoDB tune-up

Use the script on DDL/mongodb/001_users.js to create the user and set permission over the MongoDB system:

mongo  --authenticationDatabase admin < 001_users.js

If your MongoDB has user authentication:

mongo -u username -p password --authenticationDatabase admin < 001_users.js

Compile Rust Blockchain

cargo build

Run Rust Blockchain

cargo run

Blockchain Users CRUD

• Create new user

curl -X POST \
  -L \
  http://localhost:8086/api/users \
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  -d '{
	"username" : "user_3",
	"password" : "passwordUser3",
	"name" : "User3",
	"surname" : "User3 description",
	"description" : "API user",
	"admin" : "0"
}'

• Update user:

curl -X PUT \
  -L \
  http://localhost:8086/api/users \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  -d '{
	"username" : "user_3",
	"password" : "passwordUser3",
	"name" : "User3",
	"surname" : "User3 description modified",
	"description" : "API user",
	"admin" : "0",
	"user_id" : "3"
}'

• Delete user

curl -X DELETE \
  -L \
  http://localhost:8086/api/users \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  -d '{"user_id" : "3"}'

• Get user information

curl -X GET \
  -L \
  'http://localhost:8086/api/users?user_id=1' \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec'

• Perform user login

curl -X POST \
  -L \
  http://localhost:8086/api/login \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -d '{
	"username" : "api_user",
	"password" : "api_user1234"
}'

Blockchain services

• Single document insertion

curl --request POST \
  --url http://localhost:8086/api/values \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  --data '{
    "hash" : "value1",
    "key2" : "value2",
    "key3" : "value3",
    "key4" : "value4",
    "key5" : "value5",
    "key6" : "value6",
    "key7" : "value7"}'

• Multiple document insertion

curl --request POST \
  --url http://localhost:8086/api/values \
  -H 'Cache-Control: no-cache' \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  --data '[{
    "key1" : "value1",
    "key2" : "value2",
    "key3" : "value3",
    "key4" : "value4",
    "key5" : "value5",
    "key6" : "value6",
    "key7" : "value7"
    },
    {
      "key1" : "value1",
      "key2" : "value2",
      "key3" : "value3",
      "key4" : "value4",
      "key5" : "value5",
      "key6" : "value6",
      "key7" : "value7"
    }]'

• Get single block by id

curl --request GET \
  --url 'http://localhost:8086/api/values?block_id=5dac673a3537345b528984c7&encryption=1' \
  -H 'Content-type: application/json' \
  -H 'Cache-Control: no-cache' \
  -H 'Token: aca6038665c811e8a96100089be8caec'

• Full blockchain deletion

curl --request DELETE \
  --url 'http://localhost:8086/api/values?blockchain_name=sensors_values' \
  -H 'Content-type: application/json' \
  -H 'Cache-Control: no-cache' \
  -H'Token: aca6038665c811e8a96100089be8caec'

• Query by date

curl --request PUT \
  --url http://localhost:8086/api/values \
  -H 'Content-type: application/json' \
  -H 'Token: aca6038665c811e8a96100089be8caec' \
  --data '{"docs" : "1","date_from":"2019-05-01 00:00:00","date_to":"2020-05-30 00:00:00"}'

Configuration file

Set your connection parameters for MySQL/MariaDB and MongoDB on .env file.

Python script for data extraction

There is a python bulk script to extract the encrypted information from the MongoDB, the Blockchain blocks are stored in the MongoDB database sensors on the collection sensors_values.

This script is present in DDL/mongodb/script_extractor, it will create a folder in the same place called dumps_mongo with all the blockchain decrypted blocks.

The script shows this output when execute: python bulk_blockchain.py:

Options for bulk_blockchain.py:

     -type: Mandatory option to choose between databases
         simple: Bulk to files the data from the standard sensors blockchain (output path ./dumps_mongo/simple_blockchain)

     Optional params:

         -start-date: Start date to search with format dd-mm-YYY HH:mm:ss
         -end-date: End date to search with format dd-MM-YYY HH:mm:ss

         **No date parameters mean to get the full data timeline

Example:
           python bulk_blockchain.py -type=simple

           python bulk_blockchain.py -type=simple -start-date="29-07-2019" -end-date="31-07-2019"

Extract all the Blockchain:

python bulk_blockchain.py -type=simple

Search between two dates over the Blockchain:

python bulk_blockchain.py -type=simple -start-date="29-07-2019" -end-date="31-07-2019"

Postman collection

There is a postman collection available on DDL/, import it on your postman application to test the services, or use the readme CURLs.

Docker for Rust Blockchain

Docker uses as internal and external port 8090. Start the Docker witchcraft with:

docker-compose up

Docker uses the .env-docker file to obtain the configuration parameters.