Nosana container engine used for running jobs on the Nosana network. Learn more at nosana.io.

It's recommended to use Clojure version 1.10.x and JVM 11.

The configuration of the node is read from a few different places. In a production environment, the configuration values are passed as environment variables. Locally it is most convenient to use the ~/.nosana-node-config.edn file:

cp nosana-node-config.edn-TEMPLATE ~/.nosana-node-config.edn

In development you will only have to enter your node's NFT address in the .nosana-node-config.edn and configure Solana and Pinata.

If you do not have a default Solana keypair yet you can generate one with:

solana-keygen new

Make sure your Solana account has enough staked and holds an NFT.

The node uses Pinata to upload job results to IPFS. If you do not have Pinata credentials set your node will fail to upload job results and get slashed. In the future, we will support multiple storage backends - feel free to open a GitHub issue with suggestions.

For now, log in to Pinata and generate new API credentials with the pinJSONToIPFS ability. Then copy the JWT value to your config.

Below is the table of config values that can be set:

This project includes solanaj as a git submodule, so you will have to clone this repository recursively.

The solanaj classes have to be compiled once before we start:

clj -X:compile

This compiles the solanaj class files and puts them in the target folder. You can now start a repl.

We use jibbit to build a container image on the JVM without a Docker daemon.

To build a docker container and import it to your local docker daemon, tagged as nos/node:

clj -T:container "$(< jib-local.edn)"

The jib.edn file can be adjusted to push to a different registry or supply a different tagger. For more info check the jibbit docs. For CI/CD the jib-gitlab.edn file is used.

The project can also be compiled as a standalone jar:

clj -X:compile uberjar

The resulting jar file can be run in a JVM like:

PODMAN_URI=localhost:8080 java -jar target/node-0.0.189-standalone.jar

You will have to run a local non-privileged Podman container:

sudo docker run -d \
  --name podman \
  --device /dev/fuse \
  --security-opt seccomp=unconfined \
  --security-opt apparmor=unconfined \
  --security-opt label=disable \
  --cap-add sys_admin \
  --cap-add mknod \
  -p 8080:8080 \
  quay.io/podman/stable podman system service \
  --time 0 tcp:0.0.0.0:8080

Podman will be used to spin up containers for Nosana jobs.

To quickly start a development REPL, and spin up the node:

clj -M:dev -r
# Clojure 1.10.0
# user=> (go)

Make sure that your node is healthy and fix any configuration issues that are reported.

This is the fun part! You are now able to interact with the Nosana network directly through this interface.

Here are some example commands to check. Note that our repl defined the conf variable that contains the network configuration, and system which contains all the components of the server:

;; displays the current market and queue
user=> (nos/get-market conf)

;; see you if you have any jobs claimed
user=> (nos/find-my-runs conf)

;; enter the market queue
user=> (nos/enter-market conf)

;; or: just run the main loop, that will process jobs (polls after 30 seconds)
user=> (start-work-loop!)

;; to cancel the main loop
user=> (nos/exit-work-loop! system)

;; to list a compute job on the market
user=> (nos/list-job conf pl/example-job)

;; run an example pipeline from the repl
user=> (run-flow (flow/build (pl/load-yml (io/resource "pipeline2.yml"))))

Production nodes can run on any device with a JVM and Podman available. For simplicity we recommend running the node through docker. Below is an example of how you could start a Docker-based Nosana node, in which you will have to fill out the correct environment variables:

docker run --rm -it \
  -e "SOLANA_PRIVATE_KEY=$(< ~/.config/solana/id.json)"
  -e "PODMAN_CONN_URI=http://$(docker inspect -f '{{ .NetworkSettings.IPAddress }}' podman):8080" \
  -e "NOSANA_NFT=nftaddress" \
  -e "SOLANA_NETWORK=mainnet" \
  -e "PINATA_JWT=jwtvalue" \
  nos/node