Skip to content

WholesumNet/client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Wholesum network Client CLI

Overview

Wholesum network is a p2p verifiable computing network. It builds on top of Risc0, Swarm, FairOS-dfs, and Libp2p to facilitate verifiable computing at scale.

How to run

To run a client agent, you would first need to fork the comms library and put it in the parent("..") directory of the client directory. Next, you would need a job file, in case you were interested to run a tiny job, with the following look in TOML:

# schema of a tyipcal job

title = "yet another simple job"
timeout = 30

[compute]

# min ram capacity(in GB) for an offer to be accepted
min_memory_capacity = 4

# docker image run by the server
docker_image = "rezahsnz/risc0-sha"

# command to run, will run as: "sh -c command"
command = "/home/prince/sha 1>/home/prince/residue/stdout 2>/home/prince/residue/stderr"

[verification]

# Risc0 image_id of the "sha example"
image_id = "c0e787dad721d314cc4823f2e0cd5e7caa405575cc55947217bd5663c076ad6a"

# minimum number of independent successful verifications
min_required = 1

[harvest]

# minimum number of verified traces to make the whole job verified and done
min_verified_traces = 1

Save the above content to a file named simple_job.toml, and then run the client cli to get your job done:
cargo run -- --job simple_job.toml

Please note that the sample job file shown here requires the presence of Server and Verifier nodes in order to demonstrate a complete request-run-verify cycle.

USAGE

Usage: client [OPTIONS]

Options:
  -j, --job   
  -h, --help       Print help
  -V, --version    Print version