CW-1078: Electrum Wallets not reconencting correctly if the OS closes the connection (#2405)

* fix: Electrum Wallets not reconencting correctly if the OS closes the connection

* fix: Electrum connectivity bug. Enahnced checks and reconnect when needed, and Socket health logs page for logs

* fix: Add extra checks

* chore: Migrate to static log list instead of file storage

* fix: Electrum connectivity review comments

This change:
- Adds reset count for used trusted nodes
- Adds context guards for ScaffoldMessenger calls

* fix: Reset the state for _resetCount when there is a wallet switch
This commit is contained in:
David Adegoke
2025-07-31 17:24:54 +03:00
committed by GitHub
parent 723103d429
commit 186247d849
16 changed files with 740 additions and 17 deletions
@@ -0,0 +1,333 @@
import 'package:cake_wallet/di.dart';
import 'package:cake_wallet/src/screens/base_page.dart';
import 'package:cake_wallet/view_model/dev/socket_health_logs_view_model.dart';
import 'package:cw_core/utils/socket_health_logger.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_mobx/flutter_mobx.dart';
import 'package:intl/intl.dart';
import 'package:cake_wallet/store/app_store.dart';
import 'package:cake_wallet/reactions/wallet_utils.dart';
class DevSocketHealthLogsPage extends BasePage {
final SocketHealthLogsViewModel viewModel;
DevSocketHealthLogsPage(this.viewModel) {
viewModel.loadLogs();
}
@override
String? get title => "[dev] socket health logs";
@override
Widget body(BuildContext context) {
return Observer(
builder: (_) {
if (viewModel.logs.isEmpty) {
return Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Text("No logs available"),
SizedBox(height: 16),
ElevatedButton(
onPressed: () => viewModel.loadLogs(),
child: Text("Load Logs"),
),
],
),
);
}
return Column(
children: [
_StatsCard(viewModel),
Expanded(
child: _LogsList(viewModel),
),
_ActionButtons(viewModel),
],
);
},
);
}
}
class _StatsCard extends StatelessWidget {
const _StatsCard(this.viewModel);
final SocketHealthLogsViewModel viewModel;
@override
Widget build(BuildContext context) {
return Card(
margin: EdgeInsets.all(8),
child: Padding(
padding: EdgeInsets.all(16),
child: Observer(
builder: (_) => Column(
children: [
Row(
mainAxisAlignment: MainAxisAlignment.spaceAround,
children: [
_StatItem('Total', viewModel.totalLogs.toString(), Colors.blue),
_StatItem('Healthy', viewModel.healthyLogs.toString(), Colors.green),
_StatItem('Unhealthy', viewModel.unhealthyLogs.toString(), Colors.red),
],
),
SizedBox(height: 8),
if (viewModel.error != null)
Text(
'Error: ${viewModel.error}',
style: TextStyle(fontSize: 12, color: Colors.red),
),
],
),
),
),
);
}
}
class _StatItem extends StatelessWidget {
const _StatItem(this.label, this.value, this.color);
final String label;
final String value;
final Color color;
@override
Widget build(BuildContext context) {
return Column(
children: [
Text(
value,
style: TextStyle(
fontSize: 24,
fontWeight: FontWeight.bold,
color: color,
),
),
Text(
label,
style: TextStyle(
fontSize: 12,
color: Colors.grey[600],
),
),
],
);
}
}
class _LogsList extends StatelessWidget {
const _LogsList(this.viewModel);
final SocketHealthLogsViewModel viewModel;
@override
Widget build(BuildContext context) {
return Observer(
builder: (_) {
final logs = viewModel.logs;
if (logs.isEmpty) {
return Center(child: Text("No logs available"));
}
return ListView.builder(
itemCount: logs.length,
itemBuilder: (context, index) {
final log = logs[index];
return _LogItem(log);
},
);
},
);
}
}
class _LogItem extends StatelessWidget {
const _LogItem(this.log);
final SocketHealthLogEntry log;
@override
Widget build(BuildContext context) {
final dateFormat = DateFormat('MM-dd HH:mm:ss.SSS');
final isHealthy = log.isHealthy;
return Card(
margin: EdgeInsets.symmetric(horizontal: 8, vertical: 2),
color: isHealthy != null ? (isHealthy ? Colors.green[50] : Colors.red[50]) : Colors.grey[50],
child: ListTile(
title: Text(
log.toLogString(),
style: Theme.of(context).textTheme.bodySmall!.copyWith(
fontFamily: 'Monospace',
fontSize: 11,
color: isHealthy != null ? (isHealthy ? Colors.green : Colors.red) : Colors.grey,
),
),
subtitle: Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Text(
'${dateFormat.format(log.timestamp)} | ${log.trigger}',
style: TextStyle(fontSize: 10, color: Colors.grey[600]),
),
if (log.error != null)
Text(
'Error: ${log.error}',
style: TextStyle(fontSize: 10, color: Colors.red),
),
],
),
leading: Icon(
isHealthy != null ? (isHealthy ? Icons.check_circle : Icons.error) : Icons.help,
color: isHealthy != null ? (isHealthy ? Colors.green : Colors.red) : Colors.grey,
),
),
);
}
}
class _ActionButtons extends StatelessWidget {
const _ActionButtons(this.viewModel);
final SocketHealthLogsViewModel viewModel;
void _copyLogsToClipboard(BuildContext context) {
final logsText = viewModel.getLogsAsText();
Clipboard.setData(ClipboardData(text: logsText));
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Logs copied to clipboard'),
duration: Duration(seconds: 2),
),
);
}
}
void _testEnhancedHealthCheck(BuildContext context) async {
final wallet = getIt.get<AppStore>().wallet;
if (wallet == null || !isElectrumWallet(wallet.type)) {
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('No Electrum wallet found'),
backgroundColor: Colors.red,
),
);
}
return;
}
try {
final isHealthy = await wallet.checkSocketHealth();
SocketHealthLogger().logHealthCheck(
walletType: wallet.type,
walletName: wallet.name,
isHealthy: isHealthy,
syncStatus: wallet.syncStatus.toString(),
wasReconnected: true,
trigger: 'manual_enhanced_health_check',
);
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Enhanced health check completed: ${isHealthy ? "Healthy" : "Unhealthy"}'),
backgroundColor: isHealthy ? Colors.green : Colors.red,
),
);
viewModel.loadLogs();
} catch (e) {
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Enhanced health check failed: $e'),
backgroundColor: Colors.red,
),
);
}
}
}
void _refreshLogs(BuildContext context) {
viewModel.loadLogs();
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(
content: Text('Logs refreshed'),
duration: Duration(seconds: 1),
),
);
}
}
@override
Widget build(BuildContext context) {
return Padding(
padding: EdgeInsets.all(16),
child: Column(
children: [
Row(
children: [
Expanded(
child: ElevatedButton(
onPressed: () => viewModel.clearLogs(),
style: ElevatedButton.styleFrom(
backgroundColor: Colors.red,
foregroundColor: Colors.white,
),
child: Text('Clear Logs'),
),
),
SizedBox(width: 16),
Expanded(
child: ElevatedButton(
onPressed: () => _copyLogsToClipboard(context),
child: Text('Copy to Clipboard'),
),
),
],
),
SizedBox(height: 8),
Row(
children: [
Expanded(
child: ElevatedButton(
onPressed: () => _testEnhancedHealthCheck(context),
style: ElevatedButton.styleFrom(
backgroundColor: Colors.purple,
foregroundColor: Colors.white,
),
child: Text('Enhanced Health Check'),
),
),
],
),
SizedBox(height: 8),
Row(
children: [
Expanded(
child: ElevatedButton(
onPressed: () => _refreshLogs(context),
style: ElevatedButton.styleFrom(
backgroundColor: Colors.green,
foregroundColor: Colors.white,
),
child: Text('Refresh'),
),
),
],
),
],
),
);
}
}
@@ -3,7 +3,7 @@ import 'package:cake_wallet/core/new_wallet_type_arguments.dart';
import 'dart:io';
import 'package:cake_wallet/generated/i18n.dart';
import 'package:cake_wallet/reactions/bip39_wallet_utils.dart';
import 'package:cake_wallet/reactions/wallet_utils.dart';
import 'package:cake_wallet/routes.dart';
import 'package:cake_wallet/src/screens/base_page.dart';
import 'package:cake_wallet/src/screens/new_wallet/widgets/select_button.dart';
+25 -1
View File
@@ -5,7 +5,6 @@ import 'package:cake_wallet/core/auth_service.dart';
import 'package:cake_wallet/core/node_switching_service.dart';
import 'package:cake_wallet/core/totp_request_details.dart';
import 'package:cake_wallet/core/trade_monitor.dart';
import 'package:cake_wallet/di.dart';
import 'package:cake_wallet/utils/device_info.dart';
import 'package:cake_wallet/view_model/link_view_model.dart';
import 'package:cw_core/utils/print_verbose.dart';
@@ -20,6 +19,8 @@ import 'package:cake_wallet/entities/qr_scanner.dart';
import 'package:mobx/mobx.dart';
import 'package:uni_links/uni_links.dart';
import 'package:cake_wallet/src/screens/setup_2fa/setup_2fa_enter_code_page.dart';
import 'package:cake_wallet/reactions/wallet_utils.dart';
import 'package:cw_core/utils/socket_health_logger.dart';
class Root extends StatefulWidget {
Root({
@@ -169,6 +170,29 @@ class RootState extends State<Root> with WidgetsBindingObserver {
// Trigger node health check when app resumes
widget.nodeSwitchingService.performHealthCheck();
// Electrum Wallet socket health check and reconnection flow
final wallet = widget.appStore.wallet;
if (wallet != null && isElectrumWallet(wallet.type)) {
SocketHealthLogger().logHealthCheck(
walletType: wallet.type,
walletName: wallet.name,
syncStatus: wallet.syncStatus.toString(),
wasReconnected: false,
trigger: 'app_resume',
);
wallet.checkSocketHealth().then((isHealthy) {
SocketHealthLogger().logHealthCheck(
walletType: wallet.type,
walletName: wallet.name,
isHealthy: isHealthy,
syncStatus: wallet.syncStatus.toString(),
wasReconnected: true,
trigger: 'app_resume_socket_health_check',
);
});
}
break;
default:
break;
@@ -93,6 +93,12 @@ class OtherSettingsPage extends BasePage {
handler: (BuildContext context) =>
Navigator.of(context).pushNamed(Routes.devBackgroundSyncLogs),
),
if (FeatureFlag.hasDevOptions)
SettingsCellWithArrow(
title: '[dev] socket health logs',
handler: (BuildContext context) =>
Navigator.of(context).pushNamed(Routes.devSocketHealthLogs),
),
if (FeatureFlag.hasDevOptions)
SettingsCellWithArrow(
title: '[dev] network requests logs',