30817:bud-inbox-servers

BUD: Inbox servers

Lets a user list the Blossom servers that receive the blobs other pubkeys send them, with their user server list as fallback.

Russell

published
2026-11-01
revised
2026-11-02

draft optional

An inbox server stores the blobs other pubkeys send to a user. This BUD defines the inbox server list, how inbox servers behave, and how clients use them. It requires Blob pinning.

Inbox server list

A kind 11708 event lists its author's inbox servers, with the server tags of BUD-03.

{
  "kind": 11708,
  "tags": [
    ["server", "https://inbox.example.com"],
    ["server", "https://inbox.example.net"]
  ],
  "content": ""
}

Inbox server

When an inbox server serves a blob only to the pubkeys that pin it (Blob pinning), a sender cannot tell whether or when the recipient deleted it.

Sending a blob

A client sends a blob to a pubkey by uploading it to the servers of that pubkey's kind 11708, with a p tag naming the pubkey. When the pubkey has no kind 11708, the client uses its kind 10063.

Receiving a blob

A client looks for a blob sent to it on the servers of its kind 11708, then on those of its kind 10063. It requests the blob with a get token (BUD-11).

Discussion

Connect a key to comment.