The basic components of an operating system are a kernel designed to manage processes and resources and a shell. The shell is an interactive abstraction over the kernel. We have our own kernel module designed to manage processes and utilities related to using the Truebit protocol. We also provide a nice shell (CLI) to interface with the kernel. If you want to be a miner (solver/verifier) in our network you can follow the instructions below to setup your node with Docker. For technical reasons, this repository also contains all of our smart contracts. If you are interested in interfacing with Truebit via smart contract you'll want to check out this example application. It demonstrates how to use Truebit-OS as a dependency in your own development process.
If you want to talk to the developers working on this project feel free to say hello on our Gitter
An ethereum client running on port 8545, and an ipfs daemon at port 5001. For a quick start, ganache-cli is a blockchain emulator that can be used for development.
npm i -g ganache-cli
You will also need the latest version of solidity compiler installed and available on your path. Please refer to its documentation to install its binary package.
Install instructions are catered to Linux users. However, other OS's can use this by simply installing ocaml-offchain without the npm run deps script.
In order to get things running you'll have to go through all these commands at least once.
cd truebit-os/
npm i
npm run fixperms
npm run deps # you'll need to be in root (su root)
npm run compile
npm run deploydocker build . -t truebit-os:latest
docker run -it -p 4001:4001 -p 30303:30303 -v ~/kovan:/root/.local/share/io.parity.ethereum truebit-os:latest /bin/bash
Then use tmux to create multiple sessions of the shell:
Reminder commands:
To split plane horizontally
ctrl+b "
To split plane vertically
ctrl-b %
In one of the sessions:
cd truebit-os/scripts
chmod 755 kovan.sh
./kovan.sh
In the other panel (ctrl-b+arrow to change panel) run this command:
ipfs swarm connect /ip4/176.9.9.249/tcp/4001/ipfs/QmS6C9YNGKVjWK2ctksqYeRo3zGoosEPRuPhCvgAVHBXtg
Once your kovan node is synced you are ready to follow along with the usage instructions below.
Point the truebit-os shell to the wasm client configuration file which it will use to initialize.
NOTE: If you have not fully waited for your node to sync to kovan, the following command will throw an error.
npm run truebit wasm-client/config.json
You should now see the truebit-os shell. The shell provides a number of commands which you can get instructions by using the help command:
help
Before submitting a task you will need to claim some test TRU tokens, from our faucet.
claim -a 0
Then account0 after the transaction is confirmed you should have 10000 TRU.
After starting up the shell you can enter commands to start submitting and solving tasks:
You can start up a task giver process that will monitor the incentive layer smart contract for events:
start task -a 0
Now the process will be monitoring for tasks created by account 0.
We can also start up a solver with a different account:
start solve -a 1
We've started up a solver with account 1 (this is to simulate different users, but it could be the same account).
Finally, we can submit our task:
task -a 0 -t testWasmTask.json
If you are using the Kovan testnet you can look at the progress of your transactions here.
We have specified to submit a task from account 0. And the data related to the task is located at testWasmTask.json
If you are running this on a development test net you will need to skip blocks to see the solution in the solutions directory.
skip 200 # Go past the challenge period
skip 300 # Go past reveal period and finalize task
NOTE These parameters are subject to future change
To run the tests use: npm run test
The wasm-client directory houses the primary Truebit client. It contains 4 relevant JS modules that wrap the internal details of the protocol for a user friendly experience. These modules are designed to interact with the Truebit OS kernel and shell. The four modules are taskGiver, taskSubmitter, solver, and verifier. These modules can be run independently from each other. With the exception of taskGiver and taskSubmitter being recommended to run together.
The way that Truebit OS knows where to load the relevant modules is with a config file. This is a simple JSON file with a couple fields, that tell the OS where to find the modules at. Here is the example config.json provided used for basic-client:
{
"http-url": "http://localhost:8545",
"verifier": "../wasm-client/verifier",
"solver": "../wasm-client/solver",
"task-giver": "../wasm-client/taskGiver"
}Logging is provided by winston. If you would like to disable console logging, you can set the NODE_ENV to production, like so:
NODE_ENV='production' npm run test
Add submodule
git submodule add *url*
Cloning repo with submodule
git clone *repo*
cd *submodule_name*
git submodule init
git submodule update
If you want to include all the submodules with the repo you clone
git clone --recurse-submodules *url*
Fetching submodule updates
git submodule update --remote *submodule_name*
Pushing changes of a submodule to remote
git submodule update --remote --merge
Deleting submodules
git rm *submodule_name*
rm -rf .git/modules/*submodule_name*