Skip to content

Commit

Permalink
add usage guidelines for waku content topics
Browse files Browse the repository at this point in the history
  • Loading branch information
chaitanyaprem committed Dec 17, 2024
1 parent 2b297d5 commit b589da2
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions waku/informational/23/topics.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,18 @@ to indicate different bandwidth and privacy guarantees.
The encoding field indicates the serialization/encoding scheme
for the [WakuMessage payload](../../standards/core/14/message.md/#payloads) field.

### Content Topic usage guidelines

Applications should be mindful while designing/using content topics so that a bloat of content-topics does not happen.
A content topic bloat causes performance degradation in Store and Filter protocols while trying to retrieve messages.

Store queries have been noticed to be considerably slow (e.g doubling of response-time when content-topic count is increased from 10 to 100) when a lot of content-topics are involved in a single query.
Similarly number of filter subscriptions increase, which increases complexity on client side to maintain and manage these subscriptions.

Applications should analyze the query/filter criteria for fetching messages from the network and select/design content topics to match such filter criteria.
e.g: eventhough applications may want to segregate messages into different sets based on some application logic, if those sets of messages are always fetched/queried together from the network, then all those messages should use a single content-topic.


## Differences with Waku v1

In [5/WAKU1](../../deprecated/5/waku0.md) there is no actual routing.
Expand Down

0 comments on commit b589da2

Please sign in to comment.