Account
A reference to an account, held as the bare `hm://<principal>` URL, with `format: hm-profile` so editors offer an account search and accept a pasted principal.

Extends

This page describes the account value type of Hypermedia Schemas. It is a field type for the attributes of a document, and it holds a reference to an account. It is not the account concept. To learn what an account is, read Identity. The formal schema of this type is attached to this document as the schemaDefinition key of its metadata. So the app can show the schema and create values of this type.

An account value names a person, an organisation or a device by its principal. That is the public key that owns the space hm://<principal>/…. The type refines string: the value is the account's bare hm:// URL with no path. So the same spelling works anywhere a document reference does, and it leads to the account's home document. A principal holds the same key as bytes inside a signed blob. An account holds it as text inside document attributes.

format: hm-profile tells an editor two things. Show the value as a pill with the account's name. Offer a search over accounts when the field is empty. You can paste either spelling: on commit, a z6Mk… principal becomes hm://z6Mk…. The pattern lets a validator check the shape without looking anything up.

See also

    principal: the same key as bytes, for signed blobs.

    hm-url: a reference to any document, with an optional target type.

    Identity: how keys become accounts.

    Scalar schema: how format and patterns refine a string.

Do you like what you are reading? Subscribe to receive updates.

Unsubscribe anytime