Sample Truebit Task Library

Abstract

This is a Example Library of Several TrueBit Tasks that are written in different languages and show end-to-end how you would develop and deploy your own TrueBit tasks

Pre-Reqs to Install

These scripts are designed to be modified, built, and deployed within a running truebit-eth-server Docker image.

IMPORTANT! You must have completed the "Quick Start" portion of the truebit-eth read me and have an operational, properly configured Truebit installation. This is required to be able to deploy and test Truebit tasks and associated smart contracts in this repository of samples.

Your wallet must have enough ETH for contract deployment and any subsequent testing of the deployed contract. Also, appropriate TRU must be present to test task-giving.

Quick Start

This will describe the process of cloning this repository into the proper location, running a truebit-eth (or truebit-eth-server) Docker container, using the toolchain within that container to compile a sample Truebit task, and compile and deploy the associated smart contracts where appropriate.

git clone the sample repo into your ~/truebit-docker/wasm_bin directory in native Linux

YYY=$HOME'/truebit-docker'
docker run --network host -v $YYY/docker-clef:/root/.clef \
	-v $YYY/docker-geth:/root/.ethereum \
	-v $YYY/docker-ipfs:/root/.ipfs \
	-v $YYY/wasm_bin:/root/wasm_bin \
	--name truebit --rm -it truebitprotocol/truebit-eth:latest

TYPE: cd /
TYPE: bash ./goerli.sh
- Should run a split window with Geth on Top and CLEF on the bottom
- You need this window to enter in you password for the accounts when prompted
open second terminal window into container: docker exec -it truebit /bin/bash

Example Tasks

MapReduce Example

* _Language:_ C
* _Description:_ Task that takes a list of Binary32 data that are made up of ETH Address (First 20B) and a Value (Last 12B) maps the Value to the n^th prime number, then reduces the list by only looking for Value that contains the number '3'
* This example illustrates a full, end-to-end pipeline with an on-chain smart contract giving a Truebit task to be run off-chain by the Truebit solver/verifier network, and results returned on-chain to the calling smart contract upon successful completion.

To build this specific example, continue with the following instructions: