← hub.rift.pw
comprehensive guide

The Rift
Overview

A technical and philosophical exploration of post-IP infrastructure.
chapter i

The Illusion of the Indestructible Web

Why The Rift Exists

The modern internet is a masterpiece of engineering, yet it is fundamentally built upon an illusion of permanence. We traverse it daily with the assumption that the "cloud" is an ethereal, omnipresent entity that will never dissipate. But the reality is far starker. The internet we know today is highly centralized, reliant on physical chokepoints, massive data centers, monopolistic ISPs, and fragile undersea cables.

When you send a message to the person sitting across the room from you over a standard messaging app, your data does not travel the few feet between you. Instead, it is routed through your local WiFi, to your ISP, across fiber optic cables to a server farm potentially thousands of miles away, processed by a corporate algorithm, and then beamed all the way back to the device inches from your own. This is not resilience. This is extreme, precarious dependency.

This dependency makes our civilization vulnerable. A natural disaster—a hurricane taking down the power grid and cell towers in a major city—plunges millions into instantaneous digital darkness. A government decree can sever access to the global network for an entire nation. A simple, cascading BGP misconfiguration by a telecom giant can knock vast swaths of the global economy offline for hours.

The Rift was engineered to answer a singular question: How do we build a global, decentralized society that continues to function perfectly when the internet is entirely destroyed?

The Rift is an encrypted, universally adaptable mesh network. It operates independently of the traditional Internet Protocol (IP) suite, meaning it does not rely on IP addresses, centralized DNS servers, or conventional internet service providers. Instead, it utilizes any physical medium available to it. If the internet is online, The Rift treats it as merely one of many convenient transport tunnels. If the internet fails, The Rift effortlessly falls back to LoRa radios, WiFi Direct, Bluetooth, high-frequency (HF) shortwave radio, or even serial cables.

It is not just a backup communications tool. It is an entirely new, fully functioning ecosystem—complete with an un-censorable ledger economy settled on a feeless DAG, a distributed database that synchronizes state across continents without a central server, and a decentralized physical infrastructure network (DePIN) that allows individuals to share, lease, and utilize hardware compute and storage securely.

chapter ii

The Zen of The Rift

The Post-IP Doctrine

To understand The Rift, one must first understand its foundational philosophy. The traditional web operates on a client-server model: you (the client) petition a central authority (the server) for permission to speak, to read, to transact, or to exist. The server dictates the rules.

The Zen of The Rift flips this paradigm entirely. The foundational text of our ecosystem mandates that uncentralizability is not a feature added as an afterthought; it is a rigid, mathematical characteristic baked into the lowest levels of the code.

The Physics of Trust

In the legacy internet, trust is established by centralized Certificate Authorities (CAs). If a CA says a website is who it claims to be, your browser believes it. If that CA is compromised, or coerced by a state actor, that trust is shattered. In The Rift, trust is established through the immutable laws of cryptography. Every single node, every device, and every user is identified strictly by an Elliptic Curve cryptography keypair. You do not ask a third party if a message is authentic; the mathematics of the encryption prove it definitively.

Sovereignty Through Infrastructure

True freedom requires ownership of the infrastructure. The Rift is designed to run on consumer hardware—from powerful gaming PCs to low-power Raspberry Pis to $5 ESP32 microcontrollers. By distributing the network’s load across millions of peer-owned devices, The Rift ensures that no single entity can pull the plug. When you run a Rift Node, you are not a consumer; you are a sovereign operator of the network itself.

Bandwidth as an Ascetic Discipline

Modern software developers, spoiled by gigabit fiber connections, often build bloated applications that consume vast amounts of unnecessary data. The Rift assumes the worst. It assumes that you might be attempting to synchronize a database over a scratchy, 300-bits-per-second LoRa radio connection spanning twenty miles across a mountain range. Every packet is stripped to its absolute minimum. Scarcity is respected, and efficiency is paramount. By designing for the harshest possible constraints, The Rift achieves unparalleled resilience.

chapter iii

The Reticulum Network Stack

