Repository Public
1// SP Wallet iOS2// File: Features/Send/SendFlow.swift3// Description: Sending, step by step: network and asset, recipient (typed, pasted, scanned or from the address book — always4// validated), amount, then the server's preparation (fees, simulation, limits), the review of the exact intent, the5// passkey approval bound to that intent, and the follow-up until the network confirms. The isolated signer signs;6// this device never holds a key. Nothing is sent without the owner's passkey on the reviewed intent.7//8// Author: Simon-Pierre Boucher9// Contact: contact@spboucher.ai10import SwiftUI11import SPWalletCore1213@MainActor @Observable14final class SendModel {15 enum Step: Equatable { case form, review, tracking }16 var step: Step = .form17 var network: String?18 var asset: String = "native"19 var recipient = ""20 var amount = ""21 var memo = ""22 var note = ""23 var busy = false24 var error: Error?25 var draft: Proposal?26 var approval: TransferApproval?27 var submitted: Proposal?28 /** One key per distinct request: retrying the same request after a lost answer returns the same draft instead of a second one. */29 private var idempotency: (key: String, request: TransferRequest)?3031 func request() -> TransferRequest? {32 guard let network else { return nil }33 return TransferRequest(network: network, asset: asset, to: recipient.trimmingCharacters(in: .whitespacesAndNewlines),34 amount: amount.trimmingCharacters(in: .whitespaces), note: note, memo: memo.isEmpty ? nil : memo)35 }3637 private func key(for r: TransferRequest) -> String {38 if let i = idempotency, i.request == r { return i.key }39 let k = APIClient.newIdempotencyKey()40 idempotency = (k, r)41 return k42 }4344 /** Server preparation: validation, simulation, limits, then the frozen intent and its challenge, verified locally. */45 func prepare(_ env: AppEnvironment) async {46 guard let r = request(), !busy else { return }47 busy = true; error = nil48 defer { busy = false }49 do {50 let d = try await env.transfers.draft(r, idempotencyKey: key(for: r))51 // the draft must be the request (the server normalizes the address: compared case-insensitively only where the family allows)52 guard d.network == r.network, d.asset == r.asset else { throw ApprovalError.inconsistent("draft") }53 draft = d54 approval = try await env.transfers.requestApproval(for: d)55 step = .review56 } catch { self.error = error }57 }5859 /** Re-issue the challenge for the same draft (the approval window is short). */60 func refreshApproval(_ env: AppEnvironment) async {61 guard let d = draft, !busy else { return }62 busy = true; error = nil63 defer { busy = false }64 do { approval = try await env.transfers.requestApproval(for: d) } catch { self.error = error }65 }6667 func approve(_ env: AppEnvironment) async {68 guard let a = approval, !busy else { return }69 busy = true; error = nil70 defer { busy = false }71 do {72 submitted = try await env.transfers.approve(a, with: env.passkeys)73 step = .tracking74 } catch PasskeyError.cancelled {75 // sheet dismissed: nothing signed, the proposal stays pending and can be approved or refused76 } catch let e as APIError where e.isOffline {77 // the answer was lost AFTER the assertion left: do not sign again — read the real state instead78 if let p = try? await env.transfers.proposal(a.proposal.id), p.state != .pendingApproval { submitted = p; step = .tracking } else { error = e }79 } catch { self.error = error }80 }8182 func reject(_ env: AppEnvironment) async {83 guard let d = draft else { return }84 _ = try? await env.transfers.reject(d.id)85 draft = nil; approval = nil; idempotency = nil; step = .form86 }87}8889struct SendFlow: View {90 @Environment(AppModel.self) private var model91 @Environment(\.dismiss) private var dismiss92 let initialNetwork: String?93 let initialAsset: String?94 @State private var send = SendModel()95 @State private var scanning = false96 @State private var scanNotice: String?97 @State private var showBook = false98 @State private var confirmCancel = false99 @FocusState private var typing: Bool100101 var body: some View {102 NavigationStack {103 ScrollView {104 VStack(alignment: .leading, spacing: Theme.Space.section) {105 if !model.canOperate { Notice(tone: .warn, title: String(localized: "Envoi indisponible hors ligne"), message: String(localized: "Un envoi exige le serveur, le signataire isolé et ta clé d’accès.")) }106 switch send.step {107 case .form: form108 case .review: review109 case .tracking: tracking110 }111 }112 .padding(.horizontal, Theme.Space.gutter).padding(.vertical, 12)113 .frame(maxWidth: 620).frame(maxWidth: .infinity)114 }115 .spPage()116 .scrollDismissesKeyboard(.interactively)117 .navigationTitle(title).navigationBarTitleDisplayMode(.inline)118 .toolbar {119 ToolbarItemGroup(placement: .keyboard) { Spacer(); Button(String(localized: "Terminé")) { typing = false }.accessibilityIdentifier("send.keyboardDone") }120 ToolbarItem(placement: .cancellationAction) {121 Button(send.step == .tracking ? String(localized: "Fermer") : String(localized: "Annuler")) {122 if send.step == .review { confirmCancel = true } else { dismiss() }123 }.accessibilityIdentifier("send.close")124 }125 }126 .confirmationDialog(String(localized: "Refuser cette opération ?"), isPresented: $confirmCancel, titleVisibility: .visible) {127 Button(String(localized: "Refuser et fermer"), role: .destructive) { Task { await send.reject(model.env); dismiss() } }128 Button(String(localized: "Continuer la revue"), role: .cancel) {}129 } message: { Text(String(localized: "Rien n’a été signé. La proposition sera marquée refusée.")) }130 .sheet(isPresented: $scanning) { QRScannerSheet { handleScan($0) } }131 .sheet(isPresented: $showBook) { AddressBookPicker(network: send.network) { send.recipient = $0.address; showBook = false }.wallet(model) }132 .onAppear { if send.network == nil { send.network = initialNetwork; send.asset = initialAsset ?? "native" } }133 }134 .presentationSizing(.page)135 // an approval is never dismissed by an accidental swipe136 .interactiveDismissDisabled(send.step == .review || send.busy)137 }138139 private var title: String {140 switch send.step { case .form: String(localized: "Envoyer"); case .review: String(localized: "Vérifier et approuver"); case .tracking: String(localized: "Suivi de l’envoi") }141 }142143 // MARK: form144145 private var network: Network? { send.network.flatMap { model.network($0) } }146 private var assetDef: AssetDef? { network?.asset(send.asset) }147 private var balance: Balance? { model.portfolio.value?.balances.first { $0.network == send.network && $0.asset == send.asset } }148 private var parsedAmount: Result<BaseUnits, AmountError>? {149 guard let a = assetDef, !send.amount.isEmpty else { return nil }150 do { return .success(try BaseUnits.parse(send.amount, decimals: a.decimals)) } catch { return .failure(error) }151 }152 private var addressCheck: AddressVerdict? {153 guard let n = network, !send.recipient.trimmingCharacters(in: .whitespaces).isEmpty else { return nil }154 return AddressChecks.check(send.recipient, network: n, own: model.account(n.id)?.address)155 }156 private var amountProblem: String? {157 switch parsedAmount {158 case .failure(let e): return e == .tooManyDecimals ? String(localized: "Trop de décimales pour cet actif (\(assetDef?.decimals ?? 0) au plus).") : String(localized: "Montant invalide.")159 case .success(let v):160 if v.isZero { return String(localized: "Le montant doit être supérieur à zéro.") }161 if let b = balance?.units, v > b { return String(localized: "Montant supérieur au solde disponible.") }162 return nil163 case nil: return nil164 }165 }166 private var canPrepare: Bool {167 guard model.canOperate, network != nil, assetDef != nil, case .success(let v)? = parsedAmount, !v.isZero, amountProblem == nil else { return false }168 if case .invalid? = addressCheck { return false }169 return addressCheck != nil && !send.busy170 }171172 @ViewBuilder private var form: some View {173 if let n = network {174 VStack(alignment: .leading, spacing: 12) {175 HStack {176 NetworkIcon(network: n.id, size: 34)177 VStack(alignment: .leading) { Text(n.name).font(.spHeadline); if n.health?.ok == false { Text(String(localized: "RPC en panne : l’envoi peut échouer")).font(.spFootnote).foregroundStyle(Theme.warn) } }178 Spacer()179 Button(String(localized: "Changer")) { send.network = nil; send.asset = "native"; send.recipient = "" }.font(.spCallout.weight(.semibold)).accessibilityIdentifier("send.changeNetwork")180 }181 Picker(String(localized: "Actif"), selection: $send.asset) {182 ForEach(n.assets) { a in Text(a.symbol + " — " + a.name).tag(a.id) }183 }.pickerStyle(.menu).accessibilityIdentifier("send.asset")184 if let b = balance {185 HStack {186 Text(String(localized: "Disponible")).font(.spFootnote).foregroundStyle(Theme.mute)187 Spacer()188 if let d = b.display { Masked(text: Money.exact(d) + " " + b.symbol).font(.spFootnote.weight(.semibold)).monospacedDigit() }189 else { Text(String(localized: "solde illisible pour le moment")).font(.spFootnote).foregroundStyle(Theme.warn) }190 }191 }192 }.spCard()193194 VStack(alignment: .leading, spacing: 10) {195 Text(String(localized: "Destinataire")).font(.spHeadline)196 TextField(String(localized: "Adresse \(n.name)"), text: $send.recipient, axis: .vertical)197 .font(.spMono).textInputAutocapitalization(.never).autocorrectionDisabled().keyboardType(.asciiCapable).lineLimit(1...4)198 .padding(12).background(Theme.elev, in: RoundedRectangle(cornerRadius: Theme.Radius.small))199 .focused($typing).accessibilityIdentifier("send.recipient")200 HStack(spacing: 8) {201 Button { if let s = UIPasteboard.general.string { handleScan(s, source: String(localized: "presse-papiers")) } } label: { Label(String(localized: "Coller"), systemImage: "doc.on.clipboard") }.buttonStyle(.bordered)202 Button { scanning = true } label: { Label(String(localized: "Scanner"), systemImage: "qrcode.viewfinder") }.buttonStyle(.bordered).accessibilityIdentifier("send.scan")203 Button { showBook = true } label: { Label(String(localized: "Carnet"), systemImage: "book.closed") }.buttonStyle(.bordered)204 }.font(.spCallout.weight(.semibold))205 if let s = scanNotice { Notice(tone: .info, title: s) }206 if let c = addressCheck {207 switch c {208 case .valid: Label(String(localized: "Format d’adresse valide pour \(n.name) (le serveur la revalide)"), systemImage: "checkmark.circle.fill").font(.spFootnote).foregroundStyle(Theme.emerald)209 case .invalid(let why): Label(why, systemImage: "xmark.octagon.fill").font(.spFootnote).foregroundStyle(Theme.danger).accessibilityIdentifier("send.addressError")210 case .unverifiable: Label(String(localized: "Le format sera validé par le serveur à l’étape suivante"), systemImage: "info.circle").font(.spFootnote).foregroundStyle(Theme.mute)211 }212 }213 if let kind = n.memo {214 TextField(kind == "uint32" ? String(localized: "Tag de destination (nombre, si exigé)") : String(localized: "Mémo (si exigé par le destinataire)"), text: $send.memo)215 .keyboardType(kind == "uint32" ? .numberPad : .default).textInputAutocapitalization(.never).autocorrectionDisabled()216 .padding(12).background(Theme.elev, in: RoundedRectangle(cornerRadius: Theme.Radius.small))217 Text(String(localized: "Une plateforme d’échange exige souvent un mémo ou un tag : sans lui, le dépôt peut être perdu.")).font(.spFootnote).foregroundStyle(Theme.mute)218 }219 }.spCard()220221 VStack(alignment: .leading, spacing: 10) {222 Text(String(localized: "Montant")).font(.spHeadline)223 HStack {224 TextField("0", text: $send.amount).keyboardType(.decimalPad).font(.system(size: 30, weight: .semibold)).monospacedDigit().focused($typing).accessibilityIdentifier("send.amount")225 Text(assetDef?.symbol ?? "").font(.spHeadline).foregroundStyle(Theme.mute)226 }227 if case .success(let v)? = parsedAmount, let a = assetDef, let p = model.portfolio.value?.prices?[a.symbol] {228 Text("≈ " + Money.fiat(v.approximate(decimals: a.decimals) * p.value(in: model.currency), model.currency) + (p.stale ? " · " + String(localized: "prix périmé") : ""))229 .font(.spFootnote).foregroundStyle(Theme.mute)230 }231 if let p = amountProblem { Label(p, systemImage: "exclamationmark.triangle.fill").font(.spFootnote).foregroundStyle(Theme.danger) }232 if send.asset == "native" { Text(String(localized: "Les frais de réseau s’ajoutent au montant et sont payés en \(n.native.symbol).")).font(.spFootnote).foregroundStyle(Theme.mute) }233 else { Text(String(localized: "Les frais de réseau sont payés en \(n.native.symbol), en plus du montant.")).font(.spFootnote).foregroundStyle(Theme.mute) }234 TextField(String(localized: "Note personnelle (facultative, non envoyée sur la chaîne)"), text: $send.note).font(.spCallout)235 .padding(12).background(Theme.elev, in: RoundedRectangle(cornerRadius: Theme.Radius.small))236 .onChange(of: send.note) { _, v in if v.count > 80 { send.note = String(v.prefix(80)) } }237 }.spCard()238239 if let e = send.error { ErrorNotice(error: e).accessibilityIdentifier("send.error") }240 Button { Task { await send.prepare(model.env) } } label: { HStack { if send.busy { ProgressView().tint(Theme.onPrimary) }; Text(String(localized: "Préparer et vérifier")) } }241 .buttonStyle(.spPrimary).disabled(!canPrepare).accessibilityIdentifier("send.prepare")242 Text(String(localized: "Le serveur valide l’adresse, simule la transaction, estime les frais et vérifie les limites. Rien n’est signé à cette étape."))243 .font(.spFootnote).foregroundStyle(Theme.mute)244 } else {245 VStack(alignment: .leading, spacing: 4) {246 SectionHeader(title: String(localized: "Depuis quel réseau ?"))247 NetworkPicker(selection: $send.network, filter: { model.account($0.id) != nil })248 }.spCard()249 }250 }251252 /** Text from a QR code or the clipboard: parsed and validated, used only to pre-fill the form. */253 private func handleScan(_ raw: String, source: String = String(localized: "code QR")) {254 let filled = ScannedPayment.parse(raw, networks: model.networks.value ?? [], current: send.network)255 switch filled {256 case .failure(let why): scanNotice = why257 case .success(let p):258 if send.network == nil, let n = p.network { send.network = n }259 if let n = p.network, let cur = send.network, n != cur { scanNotice = String(localized: "Ce code vise le réseau \(model.network(n)?.name ?? n), pas \(model.network(cur)?.name ?? cur). Rien n’a été rempli."); return }260 send.recipient = p.address261 if let a = p.amount, send.amount.isEmpty { send.amount = a }262 if let m = p.memo, send.memo.isEmpty { send.memo = m }263 scanNotice = String(localized: "Formulaire rempli depuis le \(source). Vérifie l’adresse et le montant : rien n’est envoyé automatiquement.")264 }265 }266267 // MARK: review268269 @ViewBuilder private var review: some View {270 if let a = send.approval {271 IntentReview(intent: a.intent, digest: a.approval.digest, warnings: a.proposal.warnings ?? [])272 if let est = a.proposal.feeDisplay { Text(String(localized: "Frais estimés : \(Money.exact(est)) \(a.proposal.feeSymbol ?? ""). Le plafond affiché ci-dessus est le maximum que le signataire acceptera.")).font(.spFootnote).foregroundStyle(Theme.mute) }273 if let e = send.error { ErrorNotice(error: e).accessibilityIdentifier("send.error") }274 TimelineView(.periodic(from: .now, by: 1)) { ctx in275 let expired = a.intent.expiry <= ctx.date276 VStack(spacing: 10) {277 if expired {278 Button { Task { await send.refreshApproval(model.env) } } label: { Label(String(localized: "Fenêtre expirée : actualiser les frais et le défi"), systemImage: "arrow.clockwise") }279 .buttonStyle(.spPrimary).disabled(send.busy).accessibilityIdentifier("send.refresh")280 } else {281 Button { Task { await send.approve(model.env) } } label: { HStack { if send.busy { ProgressView().tint(Theme.onPrimary) } else { Image(systemName: "person.badge.key.fill") }; Text(String(localized: "Approuver avec la clé d’accès")) } }282 .buttonStyle(.spPrimary).disabled(send.busy || !model.canOperate).accessibilityIdentifier("send.approve")283 }284 Button(String(localized: "Refuser")) { Task { await send.reject(model.env) } }.buttonStyle(.spSecondary).disabled(send.busy).accessibilityIdentifier("send.reject")285 }286 }287 }288 }289290 @ViewBuilder private var tracking: some View {291 if let p = send.submitted {292 VStack(alignment: .leading, spacing: 4) {293 Text(String(localized: "Envoi de")).spEyebrow()294 Text(Money.exact(p.amountDisplay) + " " + p.symbol).font(.system(size: 30, weight: .semibold)).tracking(-0.6)295 if let to = p.to { Text(to).font(.spMono).foregroundStyle(Theme.mute).textSelection(.enabled) }296 }297 ProposalTracker(proposalId: p.id)298 Button(String(localized: "Terminer")) { dismiss() }.buttonStyle(.spSecondary).accessibilityIdentifier("send.done")299 }300 }301}302303struct AddressBookPicker: View {304 @Environment(AppModel.self) private var model305 @Environment(\.dismiss) private var dismiss306 let network: String?307 let pick: (AddressBookEntry) -> Void308 @State private var entries: [AddressBookEntry]?309 @State private var error: Error?310 var body: some View {311 NavigationStack {312 List {313 if let entries {314 let rows = entries.filter { network == nil || $0.network == network }315 if rows.isEmpty { EmptyState(icon: "book.closed", title: String(localized: "Aucune adresse enregistrée pour ce réseau")).listRowBackground(Color.clear) }316 ForEach(rows) { e in317 Button { pick(e) } label: {318 VStack(alignment: .leading, spacing: 3) {319 HStack { NetworkIcon(network: e.network, size: 20); Text(e.label).font(.system(size: 15.5, weight: .semibold)).foregroundStyle(Theme.ink) }320 Text(e.address).font(.system(size: 12, design: .monospaced)).foregroundStyle(Theme.mute)321 }322 }323 }324 } else if let error { ErrorNotice(error: error) } else { ProgressView() }325 }326 .navigationTitle(String(localized: "Carnet d’adresses")).navigationBarTitleDisplayMode(.inline)327 .toolbar { ToolbarItem(placement: .cancellationAction) { Button(String(localized: "Fermer")) { dismiss() } } }328 .task { do { entries = try await model.env.wallet.addressBook() } catch let e { error = e } }329 }330 }331}332