README.md

---

🌐 Official Website

The full documentation for Kinetic has been moved to its own repository. You can find all protocol specifications, technical deep dives, and whitepapers there.

👉 Kinetic Documentation Hub

---

⚡ What is Kinetic?

Kinetic is a decentralized, zero-cost, sovereign namespace and identity engine written in Rust. It solves the domain naming problem without relying on centralized corporate registries (like ICANN) and without blockchains, gas fees, or speculative crypto tokens.

Instead of paying money to registrars, you pay with sequential computational time. By evaluating a Verifiable Delay Function (VDF) over imaginary quadratic class groups, your machine proves it expended un-parallelizable time to claim a name.

• 💎 Zero Cost: Domain registrations require exactly $0.00.
• 🛡️ Squatter-Resistant: Short names scale on a steep mathematical "Squatter Cliff" (a 2-char domain requires 30 days of CPU squarings; 21–63 char domains take 30 minutes). Mass domain squatting and bot sniper farms are physically impossible.
• 🔐 Post-Quantum Ownership: Names are cryptographically bound to an ML-DSA-65 (FIPS 204) quantum-resistant identity key.
• 🌍 Native Split-DNS Interception: Integrates transparently into your OS network stack, resolving .kin names natively in any Web2 browser while passing standard internet queries through unaffected.

---

🏗️ Architecture & How It Works

Kinetic acts as a local, transparent Split-DNS gateway running on port 53:

1. Query Interception: When you type alice.kin into Firefox, Chrome, or curl, the OS resolver sends the request to the Kinetic Daemon listening on 127.0.0.2:53.
2. DHT Lookup: The daemon checks its local Kademlia DHT routing table (libp2p) to resolve the zone payload signed by Alice's post-quantum key.
3. Transparent Passthrough: Standard internet queries (e.g. google.com or github.com) are immediately forwarded to your upstream OS resolver without latency overhead.

---

🌐 Quick Start — Use the .kin Network

The .kin network is the canonical public commons running on the Kinetic engine.

📥 1. Install via One-Line Script

Linux & macOS:

curl -sSL https://kinetic.saifmukhtar.dev/install.sh | bash

Windows (PowerShell as Admin):

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

irm https://kinetic.saifmukhtar.dev/install.ps1 | iex

---

🔑 2. Initialize Your Post-Quantum Identity

Generate your 24-word master seed phrase and post-quantum keys:

kinetic seed init

---

📝 3. Claim Your .kin Name

Compute the un-parallelizable VDF proof and publish your name to the global P2P network:

kinetic name register mywebsite.kin

Once the VDF proof completes, publish the zone record:

kinetic name publish mywebsite.kin

You can now visit mywebsite.kin natively in your browser or host services on it!

🖥️ Prefer a Graphical GUI? Try the cross-platform desktop application at saifmukhtar/kinetic-client.

---

🍴 Deploy Your Own Sovereign Network (kinetic-forge)

Kinetic is designed from the ground up to be fully engine-swappable and engine-forkable. Any university, enterprise, government, or private community can deploy their own independent, cryptographically isolated namespace (e.g., .uni, .corp, .dev) in minutes.

Using the interactive kinetic-forge wizard:

cargo run --release --bin kinetic-forge

1. Configure Network Constants: Define custom TLDs, bootstrap nodes, and target VDF delay parameters in network.json.
2. Compile Engine: Constants are compiled directly into the binary suite via build.rs for maximum performance and zero config drift.
3. Governance: Maintain sovereign governance keys with emergency timelocks and 69% maintenance council ratifications.

📖 Read the Complete Engine Forking & Custom Network Guide

---

💻 Building from Source

Kinetic requires Rust 1.80+ and C++ build tools for the chiavdf FFI engine.

📦 Prerequisites

Ubuntu / Debian:

sudo apt update && sudo apt install -y build-essential cmake libgmp-dev

macOS (Homebrew):

brew install cmake gmp

🔨 Compilation

git clone https://github.com/saifmukhtar/kinetic.git

cd kinetic

cargo build --release --workspace

⚠️ CRITICAL: Always compile with --release. Debug builds lack compiler SIMD/LTO optimizations, making VDF squarings unplayably slow.

---

🧪 50-Node Simulation Sandbox

The repository includes an autonomous multi-node simulation environment (kinetic-sim/) testing network resiliency, DHT lookup, VDF anti-squatting, and CDN web hosting failovers across 50 containerized nodes.

cd kinetic-sim

python3 setup_sim.py

./deploy.sh

Run the Python orchestrator:

sudo python3 orchestrator.py

Launch the real-time visual web dashboard:

cd kinetic-dashboard && npm install && npm run dev

---

📚 Complete Whitepapers & Specifications

Explore the mathematical proofs, RFC drafts, and security models powering Kinetic:

📜 Official Whitepapers (whitepaper/)

• 📄 1. Vision & Executive Summary: The case for sovereign time-secured namespaces.
• ⚡ 2. Consensus & Proof of Patience: Squatter Cliff mathematical proofs & VDF class group squarings.
• 🆔 3. Decentralized Identity Architecture (KID): Post-quantum ML-DSA-65 identity documents.
• 🌐 4. Network & Execution Spec: libp2p Kademlia DHT, gossip subtopics, and Split-DNS.
• 🛡️ 5. Security & Threat Mitigation: Formal resistance to Sybil, Eclipse, and Front-Running attacks.
• 🏛️ 6. Governance Engine: Council multisig rules and timelock emergency resets.
• 🔨 7. Kinetic Engine Forking (kinetic-forge): Custom TLD network deployment guide.

📜 IETF Internet-Draft Specifications

• 📑 draft-mukhtar-kinetic-network-00: The Kinetic Network Protocol Specification.
• 📑 draft-mukhtar-kinetic-identity-00: The Kinetic Identity (KID) Specification.

---

🏛️ Technical Specifications & Repository Guides (.github/)

• 🏗️ ARCHITECTURE.md: Deep-dive workspace topology, binary boundaries, and trait abstractions.
• ⚙️ CONFIG.md: Comprehensive configuration guide for daemon, P2P networking, and Drand settings.
• 🔐 CRYPTO.md: Cryptographic primitive choices (Ed25519, ML-DSA-65, Chia VDF, Drand).
• 🛡️ THREAT_MODEL.md: Adversarial threat vectors, security boundaries, and non-goals.
• 🏛️ GOVERNANCE.md: Maintenance council supermajority, Council keys, and emergency procedure.
• 🤝 CONTRIBUTING.md: Contribution guidelines, commit rules, and PR checklist.
• 🔒 SECURITY.md: Responsible disclosure policy and security contacts.
• 📜 CODE_OF_CONDUCT.md: Community engagement standards.

---

🛠️ Open-Source Foundation & Acknowledgments

Kinetic is built upon world-class open-source infrastructure:

• 🦀 rust-libp2p: Peer-to-peer networking, Kademlia DHT, Gossipsub, and NAT traversal.
• 🧮 chiavdf: High-speed Class Group VDF repeated squarings engine.
• 🎲 drand: Ungameable threshold randomness beacon for VDF commitment challenges.
• ⚡ hickory-dns: Sovereign Split-DNS server interception framework.
• 🔑 ml-dsa: FIPS 204 post-quantum digital signature algorithms.
• 💾 sled: Embedded pure-Rust high-concurrency database.
• 🚀 axum: Modern async web framework powering local daemon REST APIs.

---