The Cryptographic Engine

If The Rift is the body, Reticulum is the central nervous system. Reticulum is a cryptography-based networking stack designed for mesh networks and wide-area networks over disparate hardware. It entirely replaces the TCP/IP suite for internal mesh communications.

Cryptographic Identity and Destinations

In a standard network, your device is assigned an IP address. This address changes as you move between WiFi networks, and it reveals your general location to anyone monitoring the traffic. Reticulum abandons IP addresses completely.

Instead, every entity on the network is identified by a Destination Hash. This is a 16-byte identifier derived directly from a Curve25519 public key. Your identity is mathematically tied to your encryption keys. Because there are no IP addresses, there is no centralized registry to ban or block you. Your Destination Hash is portable; it travels with you whether you are connected via Ethernet in a high-rise office or via a handheld radio in a desert.

The Announce Protocol

Because there is no central server routing traffic, nodes must figure out how to find each other. They achieve this through Announces. When a node wishes to be reachable, it broadcasts a tiny cryptographic packet—an Announce—across all of its physical interfaces. This packet contains the node's public key and its Destination Hash.

As this Announce ripples outward through the mesh, bouncing from node to node, each intermediary node records the path it took. When someone on the far side of the network wants to send you a message, their node looks at its routing table, sees the path your Announce left behind, and forwards the encrypted packet along that exact trajectory. The beauty of this system is that intermediary routing nodes never know who sent the original message, nor what it contains. They only know the next physical hop to pass the packet to.

Perfect Forward Secrecy (PFS)

Security in The Rift is uncompromising. Every single piece of data transmitted over the mesh is subjected to authenticated encryption (AES-256 or XChaCha20). There is no "unencrypted" mode.

When two nodes wish to exchange continuous or sensitive data, they establish a Link. This process utilizes an Elliptic-Curve Diffie-Hellman (ECDH) key exchange to negotiate an ephemeral session key. This ensures Perfect Forward Secrecy. Even if an adversary were to record all of your encrypted radio transmissions for a year, and then somehow managed to steal your device and extract your private master key, they still could not decrypt the historical traffic. The ephemeral session keys are destroyed the moment the Link is closed, rendering past communications permanently undecipherable.

chapter iv

The DePIN Infrastructure

Physical Hardware in a Decentralized World

Software is meaningless without the hardware to run it. The Rift is a Decentralized Physical Infrastructure Network (DePIN). This means that the physical hardware required to run the network—the antennas, the processors, the hard drives, the internet connections—is owned entirely by the participants. No corporation owns the towers. You own the towers.

The Hardware Hierarchy

The mesh accommodates hardware of all shapes, sizes, and capabilities. Every node runs the same foundational Rift node software (the reference Citadel implementation is Python on Reticulum — the language is incidental; the sovereignty is not), but its role in the ecosystem is dictated by physical capacity and earned reputation.

Transport Agnosticism

The Rift does not care how a packet moves from Point A to Point B. The daemon includes a sophisticated Interface Manager that auto-detects physical hardware. It ranks links by bandwidth: 10 Gigabit Ethernet is preferred over WiFi, WiFi is preferred over LoRa radio, and LoRa radio is preferred over High-Frequency (HF) shortwave. If an earthquake severs the fiber-optic cables leading to a Citadel, the network does not crash; it instantly, mathematically recalculates routes and begins pushing critical traffic over the slower, but indestructible, LoRa and HF radio links.

chapter v

The ADIC Ledger & Economy

Incentivizing the Infrastructure

A network cannot survive on altruism alone. It costs money to buy antennas, pay for electricity, and maintain servers. To incentivize operators to build out the physical mesh, The Rift employs a deeply integrated, sovereign deployment of the ADIC-DAG protocol: the Rift ADIC ledger. There are no blocks, no miners, and no validators — transactions are feeless messages appended to a reputation-weighted DAG, with finality your own node can compute locally.

