publickeyserver.org

🔐 How the Public Key Server Works

The Public Key Server is the backbone of secure, decentralized file sharing using post-quantum cryptography. Here's how it enables secure communication:

Key Components

The Process Flow

Privacy & Security Features

• Anonymous Option: Create aliases without email or personal information
• Quantum-Resistant: Uses CRYSTALS-Dilithium and CRYSTALS-Kyber algorithms
• End-to-End Encryption: Server cannot decrypt packages
• Temporary Storage: Packages are automatically deleted after retrieval or timeout
• Certificate Pinning: Prevents man-in-the-middle attacks

📥 Download SurePack

🚀 Quick Start Guide

# Anonymous alias (no email)
surepack create

# OR with email verification (optional)
surepack verify your@email.com

surepack create your@email.com 123456

# Smart parameter detection - no flags needed!
surepack recipient@example.com myfile.pdf

# Or use traditional flags
surepack pack -i myfile.pdf -a recipient-alias -f your-alias -o package.surepack
surepack send -i package.surepack

📖 SurePack User Manual

What is SurePack?

SurePack is a secure file transfer application that uses military-grade encryption with post-quantum cryptography. It allows you to send files securely and optionally anonymously to other users. Think of it as "PGP for 2025" - but much easier to use!

Creating Your Alias (Digital Identity)

An alias is your unique identity in the SurePack system. It's like a secure email address that you'll use to send and receive files.

Command Line Method

surepack create

You'll be prompted to enter a password to protect your private keys. Choose a strong password and remember it!

GUI Method

surepack gui

Then navigate to: Manage Aliases → Create New Alias

Optional: Associate an Email

If you want to be identifiable (not anonymous), you can associate an email:

# Smart parameter detection:
surepack verify yourname@example.com
surepack create yourname@example.com 123456

# Or traditional commands:
surepack verify -e yourname@example.com
surepack create -e yourname@example.com -t 123456

Smart Parameter Detection (NEW!)

SurePack now includes intelligent command detection that makes sending and receiving files even easier. No need to remember complex flags!

# Just provide recipient and file - SurePack figures out the rest!
surepack alice@example.com document.pdf
surepack document.pdf alice@example.com  # Order doesn't matter!

# Automatically uses your most recent alias as sender
# Auto-generates output filename with timestamp
# Sends immediately after packing

# Just provide an alias to check for packages
surepack bob@example.com

# Or check all your aliases
surepack receive

# Request email verification
surepack verify alice@example.com

# Create alias with email and token
surepack create alice@example.com 123456

# Create anonymous alias
surepack create

# No parameters? Launch the GUI
surepack

Sending Files

Step 1: Pack Your Files

surepack pack -i "document.pdf" -a "recipient-alias" -f "your-alias" -o "package.surepack"

For multiple files:

surepack pack -i "file1.doc,file2.pdf,file3.jpg" -a "recipient" -f "sender" -o "package.surepack"

For a whole folder:

surepack pack -i "C:\MyFolder" -a "recipient" -f "sender" -o "package.surepack"

Step 2: Send the Package

surepack send -i "package.surepack"

surepack pack -i "file.pdf" -a "recipient" -f "sender" -o "pkg.surepack" && surepack send -i "pkg.surepack"

Receiving Files

Step 1: Check for Packages

surepack receive -a "your-alias"

Step 2: Unpack the Files

surepack unpack -i "received-package.surepack" -o "output-folder"

Command Reference

🔒 Security Information

Where Your Keys Are Stored

• Windows: %LOCALAPPDATA%\surepack
• macOS: ~/Library/Application Support/surepack
• Linux: ~/.local/share/surepack

Best Practices

• Use a strong, unique password for your alias
• Back up your key files in a secure location
• Verify recipient aliases before sending sensitive files
• For maximum anonymity, don't associate an email with your alias
• Regularly check for software updates

Technical Details

SurePack uses the following cryptographic algorithms:

• Digital Signatures: CRYSTALS-Dilithium (NIST PQC standard)
• Key Encapsulation: CRYSTALS-Kyber (NIST PQC standard)
• Symmetric Encryption: AES-256-GCM
• Key Derivation: Argon2id

💻 Open Source

📜 License Model

PublicKeyServer operates under a custom non-monetization open source license designed to keep the software freely available while preventing commercial exploitation.

✅ What You CAN Do

• Personal Use: Use for any personal purpose
• Business Use: Use internally and externally within your organization
• Modify & Distribute: Create and share improvements (under same license)
• Educational Use: Use in schools, universities, and training
• Government Use: Deploy in public sector organizations
• Research: Use for both commercial and academic research
• Free Services: Provide the software as a free service to others

❌ What You CANNOT Do

• Sell the Software: No charging fees for the software itself
• Monetize Services: No charging for services based on this software
• Generate Revenue: No using the software to make money directly or indirectly
• Create Financial Barriers: Must remain freely accessible to all users
• Remove Attribution: Must credit original authors

🏢 Special Arrangements

Organizations wishing to monetize the software or offer paid services based on it can request explicit written permission from the license holders. Such arrangements would be considered under separate commercial licensing terms.

For complete license terms and legal text, see the LICENSE file in the project repository.