From e0d67ba4e6bffe1e33c03f82428aeae9c422390f Mon Sep 17 00:00:00 2001
From: fryorcraken <commits@fryorcraken.xyz>
Date: Thu, 16 Oct 2025 16:17:44 +1100
Subject: [PATCH] Waku API and architecture

---
 ARCHITECTURE.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 ARCHITECTURE.md

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
new file mode 100644
index 0000000..2bc3e71
--- /dev/null
+++ b/ARCHITECTURE.md
@@ -0,0 +1,42 @@
+# Waku Architecture
+
+An overview of the Waku architectures target, include the various layer and APIs.
+This is an update of the [Reliablity and Waku API](https://blog.waku.org/2024-06-20-message-reliability/) article
+
+```mermaid
+block-beta
+    columns 4
+    sc["Secure Conversations (Chat SDK)"]:4
+    
+    e["Encryption"]:1
+    rc["Reliable Channels"]:3
+    
+    space:1
+    sg["Segmentation"]:1
+    rlm["Rate Limit Manager"]:1
+    sds["Scalable Data Sync"]:1
+
+    P2PReliability["P2P Reliability (Waku API)"]:4
+    block:wakuapi:4
+        columns 7
+        RLNRelay["RLN Relay"]:1
+        Store["Store"]:1
+        Lightpush["Lightpush"]:1
+        Filter["Filter"]:1
+        Discv5["Waku Discv5"]:1
+        PeerExchange["Peer Exchange"]:1
+        PeerManager["Peer Manager"]:1
+        
+    end
+    
+    block:libp2p:4
+        P2PEncryption["Point-to-Point Encryption"]
+        Multiplexer["Multiplexer"]
+        Transport["Transport"]
+    end
+    
+    block:base:4
+        UDP["UDP"]
+        TCP["TCP/IP"]
+    end
+```
\ No newline at end of file