Skip to content

Home

Jump to bottom
Dmitry Olegovich Sorokin (@sorydima) edited this page Jun 9, 2025 · 1 revision

dVPN Wiki

Welcome to the official Wiki for dVPN by Katya Incorporated. This documentation provides comprehensive information on the decentralized Virtual Private Network (dVPN) system, including architecture, installation, usage, development contributions, integrations with Katya OS, SDK tools, and protocol documentation.

📖 Table of Contents

  1. Introduction
  2. Features
  3. Architecture Overview
  4. Installation Guide
  5. Running the dVPN Node
  6. Usage Guide
  7. Security and Privacy
  8. Integration with Katya OS
  9. Tokenomics for Node Operators
  10. API Reference
  11. SDK Documentation
  12. Protocol Whitepaper
  13. Contributing
  14. License
  15. Contacts and Support
  16. Additional Resources

🧩 Introduction

dVPN is a decentralized, peer-to-peer VPN solution aimed at ensuring maximum privacy, data sovereignty, and resilience against surveillance or censorship. Built with modern cryptographic practices and community-driven governance, dVPN is designed for use in both individual and enterprise-grade applications.

🚀 Features

  • Fully decentralized VPN network
  • Zero-knowledge privacy model
  • Onion-style multi-hop routing
  • Open-source and community-driven
  • Integrated token-based node incentivization
  • Anti-censorship and geo-unblocking capabilities

🏗 Architecture Overview

[Client Device] -> [Entry Node] -> [Relay Nodes]* -> [Exit Node] -> [Destination]
  • Entry Node: Accepts encrypted user traffic.
  • Relay Nodes: Optionally used for multiple hops to increase privacy.
  • Exit Node: Decrypts and forwards the request to the final destination.
  • Smart Contract Layer: Handles payments, reputation, and node registry.

🛠 Installation Guide

Prerequisites

  • Git
  • Node.js & npm or yarn
  • Docker (optional for quick deployment)

Clone the Repository

git clone https://github.com/Katya-Incorporated/dVPN.git
cd dVPN

Install Dependencies

npm install
# or
yarn install

▶️ Running the dVPN Node

Development Mode

npm run dev

Production Build

npm run build
npm start

🧪 Usage Guide

  1. Launch the dVPN GUI or CLI.
  2. Select the entry node and route preferences.
  3. Connect to the decentralized network.
  4. Browse anonymously and securely.

🔒 Security and Privacy

  • End-to-end encryption
  • Zero logs policy
  • Decentralized authentication and identity
  • Support for Tor and I2P routing (optional)

🧬 Integration with Katya OS

dVPN is natively integrated with Katya OS to provide:

  • One-click connection via system settings
  • Auto-routing through trusted dVPN nodes
  • Integration with Katya Identity for secure credential management
  • Seamless protection of system-wide traffic across all Katya-native apps

💸 Tokenomics for Node Operators

Node operators earn utility tokens for:

  • Uptime and stability
  • Bandwidth contributed
  • Latency and speed performance

Token rewards are distributed via a smart contract with transparent staking and withdrawal mechanisms. Operators must:

  • Register their node on-chain
  • Stake a minimum token amount for reputation
  • Follow network compliance policies (see GitHub docs)

🧰 API Reference

Authentication

POST /api/authenticate

Headers: Authorization: Bearer <token>
Body:

{
  "username": "user",
  "password": "password"
}

Node Status

GET /api/nodes/status

Returns JSON with real-time status of all nodes.

Route Configuration

POST /api/route/set

Body:

{
  "entry": "node1",
  "exit": "node3",
  "hops": ["node2"]
}

For more endpoints, refer to docs/api.md.

📦 SDK Documentation

The dVPN SDK enables developers to integrate dVPN functionality directly into applications.

SDK Installation

npm install @katya/dvpn-sdk

Basic Usage

import { connectVPN, disconnectVPN } from '@katya/dvpn-sdk';

await connectVPN({
  entry: 'node1',
  exit: 'node3',
  hops: ['node2'],
});

// later
await disconnectVPN();

SDK Features

  • Node discovery and connection
  • Session tracking
  • Token staking for app developers

📑 Protocol Whitepaper

The dVPN protocol defines:

  • Trustless Routing: No single node can decrypt the full payload.
  • On-chain Governance: Community decisions managed via DAO mechanisms.
  • Node Reputation: Weighted by historical performance, uptime, and feedback.
  • Privacy Guarantees: Zero-knowledge proofs for identity and usage.

The full whitepaper is available at: docs/whitepaper.md

🤝 Contributing

We welcome contributions! To contribute:

  1. Fork the repository
  2. Create a new branch
  3. Make your changes
  4. Submit a pull request

Please read our CONTRIBUTING.md for more info.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

📬 Contacts and Support

For inquiries, reach out via:

📚 Additional Resources

Thank you for supporting the decentralized internet. ✨

Clone this wiki locally