Skip to content

Jitpomi/seyfr-archive

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

238 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Seyfr - Send Your Files Right

 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—   β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— 
 β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β•β•β•β•šβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•”β•β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—
 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β•šβ–ˆβ–ˆβ–ˆβ–ˆβ•”β• β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—  β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•”β•
 β•šβ•β•β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•    β•šβ–ˆβ–ˆβ•”β•  β–ˆβ–ˆβ•”β•β•β•  β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—
 β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•‘β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—   β–ˆβ–ˆβ•‘   β–ˆβ–ˆβ•‘     β–ˆβ–ˆβ•‘  β–ˆβ–ˆβ•‘
 β•šβ•β•β•β•β•β•β•β•šβ•β•β•β•β•β•β•   β•šβ•β•   β•šβ•β•     β•šβ•β•  β•šβ•β•

πŸ” Military-Grade P2P File Sharing

Built with Rust β€’ Powered by Iroh β€’ Secured by AES-256-GCM

Rust License Security

🌟 What is Seyfr?

Seyfr is a peer-to-peer file sharing application that enables secure, direct file transfers without central servers. Built with Rust and powered by Iroh's cutting-edge P2P technology.

✨ Key Features

πŸš€ Core Functionality

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  πŸ“ Files & Directories         β”‚
β”‚  πŸ”„ P2P Direct Transfer         β”‚
β”‚  πŸ’Ύ Persistent Storage          β”‚
β”‚  🌐 Cross-Platform Support      β”‚
β”‚  πŸ“Š Real-time Progress          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ” Security Features

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  πŸ›‘οΈ  AES-256-GCM Encryption    β”‚
β”‚  πŸ”‘ PBKDF2 Key Derivation       β”‚
β”‚  🎲 Secure Random Generation    β”‚
β”‚  ⚑ Streaming for Large Files   β”‚
β”‚  🚫 No Central Servers          β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🎯 User Experience

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Interactive │───▢│   Command   │───▢│  Progress   β”‚
β”‚     CLI     β”‚    β”‚    Line     β”‚    β”‚  Tracking   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚                  β”‚                  β”‚
       β–Ό                  β–Ό                  β–Ό
  Menu-driven      Automation         Real-time
   Interface        Support           Feedback

πŸ—οΈ Architecture Overview

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                        SEYFR ECOSYSTEM                     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                      β”‚
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β”‚           β”‚           β”‚
          β–Ό           β–Ό           β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ seyfr-core  β”‚ β”‚  seyfr-lib  β”‚ β”‚  seyfr-ui   β”‚
β”‚             β”‚ β”‚             β”‚ β”‚             β”‚
β”‚ β€’ CLI App   β”‚ β”‚ β€’ P2P Logic β”‚ β”‚ β€’ Web UI    β”‚
β”‚ β€’ Commands  β”‚ β”‚ β€’ Crypto    β”‚ β”‚ β€’ Desktop   β”‚
β”‚ β€’ Menu UI   β”‚ β”‚ β€’ Storage   β”‚ β”‚ β€’ Mobile    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚               β”‚               β”‚
       β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
                       β–Ό
              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
              β”‚    IROH     β”‚
              β”‚ P2P Network β”‚
              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“ Project Structure

seyfr/
β”œβ”€β”€ πŸ–₯️  seyfr-core/        # CLI application and main entry point
β”œβ”€β”€ πŸ“š seyfr-lib/         # Core file sharing library
β”œβ”€β”€ 🌐 seyfr-ui/          # Cross-platform user interface
β”œβ”€β”€ πŸ“‹ docs/              # Documentation and specifications
└── πŸ“– README.md          # This file

Quick Start

Installation

  1. Clone the repository:
git clone https://github.com/jermsam/seyfr.git
cd seyfr
  1. Build the project:
cargo build --release

Interactive Mode

Launch the interactive menu:

cargo run -p seyfr-core

Choose from available options:

  • πŸ“€ Send a file
  • πŸ“‚ Send a directory
  • πŸ” Send an encrypted file
  • πŸ”’ Send an encrypted directory
  • πŸ“₯ Receive a file
  • πŸ“‚ Receive a directory
  • πŸ”“ Receive an encrypted file
  • πŸ”“πŸ“‚ Receive an encrypted directory

Command Line Usage

Sending Files

Send a regular file:

cargo run -p seyfr-core send /path/to/file.txt

Send a directory:

cargo run -p seyfr-core send-dir /path/to/directory --recursive

Send an encrypted file:

cargo run -p seyfr-core send-encrypted /path/to/file.txt --passphrase "your_password"

Send an encrypted directory:

cargo run -p seyfr-core send-dir-encrypted /path/to/directory --passphrase "your_password" --recursive

