ShieldOS Documentation
Welcome to ShieldOS — your decentralized personal security operating system. A unified suite of privacy-first tools built on Solana with secure chat, vault, authenticator, storage, and AI assistance.
Quick Start
Connect Your Wallet
Use Phantom, Solflare, Ledger, or any Solana-compatible wallet to authenticate
Sign Cryptographic Message
Your signature becomes your secure login — no passwords needed
Access Your Tools
Chat, vault, drive, authenticator, AI — all seamlessly connected and encrypted
Connect Wallet
ShieldOS uses wallet-based authentication for a passwordless, non-custodial experience. Your wallet signature serves as your cryptographic identity.
- Phantom Wallet
- Solflare Wallet
- Ledger Hardware Wallet
- All Solana-compatible wallets
Core Features
All apps run locally, encrypted, and wallet-gated. Nothing centralized. Everything you need to stay secure — in one dApp.
ShieldOS Assistant is your intelligent AI companion that provides real-time analysis, context-aware responses, and automated assistance — all while maintaining your privacy. Unlike traditional AI assistants, your conversations can be encrypted end-to-end, ensuring that only you can access your chat history.
The assistant leverages state-of-the-art language models to help you with tasks ranging from answering questions to analyzing data, all within your secure ShieldOS environment. Every interaction is processed with privacy in mind, and you maintain full control over your conversation data.
Key Features:
Real-Time Analysis & Responses
Get instant, intelligent responses to your queries. The assistant processes natural language and provides contextually relevant answers in real-time, helping you make informed decisions quickly.
Context-Aware Intelligence
The AI maintains conversation context, understanding references to previous messages and building on prior discussions. This enables more natural, flowing conversations that feel genuinely helpful.
Local Conversation History
All your conversations are stored locally on your device with optional encryption. You can search through past conversations, reference previous answers, and maintain a complete history that never leaves your control.
Optional End-to-End Encryption
Enable E2E encryption for your AI conversations. Your chats are encrypted using wallet-derived keys, ensuring that even the conversation content remains private and accessible only to you.
Multi-Modal Capabilities
Ask questions, analyze text, get explanations, summarize content, and more. The assistant supports various tasks including coding help, writing assistance, data analysis, and general knowledge queries.
Use Cases:
ShieldOS Authenticator brings multi-factor authentication into the Web3 era. Generate time-based one-time passwords (TOTP) for any service while keeping your secret seeds encrypted locally with wallet-derived keys. Unlike traditional authenticators, your 2FA codes are protected by the same cryptographic security that safeguards your blockchain assets.
The authenticator stores all secret keys locally on your device with AES-256 encryption. Your TOTP seeds never touch any server, and you maintain complete control. Compatible with all services that support standard TOTP authentication including Google, GitHub, Discord, and thousands of other platforms.
Key Features:
QR Code Integration
Add new accounts effortlessly by scanning QR codes during the 2FA setup process. The authenticator automatically extracts the secret key and configures the account with proper issuer names and labels for easy identification.
Auto-Refresh TOTP Codes
Time-based codes automatically regenerate every 30 seconds with a visual countdown timer. You'll always see the current valid code and know exactly how much time remains before it expires, preventing authentication failures.
Encrypted Local Storage
All TOTP seeds are encrypted using AES-256 encryption with keys derived from your wallet signature. Your authenticator secrets are protected with the same level of security as your cryptocurrency, ensuring no one can access your 2FA codes even if they gain physical access to your device.
Universal Compatibility
Works with any service supporting standard RFC 6238 TOTP authentication. This includes virtually all major platforms: Google, Microsoft, Amazon, GitHub, Coinbase, Binance, Discord, Twitter/X, and thousands more. If it supports Google Authenticator, it works with ShieldOS.
One-Click Copy
Click any code to instantly copy it to your clipboard for quick pasting during login. Visual feedback confirms successful copying, making the authentication process seamless and efficient.
Search & Organization
Manage dozens or hundreds of accounts with built-in search functionality. Find any account instantly by name or issuer, and organize accounts with custom labels and categories for better workflow.
Security Best Practices:
Always save backup codes when setting up 2FA on any service
Keep your wallet phrase secure — it's needed to decrypt your authenticator seeds
Test authenticator codes immediately after setup to ensure they work
Never share your TOTP codes or QR codes with anyone
ShieldOS Vault is your personal Fort Knox for digital secrets. Store unlimited passwords, private keys, seed phrases, API keys, and sensitive notes with military-grade AES-256 encryption. Unlike traditional password managers that rely on a master password, Vault uses your wallet signature as the encryption key — no passwords to remember, no passwords to leak.
Every item in your vault is encrypted individually with unique keys derived from your wallet, ensuring maximum security. The vault operates entirely client-side, meaning your plaintext secrets never leave your device. Even if someone gains access to your storage, they'll find nothing but encrypted data without your wallet signature.
Key Features:
AES-256 Military-Grade Encryption
Your vault uses the same encryption standard trusted by governments and military organizations worldwide. AES-256 is mathematically proven to be unbreakable with current technology, ensuring your secrets remain secure for decades to come.
Wallet-Derived Encryption Keys
Instead of a master password, Vault uses cryptographic signatures from your Solana wallet to derive encryption keys. This eliminates the weakest link in traditional password managers — the master password itself. Your wallet becomes your key, protected by hardware or secure enclaves.
Smart Categories & Organization
Organize your secrets with customizable categories: Passwords, Crypto Keys, API Keys, Notes, and more. Tag items, add custom fields, and structure your vault exactly how you need it. Color-coding and icons make finding items visually intuitive.
Powerful Search & Filtering
Find any vault item instantly with full-text search across titles, usernames, URLs, and notes. Filter by category, tags, or creation date. Search works on encrypted metadata fields without exposing sensitive content.
One-Click Copy & Auto-Clear
Copy passwords, keys, or any sensitive field with a single click. Clipboard automatically clears after 60 seconds to prevent accidental exposure. Visual feedback confirms successful copying without displaying the actual secret.
Password Strength Analysis
Real-time password strength meter analyzes entropy, length, character diversity, and common patterns. Get instant feedback on password security with color-coded strength indicators and actionable recommendations for improvement.
Secure Password Generator
Generate cryptographically secure random passwords with customizable options: length (8-128 characters), character sets (uppercase, lowercase, numbers, symbols), and exclusion rules. Never reuse or create weak passwords again.
Seed Phrase Storage
Safely store BIP39 seed phrases for your crypto wallets with special formatting and validation. The vault verifies valid 12/24-word phrases and provides tamper detection to ensure your recovery phrases remain intact.
Secure Notes
Store sensitive text information beyond passwords: recovery codes, PINs, software licenses, personal documents, or any private notes. Full markdown support with rich text formatting and code syntax highlighting.
Import & Export
Migrate from other password managers with CSV import. Export your vault data in encrypted format for backups or transfer to other devices. All exports maintain encryption and require your wallet signature to decrypt.
Supported Item Types:
ShieldOS Chat revolutionizes secure messaging by enabling direct communication between Solana wallet addresses. No phone numbers, no email addresses, no centralized servers storing your messages. Every message is cryptographically signed by the sender's wallet, providing mathematical proof of authenticity that can't be forged.
Messages are encrypted end-to-end using the recipient's public key, ensuring only the intended recipient can decrypt and read them. You can choose to store messages locally, ephemerally, or permanently on-chain for an immutable communication record. Chat integrates seamlessly with Solana Name Service (SNS) for human-readable addresses.
Key Features:
Cryptographically Signed Messages
Every message is signed with the sender's wallet private key using Ed25519 signatures. Recipients can verify the signature to mathematically prove the message came from the claimed sender and hasn't been tampered with. This eliminates impersonation and man-in-the-middle attacks.
End-to-End Encryption
Messages are encrypted using asymmetric encryption with the recipient's public key. Only the recipient's private key can decrypt the message. Not even ShieldOS can read your messages — true zero-knowledge communication.
Real-Time Delivery Status
Track message status in real-time: sent, delivered, read. Visual indicators show when your message reaches the recipient and when they've opened it. Delivery receipts are cryptographically signed for authenticity.
Optional On-Chain Storage
Choose to store important conversations permanently on the Solana blockchain. On-chain messages become part of the immutable ledger, creating a tamper-proof communication record. Perfect for legal agreements, contracts, or important business communications.
Authenticity Validation
Visual badges and verification indicators show cryptographic proof of message authenticity. Hover over any message to see the full signature details, sender's wallet address, and timestamp verification.
Solana Name Service Integration
Send messages to readable .sol domains instead of long wallet addresses. The chat automatically resolves SNS names to wallet addresses and displays human-readable identities for verified accounts.
Group Conversations
Create encrypted group chats with multiple wallet addresses. Each message is encrypted individually for each recipient. Group admins can manage members, and all actions are logged on-chain for transparency.
Media Sharing
Share encrypted files, images, and documents through chat. Files are stored on IPFS or Arweave with encrypted pointers shared in messages. Recipients decrypt files client-side using shared keys.
Self-Destructing Messages
Set expiration timers on sensitive messages. Messages automatically delete from both sender and recipient devices after the specified time. Perfect for sharing temporary passwords or time-sensitive information.
Use Cases:
ShieldOS Drive is your decentralized file system, offering encrypted storage without relying on centralized cloud providers. Files are encrypted client-side before upload, stored on decentralized networks (IPFS/Arweave), and can only be accessed with your wallet signature. No company can access, analyze, or monetize your files.
Choose your storage strategy: ephemeral local storage, permanent IPFS pinning, or immutable Arweave archiving. Share files securely by wallet address with granular permission controls. Recipients must sign with their wallet to decrypt shared files, ensuring only authorized parties can access your data.
Key Features:
Client-Side File Encryption
Every file is encrypted with AES-256 before leaving your device. Encryption keys are derived from your wallet and never shared. The encrypted file and the decryption key are stored separately, ensuring maximum security even if storage is compromised.
IPFS & Arweave Integration
Store files on the InterPlanetary File System (IPFS) for content-addressed, distributed storage, or use Arweave for permanent, pay-once storage that lasts forever. ShieldOS manages pinning, replication, and retrieval automatically.
Share by Wallet Address
Share files securely with any Solana wallet address. Recipients receive an encrypted access token that only their wallet can decrypt. Set expiration dates, download limits, or revoke access at any time with on-chain permission updates.
Folder Organization & Search
Organize files in unlimited nested folders with custom names, colors, and icons. Full-text search across file names, metadata, and tags. Filter by file type, size, upload date, or shared status. Starred files and recent access for quick navigation.
Version Control
Maintain version history for important files. Upload new versions while preserving access to previous iterations. Each version is stored separately with timestamp and hash verification, enabling rollback to any previous state.
Rich File Previews
Preview documents, images, videos, and code files directly in the browser after client-side decryption. Support for PDF, images (JPEG, PNG, GIF, WebP), videos (MP4, WebM), audio, text files, markdown, and code with syntax highlighting.
Bandwidth Optimization
Chunked uploads for large files with resume capability. If upload fails, resume from the last successful chunk. Parallel downloads with stream decryption for optimal performance without compromising security.
Collaboration Tools
Create shared folders with multi-user access. Set granular permissions: view-only, download, upload, or full edit rights. Activity logs show who accessed or modified files, all verified with wallet signatures.
Mobile Sync (Coming Soon)
Automatic synchronization across devices using the same wallet. Access your encrypted files from desktop, mobile, or tablet with seamless sync through decentralized networks.
Supported File Types:
ShieldOS Calendar brings your scheduling into the Web3 era with encrypted events, blockchain-based identity verification, and wallet-gated invitations. Create events, schedule meetings, and coordinate with others while maintaining complete privacy over your calendar data.
All calendar events are encrypted locally and synced across your devices. Invite participants by wallet address with cryptographic RSVP verification. Optional on-chain event registration creates immutable attendance records, perfect for verified participation in DAOs, conferences, or exclusive events.
Key Features:
Encrypted Event Creation
Create events with title, description, location, and attendees. All event data is encrypted client-side. Choose to store events locally, sync encrypted to cloud, or register on-chain for verified attendance.
Multiple Calendar Views
Switch between day, week, month, and agenda views. Customizable time zones, work hours, and week start day. Color-coded calendars for work, personal, crypto events, and custom categories.
Smart Reminders & Notifications
Set multiple reminders per event with flexible timing: minutes, hours, or days before. Desktop and mobile notifications ensure you never miss important meetings or deadlines. Snooze and reschedule directly from notifications.
Wallet-Based Invitations
Invite attendees by Solana wallet address or SNS domain. Invitations are cryptographically signed and include encrypted event details. Attendees must sign acceptance with their wallet, creating verifiable participation records.
RSVP Tracking
Track attendee responses: accepted, declined, tentative, or no response. See real-time RSVP status for each invitee. Automated reminders to non-responders as event approaches.
Recurring Events
Create repeating events with flexible patterns: daily, weekly, monthly, yearly, or custom rules. Edit single instances or entire series. Smart exclusion of holidays and weekends.
On-Chain Event Registry
Register important events on Solana blockchain for immutable proof of occurrence. Perfect for DAO votes, conference attendance, or any event requiring verified participation records.
Export & Sync
Export calendars to standard iCal format for compatibility with other calendar apps. Import existing calendars from Google Calendar, Outlook, or any iCal source. Two-way sync (coming soon) for seamless integration.
Meeting Scheduling Links
Generate shareable scheduling links similar to Calendly. Define your availability, and let others book time slots. All bookings require wallet signature to prevent spam and ensure authenticated scheduling.
Use Cases:
Coming Soon
Expanding the ecosystem with new decentralized tools and services.
ShieldOS Mail will be a complete reimagination of email for the Web3 era. Send and receive encrypted emails using your wallet address as your identity — no Gmail, no corporate email providers, no centralized servers storing your correspondence.
Planned Features:
Manage your digital identity with verifiable credentials and decentralized identity solutions. Control your personal data and identity verification on the blockchain.
Integrated payment system for sending and receiving crypto payments, creating invoices, and managing transactions. Seamless integration with your ShieldOS wallet.
Create and manage decentralized short links with built-in analytics. Share links securely with tracking and control over your data.
Architecture
1. Wallet Connection
Connect with Phantom, Solflare, Ledger, or any Solana-compatible wallet
2. Cryptographic Signature
Sign a message to prove wallet ownership — your signature is your login
3. Client-Side Encryption
All data encrypted on your device before any storage or transmission
4. Secure Storage
Choose local, on-chain, or decentralized storage (IPFS/Arweave)
5. Access Tools
Use all ShieldOS features seamlessly with your authenticated session
Security
AES-256
Advanced Encryption Standard with 256-bit keys for data encryption
RSA-2048
Public-key cryptography for secure key exchange and signatures
SHA-256
Cryptographic hash function for data integrity verification
Ed25519
Elliptic curve signatures for Solana wallet authentication
Tech Stack
Why Solana?
- Sub-second transaction finality
- Ultra-low transaction fees
- Robust developer tooling
- Large active ecosystem
- Wallet infrastructure for mass adoption
Frequently Asked Questions
No — everything is encrypted and handled client-side on your device. We never see or store your plaintext data.
No. ShieldOS is completely non-custodial. Your wallet keys stay with you at all times. We never have access to your private keys or funds.
Yes. The platform is transitioning to fully open-source. You'll be able to audit and verify all code to ensure security and transparency.
Phantom, Solflare, Ledger, and all Solana-compatible wallets are supported through the Solana Wallet Adapter.
Possibly in the future DAO phase, but it's not required for using ShieldOS features. The platform will remain free and accessible.