logos-messaging/docs.waku.org
1
0
Fork 0
mirror of https://github.com/logos-messaging/docs.waku.org.git synced 2026-01-03 13:23:06 +00:00
Code Issues Packages Projects Releases Wiki Activity
docs.waku.org/docs/overview/concepts/content-topics.md
LordGhostX 7ee00ba345
update content topics intro
2023-05-16 16:08:52 +01:00

1.7 KiB
Raw Blame History

title
Content Topics

Content Topics in Waku are the foundation for content addressing, similar to Content-Addressable Storage. They facilitate protocol-level features like processing incoming live messages selectively (Relay or Filter) and retrieving historical messages (Store) that meet specific filtering criteria.

Unlike encrypted data, Content Topics are metadata strings set by developers on outgoing messages. Please refer to the WAKU2-TOPICS specification to learn more.

Content Topic Format

Here is the recommended format for content topics:

/{application-name}/{version}/{content-topic-name}/{encoding}

  • application-name: This is the unique name of your decentralized application (dApp) to prevent conflicts with other dApps.
  • version: Typically starting at 1, this field helps track breaking changes in your messages.
  • content-topic-name: The specific name of the content topic used for filtering. If your dApp utilizes Waku for multiple features, it is advisable to have a separate content topic for each feature.
  • encoding: The message serialization/encoding format, with Protobuf (proto) being the commonly used choice.

For instance, if your dApp is called SuperCrypto and it allows users to receive notifications and send private messages, you can consider utilizing the following content topics:

  • /supercrypto/1/notification/proto
  • /supercrypto/1/private-message/proto