Logos Messaging: Difference between revisions

From Local Area Network
New article from the Building a Parallel Society course, source-checked
 
Second check fixes, plus material from the Circles handbook, Circle reports, LAN and Logos docs, source-checked
Line 4: Line 4:
The Logos documentation says Logos Messaging lets applications "send messages, relay data, and coordinate with one another without relying on centralised servers or exposing metadata." Messages travel across a peer-to-peer relay network "with no central broker". It supports one-to-one messages, group messages and public broadcast channels. Anyone can run a node, and there is no gas fee for sending or receiving messages.
The Logos documentation says Logos Messaging lets applications "send messages, relay data, and coordinate with one another without relying on centralised servers or exposing metadata." Messages travel across a peer-to-peer relay network "with no central broker". It supports one-to-one messages, group messages and public broadcast channels. Anyone can run a node, and there is no gas fee for sending or receiving messages.


The Logos website calls it "Resilient, private messaging for coordination in hostile environments."
Among its use cases, the Logos website lists "Resilient, private messaging for coordination in hostile environments."


The Logos activist course ''Building a Parallel Society'' (2026) describes Logos Messaging as a transport layer. It says chat is one of the things built on it. The course lists three uses: coordination between people and groups "that no platform is hosting", a channel that the other modules and applications use to talk to each other, and a mixnet layer. It says the module removes "the platform that controls who can organise with whom."
The Logos activist course ''Building a Parallel Society'' (2026) describes Logos Messaging as a transport layer. It says chat is one of the things built on it. The course lists three uses. The first is coordination between people and groups "that no platform is hosting". The second is a channel that the other modules and applications use to talk to each other. The third is a mixnet layer. The course says the module removes "the platform that controls who can organise with whom."


== How it works ==
== How it works ==
The documentation describes two modules.
The documentation describes two modules.
* '''Delivery''' is "the peer-to-peer messaging network at the base of the messaging stack". It is the reference implementation of the Logos Messaging protocol. Applications combine a set of protocols. Relay handles publish and subscribe messaging. RLN Relay adds spam protection with rate limiting nullifiers, which check a zero-knowledge proof in place of the sender's identity. Filter, Store and Light Push serve nodes with little bandwidth. Store keeps messages for a time so that offline peers can catch up. It does not guarantee that they stay available.
* '''Delivery''' is "the peer-to-peer messaging network at the base of the messaging stack". It is the reference implementation of the Logos Messaging protocol. Applications combine a set of protocols. Relay handles publish and subscribe messaging, in which senders publish to topics and nodes receive the topics they subscribe to. Topics are labels that route messages. RLN Relay adds spam protection with rate limiting nullifiers (RLN). Each message carries a zero-knowledge proof in place of the sender's identity. The Messaging FAQ says the proof shows only that the sender belongs to a set of users allowed to send a certain number of messages in a given time. Filter, Store and Light Push serve nodes with little bandwidth. Store keeps messages for a time so that offline peers can catch up. It does not guarantee that they stay available, and the FAQ "recommends using Logos Storage for long-term storage."
* '''Chat''' is "a protocol and library that provides one-to-one and group conversations with end-to-end encryption, using de-MLS for group messaging." It uses Delivery as its transport.
* '''Chat''' is "a protocol and library that provides one-to-one and group conversations with end-to-end encryption, using de-MLS for group messaging." It uses Delivery as its transport.


Logos Messaging is built on libp2p. The documentation says it adds a service network that anyone can use without running their own infrastructure, and spam protection that libp2p does not provide.
The FAQ says Delivery encrypts the connections between nodes but applies "no default encryption method" to the data itself. Applications choose their own encryption for message contents.


The documentation states the privacy limits openly. Relay provides pseudonymity and unlinkability. Store and Filter need a direct connection, so a node serving them can link a peer's identifier to the topics it asks for.
LAN Issue 2, the Logos movement's zine, explains what de-MLS changes. It says MLS, the standard for encrypted group chat, "assumes a server that is always online will do the job, which means whoever runs the server holds the member list." It says "Logos Messaging's version, de-MLS, removes that server and assigns the job to one member at a time, with the role rotating." Members propose adding or removing someone, and the group votes over the network. A protocol called Scalable Data Sync keeps every member in step, since each message points back to the messages that led to it. See [[Issue 2/Who Keeps the Member List?]].
 
