Domain HTTP API
This page mirrors core/domain-http/README.md in the posemesh repo (branch main).
The repository is the source of truth.
posemesh-domain-http provides authentication and Domain data operations for
Rust, JavaScript/WASM, and Python. The Posemesh worker host uses it to implement
its task-scoped storage ports. Runner authors normally use TaskCtx.input and
TaskCtx.output; see the
runner reference.
Use the client directly
| Language | Package | API and examples |
|---|---|---|
| Rust | posemesh-domain-http | Source |
| JavaScript/TypeScript | @auki/domain-client | Binding API, examples in tests |
| Python | auki-domain-client (auki_domain_client import) | Binding contract, examples in tests |
The client supports User and App credentials, Domain listing, and Domain data uploads/downloads. Configure API and DDS endpoints for the same environment. The linked integration tests require an account and Domain; inspect their setup before running them.
Build from source
Run from posemesh/core:
cargo build --locked -p posemesh-domain-http
For WASM, use make build-domain-http TARGET=wasm. For Python, use
make build-domain-http TARGET=python. Prerequisites, test behavior, and
release instructions are in
Contributing.
See the changelog for published changes. This README is also included in the Python package.