Wiki source code of Networks
Version 24.1 by Zenna Elfen on 2026/01/05 19:43
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
19.1 | 1 | (% class="jumbotron" %) |
| 2 | ((( | ||
| 3 | (% class="container" %) | ||
| 4 | ((( | ||
| |
20.1 | 5 | = Peer-for-Peer Networks = |
| |
19.1 | 6 | |
| |
20.1 | 7 | P4P, short for Peer-4-Peer (which in turn is short for Peer-for-Peer) are a family of networks which build on principles of local-first, peer-2-peer, open-source, routing agnostic (offline-first) and mutual-aid principles. The above is a lot of terms which in and of themselves carry a lot of meaning, yet when combined they enable censorship-resistant, resilient and adaptive, sustainable and energy-efficient communication infrastructures. |
| |
19.1 | 8 | ))) |
| 9 | ))) | ||
| 10 | |||
| |
3.1 | 11 | (% class="box" %) |
| 12 | ((( | ||
| |
11.1 | 13 | This page contains an overview of all P4P Networks in this wiki and their building blocks. |
| 14 | |||
| 15 | You can also [[add a P4P Network>>doc:Projects.WebHome]] or have a look at the [[P4P Applications>>doc:P4P.Applications.WebHome]]. | ||
| |
3.1 | 16 | ))) |
| |
1.1 | 17 | |
| |
24.1 | 18 | |
| 19 | ((( | ||
| |
17.1 | 20 | {{toc/}} |
| |
1.1 | 21 | |
| |
3.1 | 22 | |
| |
11.1 | 23 | == Building Blocks of P4P Networks == |
| |
9.1 | 24 | |
| 25 | |||
| |
11.1 | 26 | (% class="box" %) |
| 27 | ((( | ||
| |
15.1 | 28 | To fully assemble a P4P network one needs a few different building blocks, below is an overview of 15 of those building blocks. Lost in translation? Take a look at the [[terminology>>doc:P4P.Definitions.WebHome]]. |
| |
11.1 | 29 | ))) |
| 30 | |||
| 31 | |||
| |
15.1 | 32 | ==== **1. Data Synchronization** ==== |
| |
11.1 | 33 | |
| |
13.1 | 34 | > Synchronization answers **how updates flow between peers** and how they determine what data to exchange. This layer is about **diffing, reconciliation, order, causality tracking, and efficient exchange**, not persistence or user-facing collaboration semantics. |
| |
11.1 | 35 | |
| |
15.1 | 36 | * //How do peers detect differences and synchronize state?// |
| 37 | * Examples: Range-Based Set Reconciliation, RIBLT, Gossip-based sync, State-based vs op-based sync, Lamport/Vector/HLC clocks, Braid Protocol | ||
| |
11.1 | 38 | |
| 39 | |||
| 40 | |||
| |
15.1 | 41 | ==== **2. Collaborative Data Structures & Conflict Resolution** ==== |
| |
11.1 | 42 | |
| |
13.1 | 43 | > This layer defines **how shared data evolves** when multiple peers edit concurrently. It focuses on **conflict-free merging, causality, and consistency of meaning**, not transport or storage. CRDTs ensure deterministic convergence, while event-sourced or stream-driven models maintain a history of all changes and derive consistent state from it. |
| 44 | |||
| |
15.1 | 45 | * //How do peers collaboratively change shared data and merge conflicts?// |
| 46 | * Examples: CRDTs (Yjs, Automerge), OT, Event Sourcing, Stream Processing, Version Vectors, Peritext | ||
| |
13.1 | 47 | |
| 48 | |||
| 49 | |||
| |
15.1 | 50 | ==== **3. Data Storage & Replication** ==== |
| |
13.1 | 51 | |
| 52 | > This layer focuses on **durability, consistency, and redundancy**. It handles write-paths, crash-resilience, and replication semantics across nodes. It is the “database/storage engine” layer where **data lives and survives over time**, independent of sync or merging logic. | ||
| 53 | |||
| |
15.1 | 54 | * //How is data persisted locally and replicated between peers?// |
| 55 | * Examples: SQLite, IndexedDB, LMDB, Hypercore (append-only logs), WALs, Merkle-DAGs (IPFS/IPLD), Blob/media storage | ||
| |
13.1 | 56 | |
| 57 | |||
| 58 | |||
| |
15.1 | 59 | ==== **4. Peer & Content Discovery** ==== |
| 60 | |||
| |
13.1 | 61 | > Discovery occurs in two phases: |
| 62 | > 1. **Peer Discovery** → finding _any_ nodes | ||
| 63 | > 2. **Topic Discovery** → finding _relevant_ nodes or resources | ||
| 64 | > These mechanisms enable decentralized bootstrapping and interest-based overlays. | ||
| 65 | |||
| |
15.1 | 66 | * //How do peers find each other, and how do they discover content in the network?// |
| 67 | * Examples: DHTs (Kademlia, Pastry), mDNS, DNS-SD, Bluetooth scanning, QR bootstrapping, static peer lists, Interest-based routing, PubSub discovery (libp2p), Rendezvous protocols | ||
| |
13.1 | 68 | |
| 69 | |||
| 70 | |||
| |
15.1 | 71 | ==== **5. Identity & Trust** ==== |
| |
13.1 | 72 | |
| 73 | > Identity systems ensure reliable mapping between peers and cryptographic keys. They underpin authorization, federated trust, and secure overlays. | ||
| 74 | |||
| |
15.1 | 75 | * //How peers identify themselves, authenticate, and establish trustworthy relationships?// |
| 76 | * Examples: PKI, Distributed Identities (DIDs), Web-of-Trust, TOFU (SSH-style), Verifiable Credentials (VCs), Peer key fingerprints (libp2p PeerIDs), Key transparency logs | ||
| |
13.1 | 77 | |
| 78 | |||
| |
16.1 | 79 | |
| |
15.1 | 80 | ==== **6. Transport Layer** ==== |
| |
13.1 | 81 | |
| |
15.1 | 82 | > This layer provides logical connections and flow control. QUIC and WebRTC bring modern congestion control and encryption defaults; Interpeer explores transport beyond IP assumptions. |
| |
13.1 | 83 | |
| |
16.1 | 84 | * //How do peers establish end-to-end byte streams and reliable delivery?// |
| |
15.1 | 85 | * Examples: TCP, UDP, QUIC, SCTP, WebRTC DataChannels, Interpeer transport stack |
| |
13.1 | 86 | |
| 87 | |||
| |
16.1 | 88 | |
| |
15.1 | 89 | ==== **7. Underlying Transport (Physical/Link Layer)** ==== |
| 90 | |||
| 91 | > Highly relevant for **offline-first / edge networks**, device-to-device communication, and mesh networks and relates to the hardware which facilitates connections. | ||
| 92 | |||
| |
16.1 | 93 | * //How does data move across the medium?// |
| |
15.1 | 94 | * Examples: Ethernet, Wi-Fi Direct / Wi-Fi Aware (post-AWDL), Bluetooth Mesh, LoRa, NFC, Cellular, CSMA/CA, TDMA, FHSS |
| 95 | |||
| |
16.1 | 96 | |
| 97 | |||
| |
15.1 | 98 | ==== **8. Session & Connection Management** ==== |
| 99 | |||
| 100 | > Manages **connection lifecycle**, including authentication handshakes, reconnection after drops, and session continuation—especially important in lossy or mobile networks. | ||
| 101 | |||
| |
16.1 | 102 | * //How are connections initiated, authenticated, resumed, and kept alive?// |
| |
15.1 | 103 | * Examples: TLS handshake semantics, Noise IK/XX patterns, session tokens, keep-alive heartbeats, reconnection strategies, session resumption tickets |
| 104 | |||
| 105 | |||
| |
16.1 | 106 | |
| |
15.1 | 107 | ==== **9. Content Addressing** ==== |
| 108 | |||
| 109 | > Content addressing ensures **immutability, verifiability, and deduplication**. Identity of data = cryptographic hash, enabling offline-first and tamper-evident systems. | ||
| 110 | |||
| |
16.1 | 111 | * //How is data addressed and verified by content, not location?// |
| |
15.1 | 112 | * Examples: IPFS CIDs, BitTorrent infohashes, Git hashes, SHA-256 addressing, Named Data Networking (NDN) |
| 113 | |||
| |
16.1 | 114 | |
| 115 | |||
| |
15.1 | 116 | ==== **10. P2P Connectivity** ==== |
| 117 | |||
| |
16.1 | 118 | > Connectivity ensures peers bypass NATs/firewalls to reach each other. |
| |
15.1 | 119 | |
| |
16.1 | 120 | * //How can two peers connect directly across networks, firewalls, and NATs?// |
| |
15.1 | 121 | * Examples: IPv6 direct, NAT Traversal, STUN, TURN, ICE (used in WebRTC), UDP hole punching, UPnP |
| 122 | |||
| |
16.1 | 123 | |
| 124 | |||
| |
15.1 | 125 | ==== **11. Session & Connection Management** ==== |
| 126 | |||
| 127 | > Manages **connection lifecycle**, including authentication handshakes, reconnection after drops, and session continuation. | ||
| 128 | |||
| |
16.1 | 129 | * //How are connections initiated, authenticated, resumed, and kept alive?// |
| |
15.1 | 130 | * Examples: TLS handshake semantics, Noise IK/XX patterns, session tokens, keep-alive heartbeats, reconnection strategies, session resumption tickets |
| 131 | |||
| |
16.1 | 132 | |
| 133 | |||
| |
15.1 | 134 | ==== **12. Message Format & Serialization** ==== |
| 135 | |||
| 136 | > Serialization ensures **portable data representation**, forward-compatible schemas, and efficient messaging. IPLD provides content-addressed structuring for P2P graph data. | ||
| 137 | |||
| |
16.1 | 138 | * //How is data encoded, structured, and made interoperable between peers?// |
| |
15.1 | 139 | * Examples: CBOR, Protocol Buffers, Cap’n Proto, JSON, ASN.1, IPLD schemas, Flatbuffers |
| 140 | |||
| |
16.1 | 141 | |
| 142 | |||
| |
15.1 | 143 | ==== **13. File / Blob Synchronization** ==== |
| 144 | |||
| 145 | > Bulk data syncing has **different trade-offs** than small collaborative state (chunking, deduplication, partial transfer, resume logic). Critical for media and archival P2P use-cases. | ||
| 146 | |||
| |
16.1 | 147 | //How are large objects transferred and deduplicated efficiently across peers?// |
| |
15.1 | 148 | Examples: BitTorrent chunking, IPFS block-store, NDN segments, rsync-style delta sync, ZFS send-receive, streaming blob transfers |
| 149 | |||
| |
16.1 | 150 | |
| |
15.1 | 151 | ==== **14. Local Storage & Processing Primitives** ==== |
| 152 | |||
| 153 | > Provides durable on-device state and local computation (event sourcing, materialization, compaction). Enables offline-first writes and deterministic replay. | ||
| 154 | |||
| |
16.1 | 155 | * //How do nodes persist, index, and process data locally—without external servers?// |
| |
15.1 | 156 | * Examples: RocksDB, LevelDB, SQLite, LMDB, local WALs/append-only logs, embedded stream processors (NATS Core JetStream mode, Actyx-like edge runtimes), Kafka-like libraries |
| 157 | |||
| 158 | |||
| |
16.1 | 159 | |
| |
15.1 | 160 | ==== **15. Crash Resilience & Abortability** ==== |
| 161 | |||
| 162 | > Ensures P2P apps don’t corrupt state on crashes. Tied to **local storage & stream-processing**, and critical in offline-first and distributed update pipelines. Abortability is the updated term for Atomicity as part of the ACID abbreviation. | ||
| 163 | |||
| |
16.1 | 164 | * //How do nodes recover and maintain correctness under failure?// |
| |
15.1 | 165 | * Examples: WALs, idempotent ops, partial log replay, transactional journaling, write fences |
| 166 | |||
| 167 | |||
| 168 | |||
| 169 | |||
| |
11.1 | 170 | == Distributed Network Types == |
| 171 | |||
| 172 | |||
| 173 | [[Flowchart depicting distributed network variants, under development. Building on work from Z. Elfen, 2024: ~[~[https:~~~~/~~~~/doi.org/10.17613/naj7d-6g984~>~>https://doi.org/10.17613/naj7d-6g984~]~]>>image:P4P_Typology.png||alt="Flowchart depicting typologies of distributed networks, such as Friend-2-Friend, Grassroots Networks, Federated Networks, Local-First, P2P and P4P Networks" data-xwiki-image-style-alignment="center" height="649" width="639"]] | ||
| 174 | |||
| 175 | |||
| |
24.1 | 176 | ))) |
| |
11.1 | 177 | |
| 178 | |||
| |
21.1 | 179 | (% class="col-xs-12 col-sm-4" %) |
| 180 | ((( | ||
| 181 | {{box title="==== Contents ==== | ||
| 182 | |||
| 183 | ====== ======"}} | ||
| 184 | {{toc depth="3"/}} | ||
| 185 | {{/box}} | ||
| 186 | |||
| |
24.1 | 187 | ))) |
| 188 | |||
| 189 | |||
| 190 | ((( | ||
| 191 | == Overview of P4P Networks == | ||
| |
22.1 | 192 | {{include reference="Projects.WebHome"/}} |
| 193 | ))) | ||
| 194 | |||
| |
23.1 | 195 |