The Hypermedia data model can be described in two shapes. The format of the signed data events that are permanently saved for validation, and the state snapshot, which represents the current state of the content.

Immutable Signed Data

With the exception of attachments, all data is encoded as IPLD-CBOR blobs (an alternative to JSON), and is saved into IPFS for permanent archival across the network.

These blobs are always signed by a private key, and must be one of the following types:

Change: Describes the creation or evolution of a Document

Ref: A blob which points to the current set of Changes, to signal the latest version of a Document.

Capability: Describes the granted permissions that other keys have to interact with a document or set of documents

Comment: Lightweight content from a single author

Snapshot Data

These are the mutable values in the Hypermedia network. They can change over time as a result of interpreting the latest Immutable Signed Data.

Site: Represents the content for a given key

Document: A page of content inside a Site, the main container for information in the network

Comment: A message attached to a Document, from a single author

Capability: The current set of valid permissions on a given document