cudo-compute

Cudo Compute PoC

Contract

Building & deploying

To build and deploy on the default network

$ sh scripts/deploy-contracts.sh

CLI tool

Install

To install from NPM

$ npm install -g cudo-compute
$ cudo-compute ...

To install as a package from source

$ npm run build
$ npm pack
$ npm install -g cudo-compute-1.0.0.tgz
$ cudo-compute ...

To use from source without installing

$ npm run build
$ ./bin/cudo-compute.js ...

Contract

Building & deploying

Building and deploying is mostly managed by the CUDOS blast tool.

$ sh contract/deploy.sh

If boxchain_contract_address does not exist in the project root, this will upload and instantiate the contract and store the address in that file.

If it does exist, it will upload the new code and migrate the existing contract to it.

Off-chain

Preparation

Make sure you have deployed the contract.

Install needed packages.

$ cd offchain
$ npm install
$ sh build.sh

If you are developing, use the watch mode to rebuild main.js automatically

$ sh watch.sh

Use

$ ./boxchain <command...>

Localnet

Unless you are using testnet (or mainnet!), you'll have to start the localnet

$ cd contract
$ blast node start

Client

# List machines
$ ./boxchain -aaccount2 demand list

# Create a machine
$ ./boxchain -aaccount2 demand add [size] [amount]|[duration] [ssh-key]

# Show the status of machine ID
$ ./boxchain -aaccount2 demand get ID

# Delete machine ID (TODO)
$ ./boxchain -aaccount2 demand rm ID

Executor

# Run the server for one supply operation
$ ./boxchain -aaccount3 supply one

# Run the server until manually stopped
$ ./boxchain -aaccount3 supply run

Notes

Amounts and durations

The demand add command accepts an amount in cudos, or a duration. Cudo amounts are simply converted directly to acudos, and durations are converted to acudos via the currently configured rate.

format	unit	in cudos
NNNs	seconds	config rate
NNNm	minutes	60 * config rate
NNNh	hours	3,600 * config rate
NNNd	days	43,200 * config rate
NNNy	years	15,768,000 * config rate
NNNacudos	attocudos	1e-18 cudos
NNNfcudos	femtocudos	1e-16 cudos
NNNpcudos	picocudos	1e-12 cudos
NNNncudos	nanocudos	1e-9 cudos
NNNucudos	microcudos	1e-6 cudos
NNNmcudos	millicudos	1e-3 cudos
NNNcudos	cudos	1 cudo exactly
NNNkcudos	kilocudos	1e+3 cudos

TODO

• A web-based UI for the requester

• Run on testnet

• Run the executor on the cloud

• Run the executor on cloud compute resources provisioned by this system :)