Skip to content

Latest commit

 

History

History
139 lines (107 loc) · 5.01 KB

README.md

File metadata and controls

139 lines (107 loc) · 5.01 KB
Raw

How to run as Drive Owner

Generate a key pair for the node (Drive Account):

./generate_address

Example:

$ ./generate_address
PrivateKey:     69b24c083026fed041e0db68ee5a471fb8656575b317db632c12b82be1fbea7c
PublicKey:      98e28034b56f29edd469f19cbf3362ce1a820435931ae483daabfc2369ee1053
Address:        VA4MDQ5TXIHORZZG4LZKKRUXTUEJD6P3CQS3BPLL

Add private key:

Edit start-drive.sh and replace <PRIVATE_KEY> with drive account's private key.

#!/bin/bash

$drive_key = '<PRIVATE_KEY>'

docker stop drive
docker rm drive
docker run -d --name drive -p 6366:6466 -p 63666:64666 -v $PWD:/root/.dfms:rw proximax/sirius-storage-dfms:v0.6.4.1 dfms -k $drive_key

Example: Using nano editor by running nano start-drive.sh

#!/bin/bash

$drive_key = '69b24c083026fed041e0db68ee5a471fb8656575b317db632c12b82be1fbea7c'

docker stop drive
docker rm drive
docker run -d --name drive -p 6366:6466 -p 63666:64666 -v $PWD:/root/.dfms:rw proximax/sirius-storage-dfms:v0.6.4.1 dfms -k $drive_key

Start storage drive node

./start-drive.sh

Verify that dfms drive is running by running:

# checking docker running process:
docker ps

CONTAINER ID        IMAGE                                  COMMAND                  CREATED             STATUS              PORTS                                              NAMES
0b83f2c4c363        proximax/sirius-storage-drive:v0.6.4.1   "dfms -k 69B24C0830…"   9 seconds ago       Up 7 seconds        0.0.0.0:6366->6366/tcp, 0.0.0.0:63666->63666/tcp   drive

# checking drive container logs
docker logs drive
...
Root successfully started on:
1: /ip4/127.0.0.1/tcp/63666/p2p/12D3L7AV75nfdamZJHAf7iXNhZ3ggZxkNpaeGuzu5smXdSMgthoY
2: /ip4/172.17.0.2/tcp/63666/p2p/12D3L7AV75nfdamZJHAf7iXNhZ3ggZxkNpaeGuzu5smXdSMgthoY
API server successfuly started on /ip4/0.0.0.0/tcp/6366

Transfer XPX to the Drive Account

You may use web wallet at https://bctestnetwallet.xpxsirius.io to transfer XPX from your existing testnet account or you may get XPX from https://bctestnetfaucet.xpxsirius.io/

Exchange market

Before creating a drive, the owner must ensure that there is sufficient balance in the drive account to pay for the space for at least 1 billing period (1 month / 172800 ).

The storage units SO mosaic ID in Sirius Chain Testnet is 6de2c609655d3dbd.
The streaming units SM mosaic ID in Sirius Chain Testnet is 69dd64ed4343011c

You can see the exchange offers in the blockchain with the following API:

# offers to sell SO units for XPX
https://bctestnet1.brimstone.xpxsirius.io/exchange/sell/6de2c609655d3dbd

# offers to buy SO units for XPX
https://bctestnet1.brimstone.xpxsirius.io/exchange/buy/6de2c609655d3dbd


# offers to sell SM units for XPX
https://bctestnet1.brimstone.xpxsirius.io/exchange/sell/69dd64ed4343011c

# offers to buy SM units for XPX
https://bctestnet1.brimstone.xpxsirius.io/exchange/buy/69dd64ed4343011c

Please check here for more information about ProximaX Exchange Market.

Create Drive

In order to create a drive, the owner must first compose a drive contract.

When creating a drive contract, the drive owner node will search the exchange market for the lowest offer.

Example: create drive contract 100MB for 1 month

docker exec drive dfms contract compose 100 1
# it will take several minutes before a response
{
        "drive": "baegaajaiaqjcbfh7iec4q2hwd62eclc7x3qbs67wqxcuo5ycbizw7ubwrstjmpte",
        "owner": "0804122098e28034b56f29edd469f19cbf3362ce1a820435931ae483daabfc2369ee1053",
        "replicators": [
                "0804122061603b668fa165f6e088ebe87a6796669f494bd3c744c34f95526566f787bc69",
                "080412204d6bf5a5dcffbc2e7dfef067f17e711f036797f40e90c52022831764680c2414",
                "08041220882b77ba73cf7f0d2e972615324c61ca20b6c4cb91922a09a6c662eb4cf9377f"
        ],
        "root": "bafybeiczsscdsbs7ffqz55asqdf3smv6klcw3gofszvwlyarci47bgf354",
        "created": 949218,
        "duration": 518400,
        "space": 100,
        "replicas": 3,
        "minReplicators": 3,
        "percentApprovers": 66,
        "billingPrice": 300,
        "billingPeriod": 172800
}

Drive contract for the account can be found in the Sirius Chain.

Example: https://bctestnet1.brimstone.xpxsirius.io/account/98e28034b56f29edd469f19cbf3362ce1a820435931ae483daabfc2369ee1053/drive

Note: 98e28034b56f29edd469f19cbf3362ce1a820435931ae483daabfc2369ee1053 is the public keyof the drive account

Add file

The owner can add/upload file to the drive. Since the dfms application is running inside a docker container, it will only be able to see files that are mounted in the present working directory:

Example: adding README.md to the drive

$ docker exec drive dfms drive baegaajaiaqjcbfh7iec4q2hwd62eclc7x3qbs67wqxcuo5ycbizw7ubwrstjmpte add /root/.dfms/README.md /README.md

Hash: bafkreiaqu576lbxf5tzfbeac6jul2tcd7xbyoq2vhoqkdwjjl22izumlbi

Stop storage drive

./stop-drive.sh