feat: add monero_wallet: URI scanning for wallet restoration

sneurlax · sneurlax · commit 5ca439fc868f · 2026-03-02T10:48:10.000-06:00
closes cypherstack#1261
diff --git a/lib/pages/add_wallet_views/restore_wallet_view/restore_options_view/restore_options_view.dart b/lib/pages/add_wallet_views/restore_wallet_view/restore_options_view/restore_options_view.dart
@@ -8,6 +8,8 @@
  *
  */
 
+import 'dart:async';
+
 import 'package:dropdown_button2/dropdown_button2.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
@@ -16,13 +18,17 @@ import 'package:flutter_svg/svg.dart';
 import 'package:logger/logger.dart';
 import 'package:tuple/tuple.dart';
 
+import '../../../../notifications/show_flush_bar.dart';
 import '../../../../pages_desktop_specific/my_stack_view/exit_to_my_stack_button.dart';
+import '../../../../providers/providers.dart';
 import '../../../../providers/ui/verify_recovery_phrase/mnemonic_word_count_state_provider.dart';
 import '../../../../themes/stack_colors.dart';
 import '../../../../utilities/assets.dart';
+import '../../../../utilities/barcode_scanner_interface.dart';
 import '../../../../utilities/constants.dart';
 import '../../../../utilities/format.dart';
 import '../../../../utilities/logger.dart';
+import '../../../../utilities/monero_wallet_uri.dart';
 import '../../../../utilities/text_styles.dart';
 import '../../../../utilities/util.dart';
 import '../../../../wallets/crypto_currency/crypto_currency.dart';
@@ -34,6 +40,7 @@ import '../../../../widgets/custom_buttons/blue_text_button.dart';
 import '../../../../widgets/date_picker/date_picker.dart';
 import '../../../../widgets/desktop/desktop_app_bar.dart';
 import '../../../../widgets/desktop/desktop_scaffold.dart';
+import '../../../../widgets/desktop/secondary_button.dart';
 import '../../../../widgets/expandable.dart';
 import '../../../../widgets/icon_widgets/x_icon.dart';
 import '../../../../widgets/rounded_white_container.dart';
@@ -170,6 +177,79 @@ class _RestoreOptionsViewState extends ConsumerState<RestoreOptionsView> {
     }
   }
 
