Skip to content

Commit b589da2

Browse files
committed
add usage guidelines for waku content topics
1 parent 2b297d5 commit b589da2

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

waku/informational/23/topics.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,18 @@ to indicate different bandwidth and privacy guarantees.
129129
The encoding field indicates the serialization/encoding scheme
130130
for the [WakuMessage payload](../../standards/core/14/message.md/#payloads) field.
131131

132+
### Content Topic usage guidelines
133+
134+
Applications should be mindful while designing/using content topics so that a bloat of content-topics does not happen.
135+
A content topic bloat causes performance degradation in Store and Filter protocols while trying to retrieve messages.
136+
137+
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.
138+
Similarly number of filter subscriptions increase, which increases complexity on client side to maintain and manage these subscriptions.
139+
140+
Applications should analyze the query/filter criteria for fetching messages from the network and select/design content topics to match such filter criteria.
141+
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.
142+
143+
132144
## Differences with Waku v1
133145

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

0 commit comments

Comments
 (0)