hpos-api-rust

What is hpos-api-rust and what is it for?

hpos-api-rust is a small web API, written in Rust, that sits inside the HPOS host system and lets software talk to the Holochain services running on a host's machine. It exists so that something acting for the host — the host's own tooling or Holo's hosting services — can list the Holochain apps a device is hosting, read their usage, turn them on or off, and place calls into their zomes.

hpos-api-rust is a Rust project in the Holo Host organisation, built alongside other parts of the HPOS host stack rather than as a standalone application. Its build manifest takes its dependencies from the sibling HPOS service and configuration crates, and its documentation describes a binary whose environment is set by the host system — for example the HPOS configuration path that hpos-init supplies. The material available records no founding motive or release history, so none is described here.

In plain terms it is a small control panel expressed as an HTTP API. HPOS runs Holochain services on a host's device; this project exposes them under an /api/v2/ path so another program can ask which Holochain apps the device is hosting, how much they have been used, what they have earned, whether each is enabled or paused, and can read an app's logs or make a call into one of its zomes. Authentication relies on the hp-admin-crypto mechanism.

One documented example: a request to the hosted-apps endpoint with a seven-day usage interval returns each hosted app's details, including its source-chain count, days hosted, earnings and bandwidth, CPU and disk usage. The repository README carries the endpoint list and the configuration the binary expects. The catalog records this project's activity as stalled, and nothing in the material read describes it as something an individual installs and uses today; it is a component of the Holo hosting stack.

From 2 public sources, checked 23 September 2026.