mirror of
https://github.com/hzrd149/blossom.git
synced 2026-09-13 22:25:06 +00:00
hashtree
Adds changes-from-source-proposals.md summarizing how this specification set diverges from PRs #104-#107, and links it from the README's Source Material section, which previously compressed the entire delta into a single sentence about excluded compatibility forms. Calls out the wire-breaking changes separately: the versioned key grew from 32 to 33 bytes, nhash TLV type 5 grew with it, the blossom: URI encryption parameters were removed, three legacy read-paths were dropped, and the replaceable-event tie-break reversed. Notes that the MessagePack wire format itself is unchanged, with all manifest test vectors carrying over byte-identical. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015UJK2viVichZctCtyz9zWu
🌸 Blossom - Blobs stored simply on mediaservers
Blossom uses nostr public / private keys for users identities.
What is it?
Blossom is a specification 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
Protocol specification (BUDs)
BUDs or Blossom Upgrade Documents are short documents that outline an additional feature that a blossom server may implement.
BUDs
- BUD-00: Blossom Upgrade Documents
- BUD-01: Server requirements and blob retrieval
- BUD-02: Blob upload and management
- BUD-03: User Server List
- BUD-04: Mirroring blobs
- BUD-05: Media optimization
- BUD-06: Upload requirements
- BUD-07: Payment required
- BUD-08: Nostr File Metadata Tags
- BUD-09: Blob Report
- BUD-10: Blossom URI Schema
- BUD-11: Nostr Authorization
- BUD-12: Blob management endpoints
Endpoints
Blossom Servers expose a few endpoints for managing blobs
GET /<sha256>(optional file.ext) BUD-01HEAD /<sha256>(optional file.ext) BUD-01PUT /uploadBUD-02HEAD /uploadBUD-06GET /list/<pubkey>BUD-12 (unrecommended)DELETE /<sha256>BUD-12PUT /mirrorBUD-04HEAD /mediaBUD-05PUT /mediaBUD-05PUT /reportBUD-09
Event kinds
| kind | description | BUD |
|---|---|---|
24242 |
Authorization token | 11 |
10063 |
User Server List | 03 |
License
Public domain.
Languages
Markdown
100%