feat: surface kyoto sync phase status

Author: reez

BDKSwiftExampleWallet/Extensions/BDK+Extensions/CbfClient+Extensions.swift

@@ -72,6 +72,14 @@ extension CbfClient {
                                 )
                             }
                         }
+                    case .stateUpdate(let nodeState):
+                        await MainActor.run {
+                            NotificationCenter.default.post(
+                                name: NSNotification.Name("KyotoStateUpdate"),
+                                object: nil,
+                                userInfo: ["state": nodeState]
+                            )
+                        }
                     case .connectionsMet, .successfulHandshake:
                         await MainActor.run {
                             if !hasEstablishedConnection {

BDKSwiftExampleWallet/View Model/WalletViewModel.swift

@@ -47,6 +47,7 @@ class WalletViewModel {
     }
     var isKyotoConnected: Bool = false
     var currentBlockHeight: UInt32 = 0
+    var kyotoNodeState: NodeState?
 
     private var updateProgress: @Sendable (UInt64, UInt64) -> Void {
         { [weak self] inspected, total in
@@ -161,6 +162,23 @@ class WalletViewModel {
                 }
             }
         }
+
+        NotificationCenter.default.addObserver(
+            forName: NSNotification.Name("KyotoStateUpdate"),
+            object: nil,
+            queue: .main
+        ) { [weak self] notification in
+            guard let self else { return }
+            if self.bdkClient.getClientType() != .kyoto { return }
+            if let nodeState = notification.userInfo?["state"] as? NodeState {
+                self.kyotoNodeState = nodeState
+                if nodeState == .transactionsSynced {
+                    self.walletSyncState = .synced
+                } else {
+                    self.walletSyncState = .syncing
+                }
+            }
+        }
     }
 
     private func fullScanWithProgress() async {

BDKSwiftExampleWallet/View/Home/ActivityHomeHeaderView.swift

@@ -5,6 +5,7 @@
 //  Created by Rubens Machion on 24/04/25.
 //
 
+import BitcoinDevKit
 import SwiftUI
 
 struct ActivityHomeHeaderView: View {
@@ -17,6 +18,7 @@ struct ActivityHomeHeaderView: View {
     let isKyotoClient: Bool
     let isKyotoConnected: Bool
     let currentBlockHeight: UInt32
+    let kyotoNodeState: NodeState?
 
     let showAllTransactions: () -> Void
 
@@ -40,7 +42,13 @@ struct ActivityHomeHeaderView: View {
                 } else if walletSyncState == .syncing {
                     HStack {
                         if isKyotoClient {
-                            if progress < 100.0 {  // Kyoto progress is percent
+                            if let status = kyotoStatusText {
+                                Text(status)
+                                    .padding(.trailing, -5.0)
+                                    .fontWeight(.semibold)
+                                    .contentTransition(.opacity)
+                                    .transition(.opacity)
+                            } else if progress < 100.0 {  // Kyoto progress is percent
                                 if currentBlockHeight > 0 {
                                     Text("Block \(currentBlockHeight)")
                                         .padding(.trailing, -5.0)
@@ -198,3 +206,28 @@ struct ActivityHomeHeaderView: View {
         }
     }
 }
+
+extension ActivityHomeHeaderView {
+    fileprivate var kyotoStatusText: String? {
+        guard isKyotoClient, let kyotoNodeState else { return nil }
+        // Kyoto's NodeState reflects the next stage it will enter, so describe upcoming work.
+        switch kyotoNodeState {
+        case .behind:
+            // Still acquiring header tips, so call out the header sync explicitly.
+            return "Getting headers..."
+        case .headersSynced:
+            // Kyoto reports this once headers are already finished, so surface the next
+            // actionable phase the node is entering rather than the completed step.
+            return "Preparing filters..."
+        case .filterHeadersSynced:
+            // Filter headers are ready; actual filter scanning starts next.
+            return "Scanning filters..."
+        case .filtersSynced:
+            // Filters are exhausted; the node now gossips for matching blocks/txs.
+            return "Fetching matches..."
+        case .transactionsSynced:
+            // No further phases—fall back to showing percent + standard synced UI.
+            return nil
+        }
+    }
+}

BDKSwiftExampleWallet/View/WalletView.swift

@@ -51,7 +51,8 @@ struct WalletView: View {
                         needsFullScan: viewModel.needsFullScan,
                         isKyotoClient: viewModel.isKyotoClient,
                         isKyotoConnected: viewModel.isKyotoConnected,
-                        currentBlockHeight: viewModel.currentBlockHeight
+                        currentBlockHeight: viewModel.currentBlockHeight,
+                        kyotoNodeState: viewModel.kyotoNodeState
                     ) {
                         showAllTransactions = true
                     }