Unlike blockchains focused on speculation, the ADIC ledger is pure utility. It exists solely to manage the logistics, governance, and payment settlement of the DePIN ecosystem. Its native token is ADIC, and every DePIN activity settles as Proof-of-Useful-Work — the ledger pays for routing, storage, compute, coverage, and mapping (Rift Atlas bounties), not for burning electricity. (Operators who prefer fiat can layer optional Stripe billing on top; the mesh itself settles in ADIC.)

The Haulage Economy and Watts

How do you compensate someone for letting your data bounce off their antenna? The Rift introduces the concept of Watts. One Watt represents the transmission of 1 Kilobyte of data over 1 network hop. When a packet travels across the mesh, the protocol calculates the "cost" based on the bandwidth, latency, and distance traveled. Users pay ADIC to consume network resources, and the intermediary nodes that route the packets earn that ADIC as a reward.

Because the network often operates offline, it cannot rely on constant ledger connectivity. Instead, the daemon employs Bilateral Settlement Receipts. When Node A sends data to Node B, both nodes cryptographically sign a receipt verifying the transfer. These receipts are stored locally on the devices. When one of those devices eventually touches a node with reach to the ADIC ledger, the receipts are batched and submitted in bulk, and the ADIC is officially transferred. This allows the economy to function flawlessly even deep in the wilderness.

The PID Market Oracle

Fixed pricing leads to economic failure in dynamic environments. If network traffic surges during an emergency, fixed prices might lead to network saturation and collapse. The Rift utilizes a PID Controller Market Oracle. This is an algorithmic central bank that adjusts the price of ADIC in real-time based on physics. If network utilization spikes, the Oracle increases the cost of bandwidth to throttle non-essential traffic and incentivize more operators to turn on their nodes. If the network is idle, the price drops to encourage usage. This ensures the physical mesh remains economically balanced and technically stable under any load.

chapter vi

RiftDB: The Memory of the Mesh

Eventual Consistency Without the Cloud

If you have no centralized cloud servers, how do you maintain a shared global state? How do users know who owns a specific `.rift` domain name? How do applications save data?

The answer is RiftDB. Embedded directly into every Rift node is a localized instance of SQLite. Whenever a user takes an action—updating their profile, claiming a resource, or sending a telemetry ping—it is written to their local database instantly. The system is "local-first." It operates at the speed of your own hard drive.

Conflict-Free Replicated Data Types (CRDTs)

To synchronize these isolated local databases across the globe, RiftDB uses CRDTs. Every piece of data is tagged with a vector clock (a timestamp). When your node connects to another node, they compare databases. If there is a conflict—say, two users tried to update the same record while offline—the CRDT algorithm uses a mathematical Last-Writer-Wins (LWW) resolution to merge the changes. This allows the databases to mathematically converge to identical states without ever needing a central coordinator to arbitrate the truth.

Bloom Filters for Extreme Scarcity

Synchronizing databases over high-speed internet is trivial. Synchronizing databases over a 300-bits-per-second radio link during a grid collapse is an engineering nightmare.

To solve this, RiftDB uses highly compressed Bloom Filters. Instead of sending the entire database to a peer to see what has changed, a node generates a tiny, probabilistic mathematical summary of its database—often just a few kilobytes in size. It sends this tiny Bloom Filter over the radio link. The receiving node compares the filter against its own records, instantly identifying the exact, specific rows of data that the sender is missing. It then transmits only those specific deltas. This differential sync process allows massive global databases to remain synchronized over the weakest, lowest-bandwidth physical links imaginable.

Data propagates like a virus. Node A syncs with Node B. Node B walks across town and syncs with Node C, D, and E. Within hours, a state change made on an isolated mountain peak can ripple across the entire global mesh, ensuring the memory of the mesh is never lost.

chapter vii

The Rift Vault

Decentralized, Sharded Storage

Beyond simple text messages and database states, a functional society needs to store files—images, software binaries, maps, and documents. The Rift handles this through the Rift Vault, a decentralized, mesh-native global filesystem—concretized as RiftFS, the content-addressed store of the Rift Fabric. The design goal is IPFS's virtues with none of its internet organs: no global DHT, no public gateways, and encryption by default—storers hold only ciphertext noise.

