DigitalValut Chat 🔐

Military-Grade Secure Messaging with Quantum-Resistant Encryption

[ [ [

📋 Table of Contents

Overview
Key Features
Security Features
Quick Start
Deployment Guide
Building for Production
Project Structure
Contributing
License

🌟 Overview

DigitalValut Chat is an open-source, military-grade secure messaging application that provides true end-to-end encryption with quantum-resistant cryptography. Unlike traditional messaging apps, DigitalValut offers:

✅ True Privacy: No servers, no data collection, no tracking
✅ Quantum-Resistant: Post-quantum cryptography ready for the future
✅ P2P Communication: Direct peer-to-peer messaging via WebRTC
✅ Secure Voice Calls: End-to-end encrypted voice calling with military-grade encryption
✅ Ephemeral Messages: Self-destructing messages that leave no trace
✅ Blockchain Identity: TON blockchain wallet integration
✅ Local AI: On-device LLM for translation and spam detection
✅ Open Source: Fully auditable code under MIT License

🔑 Key Features

🔐 Military-Grade Encryption

Hybrid Cryptography: Combines X25519 key exchange with AES-256-GCM
End-to-End Encryption: Messages encrypted on your device, decrypted only by recipient
Forward Secrecy: Each session uses unique encryption keys
Secure Key Storage: Biometric-protected keychain storage

🌐 P2P Messaging

No Central Server: Direct device-to-device communication
WebRTC Data Channels: Real-time encrypted messaging
NAT Traversal: STUN/TURN support for global connectivity
Offline Mode: Messages queued and synced when back online

📞 Secure Voice Calling

End-to-End Encrypted Audio: Military-grade encryption for all voice streams
WebRTC Voice Channels: High-quality peer-to-peer voice calls
Advanced Audio Processing: Echo cancellation, noise suppression, auto-gain control
Call Controls: Mute, speaker toggle, and end call functions
Connection Indicators: Real-time call status and duration display
Public STUN/TURN Servers: Reliable connectivity across all network conditions

⏱️ Ephemeral Messages

Self-Destructing: Set messages to auto-delete after viewing
Customizable Timers: 10 seconds to 30 days
Secure Deletion: Encryption keys wiped from memory
No Traces: Messages permanently deleted

💰 TON Blockchain Integration (Planned)

Decentralized Identity: Use TON wallet address as user ID
Micropayments: Send cryptocurrency in messages
NFT Verification: Mint important messages as NFTs
Spam Prevention: Stake required to message new contacts

🤖 Local AI Features (Planned)

Auto-Translation: Real-time message translation (50+ languages)
Spam Detection: AI-powered phishing/malware detection
Chat Summaries: Instant conversation summaries
Smart Replies: Contextual quick response suggestions

🔒 Security Protections

Screenshot Blocking: Prevent screen capture
Biometric Authentication: Face ID / Touch ID / Fingerprint
Encrypted Database: Local SQLite database with AES-256
Screen Recording Detection: Alerts when recording detected

🛡️ Security Features

DigitalValut implements defense in depth with multiple security layers:

Transport Layer: WebRTC DTLS 1.3 encryption
Key Exchange: X25519 elliptic curve Diffie-Hellman
Message Encryption: AES-256-GCM authenticated encryption
Local Storage: Encrypted SQLite database
Key Management: Flutter Secure Storage with biometric protection
UI Security: Screenshot blocking and screen recording detection

🚀 Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

Flutter SDK (3.0 or higher): Install Flutter
Android Studio (for Android development): Download Android Studio
Xcode (for iOS development, macOS only): Download Xcode
Git: Install Git

Installation Steps

1. Clone the Repository

# Clone this repository to your local machine
git clone https://github.com/digitalvalut/digitalvalut_chat.git
cd digitalvalut_chat

2. Install Dependencies

# Get all Flutter packages
flutter pub get

3. Run on Android Emulator/Device

# List available devices
flutter devices

# Run the app
flutter run

4. Run on iOS Simulator/Device (macOS only)

# Open iOS simulator
open -a Simulator

# Run the app
flutter run

📦 Deployment Guide

For Non-Programmers

This guide will help you build DigitalValut Chat from source and install it on your device without using app stores.

Step 1: Install Flutter

Windows:

Download Flutter SDK from https://docs.flutter.dev/get-started/install/windows
Extract the zip file to C:\src\flutter
Add Flutter to your PATH:
- Search "Environment Variables" in Windows
- Edit "Path" variable
- Add C:\src\flutter\bin
Open Command Prompt and run: flutter doctor

macOS:

Open Terminal
Run: brew install flutter (install Homebrew first if needed)
Run: flutter doctor

Linux:

Download Flutter SDK from https://docs.flutter.dev/get-started/install/linux
Extract to /usr/local/flutter
Add to PATH: export PATH="$PATH:/usr/local/flutter/bin"
Run: flutter doctor

Step 2: Install Android Studio (for Android)

Download from https://developer.android.com/studio
Install Android Studio
Open Android Studio
Go to Settings → Appearance & Behavior → System Settings → Android SDK
Install latest Android SDK
Install Android SDK Command-line Tools

Step 3: Set Up Your Device

Android:

Enable Developer Options on your phone:
- Go to Settings → About Phone
- Tap "Build Number" 7 times
Enable USB Debugging:
- Go to Settings → Developer Options
- Turn on "USB Debugging"
Connect phone to computer via USB
Run: flutter devices (should see your phone listed)

iOS (macOS only):

Open Xcode
Go to Preferences → Accounts → Add Apple ID
Connect iPhone via USB
Trust the computer on your iPhone
Run: flutter devices

Step 4: Build the App

For Android (APK):

# Navigate to project folder
cd digitalvalut_chat

# Build APK
flutter build apk --release

# APK will be at: build/app/outputs/flutter-apk/app-release.apk

For iOS (IPA - macOS only):

# Build iOS app
flutter build ios --release

# You'll need to sign with your Apple Developer account
# Open in Xcode: ios/Runner.xcworkspace
# Select your team in Signing & Capabilities
# Archive and export IPA

Step 5: Install on Your Device

Android:

Copy app-release.apk to your phone
Open the APK file
Allow "Install from Unknown Sources" if prompted
Tap "Install"

iOS:

Install via Xcode:
- Open Xcode
- Window → Devices and Simulators
- Select your device
- Drag the .app file to Installed Apps
Or use TestFlight for beta distribution

☁️ Cloud Build & Deploy (FREE - Recommended)

🚀 Automatic Build with GitHub Actions

This repository includes GitHub Actions workflows that automatically build your app whenever you push code. No local Flutter installation needed!

What Gets Built Automatically:

✅ Android APK (Release) - Ready to install
✅ Flutter Web (Release) - Ready for Netlify
✅ Code Analysis - Automated testing
✅ Artifacts Storage - 30-day retention

How to Use:

Push code to GitHub:

git add .
git commit -m "Update app"
git push origin master

Download builds:
- Go to: https://github.com/digitalvalut/digitalvalut-chat/actions
- Click latest workflow run
- Download artifacts:
  - android-release-apk → APK file for Android
  - flutter-web-build → Web files for Netlify

Build Status:

Check your builds at: https://github.com/digitalvalut/digitalvalut-chat/actions

🌐 Deploy to Netlify (FREE Hosting)

Deploy your Flutter web app to the internet in 2 minutes - completely FREE!

Option 1: Drag & Drop (Easiest)

Get the web build:
- Download flutter-web-build artifact from GitHub Actions
- Extract the ZIP file
Deploy to Netlify:
- Visit: https://app.netlify.com/drop
- Drag the build/web folder
- Your app is live! 🎉
Get your link:
- Netlify gives you: https://[random-name].netlify.app
- Custom domain available (optional)

Option 2: Connect GitHub (Auto-Deploy)

Sign up at https://netlify.com (free account)
New Site from Git:
- Click "Add new site" → "Import existing project"
- Connect GitHub
- Select digitalvalut-chat repository
Configure build:
- Build command: flutter build web --release
- Publish directory: build/web
- Click "Deploy site"
Auto-deploy enabled:
- Every push = automatic deployment
- Live in 2-3 minutes

Your Live App:

Web Demo: https://digitalvalut-chat.netlify.app
Download APK: Available on website
Share Link: Send to friends/investors

📲 GitHub Releases (APK Distribution)

Share your Android APK with users:

Create Release:
- Go to: https://github.com/digitalvalut/digitalvalut-chat/releases/new
- Tag: v1.0.0
- Title: DigitalValut Chat v1.0.0
Upload APK:
- Attach app-release.apk from GitHub Actions
- Add changelog
- Publish release
Share download link:
- Direct APK link for users
- Installation instructions included

🏗️ Building for Production

Android Production Build

# Create app bundle for Google Play (if needed)
flutter build appbundle --release

# Or create APK for sideloading
flutter build apk --release --split-per-abi

Signing Your APK:

Create a keystore:

keytool -genkey -v -keystore ~/digitalvalut-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias digitalvalut

Reference keystore in android/key.properties:

storePassword=your_password
keyPassword=your_password
keyAlias=digitalvalut
storeFile=/path/to/digitalvalut-key.jks

Build signed APK:

flutter build apk --release

iOS Production Build

# Build for App Store or TestFlight
flutter build ios --release

# Open in Xcode for archiving
open ios/Runner.xcworkspace

Steps in Xcode:

Select "Any iOS Device" as target
Product → Archive
Distribute App → Choose distribution method
Sign with your Apple Developer certificate
Export IPA

📁 Project Structure

digitalvalut_chat/
├── lib/
│   ├── main.dart                    # App entry point
│   ├── crypto/                      # Encryption modules
│   │   ├── encryption_service.dart  # Hybrid encryption
│   │   └── key_manager.dart         # Key storage
│   ├── network/                     # P2P networking
│   │   └── p2p_manager.dart         # WebRTC manager
│   ├── database/                    # Local database
│   │   └── database_service.dart    # SQLite service
│   ├── models/                      # Data models
│   │   ├── contact.dart
│   │   ├── conversation.dart
│   │   └── message.dart
│   ├── ui/                          # User interface
│   │   ├── auth_screen.dart         # Authentication
│   │   ├── chat_list_screen.dart    # Conversation list
│   │   ├── chat_screen.dart         # Chat interface
│   │   ├── settings_screen.dart     # Settings
│   │   └── add_contact_screen.dart  # Add contacts
│   ├── security/                    # Security features
│   │   └── biometric_auth.dart      # Biometric auth
│   ├── blockchain/                  # TON integration
│   │   └── ton_wallet.dart          # TON wallet
│   ├── llm/                         # AI features
│   │   └── local_llm.dart           # Local LLM
│   └── services/                    # App services
│       └── theme_provider.dart      # Theme management
├── assets/                          # Assets
│   └── logo.png                     # App logo
├── android/                         # Android config
├── ios/                             # iOS config
├── pubspec.yaml                     # Dependencies
└── README.md                        # This file

🔧 Development

Running Tests

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

Code Quality

# Analyze code
flutter analyze

# Format code
flutter format lib/

Debugging

# Run in debug mode
flutter run --debug

# Run with verbose logging
flutter run -v

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Commit your changes: git commit -m 'Add amazing feature'
Push to the branch: git push origin feature/amazing-feature
Open a Pull Request

Development Guidelines

Follow the Flutter Style Guide
Write tests for new features
Update documentation
Ensure all tests pass before submitting PR

🔐 Security Considerations

For Users

Verify App Integrity: Always download from official sources
Backup Your Keys: Store encryption keys securely
Use Strong Biometrics: Enable Face ID/Touch ID/Fingerprint
Update Regularly: Keep app updated for security patches

For Developers

Code Audits: Security audits welcome
Report Vulnerabilities: Please report security issues privately to security@digitalvalut.chat
No Backdoors: This app contains no backdoors or surveillance features

📱 Platform Support

Feature	Android	iOS
End-to-End Encryption	✅	✅
P2P Messaging	✅	✅
Ephemeral Messages	✅	✅
Biometric Auth	✅	✅
Screenshot Blocking	✅	✅
TON Wallet	🚧	🚧
Local LLM	🚧	🚧

✅ = Implemented | 🚧 = In Development

🐛 Troubleshooting

Common Issues

"Flutter command not found"

Add Flutter to your PATH
Run flutter doctor to diagnose

"Unable to connect device"

Enable USB Debugging (Android)
Trust computer (iOS)
Check cable connection

"Build failed"

Run flutter clean
Run flutter pub get
Delete build folder
Try again

"Permission denied"

Grant required permissions in Settings
Check AndroidManifest.xml (Android)
Check Info.plist (iOS)

Getting Help

Documentation: https://digitalvalut.chat/docs
Issues: https://github.com/digitalvalut/digitalvalut_chat/issues
Community: https://discord.gg/digitalvalut
Email: support@digitalvalut.chat

📄 License

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

MIT License

Copyright (c) 2025 DigitalValut

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🙏 Acknowledgments

Flutter Team for the amazing framework
Cryptography Community for post-quantum algorithms
WebRTC Project for P2P communication
TON Foundation for blockchain integration
Open Source Community for continuous support

🌍 Links

Website: https://digitalvalut.chat
GitHub: https://github.com/digitalvalut/digitalvalut_chat
Twitter: https://twitter.com/digitalvalut
LinkedIn: https://linkedin.com/company/digitalvalut
Documentation: https://docs.digitalvalut.chat

📊 Roadmap

Version 1.0 (Current)

✅ End-to-end encryption
✅ P2P messaging
✅ Ephemeral messages
✅ Biometric authentication
✅ Screenshot blocking

Version 1.1 (Q2 2025)

🚧 TON blockchain wallet
🚧 Local LLM integration
🚧 Voice/Video calls
🚧 Group chats

Version 2.0 (Q3 2025)

🚧 File sharing
🚧 Message reactions
🚧 Desktop apps
🚧 Multi-device sync

💬 Contact

For questions, suggestions, or support:

Email: contact@digitalvalut.chat
Twitter: @digitalvalut
Discord: https://discord.gg/digitalvalut

Made with ❤️ by the DigitalValut Team

Secure your conversations. Own your privacy. Trust no one.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
android		android
assets		assets
docs		docs
ios/Runner		ios/Runner
lib		lib
test		test
web		web
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOYMENT.md		DEPLOYMENT.md
DEPLOYMENT.pdf		DEPLOYMENT.pdf
GITHUB_ACTIONS_SETUP.md		GITHUB_ACTIONS_SETUP.md
GITHUB_ACTIONS_STATUS.md		GITHUB_ACTIONS_STATUS.md
GITHUB_ACTIONS_STATUS.pdf		GITHUB_ACTIONS_STATUS.pdf
LICENSE		LICENSE
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
PROJECT_SUMMARY.pdf		PROJECT_SUMMARY.pdf
README.md		README.md
SECURITY.md		SECURITY.md
SECURITY.pdf		SECURITY.pdf
VOICE_CALLING_DOCUMENTATION.md		VOICE_CALLING_DOCUMENTATION.md
VOICE_CALLING_DOCUMENTATION.pdf		VOICE_CALLING_DOCUMENTATION.pdf
analysis_options.yaml		analysis_options.yaml
logo.png		logo.png
netlify.toml		netlify.toml
pubspec.yaml		pubspec.yaml

Latest commit

History

Folders and files

Repository files navigation