A mobile wallet application for Fuego (XFG) privacy cryptocurrency. Features include secure untraceable transactions, encrypted messaging, privacy banking suite, menu for Ξlderfier (decentralized verification) nodes, complete with 'Elderfyre Stayking' ceremony, plus built-in mining. 🔥

• PIN Authentication with PBKDF2 secure hashing
• Biometric Authentication (fingerprint/Face ID)
• AES-256-CBC Encryption for wallet data
• Secure Device Storage with hardware keychain
• 25-word Mnemonic backup / recovery

• Create New Wallets with secure entropy
• Restore from Backup using mnemonic phrase or private keys
• Real-time Balance Display with privacy toggle
• Blockchain Sync progress tracking
• Transaction History with confirmation status monitoring

• Send XFG with configurable privacy levels
• Ring Signatures (8-15 mixins for anonymity)
• Receive with QR Codes and integrated addresses
• Payment ID Support for transaction identification
• Fee Estimation and validation

• CPU Mining Controls directly from device
• Thread Configuration (1-8 CPU threads)
• Real-time Hashrate monitoring
• Mining Performance tracking

• Elderfier Registration requires 800 XFG stake
• Consensus Participation (3of3 FastPass/ 8of10 FallBack)
• Network Monitoring of all Elderfier nodes
• Fyre_Fee Rewards Tracking and performance metrics

• Blockchain Messaging with end-to-end encryption
• Self-Destruct Messages with configurable timers
• Censorship Resistance via blockchain storage
• Complete Privacy with no metadata tracking

• Flutter SDK: 3.22.2 or higher
• Dart SDK: 3.4.3 or higher
• Android Studio / Xcode for platform-specific builds
• Internet connection to connect to Fuego network nodes

1. Clone the repository

   git clone https://github.com/usexfg/fuego-flutter.git
   cd fuego-flutter

2. Install dependencies

   flutter pub get

3. Run the app

   flutter run

# Android APK
flutter build apk --release

# Android App Bundle
flutter build appbundle --release

# iOS (requires Xcode)
flutter build ios --release

lib/
├── main.dart                    # App entry point
├── models/                      # Data models
├── services/                    # Business logic
│   ├── fuego_rpc_service.dart  # Fuego RPC communication
│   └── security_service.dart   # Security & encryption
├── providers/                   # State management
├── screens/                     # UI screens
│   ├── auth/                   # Authentication
│   ├── wallet_setup/           # Wallet creation/restore
│   ├── home/                   # Main dashboard
│   ├── transactions/           # Send/receive
│   ├── elderfier/              # Staking features
│   ├── messaging/              # Encrypted messaging
│   └── settings/               # Configuration
├── widgets/                     # Reusable components
└── utils/                       # Utilities & theming

• Provider Pattern for reactive state management
• Clean Architecture with separation of concerns
• Comprehensive Error Handling throughout

• Multi-layered Encryption with industry standards
• Hardware Security Integration when available
• Memory Protection with automatic data clearing
• Secure Key Derivation and storage

The app connects to remote Fuego network nodes for full functionality. By default, it connects to community-maintained public nodes, but you can configure custom nodes in the app settings.

The app includes several pre-configured remote nodes, with 207.244.247.64:18180 as the primary default:

• 207.244.247.64:18180 (Primary)
• node1.usexfg.org
• node2.usexfg.org
• fuego.seednode1.com
• fuego.seednode2.com
• fuego.communitynode.net

You can add custom nodes through the Settings > Node Connection menu, or modify the defaults in:

// lib/services/fuego_rpc_service.dart
static const List<String> defaultRemoteNodes = [
  'node1.usexfg.org',
  'node2.usexfg.org',
  // ... more nodes
];

• RPC port: 18180 (default)
• Wallet RPC port: 8070
• Must support standard CryptoNote RPC methods

• AES-256-CBC encryption for all stored wallet data
• PBKDF2 key derivation with 100,000 iterations
• Secure random generation for keys and entropy
• Hardware security module integration when available

• Dynamaxin for highest possible privacy (per available decoy outputs: min 8 max 18)
• Payment IDs for transaction identification
• Integrated addresses better UX, easier for network services
• No data tracking - all operations local

• Multi-factor authentication with PIN + biometric
• Failed attempt protection with progressive lockout
• Secure session management with timeout
• Device binding with hardware-specific keys

• ✅ Android 7.0+ (API level 24+)
• ✅ iOS 12.0+
• 🔄 Linux Desktop (ready)
• 🔄 Windows Desktop (ready)
• 🔄 macOS Desktop (ready)

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

# Run integration tests
flutter drive --target=test_driver/app.dart

We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes and test thoroughly
4. Commit your changes: git commit -m 'Add amazing feature'
5. Push to the branch: git push origin feature/amazing-feature
6. Open a Pull Request

• Follow Flutter's style guide
• Use flutter analyze to check for issues
• Format code with dart format
• Write tests for new features

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

• Fuego Website: https://usexfg.org
• Main Repository: https://github.com/usexfg/fuego
• Discord: https://discord.gg/5UJcJJg
• Twitter: https://twitter.com/useXFG

• Issues: GitHub Issues
• Discord: Fuego Community
• Email: [email protected]

This software is provided "as is" without warranty. Cryptocurrency transactions are irreversible. Always:

• Backup your wallet securely
• Verify transactions before sending
• Use at your own risk
• Keep your backup phrase safe

Built with 🔥 for the Fuego Mob

Privacy • Security • Decentralization