Erasure Coding and Sharding

When you upload a file to the Rift Vault, it is not simply stored on a single hard drive. The file is heavily encrypted and then mathematically sliced into multiple fragments using Erasure Coding (e.g., 4 data shards + 2 parity shards). These shards are then scattered across the mesh, pinned to various Citadels and Edge Nodes.

Because of the parity shards, the original file can be perfectly reconstructed even if a significant percentage of the nodes holding the shards are destroyed or go offline. You, as the owner, hold the cryptographic keys required to reassemble and decrypt the data. To the nodes storing your shards, the data is just meaningless encrypted noise.

Bandwidth Gating (RFPPull)

Moving large files across a mesh network is dangerous; it can easily saturate the bandwidth of slower radio links, preventing critical telemetry from getting through. To mitigate this, The Rift employs strict Bandwidth Gating.

When a node requests a file (via an RFPPull request), the protocol checks the speed of the physical interface. If the request comes over a low-speed LoRa link (under 50 kbps), the transfer is explicitly denied or heavily throttled. The node must wait until it comes within range of a higher-speed interface (like WiFi HaLow or Ethernet) before the multi-megabyte stream is initiated. This ensures the primary radio mesh remains clear for high-priority life-and-death communication.

chapter viii

The Compute Layer

Permissionless Code Execution via WASM

A true post-IP infrastructure must be able to run complex software without relying on centralized corporate clouds like AWS or Google Cloud. The Rift achieves this through its native Compute Layer, powered by WebAssembly (WASM).

The Wasmtime Sandbox

Embedded inside the Rift node runtime is a highly secure WASM sandbox (using Wasmtime). Developers can write applications in Rust, C++, or any language that compiles to WebAssembly. They can then deploy these applications directly into the mesh.

When a node runs a WASM app, the app is trapped inside a strict sandbox. It has no direct access to the host computer's file system or memory. It is given a strict "fuel" limit (e.g., 1,000,000 computation cycles) to ensure that malicious or buggy code cannot freeze the host machine. If it runs out of fuel, the execution is cleanly terminated.

The Hosting Marketplace

Through the ADIC ledger's PoUW hosting market, users can rent out their idle CPU and GPU power. If you have a powerful gaming PC sitting idle, you can lease its compute power to the mesh. Developers can pay ADIC to deploy their WASM applications or AI Inference models (like Stable Diffusion or LLMs) directly onto your hardware. Because everything is handled through PoUW Hook escrow on the ADIC ledger, you don't need to trust the developer, and the developer doesn't need to trust you. The code runs, the proofs are generated, and the ADIC is transferred automatically.

Storage and compute are two faces of a larger whole. The architecture that binds them—and every other resource class—into one substrate is the Rift Fabric.

chapter ix

The Rift Fabric

One Substrate, Zero Internet Organs

The execution substrates the world already builds—cloud runtimes, container registries, object stores, AI inference farms—all assume the internet stack: DNS for discovery, HTTP and gRPC for control, TLS for trust, registries pulled over HTTPS. The Rift's answer is the Rift Fabric: compute, storage, virtual machines, sandboxes, GPU, and distributed AI in which every node-to-node interaction—discovery, addressing, control, streaming, bulk transfer, distribution, and settlement—happens over Reticulum primitives alone. No HTTP, no gRPC, no DNS, no IP addresses, no internet registries appear anywhere in its protocols.

The clarifying observation: a CPU, a GPU, a hypervisor, or an inference kernel is local hardware—it has no networking opinion. Everything internet-coupled lives in the ring around it: discovery, addressing, control, transfer, registries, auth. The Fabric replaces that ring with Reticulum and leaves the local core untouched. We do not rewrite WASM or CUDA; we sever them from IP.

The Five Planes

rngit: The Proven Model and the Distribution Spine

This pattern is not speculative—it already works. rngit serves entire Git repositories over pure Reticulum: services found by announce, hash addressing instead of DNS, per-identity default-deny ACLs, and Ed25519-signed releases that clients verify before a single byte executes. The Fabric is rngit generalized from source code to every resource class—and rngit remains the only channel by which software reaches a node: signed releases over the mesh, never an HTTPS pull. Every running byte traces to a signed release.

