aboutsummaryrefslogtreecommitdiffstats
path: root/swarm/storage/feeds/doc.go
blob: d1edf5d6d1621d1a9201c5fb0b2bfd6663130282 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
/*
Package feeds defines Swarm Feeds.

Swarm Feeds allows a user to build an update feed about a particular topic
without resorting to ENS on each update.
The update scheme is built on swarm chunks with chunk keys following
a predictable, versionable pattern.

A Feed is tied to a unique identifier that is deterministically generated out of
the chosen topic.

A Feed is defined as the series of updates of a specific user about a particular topic

Actual data updates are also made in the form of swarm chunks. The keys
of the updates are the hash of a concatenation of properties as follows:

updateAddr = H(Feed, Epoch ID)
where H is the SHA3 hash function
Feed is the combination of Topic and the user address
Epoch ID is a time slot. See the lookup package for more information.

A user looking up a the latest update in a Feed only needs to know the Topic
and the other user's address.

The Feed Update data is:
updatedata = Feed|Epoch|data

The full update data that goes in the chunk payload is:
updatedata|sign(updatedata)

Structure Summary:

Request: Feed Update with signature
    Update: headers + data
        Header: Protocol version and reserved for future use placeholders
        ID: Information about how to locate a specific update
            Feed: Represents a user's series of publications about a specific Topic
                Topic: Item that the updates are about
                User: User who updates the Feed
            Epoch: time slot where the update is stored

*/
package feeds