Files
0xbathangandJulesFILIOT 26630f3486 chore: rebrand Vac to Logos Research & update docusaurus-preset
* Update index.md

removed vac for logos research

* Update community.mdx

removing vac mentions

* Update contribute.md

minor style fixes

* Update principles.md

removing vac

* Update research.md

remove vac mentions

* Update rfcprocess.md

remove vac references

* Update rln.md

changed waku references to Logos Messaging - someone with more tech knowledge should check if accurate and examples are still relevant

unified language (mix of US and UK English used before)

* Update rln.md

updated style and changed "logos messaging" to "logos"

* Update security.md

removed vac references

* Update vips.md

changed nescience and vac references

* Update vsus.md

changed out vac references and reworded some things

* Update vsus.md

* Update vsus.md

* chore:  replace Vac references by Logos Research

Replace remaining references of Vac by Logos Research.

* chore: replace visible refs of rfc.vac.dev by lip.logos.co

* chore: update twitter links

* fix: pin docusaurus packages versions

* chore: use theme aware logo

* chore: bump `logos-docusaurus-preset` -- updates assets/metadata

New version of the `@acid-info/logos-docusaurus-preset` package updates the following:
- title/tagline/URL rebranded to "Logos Research" (research.logos.co); navbar logo gains srcDark for theme-aware switching (black in light mode, off-white in dark mode)
- all SVGs/ICO replaced with Logos lambda mark; off-white variants for dark contexts

* chore(/principles): update link top status.app principles

* chore: bump `@acid-info/logos-docusaurus-preset` package version

* chore: bump `@acid-info/logos-docusaurus-preset` package version

* chore: bump `@acid-info/logos-docusaurus-preset` package version

---------

Co-authored-by: JulesFILIOT <dev@julesfiliot.com>
2026-05-08 16:39:45 +09:00

5.9 KiB
Raw Permalink Blame History

Rate Limiting Nullifier (RLN)

A privacy-preserving rate-limiting protocol for decentralised systems, powered by ZK.


This document summarises RLN's principles and provides reference materials for developers and researchers interested in privacy-preserving rate limiting.

Why RLN?

In decentralised systems, rate limiting must prevent spam without exposing identities or relying on central control.

RLN achieves this using zero-knowledge proofs and anonymous nullifiers, enabling fair participation that is privacy preserving, decentralised, and verifiable.

What is RLN?

RLN is a zero-knowledge protocol that enables rate limiting without revealing user identities.

It prevents spam in anonymous systems by allowing each user to generate exactly one valid proof per time window, named Epoch, while maintaining anonymity.

How RLN works

  1. A user joins a group (for example, a Merkle tree).
  2. Each message includes a proof and a nullifier.
  3. The proof is verified with nullifiers.
  4. If a nullifier is reused within a time window, it indicates spam.
  5. The system detects abuse without revealing the sender's identity.

Core components:

Concept Description
Nullifiers A unique message or TX tag per message window
Rate limit window (Epochs) Defines how often a proof can be valid
Membership proof Confirms user is part of an authorized group by tree
Proof system Zero-knowledge circuit (Groth16) by Zerokit
Secret Extractable by an additional nullifier that exceeds the user's commitment
id-commitment Commitment of the user message (TX) right for an epoch and secret.

Resources

Docs

Implementations

Integrations / Use Cases

  • Status Gasless L2: In Status Network, RLN serves as the cryptographic rate-limiting layer that enables secure and fair gasless transactions. Instead of traditional gas fees, users are limited by cryptographic proofs based on RLN. Each user can send only a fixed number of transactions per epoch; exceeding this limit makes their secret key recoverable. RLN uses Sparse Merkle Trees for scalable membership management, supporting millions of accounts. The system operates through a ProverVerifier model: the Prover generates an RLN proof for each transaction, while the Verifier in the Sequencer validates it. This architecture allows Status Layer 2 to process gasless, privacy-preserving, and spam-resistant transactions efficiently. See the implementation here: rln.md
  • Waku-rln-relay: In Logos Messaging, RLN is integrated into the gossip-based relay layer to enable privacy-preserving spam protection without relying on centralised moderation or heavy computational proof-of-work. The resulting protocol, WAKU-RLN-RELAY, limits the messaging rate of each peer through zero-knowledge proofs that verify group membership while keeping user identities private. If a participant exceeds the allowed message quota, their secret can be cryptographically revealed, resulting in a financial penalty, while honest peers who detect spammers are rewarded. This integration allows Logos Messaging to provide anonymous, decentralised, and spam-resistant messaging across heterogeneous networks. Check the rln.waku.org RLN Membership on Linea Sepolia testnet.
  • Railgun: In the RAILGUN ecosystem, privacy is achieved fully on-chain through zero-knowledge cryptography, enabling users to interact privately with DeFi and smart contracts across Ethereum, BSC, Polygon, and Arbitrum without leaving their native chain. Since RAILGUN uses Logos Messaging as its communication layer, the same RLN-based anti-spam mechanisms described in the previous section apply here as well. This integration ensures that private transactions and messages remain secure, decentralised, and censorship-resistant while benefiting from Logos Messaging's efficient peer-to-peer messaging framework.
  • The Graph: In the Graph ecosystem, Graphcast leverages Logos Messaging and RLN to enable real-time, spam-resistant, and privacy-preserving communication among Indexers. Instead of relying on costly on-chain broadcasts, Graphcast provides a peer-to-peer messaging layer where Indexers can exchange data such as subgraph integrity checks, query analytics, and coordination signals at near-zero cost. RLN ensures rate-limited, anonymous message delivery, preventing spam while maintaining low latency and privacy. Since Logos Messaging serves as the underlying communication protocol, the same RLN-based mechanisms described earlier apply, allowing The Graph network to scale coordination securely without incurring blockchain gas fees.

Talks and references