Skip to content

FreeFlow is a protocol and system for creating resilient, anonymous, and censorship-resistant communication networks using mobile and portable devices. It works without internet access, without centralized servers, and thrives in environments with poor or no connectivity.

License

Notifications You must be signed in to change notification settings

ermoluk/FreeFlow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

36 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

πŸŒ€ FreeFlow

Decentralized, Offline-Resilient Mesh Networking with Built-In Incentives


🌍 Overview

FreeFlow is a protocol and system for creating resilient, anonymous, and censorship-resistant communication networks using mobile and portable devices.
It operates without internet access, without centralized servers, and thrives even in environments with weak or no connectivity.

At its core lies the economic layer PoCCA (Proof-of-Contact Credit Architecture) β€” a mechanism that rewards devices for participating in the network by connecting, relaying, and storing data, allowing FreeFlow to expand organically.


🎯 Project Goals

  • Enable device-to-device communication during internet shutdowns or censorship.
  • Use Bluetooth, Wi-Fi Direct, and local radio protocols to build mesh clusters.
  • Implement store-and-forward propagation for disconnected regions.
  • Ensure privacy and anonymity through cryptographic identities and onion routing.
  • Reward participation using decentralized credits (not blockchain-dependent).

🧩 Core Concepts

πŸ”Ή Mesh Clusters

Local networks formed between nearby devices using short-range radio. Devices exchange identity, presence, and routing hints.

πŸ”Ή Bridge Nodes

Devices that link separate clusters β€” physically (couriers, drones) or via long-range radio β€” enabling data transfer between isolated zones.

πŸ”Ή Partial Routing

Nodes do not know the global topology. Instead, they maintain a small list of known clusters and use probabilistic or shortest-path routing based on available data.

πŸ”Ή Store-and-Forward

If no route exists to the destination, data is encrypted and stored locally, then forwarded once a valid path appears.


πŸ’  PoCCA β€” Proof-of-Contact Credit Architecture

An incentive model that generates cryptographic proofs of network activity and rewards useful behavior.

  • Proof of Contact (PoC): Two devices connect and exchange signed contact logs for credit.
  • Proof of Relay (PoR): Relay nodes sign the packet path and earn credit.
  • Proof of Store (PoS): Nodes that store data offline and later deliver it also gain credit.

Each node maintains a local ledger of its actions, which synchronizes and verifies when connecting to a wider mesh. Credits can be used for priority transmission, service access, or peer exchange.


πŸ“‘ Addressing Format

ClusterID:NodeID.SessionID

Example:

A3xh:g7h6.bbqh

ClusterID β€” short hash of the cluster’s public key.
NodeID β€” short hash of the node’s public key.
SessionID β€” one-time identifier for each session or packet.


πŸ” Security & Privacy

  • All messages are signed using Ed25519 keys.
  • Onion routing hides the complete route and encrypts each hop.
  • Session IDs prevent replay attacks and spoofing.
  • Trust is built using locally signed logs and PoCCA proofs.

πŸ“¦ Packet Example

{
  "from": "A3xh:g7h6",
  "to": "Jk92:kf45",
  "session": "bbqh",
  "type": "onion",
  "payload": "encrypted_blob",
  "signature": "sig_by_private_key",
  "hops_left": 5
}

πŸ‘₯ Needed Roles

  • Python developers
  • Rust developers
  • Kotlin / Android developers
  • Swift / iOS developers
  • Cryptography & Protocol Engineers
  • Distributed Systems Researchers
  • C / C++ developers (ESP32 & embedded runtime)

πŸš€ Why FreeFlow Matters

When the internet is blocked, shut down, or unavailable, people still need to communicate. FreeFlow allows individuals to stay connected, share information, and remain free.

Communication must be decentralized, anonymous, and unstoppable.

Β© 2025 – ermoluk

About

FreeFlow is a protocol and system for creating resilient, anonymous, and censorship-resistant communication networks using mobile and portable devices. It works without internet access, without centralized servers, and thrives in environments with poor or no connectivity.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages