Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Features/Send/SendFlow.swift3// Description: State machine of a transfer: form → server draft (validation, simulation, policy pre-check) → frozen intent verified against its challenge → passkey assertion → signer → broadcast → confirmations. The client decides nothing about success: every state shown is the server's, itself read from the chain.4import Foundation5import SPWalletCore67@MainActor @Observable final class SendFlow {8 enum Step: Equatable { case form, preparing, review, approving, tracking }910 let model: AppModel11 var network = ""12 var asset = "native"13 var to = ""14 var amount = ""15 var memo = ""16 var note = ""1718 private(set) var step: Step = .form19 private(set) var draft: Proposal?20 private(set) var approval: TransferApproval?21 private(set) var tracked: Proposal?22 private(set) var history: [(Date, ProposalState)] = []23 var error: String?24 /// Kept while the form does not change, so a retried preparation answers the same draft instead of creating a second one.25 private var idempotency: (key: String, fingerprint: String)?26 private var trackTask: Task<Void, Never>?2728 init(model: AppModel) { self.model = model }2930 var net: SPWalletCore.Network? { model.network(network) }31 var assetDef: AssetDef? { net?.asset(asset) }32 var balance: Balance? { model.portfolio?.value.balances.first { $0.network == network && $0.asset == asset } }33 var addressCheck: AddressCheck? { guard let n = net, !to.trimmingCharacters(in: .whitespaces).isEmpty else { return nil }; return AddressValidator.check(to, network: n) }34 var otherNetworks: [SPWalletCore.Network] {35 guard let all = model.networks?.value, addressCheck?.isValid == false else { return [] }36 return AddressValidator.plausibleNetworks(for: to, among: all).filter { $0.id != network }37 }38 var parsedAmount: BaseUnits? { guard let d = assetDef?.decimals else { return nil }; return try? BaseUnits.parse(normalizedAmount, decimals: d) }39 var normalizedAmount: String { amount.trimmingCharacters(in: .whitespaces).replacingOccurrences(of: ",", with: ".").replacingOccurrences(of: "\u{202F}", with: "").replacingOccurrences(of: " ", with: "") }40 var exceedsBalance: Bool { guard let a = parsedAmount, let b = balance?.units else { return false }; return a > b }41 var isOwnAddress: Bool { guard let n = addressCheck?.normalized else { return false }; return model.address(on: network) == n }4243 var formProblem: String? {44 guard net != nil, assetDef != nil else { return "Choisissez un réseau et un actif." }45 switch addressCheck {46 case nil: return "Entrez l’adresse du destinataire."47 case .invalid(let r): return SendFlow.text(r)48 case .unverifiable, .valid: break49 }50 if isOwnAddress { return "La destination est l’adresse de ce portefeuille." }51 if amount.isEmpty { return "Entrez un montant." }52 guard let a = parsedAmount, !a.isZero else { return "Montant invalide (au plus \(assetDef?.decimals ?? 0) décimales)." }53 if balance?.isAvailable == true, exceedsBalance { return "Montant supérieur au solde lu sur la chaîne." }54 if let m = net?.memo, m == "uint32", !memo.isEmpty, UInt32(memo) == nil { return "L’étiquette de destination doit être un entier." }55 return nil56 }5758 static func text(_ r: AddressRejection) -> String {59 switch r {60 case .malformed: "Ce n’est pas la forme d’une adresse de ce réseau."61 case .badChecksum: "Somme de contrôle invalide : un caractère est probablement erroné."62 case .mixedCase: "Majuscules et minuscules mélangées : adresse invalide pour cet encodage."63 case .wrongNetwork: "Adresse bien formée, mais d’un autre réseau."64 case .unsupportedType: "Type d’adresse que ce portefeuille n’envoie pas."65 case .reserved: "Adresse nulle ou de destruction : les fonds y seraient perdus."66 case .nonCanonical: "Adresse non canonique : utilisez sa forme standard."67 }68 }6970 func setMax() { if let b = balance, let d = b.display { amount = d } }7172 func prepare() async {73 guard formProblem == nil, model.canOperate, step == .form else { return }74 error = nil; step = .preparing75 let req = TransferRequest(network: network, asset: asset, to: to.trimmingCharacters(in: .whitespacesAndNewlines), amount: normalizedAmount, note: note, memo: memo.isEmpty ? nil : memo)76 let fp = "\(req.network)|\(req.asset)|\(req.to)|\(req.amount)|\(req.note)|\(req.memo ?? "")"77 if idempotency?.fingerprint != fp { idempotency = (APIClient.newIdempotencyKey(), fp) }78 do {79 let d = try await model.transfers.draft(req, idempotencyKey: idempotency!.key)80 // the draft must be the transfer that was typed: the server normalizes the address, nothing else may differ81 guard d.network == req.network, d.asset == req.asset, d.amount == (parsedAmount?.description ?? "") else { throw ApprovalError.inconsistent("le brouillon du serveur ne correspond pas au formulaire") }82 if let local = addressCheck?.normalized, let dto = d.to, local != dto { throw ApprovalError.inconsistent("destination normalisée différemment par le serveur") }83 guard d.state == .draft || d.state == .pendingApproval else { throw APIError(status: 409, code: "bad_state", message: "Cette demande a déjà été traitée (\(ErrorText.state(d.state))). Modifiez le formulaire pour en créer une nouvelle.") }84 draft = d85 approval = try await model.transfers.requestApproval(for: d)86 step = .review87 } catch { self.error = model.describe(error); step = .form }88 }8990 func approve() async {91 guard let a = approval, step == .review else { return }92 error = nil; step = .approving93 do {94 let p = try await model.transfers.approve(a, with: model.authenticator)95 idempotency = nil96 begin(tracking: p)97 } catch PasskeyError.cancelled { step = .review }98 catch let e as APIError where e.isOffline {99 // the answer was lost: the approval may have reached the signer — never sign twice, follow the proposal instead100 self.error = "Réponse perdue pendant l’approbation. Lecture de l’état réel de l’opération…"101 if let p = try? await model.transfers.proposal(a.proposal.id), p.state != .pendingApproval { idempotency = nil; begin(tracking: p) } else { step = .review }102 }103 catch {104 self.error = model.describe(error)105 if let p = try? await model.transfers.proposal(a.proposal.id), p.state != .pendingApproval { idempotency = nil; begin(tracking: p) } else { step = .review }106 }107 }108109 func reject() async {110 guard let a = approval else { return }111 _ = try? await model.transfers.reject(a.proposal.id)112 idempotency = nil; approval = nil; draft = nil; step = .form113 }114115 private func begin(tracking p: Proposal) {116 tracked = p; history = [(Date(), p.state)]; step = .tracking117 Task { await model.refreshActivity() }118 trackTask?.cancel()119 trackTask = Task { [weak self] in120 while !Task.isCancelled {121 guard let self, let cur = self.tracked, !cur.state.isTerminal else { return }122 try? await Task.sleep(for: .seconds(cur.state == .broadcast || cur.state == .confirming ? 5 : 2))123 guard let p = try? await self.model.transfers.proposal(cur.id) else { continue }124 if p.state != self.tracked?.state { self.history.append((Date(), p.state)); if p.state.isTerminal { Notifier.proposal(p); await self.model.refreshAll() } }125 self.tracked = p126 }127 }128 }129130 func reset() {131 trackTask?.cancel(); tracked = nil; approval = nil; draft = nil; history = []; error = nil132 to = ""; amount = ""; memo = ""; note = ""; idempotency = nil; step = .form133 }134}135