From 68214214d9ea592388b0f43036ca37be904e7165 Mon Sep 17 00:00:00 2001
From: Rishabhmishra3129 <rishabhmishra3129@gmail.com>
Date: Sun, 10 May 2026 17:27:03 +0530
Subject: [PATCH 1/2] docs: add large-message propagation draft

---
 docs/docs/gossipsub-large-message-flow.md | 76 +++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 docs/docs/gossipsub-large-message-flow.md

diff --git a/docs/docs/gossipsub-large-message-flow.md b/docs/docs/gossipsub-large-message-flow.md
new file mode 100644
index 000000000..ae7e49a4e
--- /dev/null
+++ b/docs/docs/gossipsub-large-message-flow.md
@@ -0,0 +1,76 @@
+# Gossipsub 1.4 Large Message Propagation
+
+## Overview
+
+This document describes the proposed large-message
+propagation mechanism for Gossipsub 1.4.
+
+Large payloads are segmented into smaller chunks
+before propagation through the gossip mesh.
+
+---
+
+# Segmentation Flow
+
+```text
+Publisher
+   │
+Large Message
+   │
+Segmentation Layer
+   │
+┌───────────────┐
+│ Segment 1     │
+│ Segment 2     │
+│ Segment 3     │
+└───────────────┘
+   │
+Gossipsub Mesh
+   │
+Receiving Peers
+   │
+Reassembly Layer
+   │
+Reconstructed Message
+```
+
+---
+
+# Segment Metadata
+
+Each segment contains:
+
+| Field | Description |
+|---|---|
+| message_id | Unique identifier for original message |
+| segment_index | Current segment number |
+| total_segments | Total number of segments |
+| checksum | Integrity verification |
+| payload | Segment data |
+
+---
+
+# Reconstruction
+
+Receiving peers reconstruct the message after all
+segments are received.
+
+Reconstruction includes:
+
+- ordered reassembly
+- integrity verification
+- duplicate filtering
+- missing segment recovery
+
+---
+
+# Security Considerations
+
+Potential concerns include:
+
+- malicious segment flooding
+- incomplete message spam
+- memory exhaustion attacks
+- invalid checksum propagation
+
+Integrity verification should occur before reassembly.
\ No newline at end of file

From 8f99d2da48defe163c4e50db9fb24350588c5d4f Mon Sep 17 00:00:00 2001
From: Rishabhmishra3129 <rishabhmishra3129@gmail.com>
Date: Sun, 10 May 2026 17:32:22 +0530
Subject: [PATCH 2/2] docs: add large-message propagation draft

---
 {docs => fetch/docs}/docs/gossipsub-large-message-flow.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 rename {docs => fetch/docs}/docs/gossipsub-large-message-flow.md (95%)

diff --git a/docs/docs/gossipsub-large-message-flow.md b/fetch/docs/docs/gossipsub-large-message-flow.md
similarity index 95%
rename from docs/docs/gossipsub-large-message-flow.md
rename to fetch/docs/docs/gossipsub-large-message-flow.md
index ae7e49a4e..96e5f675f 100644
--- a/docs/docs/gossipsub-large-message-flow.md
+++ b/fetch/docs/docs/gossipsub-large-message-flow.md
@@ -73,4 +73,4 @@ Potential concerns include:
 - memory exhaustion attacks
 - invalid checksum propagation
 
-Integrity verification should occur before reassembly.
\ No newline at end of file
+Integrity verification should occur before reassembly.