Data and primitivesBlobs

Blobs

Identify binary bytes by content hash without confusing references with storage, transfer, or access.

Use a Blob reference to identify binary bytes by content hash. The primitive defines identity and metadata, not a binary store, downloader, or access grant.

A reference identifies expected bytes without proving their availability.

Identify bytes, not a location

BlobId is a 32-byte cryptographic hash of raw content. Identical bytes produce the same identifier. Changed bytes have a different content identity.

BlobRef combines that identifier with a byte count and optional content type. Construction from content computes the hash and size. Construction from stored parts reconstructs the supplied reference without proving that any bytes exist.

After retrieval, verify the bytes against BlobId. Check the size and inspect the actual format before use. Content type is self-asserted metadata, not a verified decoder choice or security boundary.

Own availability and retention

Your application chooses binary storage, transfer protocols, request authority, retention, and garbage collection. A shared identifier can support deduplication. It does not authorize another reader or promise permanent retention.

A reference has no document-style Active or Archived lifecycle. Saving, archiving, or deleting a related record does not itself establish what happens to shared bytes. Define those rules in the owning storage integration.

Metadata replication and binary availability remain independent. Bound file sizes, decode dimensions, transfer buffers, and concurrent requests. Report missing content separately from a saved record, and reject hash mismatches before presenting bytes.

Compose with other primitives

Entity ontology supports OntologyValue::BlobRef. Document fields do not embed BlobRef. Preserve document attachments through an application-owned relation rather than truncating a hash into a UUID.

The Blob reference defines exact constructors and verification methods. Consult the Platform language references for binding entry points.