Skip to content

ColinRitman/fuego-GTR-wallet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

120 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”₯ Fuego Wallet GTR

Build Status Release License Security

Fuego GTR Wallet is a modern, secure, and feature-rich desktop cryptocurrency wallet for the Fuego (XFG) privacy blockchain banking network. Built with Tauri, Rust, and modern web technologies, it provides a native desktop experience with advanced security features and comprehensive functionality.

✨ Features

πŸ”’ Security & Privacy

  • Encrypted Storage - All wallet data encrypted with AES-256
  • Session Management - Secure authentication and session handling
  • Password Validation - Strong password requirements and validation
  • Secure Backup - Encrypted ZIP backups with multiple types
  • Audit Trail - Complete operation history and logging

πŸ’° Wallet Functionality

  • XFG Support - Full support for Fuego cryptocurrency
  • Real-time Sync - Live blockchain synchronization with progress tracking
  • Transaction Management - Send, receive, and track transactions
  • Term Deposits - Lock XFG for interest with flexible terms
  • Address Management - Multiple addresses with labels and subaddresses
  • Mining Integration - Built-in mining support with pool management

πŸ–₯️ User Experience

  • Multi-language Support - 11 languages with RTL support
  • Modern UI - Beautiful, responsive interface with dark/light themes
  • Real-time Updates - Live balance, sync progress, and notifications
  • Performance Optimized - Resource monitoring, caching, and threading
  • Cross-platform - Native apps for Windows, macOS, and Linux

⚑ Advanced Features

  • Blockchain Explorer - Multiple explorer integrations
  • Performance Monitoring - CPU, memory, and network metrics
  • Background Tasks - Automated operations and maintenance
  • Settings Management - Comprehensive configuration options
  • Backup & Recovery - Multiple backup types and restoration

πŸš€ Quick Start

Prerequisites

  • Node.js 18+ and npm
  • Rust 1.70+ with Cargo
  • System Dependencies:
    • Linux: libwebkit2gtk-4.0-dev libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev
    • macOS: webkit2gtk openssl (via Homebrew)
    • Windows: Automatically handled by Tauri

Installation

  1. Clone the repository

    git clone https://github.com/fuego-wallet/fuego-GTR-wallet.git
    cd fuego-GTR-wallet/fuego-tauri
  2. Install dependencies

    npm install
  3. Run in development mode

    npm run tauri dev
  4. Build for production

    npm run tauri build

Download Pre-built Releases

Visit the Releases page to download pre-built binaries for your platform.

πŸ—οΈ Architecture

Technology Stack

  • Frontend: HTML5, CSS3, TypeScript, Modern JavaScript
  • Backend: Rust with Tauri framework
  • Fuego Core Integration: C++ FFI bindings
  • UI Framework: Custom CSS with modern design patterns
  • Build System: Tauri CLI with Rust Cargo

Project Structure

fuego-tauri/
β”œβ”€β”€ src/                    # Frontend source code
β”‚   β”œβ”€β”€ main.ts            # Main application logic
β”‚   └── styles.css         # Application styles
β”œβ”€β”€ src-tauri/             # Rust backend
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ lib.rs         # Main Rust entry point
β”‚   β”‚   β”œβ”€β”€ crypto/        # CryptoNote integration
β”‚   β”‚   β”œβ”€β”€ security/      # Security features
β”‚   β”‚   β”œβ”€β”€ performance/   # Performance optimization
β”‚   β”‚   β”œβ”€β”€ settings/      # Settings management
β”‚   β”‚   β”œβ”€β”€ backup/        # Backup & recovery
β”‚   β”‚   β”œβ”€β”€ i18n/          # Internationalization
β”‚   β”‚   β”œβ”€β”€ optimization/  # Advanced optimization
β”‚   β”‚   └── advanced/      # Advanced features
β”‚   β”œβ”€β”€ Cargo.toml         # Rust dependencies
β”‚   └── fuego_wallet_real.cpp  # C++ CryptoNote FFI
β”œβ”€β”€ package.json           # Node.js dependencies
└── tauri.conf.json       # Tauri configuration

πŸ”§ Development

Setting up Development Environment

  1. Install Rust

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  2. Install Node.js

    # Using nvm (recommended)
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
    nvm install 18
    nvm use 18
  3. Install Tauri CLI

    cargo install tauri-cli

Running Tests

# Frontend tests
npm test

# Rust tests
cargo test

# Integration tests
npm run test:integration

Code Quality

# Linting
npm run lint
cargo clippy

# Formatting
npm run format
cargo fmt

# Security audit
npm audit
cargo audit

πŸ“¦ Building & Distribution

Local Build

npm run tauri build

Cross-platform Build

The GitHub Actions workflows automatically build for all platforms:

  • Linux: AppImage
  • Windows: NSIS installer (.exe)
  • macOS: DMG package

Release Process

  1. Create a git tag: git tag v1.0.0
  2. Push the tag: git push origin v1.0.0
  3. GitHub Actions will automatically build and release

πŸ” Security

Security Features

  • Encrypted Storage: All sensitive data encrypted at rest
  • Secure Communication: HTTPS/TLS for all network operations
  • Input Validation: Comprehensive input sanitization
  • Session Security: Secure session management with timeouts
  • Audit Logging: Complete operation audit trail

Reporting Security Issues

Please report security vulnerabilities privately see SECURITY.md for more details.

🌐 Internationalization

Fuego GTR Wallet supports 11 languages:

  • English (en)
  • Spanish (es)
  • French (fr)
  • German (de)
  • Italian (it)
  • Portuguese (pt)
  • Russian (ru)
  • Chinese (zh)
  • Japanese (ja)
  • Korean (ko)
  • Arabic (ar) - with RTL support

🀝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Workflow

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

πŸ“„ License

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

πŸ€™ Support

πŸ™ Acknowledgments

  • Tauri Team - For desktop app framework
  • CryptoNote Community - For underlying privacy blockchain technology
  • Fuego Network - For cryptocurrency network & XFG banking ecosystem
  • Contributors - All de-amazing people who contribute to this project

πŸ“Š Project Status

  • Version: 1.0.0
  • Status: Active Development
  • Platforms: Windows, macOS, *Nix
  • Languages: 11 supported
  • Security: Audited and secure

Made with πŸ”₯ by Fuego Mob πŸ…»Δ©πŸ„΅πž

About

πŸ”₯ Desktop XFG wallet app. Features decentralized privacy banking, send/receive XFG, integrated miner & more. Built with Tauri & powered by Fuego L1 Privacy Blockchain Network.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors