Skip to content

Public Service Boundary ​

MALT Core authenticates relationships relative to a caller-selected Root and query. The optional Gateway supplies storage, execution and managed service access. The local runtime and browser clients verify the evidence and returned payload bytes.

Website and Console ​

This VitePress site provides public explanations, tutorials and browser proof tools. Its source is malt-web/docs.

The Gateway Console is maintained in gateway/console, alongside the Gateway service. It is built independently from the Go service binary and uses same-origin /api routes. The supported browser authentication SDK and WASM assets come from malt-ts.

The local MALT runtime is another client: it owns the CLI/daemon, local trust state, UnixFS behavior and verification. There is no separate managed Console repository.

Managed Access ​

The managed Console provides account sign-in, Bucket selection, file browsing and uploads. Gateway owns identity, authorization, quotas, service administration and branch publication. Bucket permissions and service-administrator access are separate authorities.

Shared authentication, CAS and dataset capabilities follow the runtime's public Node API. Gateway services apply the caller's permissions and Bucket lifecycle to each operation. Reader permits queries and reads; candidate export, materialization and publication require Writer.

A materialization receipt acknowledges persistence at the selected service. Publishing a branch or observing its head does not accept that Root on behalf of the client. Concurrent publication may preserve a candidate on a conflict branch; the application must check the result bound to its original request.

Snapshot Reads and Payloads ​

The Console keeps its selected browsing snapshot separate from a newly observed head. A head notification prompts an explicit refresh. Proofs are checked against the selected Root and exact query; payload blocks are checked against authenticated CIDs. Browser HTTP cache hits alone do not establish verification.

Managed Bucket proof queries require authorization. In the current managed edge design, immutable payloads are separately readable by CID through GET|HEAD /api/v1/cas/{cid}. Store ciphertext or intentionally public bytes on that public delivery path. Bucket ACL changes affect later authorized service calls, but cannot recall a public CID download, cached response or bytes already held by a client. Complete shared-snapshot and cache revocation policy remains deferred.

These are source-level service boundaries. The Gateway repository owns the immutable-read contract and deployment procedures; access to that service repository is restricted. A source commit or successful build does not establish which version a live deployment runs.

Ownership ​

SurfaceOwner
Protocol, Root formats, proofs and local authenticationMALT Core
Browser API, Workers and distributed WASMmalt-ts
Public website, explanations and proof toolsmalt-web
Managed service and account/Bucket ConsoleGateway
Local accepted roots, CLI/daemon and UnixFSMALT runtime
Reproducible experiments and result provenancemalt-evaluation

See Runtime and Repository Boundaries for the implementation map and Gateway API Boundaries for typed HTTP requests.

MALT separates payload storage, arc authentication, and execution.