Audit Once, One Command, Then Autonomic

The operator experience is deliberately minimal. At install, the node audits its own hardware. The operator runs rift fabric share—choosing how much to offer—and that is the last required human act. From there the network handles offers, reputation-weighted leasing, execution, proofs of retrievability, receipts, and ADIC settlement autonomically: zero per-job prompts, no claiming ceremony. And the Fabric hosts everything: Atlas tiles, the wallet, applications, even ledger peers run as Fabric tenants. The Rift hosts The Rift on the Fabric.

chapter x

The Anatomy of Disaster Resilience

When the Center Does Not Hold

To truly comprehend the value of The Rift, one must examine how it performs when the centralized infrastructure of the modern world catastrophically fails. Consider a Category 5 hurricane that makes landfall on a major coastal city. Power grids fail. Fiber optic cables are severed. Cell phone towers are either destroyed by wind or their backup batteries deplete within 48 hours. Millions of people are plunged into a communications blackout.

The Instantaneous Fallback

In a standard internet paradigm, communication simply ceases. In The Rift, the network adapts instantly. Because Reticulum does not rely on static routing tables or IP addresses, the destruction of the central nodes merely forces the mesh to find new paths. As the fiber lines go dark, the Rift Nodes operating on battery-powered laptops and smartphones automatically fail over to their secondary interfaces: WiFi Direct, Bluetooth, and LoRa radios.

A neighborhood cut off from the world can still communicate internally. Citizens can share localized resource maps, coordinate rescue efforts, and distribute medical requests. Because RiftDB uses CRDTs, a doctor updating a triage list on a tablet at a local shelter will have that data synchronized seamlessly to every other tablet in the vicinity, creating a unified, resilient local state without a single functioning cell tower.

Bridging the Gap

But local communication is not enough; the isolated city must reach the outside world. This is where the diverse hardware topology of The Rift shines. Within the city, low-power LoRa radios can bridge gaps of 5 to 15 kilometers, hopping from rooftop to rooftop until they find a path out of the disaster zone.

If the destruction is too vast, the mesh relies on Rift Beacons. These are nodes equipped with High-Frequency (HF) shortwave radios. HF radio signals bounce off the ionosphere, allowing them to travel hundreds or thousands of miles over the horizon. A single Rift Beacon operating on a car battery in the blackout zone can connect to a Citadel in another state entirely. While the bandwidth of HF is extremely low, The Rift's protocol is so efficient that it can trickle critical text messages, database deltas, and cryptographic proofs out of the disaster zone, providing a vital lifeline when all other infrastructure is dead.

Censorship and Autonomy

Disasters are not always natural; sometimes they are political. When a hostile government enacts an internet blackout to suppress its citizens, The Rift functions as an un-killable subterranean network. Because it encrypts everything, hides routing metadata, and uses invisible transport layers like Bluetooth and localized WiFi, authorities cannot easily detect, let alone sever, the communications. It is an infrastructure built to ensure that human autonomy outlives the systems trying to control it.

chapter xi

The Fabric of the Independent

We have lived for decades inside an architecture of dependency. We have allowed our memories, our communications, and our economies to be held hostage by centralized servers and fragile cables.

The Rift is the antidote to this dependency. It is a complete societal substrate, built from the ground up to survive the collapse of the old world. It is the realization that true sovereignty requires owning the infrastructure you rely upon.

And Earth is not the only thing that will be mapped. The Rift is built for a future of mapped interiors, cities, oceans, Moon and Mars — one sovereign spatial fabric, the Rift Atlas, for every world humans touch: alive without the internet, honest across light-delay. The mesh connects worlds. The Atlas remembers their shape. The ADIC ledger settles what mapping is worth.

The blueprints are drawn. The daemon is running. The tangle is weaving. The mesh is alive.

There is no cloud.
There is no master.
There is only The Rift.