The Real World Web

Synced from the repository

This page mirrors README.md in the posemesh repo (branch main). The repository is the source of truth.

Build compute nodes and robots on the Auki network with a Rust Runner. Posemesh handles machine authentication, DMS task polling, heartbeats, storage access, and reporting results. Your runner implements the capability.

Use Auki SDK protocols to exchange data with other peers during a task.

Start here

Run a robot and compute node together. Both claim dedicated DMS tasks, exchange an Echo message over P2P, and report completion.

You need Rust 1.89+, Python 3, and configured workers in a compatible DDS/DMS environment.

What are you building?

Build	Identity	Task placement
Compute node	DDS registration and a signing wallet; DDS applies staking requirements	Public or dedicated work across eligible Domains
Robot	DDS robot credentials, without a compute wallet or stake	Dedicated work in its assigned Domain

Both use the same runner interface. The entrypoint selects machine authentication. For user apps and backend services that connect to peers, start with Auki SDK.

Documentation

I want to…	Read
Configure host credentials, endpoints, and P2P	Configure workers
Create workers or authorize job submission	Provision workers
Implement my own task capability	Write a runner
Exchange data with another peer	Use P2P in a runner
Handle cancellation, retries, and shutdown	Manage task lifecycle
Understand the runtime and services	How tasks execute
Look up traits, ports, and results	Runner reference
Look up environment variables or troubleshoot	Configuration reference

Repository

Directory	Contents
core/compute-node/	Shared host for compute nodes and robots
core/compute-node-runner-api/	Runner interface and the paired Echo example
core/domain-http/	Domain HTTP client and bindings

The Rust workspace is in core/. To work on the implementation or other components in this repository, see Contributing.

MIT license. Report security issues privately to security@aukilabs.com.