v2.7 Protocol Active

Decentralized Mesh.
Unbreakable Privacy.

Aegis is natively a pure, peer-to-peer cryptographic network. Coupled with the Aegis Cloud Relay, it effortlessly punches through firewalls to create a seamless, indestructible communication mesh.

True Decentralization

Building a Native P2P Mesh

Without strict firewalls, Aegis nodes naturally form a pure, serverless mesh network. They use a gossip protocol to continually share peer lists. Click through the steps below to see how nodes auto-discover each other.

ðŸ‘Đ‍ðŸ’ŧ
Alice's Node
ðŸ‘Ļ‍ðŸ’ŧ
Bob's Node
🧑‍ðŸ’ŧ
Charlie's Node
ðŸ•ĩïļ
Dave's Node

Alice is online. Her node is actively listening, but no peers are connected yet.

The Connection Problem

How Aegis Bypasses Firewalls

Native P2P is flawless until it encounters a strict home router. Here is how the Cloud Relay solves the modern internet's strict NAT configurations.

ðŸĪ

1. Local Connectivity

By default, Aegis looks for an open route. If Alice and Bob are on the same local network, or have open routers (UPnP enabled), their nodes will connect directly to each other with zero middlemen required.

ðŸ§ą

2. The Firewall Barrier

However, most home and mobile networks use strict NAT firewalls. If Alice and Bob are both at home behind strict firewalls, their routers will block incoming direct connections, isolating them from the mesh.

☁ïļ

3. The Optional Cloud Relay

To fix this, users can optionally connect to an Aegis Cloud Relay. Because the Relay is hosted on a public server (like AWS) with no firewalls, Alice and Bob can both easily connect to it, allowing it to seamlessly bridge their connection.

Adding the Public AWS Relay

To preserve total decentralization, the Aegis Cloud Relay is not built-in to the application by default. If you are having trouble connecting to friends, follow these steps to manually add our public, 24/7 AWS Relay node to your mesh.

1

Open your Aegis Desktop Application.

2

In the top right navigation bar, click the "Peers" status button (e.g., "0 Peers").

3

Paste the following IP address into the "Manual Override" input box:

http://3.16.213.66:8080
4

Click "Connect". Your node will now use the AWS relay to automatically punch through your firewall and sync with the global mesh!

Bypassing Firewalls

Cloud Relay Topology

If Alice and Bob are both behind firewalls, they can use the Relay as a secure middleman. Click to visualize the data flow.

ðŸ‘Đ‍ðŸ’ŧ
Aegis Client
(Alice)
☁ïļ
AWS Relay
3.16.213.66
ðŸ‘Ļ‍ðŸ’ŧ
Aegis Client
(Bob)

Under the Hood: The Components

Project Aegis consists of two separate binaries programmed in Go.

ðŸ’ŧ Aegis Node (Client)

The `main.go` file. This is the desktop/local application run by the end user. It contains the entire UI, cryptographic keychains, and local database.

  • ED25519 Identity Users generate a Master Password locally. This derives an AES-GCM key that encrypts their ED25519 private keys before saving to disk.
  • Hybrid Logical Clocks (HLC) Ensures CRDT-style exact chronological ordering of messages across decentralized devices, regardless of latency.
  • WebRTC Intercept Voice and Video call SDP/ICE candidates are wrapped securely into JSON payloads and routed through the mesh network to establish direct connections.

☁ïļ Aegis Cloud Relay

The `main2.go` file. A headless (no UI) propagator installed on cloud servers like AWS or DigitalOcean. It bridges incompatible peers.

  • Cryptographic Gatekeeper To prevent spam, the relay recalculates the SHA256 root hash and verifies the ED25519 signature of every message before accepting it into AWS RAM.
  • Garbage Collection & LRU Runs a background thread every hour. Automatically deletes messages older than 7 days, and evicts oldest files if the disk quota (e.g., 20GB) is reached.
  • DDoS Rate Limiting Tracks IPs natively via Mutex-locked maps. Drops requests instantly if an IP pushes more than 20 packets every 5 seconds.
Decentralized Governance

Moderation Without Servers

The "True Ban" (v2.7 Fix)

Because anyone can sync a P2P ledger, booting a user requires cryptographic enforcement. When an Admin issues a `PLATFORM_BAN`, two things happen:

  1. The Relay & Clients add the bad actor's Hash to a blacklist.
  2. Permanent Local Firewall: The banned user's own node intercepts the Ban packet targeting their Hash. It forcefully deletes their local platform copy and appends the platform ID to a `BannedFrom` array in their `identity.json`, physically preventing their own node from re-joining via Discover loops.
ðŸ‘ŧ

Shadow Bans

A classic community management tool, adapted for decentralized CRDTs. When an admin issues a `PLATFORM_SHADOW_BAN`, the target's Root Hash is flagged. The target can still push messages to the network, and their own node shows the messages as "Sent". However, every other client node silently drops the packets upon arrival, rendering the spammer invisible without them realizing it.

ðŸŠĶ

Message Tombstones

Since there is no central database to "delete" a message from, admins broadcast a `TOMBSTONE` packet referencing a Message ID. When peers receive it, their nodes overwrite the local database entry's text and files, marking it as "[Purged by Powernode]".