Logos Messaging is built on libp2p, a widely used peer-to-peer networking library. The documentation says it adds a service network that anyone can use without running their own infrastructure, and spam protection that libp2p does not provide.
 
The documentation sets out the privacy limits. Relay provides pseudonymity, so messages carry no real identity, and unlinkability, so messages are hard to tie to their sender. Store and Filter need a direct connection, so a node serving them can link a peer's identifier to the topics it asks for.


=== Mixnet ===
=== Mixnet ===
The Logos stack also has a mixnet in its networking layer. The documentation says messages are "routed through a sequence of intermediary relay nodes that shuffle and delay traffic before forwarding it", with cover traffic. The course calls the mixnet layer "running today as a demo". The Logos documentation describes its current state as a separate desktop app, chat_ui_mix, built from a branch of the Logos Chat interface. The app connects to a "testnet-0.2 mix fleet" and sends messages "sender-unlinkably through the 3-hop mixnet." That procedure is marked accurate for Testnet v0.2.1.
The Logos stack also has a mixnet in its networking layer. The documentation says messages are "routed through a sequence of intermediary relay nodes that shuffle and delay traffic before forwarding it", with cover traffic. The course calls the mixnet layer "running today as a demo". For Testnet v0.2.1 the documentation describes a separate desktop app, chat_ui_mix, built from a branch of the Logos Chat interface. The app connects to a "testnet-0.2 mix fleet" and sends messages "sender-unlinkably through the 3-hop mixnet." With Testnet v0.3, Logos says "Chat now uses RLN and Mix through Delivery." Mix is also available to developers through the Messaging API, and "the Mix module allows node operators to run mix nodes."


== In Basecamp ==
== In Basecamp ==
The Logos website lists a Chat app in Basecamp for "Encrypted one-to-one chat. Peer to peer, with no server in the middle." The Logos procedure, marked accurate for Testnet v0.2.1, installs Chat from the Basecamp Package Manager. Installing it also brings in the chat module and the delivery module. The app gives each instance an address that another instance uses to open a conversation. The procedure notes that "Identity, conversations, and message history exist only while the app is running."
The Logos website lists a Chat app in Basecamp for "Encrypted one-to-one chat. Peer to peer, with no server in the middle." The Logos procedure for one-to-one chat, marked accurate for Testnet v0.2.1, installs Chat from the Basecamp Package Manager. Installing it also brings in the chat module and the delivery module. The app gives each instance an address that another instance uses to open a conversation. That procedure says "Identity, conversations, and message history exist only while the app is running." Logos says that with Testnet v0.3 "Chat now keeps message history across sessions". It adds that "reopening chat creates a new account." The group procedure says conversations from an earlier launch "stay readable under Previous sessions but can't be sent to".
 
The group procedure, written for Testnet v0.3.0, describes end-to-end encrypted group conversations in the Chat app. Members are invited by address. It says "in this release membership only grows: members can't be removed and can't leave."
 
Sending on the logos.test network needs an RLN membership. The documentation says "a node needs an active membership before any message it sends goes out." In Basecamp the membership is registered from the Delivery Demo app. The node pays for it in LEZ native tokens from a payer account that it derives itself, and "There is no faucet". The documentation lists Chat and its two modules among the Basecamp apps that run natively on Windows.