Receiving Files

Receive a file:

cargo run -p seyfr-core receive "TICKET_STRING" /destination/path

Receive an encrypted file:

cargo run -p seyfr-core receive-encrypted --passphrase "your_password" "TICKET_STRING" /destination/path

πŸ”„ How It Works

File Sharing Process Flow

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   SENDER    β”‚    β”‚  ENCRYPT &  β”‚    β”‚   TICKET    β”‚    β”‚  RECEIVER   β”‚
β”‚             │───▢│   PACKAGE   │───▢│ GENERATION  │───▢│             β”‚
β”‚ Select File β”‚    β”‚    File     β”‚    β”‚             β”‚    β”‚ Enter Ticketβ”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚                   β”‚                   β”‚                   β”‚
       β–Ό                   β–Ό                   β–Ό                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ File System β”‚    β”‚ Iroh Blobs  β”‚    β”‚ Share Ticketβ”‚    β”‚ P2P Network β”‚
β”‚   Access    β”‚    β”‚   Storage   β”‚    β”‚   String    β”‚    β”‚  Discovery  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                             β”‚
                                             β–Ό
                                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                    β”‚   DIRECT    β”‚
                                    β”‚  TRANSFER   β”‚
                                    β”‚             β”‚
                                    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                             β”‚
                                             β–Ό
                                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                                    β”‚  DOWNLOAD & β”‚
                                    β”‚   DECRYPT   β”‚
                                    β”‚             β”‚
                                    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Security Flow

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ PLAINTEXT   │───▢│ AES-256-GCM │───▢│ CIPHERTEXT  β”‚
β”‚    FILE     β”‚    β”‚ ENCRYPTION  β”‚    β”‚    FILE     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
       β”‚                   β–²                   β”‚
       β”‚                   β”‚                   β”‚
       β–Ό                   β”‚                   β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ PASSPHRASE  │───▢│   PBKDF2    β”‚    β”‚ P2P NETWORK β”‚
β”‚   INPUT     β”‚    β”‚ KEY DERIVE  β”‚    β”‚  TRANSFER   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                           β–²                   β”‚
                           β”‚                   β”‚
                   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”            β–Ό
                   β”‚   SECURE    β”‚    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                   β”‚   RANDOM    β”‚    β”‚  RECEIVER   β”‚
                   β”‚ SALT & NONCEβ”‚    β”‚  DECRYPTS   β”‚
                   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ”’ Security Model

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                      SECURITY GUARANTEES                       β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

🚫 NO CENTRAL AUTHORITY          πŸ” END-TO-END ENCRYPTION
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Your Device   │◄────────────►│  Peer's Device  β”‚
β”‚                 β”‚   Direct     β”‚                 β”‚
β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚   P2P        β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚ β”‚ Private Key β”‚ β”‚ Connection   β”‚ β”‚ Private Key β”‚ β”‚
β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚              β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
        β”‚                                β”‚
        β–Ό                                β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Local Encrypted β”‚              β”‚ Local Encrypted β”‚
β”‚    Storage      β”‚              β”‚    Storage      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

⚑ EPHEMERAL CONNECTIONS          πŸ”‘ USER-CONTROLLED KEYS
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”              β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ No Permanent    β”‚              β”‚ Your Passphrase β”‚
β”‚   Servers       β”‚              β”‚ = Your Control  β”‚
β”‚                 β”‚              β”‚                 β”‚
β”‚ Connections     β”‚              β”‚ No Key Escrow  β”‚
β”‚ Exist Only      β”‚              β”‚ No Backdoors   β”‚
β”‚ During Transfer β”‚              β”‚ No Recovery     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜              β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ›‘οΈ Security Features

Feature Implementation Benefit
πŸ” Encryption AES-256-GCM Military-grade protection
πŸ”‘ Key Derivation PBKDF2 (600k iterations) Brute-force resistance
🎲 Randomness Cryptographically secure Unique nonces/salts
πŸ›‘οΈ Memory Protection Zeroizing + mlock() Key safety
⚑ Streaming Chunked processing Large file support

Development

Building

cargo build

Testing

cargo test

Running with Debug Logs

RUST_LOG=debug cargo run -p seyfr-core

Architecture

Components

  • seyfr-core: CLI interface and command handling
  • seyfr-lib: Core file sharing, encryption, and P2P logic
  • seyfr-ui: Web interface (planned)

Key Technologies

  • Iroh: P2P networking and blob storage
  • AES-GCM: File encryption
  • Tokio: Async runtime
  • Clap: CLI argument parsing
  • Inquire: Interactive prompts

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

License

This project is licensed under the terms specified in the LICENSE file.

About

learn sendme

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors