Skip to main content

Module root

Module root 

Source
Expand description

Org roots: the client’s root of trust.

A Root lists the org’s k-of-n root keys, the release keys it delegates (optionally scoped to apps and channels, with an expiry) and the timestamp keys the org chose to trust: none, the WeirdBrains timestamp key, the org’s own, or several. The app pins a RootPin (a fingerprint of the first root’s keys and threshold) at build time.

Rotation follows TUF: root version N+1 must be signed by a threshold of version N’s keys and a threshold of its own keys.

Structs§

Delegation
A release key delegated by the root.
Root
An org root record.
RootPin
The trust anchor compiled into an app: BLAKE3 (derive-key mode) over the threshold and the sorted root keys. It names a key set, not a document, so it survives re-signing.

Constants§

MAX_KEYS
Most keys in any one role.
MAX_SCOPE
Most app or channel names in one delegation scope.