+  /// Scan a monero_wallet: QR code and route to the appropriate restore view.
+  Future<void> _scanWalletUri() async {
+    try {
+      final qrResult = await ref.read(pBarcodeScanner).scan(context: context);
+      final rawContent = qrResult.rawContent ?? "";
+
+      final walletUri = MoneroWalletUriData.parse(rawContent);
+      if (walletUri == null) {
+        if (mounted) {
+          unawaited(
+            showFloatingFlushBar(
+              type: FlushBarType.warning,
+              message: "Not a valid monero_wallet: URI",
+              context: context,
+            ),
+          );
+        }
+        return;
+      }
+
+      if (walletUri.isSeedRestore) {
+        if (mounted) {
+          final words = walletUri.seed!.split(' ');
+          await Navigator.of(context).pushNamed(
+            RestoreWalletView.routeName,
+            arguments: (
+              walletName: walletName,
+              coin: coin,
+              seedWordsLength: words.length,
+              restoreBlockHeight: walletUri.height ?? 0,
+              mnemonicPassphrase: "",
+              initialMnemonic: words,
+            ),
+          );
+        }
+      } else if (walletUri.isViewKeyRestore) {
+        if (mounted) {
+          await Navigator.of(context).pushNamed(
+            RestoreViewOnlyWalletView.routeName,
+            arguments: (
+              walletName: walletName,
+              coin: coin,
+              restoreBlockHeight: walletUri.height ?? 0,
+              initialAddress: walletUri.address,
+              initialViewKey: walletUri.privateViewKey,
+            ),
+          );
+        }
+      }
+    } on PlatformException catch (e, s) {
+      if (mounted) {
+        try {
+          await checkCamPermDeniedMobileAndOpenAppSettings(
+            context,
+            logging: Logging.instance,
+          );
+        } catch (e, s) {
+          Logging.instance.e(
+            "Failed to check cam permissions",
+            error: e,
+            stackTrace: s,
+          );
+        }
+      } else {
+        Logging.instance.e(
+          "Wallet URI qr scan failed: $e",
+          error: e,
+          stackTrace: s,
+        );
+      }
+    }
+  }
+
   Future<void> chooseDate() async {
     // check and hide keyboard
     if (FocusScope.of(context).hasFocus) {
@@ -355,6 +435,17 @@ class _RestoreOptionsViewState extends ConsumerState<RestoreOptionsView> {
                       chooseMnemonicLength: chooseMnemonicLength,
                     ),
               if (!isDesktop) const Spacer(flex: 3),
+              if (coin is Monero || coin is Wownero)
+                Padding(
+                  padding: EdgeInsets.only(
+                    top: isDesktop ? 16 : 8,
+                    bottom: isDesktop ? 16 : 8,
+                  ),
+                  child: SecondaryButton(
+                    label: "Scan wallet URI",
+                    onPressed: _scanWalletUri,
+                  ),
+                ),
               SizedBox(height: isDesktop ? 32 : 12),
               RestoreOptionsNextButton(
                 isDesktop: isDesktop,
diff --git a/lib/pages/add_wallet_views/restore_wallet_view/restore_view_only_wallet_view.dart b/lib/pages/add_wallet_views/restore_wallet_view/restore_view_only_wallet_view.dart
@@ -49,6 +49,8 @@ class RestoreViewOnlyWalletView extends ConsumerStatefulWidget {
     required this.coin,
     required this.restoreBlockHeight,
     this.clipboard = const ClipboardWrapper(),
+    this.initialAddress,
+    this.initialViewKey,
   });
 
   static const routeName = "/restoreViewOnlyWallet";
@@ -58,6 +60,13 @@ class RestoreViewOnlyWalletView extends ConsumerStatefulWidget {
   final int restoreBlockHeight;
   final ClipboardInterface clipboard;
 
+  /// Optional pre-populated address (e.g. from a monero_wallet: URI scan).
+  final String? initialAddress;
+
+  /// Optional pre-populated private view key
+  /// (e.g. from a monero_wallet: URI scan).
+  final String? initialViewKey;
+
   @override
   ConsumerState<RestoreViewOnlyWalletView> createState() =>
       _RestoreViewOnlyWalletViewState();
@@ -326,6 +335,20 @@ class _RestoreViewOnlyWalletViewState
     } else if (widget.coin is CryptonoteCurrency) {
       _walletType = ViewOnlyWalletType.cryptonote;
     }
+
+    // Pre-populate fields if initial values are provided (e.g. from a
+    // monero_wallet: URI scan).
+    if (widget.initialAddress != null) {
+      addressController.text = widget.initialAddress!;
+    }
+    if (widget.initialViewKey != null) {
+      viewKeyController.text = widget.initialViewKey!;
+    }
+    if (widget.initialAddress != null || widget.initialViewKey != null) {
+      _enableRestoreButton =
+          addressController.text.isNotEmpty &&
+          viewKeyController.text.isNotEmpty;
+    }
   }
 
   @override
diff --git a/lib/pages/add_wallet_views/restore_wallet_view/restore_wallet_view.dart b/lib/pages/add_wallet_views/restore_wallet_view/restore_wallet_view.dart
@@ -32,6 +32,7 @@ import '../../../themes/stack_colors.dart';
 import '../../../utilities/address_utils.dart';
 import '../../../utilities/assets.dart';
 import '../../../utilities/barcode_scanner_interface.dart';
+import '../../../utilities/monero_wallet_uri.dart';
 import '../../../utilities/clipboard_interface.dart';
 import '../../../utilities/constants.dart';
 import '../../../utilities/custom_text_selection_controls.dart';
@@ -68,6 +69,7 @@ import '../add_token_view/edit_wallet_tokens_view.dart';
 import '../select_wallet_for_token_view.dart';
 import '../verify_recovery_phrase_view/verify_recovery_phrase_view.dart';
 import 'confirm_recovery_dialog.dart';
+import 'restore_view_only_wallet_view.dart';
 import 'sub_widgets/restore_failed_dialog.dart';
 import 'sub_widgets/restore_succeeded_dialog.dart';
 import 'sub_widgets/restoring_dialog.dart';
@@ -81,6 +83,7 @@ class RestoreWalletView extends ConsumerStatefulWidget {
     required this.mnemonicPassphrase,
     required this.restoreBlockHeight,
     this.clipboard = const ClipboardWrapper(),
+    this.initialMnemonic,
   });
 
   static const routeName = "/restoreWallet";
@@ -93,6 +96,10 @@ class RestoreWalletView extends ConsumerStatefulWidget {
 
   final ClipboardInterface clipboard;
 
+  /// Optional pre-populated mnemonic words
+  /// (e.g. from a monero_wallet: URI scan).
+  final List<String>? initialMnemonic;
+
   @override
   ConsumerState<RestoreWalletView> createState() => _RestoreWalletViewState();
 }
