fix(xelis): restore wallet integration with XWF

docs/building.md

@@ -4,6 +4,10 @@ Here you will find instructions on how to install the necessary tools for buildi
 
 ## Prerequisites
 
+- Xelis requires Flutter 3.47 or newer and Rustup. Native Assets builds the
+  native wallet library and installs its pinned Rust toolchain automatically.
+  Android builds require NDK r28 or newer.
+
 - The only OS supported for building Android and Linux desktop is Ubuntu 24.04.  Windows builds require using Ubuntu 24.04 on WSL2.  macOS builds for itself and iOS.  Advanced users may also be able to build on other Debian-based distributions like Linux Mint.
 - Android setup ([Android Studio](https://developer.android.com/studio) and subsequent dependencies)
 - 100 GB of storage
@@ -14,7 +18,7 @@ Here you will find instructions on how to install the necessary tools for buildi
 The following instructions are for building and running on a Linux host.  Alternatively, see the [Mac](#mac-host) and/or [Windows](#windows-host) section.  This entire section (except for the Android Studio section) needs to be completed in WSL if building on a Windows host.
 
 ### Flutter
-Install Flutter 3.38.5 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk).  Run `flutter doctor` in a terminal to confirm its installation.
+Install Flutter 3.47.2 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk).  Run `flutter doctor` in a terminal to confirm its installation.
 
 ### Android Studio
 Install Android Studio.  Follow instructions here [https://developer.android.com/studio/install#linux](https://developer.android.com/studio/install#linux) or install via snap:
@@ -69,7 +73,7 @@ pip3 install --upgrade meson==0.64.1 markdown==3.4.1 markupsafe==2.1.1 jinja2==3
 ```
 
 ### Flutter
-Install Flutter 3.38.5 by [following their guide](https://docs.flutter.dev/install/manual).
+Install Flutter 3.47.2 by [following their guide](https://docs.flutter.dev/install/manual).
 
 Run `flutter doctor` in a terminal to confirm its installation.
 
@@ -220,7 +224,7 @@ rustup target add aarch64-apple-ios aarch64-apple-darwin
 Optionally download [Android Studio](https://developer.android.com/studio) as an IDE and activate its Dart and Flutter plugins.  VS Code may work as an alternative, but this is not recommended.
 
 ### Flutter
-Install 3.38.5 on your Mac host by [following their guide](https://docs.flutter.dev/install/manual).  Run `flutter doctor` in a terminal to confirm its installation.
+Install Flutter 3.47.2 on your Mac host by [following their guide](https://docs.flutter.dev/install/manual).  Run `flutter doctor` in a terminal to confirm its installation.
 
 ### Build plugins and configure
 #### Building plugins for iOS 
@@ -300,7 +304,7 @@ If the DLL was built on the WSL filesystem instead of on Windows, copy `stack_wa
 Frostdart will be built by the Windows host later.
 
 ### Install Flutter on Windows host
-Install Flutter 3.38.5 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/install/manual).  Run `flutter doctor` in PowerShell to confirm its installation.
+Install Flutter 3.47.2 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/install/manual).  Run `flutter doctor` in PowerShell to confirm its installation.
 
 ### Rust
 Install [Rust](https://www.rust-lang.org/tools/install) on the Windows host (not in WSL2).  Download the installer from [rustup.rs](https://rustup.rs), make sure it works on the commandline (you may need to open a new terminal), and install the following versions:
@@ -363,6 +367,27 @@ dart run coinlib:build_windows
 flutter run -d windows
 ```
 
+## Xelis tests
+
+Run on a configured desktop target (`windows`, `linux`, or `macos`) with
+the application's native plugin dependencies:
+
+```sh
+flutter test integration_test/xelis/xelis_adapter_test.dart -d windows
+flutter test integration_test/xelis/xelis_restore_test.dart -d windows
+flutter test integration_test/xelis/xelis_swb_test.dart -d windows
+```
+
+The transfer test starts a temporary devnet node using a host `xelis_daemon`
+1.25 executable:
+
+```sh
+flutter test integration_test/xelis/xelis_local_transfer_test.dart -d windows \
+  --dart-define=XELIS_LOCAL_DAEMON=/absolute/path/to/xelis_daemon
+```
+
+Missing `XELIS_LOCAL_DAEMON` or an invalid path fails the test.
+
 # Troubleshooting
 
 Run with `-v` or `--verbose` to see a more detailed error.  Certain exceptions (like missing a plugin library) may not report quality errors without `verbose`, especially on Windows.

integration_test/xelis/xelis_adapter_test.dart

@@ -0,0 +1,64 @@
+import 'dart:io';
+
+import 'package:flutter_test/flutter_test.dart';
+import 'package:integration_test/integration_test.dart';
+import 'package:path/path.dart' as path;
+
+import 'package:stackwallet/wallets/crypto_currency/crypto_currency.dart';
+import 'package:stackwallet/wl_gen/interfaces/lib_xelis_interface.dart';
+
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+  testWidgets(
+    'Stack adapter opens native storage and exposes typed zero state',
+    (tester) async {
+      await libXelis.initRustLib();
+      final root = await Directory.systemTemp.createTemp(
+        'stack_xelis_adapter_',
+      );
+      final tableDirectory = await Directory(path.join(root.path, 'table'))
+          .create();
+      final tablesPath = '${tableDirectory.path}${Platform.pathSeparator}';
+      OpaqueXelisWallet? wallet;
+      try {
+        wallet = await libXelis.createXelisWallet(
+          'wallet',
+          name: 'wallet',
+          directory: root.path,
+          password: 'isolated-fixture-password',
+          network: CryptoCurrencyNetwork.test,
+          precomputedTablesPath: tablesPath,
+          stack_l1Low: true,
+        );
+        expect(
+          await Directory(path.join(root.path, 'wallet')).exists(),
+          isTrue,
+        );
+        expect(await libXelis.getXelisBalanceRaw(wallet), BigInt.zero);
+        expect(await libXelis.allHistory(wallet), isEmpty);
+        expect(
+          libXelis.isAddressValid(
+            address: libXelis.getAddress(wallet),
+            network: CryptoCurrencyNetwork.test,
+          ),
+          isTrue,
+        );
+        expect(
+          libXelis.isAddressValid(
+            address: libXelis.getAddress(wallet),
+            network: CryptoCurrencyNetwork.main,
+          ),
+          isFalse,
+        );
+        final runtime = await libXelis.subscribeRuntimeEvents(wallet);
+        final business = await libXelis.subscribeBusinessEvents(wallet);
+        await runtime.cancel();
+        await business.cancel();
+      } finally {
+        if (wallet != null) await libXelis.closeWallet(wallet);
+        await root.delete(recursive: true);
+      }
+    },
+    timeout: const Timeout(Duration(minutes: 2)),
+  );
+}