Expand description
Hyprstream binary - ML inference server
This binary provides the main entry point for the Hyprstream service.
EnumsΒ§
- Native
Announcement πRefresh Completion - The only native-announcement refresh path used by the production publisher.
- Proof
Replay πStore Selection - Install the v16 proof admission substrate: the rotating server challenge and the replay admission store (Β§4.6, Β§4.7).
- Quic
Checkpoint πPolicy - The only startup policy that consumes PDS lifecycle classification.
- Telemetry
Provider π - Telemetry provider type
ConstantsΒ§
- POLICY_
INITIAL_ πPUBLICATION_ BUDGET - Policy must serve authority probes while Discovery starts, but is not READY until Discovery accepts its announcement. Only typed pre-dispatch Iroh unavailability can keep that initial publication pending.
- POLICY_
INITIAL_ πPUBLICATION_ RETRY
FunctionsΒ§
- build_
cli π - Build the CLI using clap builder API with hybrid derive-based subcommands.
- dedicated_
service_ πprocess_ name - Process termination is safe only when this process hosts one known service.
- flat_
key_ πpolicy_ resolver_ credential - The enrolled credential a process-global resolver presents when the process
has no selected service identity (a multi-service foreground graph or a
plain CLI command). On a flat-key deployment
policyresolves to the node root/CA key (#759), so that key IS the policy identity: the resolver may present policyβs enrolled JWT. Without it, cross-process Discovery resolution from such a process goes out anonymous and dies at the MAC dispatch PEP (NoClearance) on labeled nodes. Split-key deployments are unchanged: key mismatch or a missing credential yields None. - foreground_
service_ πprocess_ names - Resolve the services hosted by this foreground process independently of transport profile. Background start commands do not host their children.
- handle_
quick_ πcommand - Handle all
quicksubcommands β orchestrated multi-step workflows. - init_
telemetry π - Initialize OpenTelemetry with the specified provider
- install_
envelope_ πverify_ config - Install the process-global envelope verify configuration (#152, #160).
- install_
process_ πproduction_ resolver - Install the process production resolver and return whether the
authenticated trust source was the OS-owned bootstrap (
true) or a DID-anchored source (false). The caller retains this selection so the QUIC startup gate can scope first-boot deferral to the OS-owned path only. - install_
proof_ πadmission - install_
session_ πpq_ overlay - Install the session PQ binding overlay, the runtime anchoring path for clients no operator can pre-enroll (browsers and other device-generated identities).
- load_
config π - Load HyprConfig from file path or default locations
- load_
process_ πsigning_ key - Required service startup consumes the provisionerβs retained key. Missing or malformed material is never a reason to generate a new identity or use the CLI/root key. Compatibility commands retain their existing key behavior.
- main π
- native_
announcement_ πbearer - Use the current authority projectionβs service JWT for envelope identity.
- native_
service_ πprocess_ name - Select the process identity before constructing any resolver/client. Transport flags do not decide whose identity a required-native split service uses.
- process_
identity_ πname - The identity a foreground process installs into the process-global Discovery resolver and later uses for service startup. A native (iroh-required) selection takes precedence; otherwise a dedicated single-service compatibility process uses its provisioned service identity so the resolver client and the service share one key and enrolled credential. Plain CLI commands get neither.
- publish_
native_ πannouncement_ attempt - The required first result covers both fresh-authority projection and the Discovery publication. An authority error must not bypass the handshake.
- quic_
checkpoint_ πpolicy - refresh_
native_ πannouncement - resolve_
moq_ πrelay_ reach - Resolve a serviceβs verifying key via the global trust store.
- resolve_
service_ πvk - select_
iroh_ πmoql_ admission_ proof - Quinnβs CONNECT path has no process-global MoQL proof slot. Defer proof collection itself to an enabled Iroh profile so Quinn-only multi-service startup does not inherit Irohβs one-service dialer restriction.
- select_
proof_ πreplay_ store - select_
single_ πprocess_ moql_ admission_ proof - A QUIC process currently owns one native MoQ dialer and its admission-proof slot. Sharing that slot across separately checkpointed services would make a later service dial as the first serviceβs DID. Refuse that topology until the dialer is service-scoped; checkpointed services must run separately.
- spawn_
native_ πannouncement_ loop - Spawn the native-announcement refresh loop on its own current-thread Tokio runtime and return a channel for the first announcement result.
- start_
native_ πannouncement_ publisher - Production publisher startup boundary: only required Iroh waits for a successful first publication. Compatibility keeps its retry task alive.
- supports_
tui π - wait_
for_ πpolicy_ initial_ publication - with_
runtime π - Execute a command with the appropriate runtime configuration
Type AliasesΒ§
- Native
Announcement πFirst Result - One-shot sender for the first native-announcement result.
- Native
Announcement πFirst Tx - Optional one-shot channel passed to the native-announcement loop body so it can report the result of the first announcement.