@@ -163,6 +170,15 @@ class _RestoreWalletViewState extends ConsumerState<RestoreWalletView> {
       // _focusNodes.add(FocusNode());
     }
 
+    // Pre-populate mnemonic words if provided (e.g. from a
+    // monero_wallet: URI scan).
+    if (widget.initialMnemonic != null &&
+        widget.initialMnemonic!.isNotEmpty) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        _clearAndPopulateMnemonic(widget.initialMnemonic!);
+      });
+    }
+
     super.initState();
   }
 
@@ -613,7 +629,49 @@ class _RestoreWalletViewState extends ConsumerState<RestoreWalletView> {
     try {
       final qrResult = await ref.read(pBarcodeScanner).scan(context: context);
 
-      final results = AddressUtils.decodeQRSeedData(qrResult.rawContent ?? "");
+      final rawContent = qrResult.rawContent ?? "";
+
+      // Try parsing as a monero_wallet: URI first (for Monero/Wownero coins).
+      if (widget.coin is Monero || widget.coin is Wownero) {
+        final walletUri = MoneroWalletUriData.parse(rawContent);
+        if (walletUri != null) {
+          if (walletUri.isSeedRestore) {
+            final words = walletUri.seed!.split(' ');
+            if (words.isNotEmpty) {
+              _clearAndPopulateMnemonic(words);
+              Logging.instance.i(
+                "mnemonic populated from monero_wallet: URI",
+              );
+            }
+            return;
+          } else if (walletUri.isViewKeyRestore) {
+            if (mounted) {
+              unawaited(
+                showFloatingFlushBar(
+                  type: FlushBarType.info,
+                  message:
+                      "View-key wallet URI detected. Opening view-only restore.",
+                  context: context,
+                ),
+              );
+              await Navigator.of(context).pushNamed(
+                RestoreViewOnlyWalletView.routeName,
+                arguments: (
+                  walletName: widget.walletName,
+                  coin: widget.coin,
+                  restoreBlockHeight: walletUri.height ?? 0,
+                  initialAddress: walletUri.address,
+                  initialViewKey: walletUri.privateViewKey,
+                ),
+              );
+            }
+            return;
+          }
+        }
+      }
+
+      // Fall back to the existing JSON-encoded mnemonic QR format.
+      final results = AddressUtils.decodeQRSeedData(rawContent);
 
       if (results["mnemonic"] != null) {
         final list = (results["mnemonic"] as List)
diff --git a/lib/route_generator.dart b/lib/route_generator.dart
@@ -1641,6 +1641,28 @@ class RouteGenerator {
         return _routeError("${settings.name} invalid args: ${args.toString()}");
 
       case RestoreWalletView.routeName:
+        if (args
+            is ({
+              String walletName,
+              CryptoCurrency coin,
+              int seedWordsLength,
+              int restoreBlockHeight,
+              String mnemonicPassphrase,
+              List<String>? initialMnemonic,
+            })) {
+          return getRoute(
+            shouldUseMaterialRoute: useMaterialPageRoute,
+            builder: (_) => RestoreWalletView(
+              walletName: args.walletName,
+              coin: args.coin,
+              seedWordsLength: args.seedWordsLength,
+              restoreBlockHeight: args.restoreBlockHeight,
+              mnemonicPassphrase: args.mnemonicPassphrase,
+              initialMnemonic: args.initialMnemonic,
+            ),
+            settings: RouteSettings(name: settings.name),
+          );
+        }
         if (args is Tuple5<String, CryptoCurrency, int, int, String>) {
           return getRoute(
             shouldUseMaterialRoute: useMaterialPageRoute,
@@ -1657,6 +1679,26 @@ class RouteGenerator {
         return _routeError("${settings.name} invalid args: ${args.toString()}");
 
       case RestoreViewOnlyWalletView.routeName:
+        if (args
+            is ({
+              String walletName,
+              CryptoCurrency coin,
+              int restoreBlockHeight,
+              String? initialAddress,
+              String? initialViewKey,
+            })) {
+          return getRoute(
+            shouldUseMaterialRoute: useMaterialPageRoute,
+            builder: (_) => RestoreViewOnlyWalletView(
+              walletName: args.walletName,
+              coin: args.coin,
+              restoreBlockHeight: args.restoreBlockHeight,
+              initialAddress: args.initialAddress,
+              initialViewKey: args.initialViewKey,
+            ),
+            settings: RouteSettings(name: settings.name),
+          );
+        }
         if (args
             is ({
               String walletName,
diff --git a/lib/utilities/monero_wallet_uri.dart b/lib/utilities/monero_wallet_uri.dart
