Accessing

Object assets can be accessed using PRE URIs and retrieved via satellites.

PRE URI

A PRE URI (Uniform Resource Identifier) is used to locate and access a specific asset of an object at a particular revision. The format for the URI is:

pre://{oid}/{rev}/{sel}
  • oid: The unique identifier of the object, in dot-decimal format.
  • rev: The object's revision number.
  • sel: Selector to specify the asset type.

Alternatively, materials or object assets can be retrieved via a hash-based URI:

pre://{universe}/{hash}
  • universe: The universe ID where the material's preimage is known.
  • hash: The hexadecimal hash of the material or asset.

HTTP Gateway URL

For browsers or legacy systems that don’t natively support PRE URIs, object assets can be accessed using HTTP gateways:

https://preimage.link/{oid}/{rev}/{sel}

or through the hash-based URL:

https://preimage.link/{universe}/{hash}

These URLs allow assets to be easily viewed or downloaded via a web browser.

By leveraging satellites and gateways like preimage.link, the protocol ensures transparent, verifiable, and accessible object assets, whether accessed through decentralized command-line interfaces or web platforms.