🌸 Blossom

Blobs stored simply on mediaservers

What is it?

Blossom is a spec of http endpoints for storing blobs on publicly accessible servers

How dose it work?

Blobs are packs of binary data addressed by their sha256 hash

Blossom Servers expose four endpoints for managing blobs

GET /<sha256> (optional file .ext)
PUT /upload
GET /list
DELETE /<sha256>

Blob Descriptor

A blob descriptor is a JSON object containing url, sha256, size, type, and created fields

url A public facing url this blob can retrieved from
sha256 The sha256 hash of the blob
size The size of the blob in bytes
type (optional) The MIME type of the blob
created The unix timestamp of when the blob was uploaded to the server

Servers may include additional fields in the descriptor like magnet, infohash, or ipfs depending on other protocols they support

Nostr Identities

Blossom uses nostr public / private keys for identities. Users are expected to sign "Client Authentication" events to prove their identity when uploading or deleting blobs

Server Implementation

See Server

Client Implementation

Example Implementation: blossom-client (TypeScript)