redundanet 2.0.0__tar.gz → 2.0.2__tar.gz

redundanet-2.0.2/PKG-INFO

@@ -0,0 +1,298 @@
+Metadata-Version: 2.1
+Name: redundanet
+Version: 2.0.2
+Summary: Distributed encrypted storage on a mesh VPN network
+Home-page: https://github.com/alessandrodefilippo/redundanet
+License: MIT
+Keywords: distributed-storage,vpn,encryption,mesh-network,tahoe-lafs
+Author: Alessandro De Filippo
+Author-email: alessandro@example.com
+Requires-Python: >=3.11,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: System :: Distributed Computing
+Classifier: Topic :: System :: Networking
+Requires-Dist: gitpython (>=3.1,<4.0)
+Requires-Dist: httpx (>=0.26,<0.27)
+Requires-Dist: jinja2 (>=3.1,<4.0)
+Requires-Dist: jsonschema (>=4.21,<5.0)
+Requires-Dist: psutil (>=5.9,<6.0)
+Requires-Dist: pydantic (>=2.5,<3.0)
+Requires-Dist: pydantic-settings (>=2.1,<3.0)
+Requires-Dist: python-gnupg (>=0.5,<0.6)
+Requires-Dist: pyyaml (>=6.0,<7.0)
+Requires-Dist: rich (>=13.7,<14.0)
+Requires-Dist: structlog (>=24.1,<25.0)
+Requires-Dist: typer[all] (>=0.12.0)
+Requires-Dist: watchdog (>=4.0,<5.0)
+Project-URL: Documentation, https://redundanet.readthedocs.io
+Project-URL: Repository, https://github.com/alessandrodefilippo/redundanet
+Description-Content-Type: text/markdown
+
+# RedundaNet - Distributed Encrypted Storage Network
+
+[![CI](https://github.com/adefilippo83/redundanet/actions/workflows/ci.yml/badge.svg)](https://github.com/adefilippo83/redundanet/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/redundanet)](https://pypi.org/project/redundanet/)
+[![License](https://img.shields.io/github/license/adefilippo83/redundanet)](LICENSE)
+
+RedundaNet is a distributed, encrypted storage system built on a secure mesh VPN network. It enables users to contribute storage resources to a collective grid while maintaining privacy through end-to-end encryption.
+
+**Website**: [https://redundanet.com](https://redundanet.com)
+
+## Features
+
+- **Decentralized Architecture**: No central authority or single point of failure
+- **End-to-End Encryption**: Data is encrypted before leaving your device using Tahoe-LAFS
+- **GPG-Based Authentication**: Secure node identity verification via public keyservers
+- **Private Networking**: Secure Tinc mesh VPN isolates the storage network
+- **Erasure Coding**: Data is split and distributed across multiple nodes (3-of-10 scheme)
+- **Open Membership**: Anyone can apply to join the network
+- **Containerized Deployment**: Easy setup with Docker Compose
+- **Raspberry Pi Ready**: Pre-built images for ARM devices
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         RedundaNet Network                              │
+│                                                                         │
+│    Your File                                                            │
+│        │                                                                │
+│        ▼                                                                │
+│   ┌─────────┐     Encrypted      ┌─────────┐                           │
+│   │ Encrypt │ ──────────────────►│  Split  │                           │
+│   │  (AES)  │                    │(Erasure)│                           │
+│   └─────────┘                    └────┬────┘                           │
+│                                       │                                 │
+│              ┌────────────────────────┼────────────────────────┐       │
+│              ▼            ▼           ▼           ▼            ▼       │
+│         ┌───────┐    ┌───────┐   ┌───────┐   ┌───────┐    ┌───────┐   │
+│         │Share 1│    │Share 2│   │Share 3│   │  ...  │    │Share10│   │
+│         └───┬───┘    └───┬───┘   └───┬───┘   └───┬───┘    └───┬───┘   │
+│             │            │           │           │            │        │
+│             ▼            ▼           ▼           ▼            ▼        │
+│         ┌───────┐    ┌───────┐   ┌───────┐   ┌───────┐    ┌───────┐   │
+│         │Node A │    │Node B │   │Node C │   │Node D │    │Node E │   │
+│         │ (VPN) │◄──►│ (VPN) │◄─►│ (VPN) │◄─►│ (VPN) │◄──►│ (VPN) │   │
+│         └───────┘    └───────┘   └───────┘   └───────┘    └───────┘   │
+│                                                                         │
+│         Only 3 of 10 shares needed to reconstruct your file            │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Key Concepts:**
+- **Your data is encrypted** on your device before upload - nodes cannot read your files
+- **Erasure coding** splits data across nodes - any 3 of 10 nodes can reconstruct your file
+- **Mesh VPN** connects all nodes securely - no central server required
+- **GPG keys** verify node identity - published to public keyservers
+
+## Join the Network
+
+Want to contribute storage and join RedundaNet? Here's how:
+
+### 1. Generate and Publish Your GPG Key
+
+```bash
+# Install the CLI
+pip install redundanet
+
+# Generate a GPG key for your node
+redundanet node keys generate --name my-node --email you@example.com
+
+# Publish your key to public keyservers
+redundanet node keys publish --key-id YOUR_KEY_ID
+```
+
+### 2. Submit Your Application
+
+Visit [redundanet.com/join.html](https://redundanet.com/join.html) and fill out the application form with:
+- Your GPG Key ID
+- Storage contribution (how much space you'll share)
+- Your region
+- Device type
+
+This creates a GitHub issue that's automatically processed.
+
+### 3. Wait for Approval
+
+A maintainer will review your application and merge the PR that adds your node to the network manifest.
+
+### 4. Set Up Your Node
+
+Once approved:
+
+```bash
+# Clone the repository
+git clone https://github.com/adefilippo83/redundanet.git
+cd redundanet
+
+# Initialize your node (use the name assigned to you)
+redundanet init --name node-XXXXXXXX
+
+# Sync the manifest
+redundanet sync
+
+# Start services
+docker compose up -d
+
+# Check status
+redundanet status
+```
+
+## Quick Start (Existing Network Members)
+
+### Prerequisites
+
+- Python 3.11+
+- Docker and Docker Compose
+- GPG (for key management)
+
+### Installation
+
+```bash
+pip install redundanet
+```
+
+### Start Services
+
+```bash
+# As a storage node (contributes storage)
+docker compose --profile storage up -d
+
+# As a client only (uses storage)
+docker compose --profile client up -d
+```
+
+### Upload and Download Files
+
+```bash
+# Upload a file
+redundanet storage upload /path/to/file.txt
+# Returns: URI:CHK:abc123...
+
+# Download a file
+redundanet storage download URI:CHK:abc123... /path/to/output.txt
+```
+
+## CLI Commands
+
+```
+redundanet --help
+
+Commands:
+  init        Initialize a new node
+  status      Show node and network status
+  sync        Sync manifest from repository
+  validate    Validate manifest file
+
+  node        Node management commands
+    list      List all nodes in the network
+    info      Show detailed node information
+    add       Add a new node to manifest
+    remove    Remove a node from manifest
+    keys      Manage GPG keys (generate, export, import, publish, fetch, list)
+
+  network     Network management
+    join      Join an existing network
+    leave     Leave the network
+    peers     Show connected peers
+    vpn       VPN management (start/stop/status)
+
+  storage     Storage management
+    status    Show storage status
+    mount     Mount Tahoe filesystem
+    unmount   Unmount filesystem
+    upload    Upload a file
+    download  Download a file
+```
+
+## Raspberry Pi
+
+Pre-built images are available for Raspberry Pi:
+
+1. Download from [GitHub Releases](https://github.com/adefilippo83/redundanet/releases)
+2. Flash to SD card using Raspberry Pi Imager
+3. Boot and SSH in: `ssh redundanet@redundanet.local` (password: `redundanet`)
+4. Run `redundanet init` to configure
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph "Your Device"
+        A[redundanet CLI] --> B[Tahoe Client]
+        B --> C[Tinc VPN]
+    end
+
+    subgraph "Network Nodes"
+        D[Tinc VPN] --> E[Tahoe Storage]
+        F[Tinc VPN] --> G[Tahoe Storage]
+        H[Tinc VPN] --> I[Tahoe Introducer]
+    end
+
+    C -->|Encrypted Mesh| D
+    C -->|Encrypted Mesh| F
+    C -->|Encrypted Mesh| H
+```
+
+**Components:**
+- **Tinc VPN**: Creates encrypted mesh network between all nodes
+- **Tahoe-LAFS**: Handles encryption, erasure coding, and distributed storage
+- **GPG**: Authenticates node identity via public keyservers
+- **Manifest**: YAML file in Git defining network configuration
+
+## Documentation
+
+- [Installation Guide](docs/installation.md)
+- [Quick Start Guide](docs/quickstart.md)
+- [Configuration Reference](docs/configuration.md)
+- [Architecture Overview](docs/architecture.md)
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/adefilippo83/redundanet.git
+cd redundanet
+
+# Install dependencies
+make install
+
+# Run tests
+make test
+
+# Run linting
+make lint
+
+# Run type checking
+make type-check
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`make test`) and linting (`make lint`)
+5. Commit your changes
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [Tahoe-LAFS](https://tahoe-lafs.org/) - Distributed storage system
+- [Tinc VPN](https://www.tinc-vpn.org/) - Mesh VPN daemon
+- [Typer](https://typer.tiangolo.com/) - CLI framework
+

redundanet-2.0.2/README.md

@@ -0,0 +1,258 @@
+# RedundaNet - Distributed Encrypted Storage Network
+
+[![CI](https://github.com/adefilippo83/redundanet/actions/workflows/ci.yml/badge.svg)](https://github.com/adefilippo83/redundanet/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/redundanet)](https://pypi.org/project/redundanet/)
+[![License](https://img.shields.io/github/license/adefilippo83/redundanet)](LICENSE)
+
+RedundaNet is a distributed, encrypted storage system built on a secure mesh VPN network. It enables users to contribute storage resources to a collective grid while maintaining privacy through end-to-end encryption.
+
+**Website**: [https://redundanet.com](https://redundanet.com)
+
+## Features
+
+- **Decentralized Architecture**: No central authority or single point of failure
+- **End-to-End Encryption**: Data is encrypted before leaving your device using Tahoe-LAFS
+- **GPG-Based Authentication**: Secure node identity verification via public keyservers
+- **Private Networking**: Secure Tinc mesh VPN isolates the storage network
+- **Erasure Coding**: Data is split and distributed across multiple nodes (3-of-10 scheme)
+- **Open Membership**: Anyone can apply to join the network
+- **Containerized Deployment**: Easy setup with Docker Compose
+- **Raspberry Pi Ready**: Pre-built images for ARM devices
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                         RedundaNet Network                              │
+│                                                                         │
+│    Your File                                                            │
+│        │                                                                │
+│        ▼                                                                │
+│   ┌─────────┐     Encrypted      ┌─────────┐                           │
+│   │ Encrypt │ ──────────────────►│  Split  │                           │
+│   │  (AES)  │                    │(Erasure)│                           │
+│   └─────────┘                    └────┬────┘                           │
+│                                       │                                 │
+│              ┌────────────────────────┼────────────────────────┐       │
+│              ▼            ▼           ▼           ▼            ▼       │
+│         ┌───────┐    ┌───────┐   ┌───────┐   ┌───────┐    ┌───────┐   │
+│         │Share 1│    │Share 2│   │Share 3│   │  ...  │    │Share10│   │
+│         └───┬───┘    └───┬───┘   └───┬───┘   └───┬───┘    └───┬───┘   │
+│             │            │           │           │            │        │
+│             ▼            ▼           ▼           ▼            ▼        │
+│         ┌───────┐    ┌───────┐   ┌───────┐   ┌───────┐    ┌───────┐   │
+│         │Node A │    │Node B │   │Node C │   │Node D │    │Node E │   │
+│         │ (VPN) │◄──►│ (VPN) │◄─►│ (VPN) │◄─►│ (VPN) │◄──►│ (VPN) │   │
+│         └───────┘    └───────┘   └───────┘   └───────┘    └───────┘   │
+│                                                                         │
+│         Only 3 of 10 shares needed to reconstruct your file            │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**Key Concepts:**
+- **Your data is encrypted** on your device before upload - nodes cannot read your files
+- **Erasure coding** splits data across nodes - any 3 of 10 nodes can reconstruct your file
+- **Mesh VPN** connects all nodes securely - no central server required
+- **GPG keys** verify node identity - published to public keyservers
+
+## Join the Network
+
+Want to contribute storage and join RedundaNet? Here's how:
+
+### 1. Generate and Publish Your GPG Key
+
+```bash
+# Install the CLI
+pip install redundanet
+
+# Generate a GPG key for your node
+redundanet node keys generate --name my-node --email you@example.com
+
+# Publish your key to public keyservers
+redundanet node keys publish --key-id YOUR_KEY_ID
+```
+
+### 2. Submit Your Application
+
+Visit [redundanet.com/join.html](https://redundanet.com/join.html) and fill out the application form with:
+- Your GPG Key ID
+- Storage contribution (how much space you'll share)
+- Your region
+- Device type
+
+This creates a GitHub issue that's automatically processed.
+
+### 3. Wait for Approval
+
+A maintainer will review your application and merge the PR that adds your node to the network manifest.
+
+### 4. Set Up Your Node
+
+Once approved:
+
+```bash
+# Clone the repository
+git clone https://github.com/adefilippo83/redundanet.git
+cd redundanet
+
+# Initialize your node (use the name assigned to you)
+redundanet init --name node-XXXXXXXX
+
+# Sync the manifest
+redundanet sync
+
+# Start services
+docker compose up -d
+
+# Check status
+redundanet status
+```
+
+## Quick Start (Existing Network Members)
+
+### Prerequisites
+
+- Python 3.11+
+- Docker and Docker Compose
+- GPG (for key management)
+
+### Installation
+
+```bash
+pip install redundanet
+```
+
+### Start Services
+
+```bash
+# As a storage node (contributes storage)
+docker compose --profile storage up -d
+
+# As a client only (uses storage)
+docker compose --profile client up -d
+```
+
+### Upload and Download Files
+
+```bash
+# Upload a file
+redundanet storage upload /path/to/file.txt
+# Returns: URI:CHK:abc123...
+
+# Download a file
+redundanet storage download URI:CHK:abc123... /path/to/output.txt
+```
+
+## CLI Commands
+
+```
+redundanet --help
+
+Commands:
+  init        Initialize a new node
+  status      Show node and network status
+  sync        Sync manifest from repository
+  validate    Validate manifest file
+
+  node        Node management commands
+    list      List all nodes in the network
+    info      Show detailed node information
+    add       Add a new node to manifest
+    remove    Remove a node from manifest
+    keys      Manage GPG keys (generate, export, import, publish, fetch, list)
+
+  network     Network management
+    join      Join an existing network
+    leave     Leave the network
+    peers     Show connected peers
+    vpn       VPN management (start/stop/status)
+
+  storage     Storage management
+    status    Show storage status
+    mount     Mount Tahoe filesystem
+    unmount   Unmount filesystem
+    upload    Upload a file
+    download  Download a file
+```
+
+## Raspberry Pi
+
+Pre-built images are available for Raspberry Pi:
+
+1. Download from [GitHub Releases](https://github.com/adefilippo83/redundanet/releases)
+2. Flash to SD card using Raspberry Pi Imager
+3. Boot and SSH in: `ssh redundanet@redundanet.local` (password: `redundanet`)
+4. Run `redundanet init` to configure
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph "Your Device"
+        A[redundanet CLI] --> B[Tahoe Client]
+        B --> C[Tinc VPN]
+    end
+
+    subgraph "Network Nodes"
+        D[Tinc VPN] --> E[Tahoe Storage]
+        F[Tinc VPN] --> G[Tahoe Storage]
+        H[Tinc VPN] --> I[Tahoe Introducer]
+    end
+
+    C -->|Encrypted Mesh| D
+    C -->|Encrypted Mesh| F
+    C -->|Encrypted Mesh| H
+```
+
+**Components:**
+- **Tinc VPN**: Creates encrypted mesh network between all nodes
+- **Tahoe-LAFS**: Handles encryption, erasure coding, and distributed storage
+- **GPG**: Authenticates node identity via public keyservers
+- **Manifest**: YAML file in Git defining network configuration
+
+## Documentation
+
+- [Installation Guide](docs/installation.md)
+- [Quick Start Guide](docs/quickstart.md)
+- [Configuration Reference](docs/configuration.md)
+- [Architecture Overview](docs/architecture.md)
+
+## Development
+
+```bash
+# Clone repository
+git clone https://github.com/adefilippo83/redundanet.git
+cd redundanet
+
+# Install dependencies
+make install
+
+# Run tests
+make test
+
+# Run linting
+make lint
+
+# Run type checking
+make type-check
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`make test`) and linting (`make lint`)
+5. Commit your changes
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [Tahoe-LAFS](https://tahoe-lafs.org/) - Distributed storage system
+- [Tinc VPN](https://www.tinc-vpn.org/) - Mesh VPN daemon
+- [Typer](https://typer.tiangolo.com/) - CLI framework

{redundanet-2.0.0 → redundanet-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "redundanet"
-version = "2.0.0"
+version = "2.0.2"
 description = "Distributed encrypted storage on a mesh VPN network"
 authors = ["Alessandro De Filippo <alessandro@example.com>"]
 license = "MIT"
@@ -29,7 +29,7 @@ redundanet = "redundanet.cli.main:app"
 
 [tool.poetry.dependencies]
 python = "^3.11"
-typer = {extras = ["all"], version = "^0.9.0"}
+typer = {extras = ["all"], version = ">=0.12.0"}
 pydantic = "^2.5"
 pydantic-settings = "^2.1"
 pyyaml = "^6.0"

{redundanet-2.0.0 → redundanet-2.0.2}/src/redundanet/auth/gpg.py

@@ -43,9 +43,9 @@ class GPGKeyInfo:
             fingerprint=key.get("fingerprint", ""),
             user_id=user_id,
             email=email,
-            created=key.get("date", None),
-            expires=key.get("expires", None),
-            trust=key.get("trust", None),
+            created=key.get("date"),
+            expires=key.get("expires"),
+            trust=key.get("trust"),
         )
 
 
@@ -107,7 +107,7 @@ class GPGManager:
 
         key = self._gpg.gen_key(input_data)
 
-        if not key.ok:
+        if not key.fingerprint:
             raise GPGError(f"Failed to generate GPG key: {key.status}")
 
         logger.info("GPG key generated", fingerprint=str(key))