On 1 November 2026 the official module catalogue, logos-co/logos-modules-release on GitHub, listed seven Logos Messaging modules. They include the delivery and chat modules, the Chat interface, a libp2p networking module, two rate limiting nullifier modules and an educational Delivery Demo. The catalogue pinned the delivery module at version 0.3.3 and the chat module and Chat interface at 0.3.0. The underlying chat library describes itself as "pre-1.0, and moving", with every component at version 0.1.0 and the protocol not yet frozen.
On 1 November 2026 the official module catalogue, logos-co/logos-modules-release on GitHub, listed seven Logos Messaging modules. They include the delivery and chat modules, the Chat interface, a libp2p networking module, two rate limiting nullifier modules and an educational Delivery Demo. The catalogue pinned the delivery module at version 0.3.3 and the chat module and Chat interface at 0.3.0. The underlying chat library describes itself as "pre-1.0, and moving", with every component at version 0.1.0 and the protocol not yet frozen.
== In use ==
Projects on the [[Tools]] page that use Logos Messaging include [[Booth]], [[Receiver]], [[Forumer]], [[KYM]], [[Perun]], [[Shrooms]], [[WhisperBox]], [[Backpack]], [[Whistleblower]] and [[Logos Autonomous Agent]]. [[LNS]], [[LEZ Atomic Swaps]] and [[Forum-protocol]] also use it. The Tools page lists those three under the Logos Execution Zone.
In October 2025 the [[Circles/Porto|Porto Circle]] proposed a privacy-first support tool for survivors of domestic violence, designed on Waku. Its proposal argued that "Existing helplines and police systems are centralised, easily traceable, and often unsafe."


== Names ==
== Names ==
The Logos documentation glossary defines Waku as "An old name for the Logos Delivery component of the Logos technology stack." Its list of repositories says logos-delivery was "formerly nwaku" and logos-delivery-js was "formerly Waku v2". The documentation still links to Waku pages and specifications in places. The ''Logos Field Guide'' (2026), a guide for anyone publishing or building under Logos, says "Logos Messaging was previously part of Waku." It asks for current module names in public-facing work and says Nomos, Waku and Codex are used "only when helping people map old names to current modules."
The Logos documentation glossary defines Waku as "An old name for the Logos Delivery component of the Logos technology stack." Its list of repositories says logos-delivery was "formerly nwaku" and logos-delivery-js was "formerly Waku v2". The documentation still links to Waku pages and specifications in places. The ''Logos Field Guide'' (2026), a guide for anyone publishing or building under Logos, says "Logos Messaging was previously part of Waku." It asks for current module names in public-facing work. It keeps the name Waku for legacy work, older documents, upstream history and specific technical components.


