|
1 | 1 | # Rate Limiting Nullifier (RLN) |
2 | 2 |
|
3 | | -A privacy-preserving rate limiting protocol for decentralized systems, powered by ZK. |
| 3 | +A privacy-preserving rate-limiting protocol for decentralised systems, powered by ZK. |
4 | 4 |
|
5 | 5 | --- |
6 | 6 |
|
7 | | -This document summarizes RLN's principles and provides reference materials for developers and researchers interested in privacy-preserving rate limiting. |
| 7 | +This document summarises RLN's principles and provides reference materials for developers and researchers interested in privacy-preserving rate limiting. |
8 | 8 |
|
9 | | -## Why RLN |
| 9 | +## Why RLN? |
10 | 10 |
|
11 | | -In decentralized systems, rate limiting must prevent spam without exposing identities or relying on central control. |
| 11 | +In decentralised systems, rate limiting must prevent spam without exposing identities or relying on central control. |
12 | 12 |
|
13 | | -RLN achieves this using zero-knowledge proofs and anonymous nullifiers, enabling fair participation that is **privacy-preserving**, **decentralized**, and **verifiable**. |
| 13 | +RLN achieves this using zero-knowledge proofs and anonymous nullifiers, enabling fair participation that is **privacy preserving**, **decentralised**, and **verifiable**. |
14 | 14 |
|
15 | | -## What is RLN |
| 15 | +## What is RLN? |
16 | 16 |
|
17 | 17 | RLN is a zero-knowledge protocol that enables rate limiting without revealing **user identities**. |
18 | 18 |
|
19 | | -It prevents spam in anonymous systems by allowing each user to generate exactly one valid proof per time window named **Epoch**, maintaining anonymity. |
| 19 | +It prevents spam in anonymous systems by allowing each user to generate exactly one valid proof per time window, named **Epoch**, while maintaining anonymity. |
20 | 20 |
|
21 | | -## How RLN Works |
| 21 | +## How RLN works |
22 | 22 |
|
23 | 23 | 1. A user joins a group (for example, a Merkle tree). |
24 | 24 | 2. Each message includes a proof and a nullifier. |
25 | 25 | 3. The proof is verified with nullifiers. |
26 | 26 | 4. If a nullifier is reused within a time window, it indicates **spam**. |
27 | 27 | 5. The system detects abuse without revealing the sender's identity. |
28 | 28 |
|
29 | | -Core Components: |
| 29 | +Core components: |
30 | 30 |
|
31 | 31 | | Concept | Description | |
32 | 32 | | --- | --- | |
@@ -58,16 +58,16 @@ Core Components: |
58 | 58 |
|
59 | 59 | ### Integrations / Use Cases |
60 | 60 |
|
61 | | -- [Status Gasless L2](https://docs.status.network/general-info/gasless-transactions#rln) |
| 61 | +- [Status Gasless L2](https://docs.status.network/general-info/gasless-transactions#rln): |
62 | 62 | 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 Prover–Verifier 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](https://github.com/status-im/status-network-monorepo/blob/develop/status-network-contracts/docs/rln.md) |
63 | | -- [Waku-rln-relay](https://arxiv.org/pdf/2207.00117) |
64 | | - In the Waku network, RLN is integrated into the gossip-based relay layer to enable privacy-preserving spam protection without relying on centralized 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 Waku to provide anonymous, decentralized, and spam-resistant messaging across heterogeneous networks. Check the [rln.waku.org](https://rln.waku.org/) RLN Membership on Linea Sepolia testnet. |
65 | | -- [Railgun](https://docs.railgun.org/wiki/learn/privacy-system/community-broadcasters) |
66 | | - 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 Waku 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, decentralized, and censorship-resistant while benefiting from Waku's efficient peer-to-peer messaging framework. |
67 | | -- [TheGraph](https://docs.graphops.xyz/graphcast/radios/listener-radio?_highlight=waku#advanced-configuration) |
68 | | - In Graph ecosystem, Graphcast leverages Waku 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 Waku 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. |
69 | | - |
70 | | -### Talks & References |
| 63 | +- [Waku-rln-relay](https://arxiv.org/pdf/2207.00117): |
| 64 | + 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](https://rln.waku.org/) RLN Membership on Linea Sepolia testnet. |
| 65 | +- [Railgun](https://docs.railgun.org/wiki/learn/privacy-system/community-broadcasters): |
| 66 | + 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. |
| 67 | +- [The Graph](https://docs.graphops.xyz/graphcast/radios/listener-radio?_highlight=waku#advanced-configuration): |
| 68 | + 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. |
| 69 | + |
| 70 | +### Talks and references |
71 | 71 |
|
72 | 72 | - [Using RLN in a Peer to Peer Network | Aaryamann Challani | PROGCRYPTO](https://www.youtube.com/watch?v=7xDxv8F70Jg) |
73 | 73 | - [0xPARC RLN YT](https://www.youtube.com/watch?v=OGhf991iTPc) |
|
0 commit comments