mirror of
https://github.com/hzrd149/blossom.git
synced 2025-12-12 07:48:51 +00:00
1.3 KiB
1.3 KiB
BUD-02
User Server List
draft optional
Defines a replaceable event using kind:10063 to advertise the blossom servers a user uses to host their blobs.
The event MUST include at least one server tag containing the full server URL including the http:// or https://.
The order of these tags is important and should be arranged with the users most "reliable" or "trusted" servers coming first.
The .content is not used.
{
"id": "e4bee088334cb5d38cff1616e964369c37b6081be997962ab289d6c671975d71",
"pubkey": "781208004e09102d7da3b7345e64fd193cd1bc3fce8fdae6008d77f9cabcd036",
"content": "",
"kind": 10063,
"created_at": 1708774162,
"tags": [
["server", "https://cdn.self.hosted"],
["server", "https://cdn.satellite.earth"]
],
"sig": "cc5efa74f59e80622c77cacf4dd62076bcb7581b45e9acff471e7963a1f4d8b3406adab5ee1ac9673487480e57d20e523428e60ffcc7e7a904ac882cfccfc653"
}
Client Integration
When uploading blobs clients should attempt to upload the blob to all or at least the top 3 server on the list event.
This ensures that the blob is available in multiple locations in the case one of the servers goes offline.
Server Integration
Servers may use this event kind to discover other servers that a user is uploading to in order to download specific blobs from.