blossom/README.md

1.0 KiB

🌸 Blossom - Blobs stored simply on mediaservers

What is it?

Blossom is a spec for a set of HTTP endpoints that allow users to store blobs of data on publicly accessible servers

What are blobs

Blobs are packs of binary data addressed by their sha256 hash

How does it work?

Blossom Servers expose four endpoints for managing blobs

  • GET /<sha256> (optional file .ext)
  • HEAD /<sha256> (optional file .ext)
  • PUT /upload
    • Authentication: Signed nostr event
    • Return a blob descriptor
  • GET /list/<pubkey>
    • Returns an array of blob descriptors
    • Authentication (optional): Signed nostr event
  • DELETE /<sha256>

Protocol specification

BUDs stand for Blossom Upgrade Possibilities.

See the BUDs folder and specifically BUD-01 for a detailed explanation of the endpoints

License

Public domain.