Repository Public
1// SP Wallet iOS2// File: App/AppModel.swift3// Description: Session and wallet state of the app: launch, passkey sign-in, optional device lock, read-only offline consultation,4// the base data (networks, accounts, portfolio, activity, settings) with their freshness, and refresh scheduling.5// Everything shown comes from the server or from a dated snapshot of what the server said; nothing is made up.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import Foundation10import Observation11import OSLog12import SPWalletCore13import WidgetKit1415/** A value with its provenance: live from the server just now, or a snapshot saved at `savedAt`. */16struct Loaded<T: Sendable>: Sendable {17 var value: T?18 var savedAt: Date?19 /** True when `value` came from the server during this session's last successful refresh. */20 var live = false21 var error: APIError?2223 var isCached: Bool { value != nil && !live }24 mutating func set(live v: T) { value = v; savedAt = Date(); live = true; error = nil }25 mutating func set(cached c: Cached<T>) { value = c.value; savedAt = c.savedAt; live = false }26 mutating func fail(_ e: APIError) { error = e; live = false }27}2829@MainActor @Observable30final class AppModel {31 enum Phase: Equatable { case launching, signedOut, locked, ready }3233 let env: AppEnvironment34 /** Navigation state; kept here so that every presented content can be given the whole environment from the model alone. */35 let router = Router()36 @ObservationIgnored private let log = Logger(subsystem: "ai.spboucher.spwallet.ios", category: "app")3738 var phase: Phase = .launching39 /** Read-only consultation of the last synchronized data, without a session. No operation is offered in this mode. */40 var offlineBrowsing = false41 /** The last request could not reach the server. */42 var offline = false43 var signingIn = false44 var signInError: String?45 var hasOfflineData = false4647 var networks = Loaded<[Network]>()48 var accounts = Loaded<Accounts>()49 var portfolio = Loaded<Portfolio>()50 var activity = Loaded<[ActivityItem]>()51 var settings = Loaded<WalletSettings>()52 var isRefreshing = false5354 @ObservationIgnored private var eventsTask: Task<Void, Never>?55 @ObservationIgnored private var refreshTask: Task<Void, Never>?56 @ObservationIgnored private var backgroundedAt: Date?5758 /** Alerts: polling, unread badge, local notifications (Core/System/AlertCenter.swift). */59 @ObservationIgnored private(set) lazy var alertCenter = AlertCenter(model: self)6061 init(env: AppEnvironment) { self.env = env }6263 // MARK: derived6465 /** Operations (send, swap, approve…) need a live session and a reachable server. */66 var canOperate: Bool { phase == .ready && !offlineBrowsing && !offline }67 var currency: FiatCurrency { settings.value?.currency ?? .cad }68 var hideBalances: Bool { settings.value?.hideBalances ?? false }69 func network(_ id: String) -> Network? { networks.value?.first { $0.id == id } }70 func account(_ network: String) -> Account? { accounts.value?.accounts.first { $0.network == network } }7172 // MARK: lifecycle7374 func bootstrap() async {75 #if DEBUG76 await env.prepareDevStackIfNeeded()77 #endif78 eventsTask?.cancel()79 eventsTask = Task { [weak self] in80 guard let self else { return }81 for await e in await self.env.client.events() where e == .unauthenticated { self.sessionEnded() }82 }83 await loadSnapshots()84 hasOfflineData = portfolio.value != nil85 do {86 let s = try await env.auth.state()87 offline = false88 if s.authenticated { await enter() } else { phase = .signedOut }89 } catch let e as APIError where e.isOffline {90 offline = true91 // no network: with a stored session and snapshots, open in read-only mode behind the device lock92 if await env.client.hasToken, hasOfflineData { offlineBrowsing = true; phase = env.preferences.deviceLock ? .locked : .ready }93 else { phase = .signedOut }94 } catch { phase = .signedOut }95 }9697 private func enter() async {98 offlineBrowsing = false99 phase = env.preferences.deviceLock && DeviceLock.available() != .none ? .locked : .ready100 if phase == .locked { await unlock() }101 await refreshAll()102 startAutoRefresh()103 }104105 func signIn() async {106 guard !signingIn else { return }107 signingIn = true; signInError = nil108 defer { signingIn = false }109 do {110 try await env.auth.login(with: env.passkeys)111 offline = false; offlineBrowsing = false112 phase = .ready // the passkey just verified the person: no second local prompt113 await refreshAll()114 startAutoRefresh()115 } catch PasskeyError.cancelled {116 // dismissed: nothing to report117 } catch PasskeyError.noCredential {118 signInError = String(localized: "Aucune clé d’accès de ce portefeuille n’est disponible sur cet appareil. Ajoute cet appareil depuis un appareil déjà enrôlé (Sécurité → Ajouter une clé d’accès), ou utilise une clé d’accès synchronisée par iCloud.")119 } catch PasskeyError.notAvailable(let why) {120 signInError = String(localized: "Les clés d’accès ne sont pas utilisables pour ce portefeuille sur cet appareil pour le moment.") + "\n" + why121 } catch let e as APIError where e.isOffline {122 offline = true123 signInError = String(localized: "Le serveur du portefeuille est injoignable. Vérifie la connexion.")124 } catch let e as APIError {125 signInError = e.code == "login_failed" ? String(localized: "Le serveur n’a pas reconnu cette clé d’accès.") : e.message126 } catch { signInError = error.localizedDescription }127 }128129 /** Explicit sign-out: the session is revoked on the server and nothing of the wallet stays on the device. */130 func signOut() async {131 stopAutoRefresh()132 await env.auth.logout()133 await wipeLocalData()134 phase = .signedOut135 }136137 func wipeLocalData() async {138 await env.cache.removeAll()139 WidgetSnapshot.erase(appGroup: env.configuration.appGroup)140 WidgetCenter.shared.reloadAllTimelines()141 networks = .init(); accounts = .init(); portfolio = .init(); activity = .init(); settings = .init()142 hasOfflineData = false; offlineBrowsing = false143 alertCenter.reset()144 }145146 /** The server ended the session (30 minutes idle, 12 hours absolute, or revoked). Snapshots stay for read-only consultation. */147 private func sessionEnded() {148 stopAutoRefresh()149 guard phase != .signedOut else { return }150 offlineBrowsing = false151 phase = .signedOut152 markAllCached()153 alertCenter.sessionEnded()154 }155156 private func markAllCached() { networks.live = false; accounts.live = false; portfolio.live = false; activity.live = false; settings.live = false }157158 func browseOffline() async {159 guard hasOfflineData else { return }160 if env.preferences.deviceLock, DeviceLock.available() != .none {161 guard await DeviceLock.unlock(reason: String(localized: "Afficher les dernières données synchronisées du portefeuille")) else { return }162 }163 offlineBrowsing = true164 phase = .ready165 }166167 func leaveOfflineBrowsing() { offlineBrowsing = false; phase = .signedOut }168169 func unlock() async {170 guard phase == .locked else { return }171 if await DeviceLock.unlock(reason: String(localized: "Déverrouiller SP Wallet")) { phase = .ready }172 }173174 func sceneDidEnterBackground() { backgroundedAt = Date(); stopAutoRefresh() }175176 func sceneDidBecomeActive() async {177 if phase == .ready, env.preferences.deviceLock, DeviceLock.available() != .none, let t = backgroundedAt, Date().timeIntervalSince(t) > 60 {178 phase = .locked179 }180 backgroundedAt = nil181 if phase == .locked { await unlock() }182 if phase == .ready, !offlineBrowsing { await refreshAll(); startAutoRefresh() }183 else if phase == .ready, offlineBrowsing { await retryOnline() }184 }185186 /** From offline consultation: try the server again; a still-valid session resumes normally. */187 func retryOnline() async {188 do {189 let s = try await env.auth.state()190 offline = false191 if s.authenticated { offlineBrowsing = false; await refreshAll(); startAutoRefresh() }192 else if offlineBrowsing { /* stay in read-only mode; signing in is offered by the banner */ }193 } catch { offline = true }194 }195196 // MARK: data197198 private func loadSnapshots() async {199 if let c = await env.cache.load([Network].self, key: "networks") { networks.set(cached: c) }200 if let c = await env.cache.load(Accounts.self, key: "accounts") { accounts.set(cached: c) }201 if let c = await env.cache.load(Portfolio.self, key: "portfolio") { portfolio.set(cached: c) }202 if let c = await env.cache.load([ActivityItem].self, key: "activity") { activity.set(cached: c) }203 if let c = await env.cache.load(WalletSettings.self, key: "settings") { settings.set(cached: c) }204 }205206 func refreshAll() async {207 guard phase != .signedOut, !offlineBrowsing || !offline else { return }208 guard !isRefreshing else { return }209 isRefreshing = true210 defer { isRefreshing = false }211 async let n = fetch { try await $0.wallet.networks() }212 async let a = fetch { try await $0.wallet.accounts() }213 async let p = fetch { try await $0.wallet.portfolio() }214 async let h = fetch { try await $0.wallet.activity(limit: 200) }215 async let st = fetch { try await $0.wallet.settings() }216 let (rn, ra, rp, rh, rs) = await (n, a, p, h, st)217 networks = applied(rn, networks, key: "networks"); accounts = applied(ra, accounts, key: "accounts")218 portfolio = applied(rp, portfolio, key: "portfolio"); activity = applied(rh, activity, key: "activity"); settings = applied(rs, settings, key: "settings")219 hasOfflineData = portfolio.value != nil220 publishWidgetSnapshot()221 }222223 func refreshPortfolio() async {224 let r = await fetch { try await $0.wallet.portfolio() }225 portfolio = applied(r, portfolio, key: "portfolio")226 publishWidgetSnapshot()227 }228 /** Background app refresh: the widget snapshot needs the owner's display settings, so the snapshots are loaded first. */229 func backgroundRefresh() async {230 if settings.value == nil { await loadSnapshots() }231 guard settings.value != nil else { return }232 await refreshPortfolio()233 }234 func refreshActivity() async {235 let r = await fetch { try await $0.wallet.activity(limit: 200) }236 activity = applied(r, activity, key: "activity")237 }238239 private func fetch<T: Sendable>(_ call: @escaping @MainActor (AppEnvironment) async throws -> T) async -> Result<T, Error> {240 do { return .success(try await call(env)) } catch { return .failure(error) }241 }242243 private func applied<T: Codable & Sendable>(_ result: Result<T, Error>, _ current: Loaded<T>, key: String) -> Loaded<T> {244 var slot = current245 switch result {246 case .success(let v):247 slot.set(live: v); offline = false248 Task { await env.cache.save(v, key: key) }249 case .failure(let e as APIError):250 slot.fail(e)251 if e.isOffline { offline = true }252 else if !e.isUnauthenticated { log.error("refresh \(key, privacy: .public) failed: \(e.code, privacy: .public)") }253 case .failure: break254 }255 return slot256 }257258 func update(settings new: WalletSettings) async {259 do { settings.set(live: try await env.wallet.update(settings: new)); await env.cache.save(new, key: "settings"); publishWidgetSnapshot() }260 catch let e as APIError { settings.fail(e) } catch {}261 }262263 // MARK: refresh pacing (foreground only; the server caches chain reads for 12 s and prices for 4 minutes)264265 func startAutoRefresh() {266 refreshTask?.cancel()267 refreshTask = Task { [weak self] in268 while !Task.isCancelled {269 // faster while something is in flight, slow otherwise: fewer requests, less battery270 let inFlight = self?.portfolio.value?.pending.contains { $0.state.isInFlight } ?? false271 try? await Task.sleep(for: .seconds(inFlight ? 8 : 45))272 guard !Task.isCancelled, let self, self.phase == .ready, !self.offlineBrowsing else { continue }273 await self.refreshPortfolio()274 if inFlight { await self.refreshActivity() }275 }276 }277 }278 func stopAutoRefresh() { refreshTask?.cancel(); refreshTask = nil }279280 // MARK: widgets281282 func publishWidgetSnapshot() {283 guard let p = portfolio.value else { return }284 let allowed = env.preferences.widgetAmounts && !hideBalances285 let alertFields = alertCenter.widgetFields()286 let total = p.estimatedTotal(in: currency)287 var bySymbol: [String: (name: String, value: Double)] = [:]288 for b in p.balances { if let v = p.estimatedValue(of: b, in: currency), v > 0 { bySymbol[b.symbol, default: (b.name, 0)].value += v } }289 let top = bySymbol.sorted { $0.value.value > $1.value.value }.prefix(4).map { k, v in290 WidgetSnapshot.Asset(symbol: k, name: v.name, value: allowed ? Money.fiat(v.value, currency) : nil, share: total.value > 0 ? v.value / total.value : 0, change24h: p.prices?[k]?.change24h)291 }292 let txs = (activity.value ?? []).prefix(4).map {293 WidgetSnapshot.Transaction(id: $0.id, kind: $0.kind, symbol: $0.symbol, amount: allowed ? $0.amountDisplay : nil, state: $0.state, settled: $0.isSettled, at: $0.at)294 }295 var weighted = 0.0296 for (k, v) in bySymbol { if let c = p.prices?[k]?.change24h, total.value > 0 { weighted += c * v.value / total.value } }297 WidgetSnapshot(savedAt: portfolio.savedAt ?? Date(), signedIn: true, amountsAllowed: allowed,298 total: allowed ? Money.fiat(total.value, currency) : nil, totalComplete: total.complete,299 change24h: bySymbol.isEmpty ? nil : weighted, pricesStale: p.pricesStale, assets: Array(top), transactions: Array(txs),300 unreadAlerts: alertFields.unreadAlerts, criticalAlert: alertFields.criticalAlert, halted: p.halted).write(appGroup: env.configuration.appGroup)301 WidgetCenter.shared.reloadAllTimelines()302 }303}304