== See also ==
== See also ==
Line 32: Line 45:
* [[Basecamp]]
* [[Basecamp]]
* [[Testnet]]
* [[Testnet]]
* [[Tools]]
* [[Logos Blockchain]]
* [[Logos Blockchain]]
* [[Logos Storage]]
* [[Logos Storage]]
Line 41: Line 55:
* [https://logos.co/basecamp Basecamp], Logos, accessed 4 November 2026
* [https://logos.co/basecamp Basecamp], Logos, accessed 4 November 2026
* [https://docs.logos.co/messaging Introduction to Logos Messaging], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/messaging Introduction to Logos Messaging], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/messaging/get-started/faq FAQ: Logos Messaging], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/what-is-logos What is Logos?], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/what-is-logos What is Logos?], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/mixnet/get-started/send-anonymised-messages-over-the-mix-network Send anonymised messages over the mix network], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/mixnet/get-started/send-anonymised-messages-over-the-mix-network Send anonymised messages over the mix network], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/messaging/get-started/send-1-1-messages-logos-chat Send 1:1 messages with the Logos Chat app], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/messaging/get-started/send-1-1-messages-logos-chat Send 1:1 messages with the Logos Chat app], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/messaging/get-started/send-group-messages-logos-chat Send group messages with the Logos Chat app], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/lez/rln/register-rln-membership-from-basecamp Register an RLN membership from Basecamp], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/basecamp/install-logos-basecamp Install Logos Basecamp], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/glossary Glossary], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/glossary Glossary], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/logos-ecosystem-repositories Logos ecosystem repositories], Logos documentation, accessed 4 November 2026
* [https://docs.logos.co/get-started/logos-ecosystem-repositories Logos ecosystem repositories], Logos documentation, accessed 4 November 2026
* [https://logos.co/media/article/logos-testnet-v03-live Logos Testnet v0.3 is Now Live], Logos, 30 September 2026
* [https://forum.logos.co/t/1382 Porto Circle winnable issue: Build Europe's First Digital Escape Egress], Logos Forum, 14 October 2025
* [https://github.com/logos-messaging/logos-chat logos-chat README], GitHub, accessed 4 November 2026
* [https://github.com/logos-messaging/logos-chat logos-chat README], GitHub, accessed 4 November 2026
* [https://github.com/logos-co/logos-modules-release logos-modules-release README], GitHub, commit of 1 November 2026
* [https://github.com/logos-co/logos-modules-release logos-modules-release README], GitHub, commit of 1 November 2026
Line 51: Line 71:
* [https://github.com/logos-co/logos-chat-module/blob/5053dd5062817f34a93055435781c1c448c7ce6c/metadata.json logos-chat-module metadata.json], GitHub, as pinned in the catalogue on 1 November 2026
* [https://github.com/logos-co/logos-chat-module/blob/5053dd5062817f34a93055435781c1c448c7ce6c/metadata.json logos-chat-module metadata.json], GitHub, as pinned in the catalogue on 1 November 2026
* [https://github.com/logos-co/logos-chat-ui/blob/15c16ca4ad48efe63993daa0765cac8ca9f7c36d/metadata.json logos-chat-ui metadata.json], GitHub, as pinned in the catalogue on 1 November 2026
* [https://github.com/logos-co/logos-chat-ui/blob/15c16ca4ad48efe63993daa0765cac8ca9f7c36d/metadata.json logos-chat-ui metadata.json], GitHub, as pinned in the catalogue on 1 November 2026
* LAN, Issue 2, Logos, October 2026
* Building a Parallel Society, Logos activist course, 2026
* Building a Parallel Society, Logos activist course, 2026
* Logos Field Guide, Logos, 2026
* Logos Field Guide, Logos, 2026

Revision as of 21:10, 4 November 2026

Logos Messaging is the messaging layer of the Logos technology stack. Logos describes it as "Private, censorship-resistant communication between parties." Its main component, Logos Delivery, was formerly called Waku. Together with Logos Blockchain and Logos Storage it makes up the initial Logos stack, and people run it on their own machines through Basecamp.

What it does

The Logos documentation says Logos Messaging lets applications "send messages, relay data, and coordinate with one another without relying on centralised servers or exposing metadata." Messages travel across a peer-to-peer relay network "with no central broker". It supports one-to-one messages, group messages and public broadcast channels. Anyone can run a node, and there is no gas fee for sending or receiving messages.

Among its use cases, the Logos website lists "Resilient, private messaging for coordination in hostile environments."

The Logos activist course Building a Parallel Society (2026) describes Logos Messaging as a transport layer. It says chat is one of the things built on it. The course lists three uses. The first is coordination between people and groups "that no platform is hosting". The second is a channel that the other modules and applications use to talk to each other. The third is a mixnet layer. The course says the module removes "the platform that controls who can organise with whom."

How it works

The documentation describes two modules.

  • Delivery is "the peer-to-peer messaging network at the base of the messaging stack". It is the reference implementation of the Logos Messaging protocol. Applications combine a set of protocols. Relay handles publish and subscribe messaging, in which senders publish to topics and nodes receive the topics they subscribe to. Topics are labels that route messages. RLN Relay adds spam protection with rate limiting nullifiers (RLN). Each message carries a zero-knowledge proof in place of the sender's identity. The Messaging FAQ says the proof shows only that the sender belongs to a set of users allowed to send a certain number of messages in a given time. Filter, Store and Light Push serve nodes with little bandwidth. Store keeps messages for a time so that offline peers can catch up. It does not guarantee that they stay available, and the FAQ "recommends using Logos Storage for long-term storage."
  • Chat is "a protocol and library that provides one-to-one and group conversations with end-to-end encryption, using de-MLS for group messaging." It uses Delivery as its transport.

The FAQ says Delivery encrypts the connections between nodes but applies "no default encryption method" to the data itself. Applications choose their own encryption for message contents.

LAN Issue 2, the Logos movement's zine, explains what de-MLS changes. It says MLS, the standard for encrypted group chat, "assumes a server that is always online will do the job, which means whoever runs the server holds the member list." It says "Logos Messaging's version, de-MLS, removes that server and assigns the job to one member at a time, with the role rotating." Members propose adding or removing someone, and the group votes over the network. A protocol called Scalable Data Sync keeps every member in step, since each message points back to the messages that led to it. See Issue 2/Who Keeps the Member List?.

Logos Messaging is built on libp2p, a widely used peer-to-peer networking library. The documentation says it adds a service network that anyone can use without running their own infrastructure, and spam protection that libp2p does not provide.

The documentation sets out the privacy limits. Relay provides pseudonymity, so messages carry no real identity, and unlinkability, so messages are hard to tie to their sender. Store and Filter need a direct connection, so a node serving them can link a peer's identifier to the topics it asks for.

Mixnet

The Logos stack also has a mixnet in its networking layer. The documentation says messages are "routed through a sequence of intermediary relay nodes that shuffle and delay traffic before forwarding it", with cover traffic. The course calls the mixnet layer "running today as a demo". For Testnet v0.2.1 the documentation describes a separate desktop app, chat_ui_mix, built from a branch of the Logos Chat interface. The app connects to a "testnet-0.2 mix fleet" and sends messages "sender-unlinkably through the 3-hop mixnet." With Testnet v0.3, Logos says "Chat now uses RLN and Mix through Delivery." Mix is also available to developers through the Messaging API, and "the Mix module allows node operators to run mix nodes."

In Basecamp

The Logos website lists a Chat app in Basecamp for "Encrypted one-to-one chat. Peer to peer, with no server in the middle." The Logos procedure for one-to-one chat, marked accurate for Testnet v0.2.1, installs Chat from the Basecamp Package Manager. Installing it also brings in the chat module and the delivery module. The app gives each instance an address that another instance uses to open a conversation. That procedure says "Identity, conversations, and message history exist only while the app is running." Logos says that with Testnet v0.3 "Chat now keeps message history across sessions". It adds that "reopening chat creates a new account." The group procedure says conversations from an earlier launch "stay readable under Previous sessions but can't be sent to".

The group procedure, written for Testnet v0.3.0, describes end-to-end encrypted group conversations in the Chat app. Members are invited by address. It says "in this release membership only grows: members can't be removed and can't leave."

Sending on the logos.test network needs an RLN membership. The documentation says "a node needs an active membership before any message it sends goes out." In Basecamp the membership is registered from the Delivery Demo app. The node pays for it in LEZ native tokens from a payer account that it derives itself, and "There is no faucet". The documentation lists Chat and its two modules among the Basecamp apps that run natively on Windows.

On 1 November 2026 the official module catalogue, logos-co/logos-modules-release on GitHub, listed seven Logos Messaging modules. They include the delivery and chat modules, the Chat interface, a libp2p networking module, two rate limiting nullifier modules and an educational Delivery Demo. The catalogue pinned the delivery module at version 0.3.3 and the chat module and Chat interface at 0.3.0. The underlying chat library describes itself as "pre-1.0, and moving", with every component at version 0.1.0 and the protocol not yet frozen.

In use

Projects on the Tools page that use Logos Messaging include Booth, Receiver, Forumer, KYM, Perun, Shrooms, WhisperBox, Backpack, Whistleblower and Logos Autonomous Agent. LNS, LEZ Atomic Swaps and Forum-protocol also use it. The Tools page lists those three under the Logos Execution Zone.

In October 2025 the Porto Circle proposed a privacy-first support tool for survivors of domestic violence, designed on Waku. Its proposal argued that "Existing helplines and police systems are centralised, easily traceable, and often unsafe."

Names

The Logos documentation glossary defines Waku as "An old name for the Logos Delivery component of the Logos technology stack." Its list of repositories says logos-delivery was "formerly nwaku" and logos-delivery-js was "formerly Waku v2". The documentation still links to Waku pages and specifications in places. The Logos Field Guide (2026), a guide for anyone publishing or building under Logos, says "Logos Messaging was previously part of Waku." It asks for current module names in public-facing work. It keeps the name Waku for legacy work, older documents, upstream history and specific technical components.

See also

Sources

Page status: Outline. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.