Repository Public
1// SP Wallet iOS2// File: Features/TradingAgents/AgentVaultWorkspace.swift3// Description: The vault of a spot agent: its address on the agent's network (QR, copy), its real on-chain balances, how to fund it4// (the Send flow of the wallet, where the owner types or pastes the destination himself), what the same address holds5// on other networks (funds sent on the wrong network), and the return to the owner — the WHOLE balance of one asset,6// back to the owner's own address, the only destination the signer signs for a vault — followed until the network7// confirms it. A retry reuses the same idempotency key: nothing is signed twice.8//9// Author: Simon-Pierre Boucher10// Contact: contact@spboucher.ai11import SwiftUI12import SPWalletCore1314@MainActor @Observable15final class VaultModel {16 let agentId: String17 var elsewhere: FundsElsewhere?18 var elsewhereError: Error?19 var returns: [VaultReturn]?20 /** False: this server signs but does not relay. */21 var broadcast: Bool?22 var returnsError: Error?23 var gas: AgentNetworks.Gas?24 var busy: String?25 var error: Error?26 /** One key per (network, asset) request, kept until that return is terminal: a retry answers the same operation. */27 private(set) var keys: [String: String] = [:]2829 init(agentId: String) { self.agentId = agentId }3031 static func slot(network: String?, asset: String) -> String { (network ?? "home") + ":" + asset }3233 func key(network: String?, asset: String) -> String {34 let s = Self.slot(network: network, asset: asset)35 if let k = keys[s] { return k }36 let k = APIClient.newIdempotencyKey()37 keys[s] = k38 return k39 }40 func release(network: String?, asset: String) { keys[Self.slot(network: network, asset: asset)] = nil }4142 func load(_ api: AgentsAPI, network: String) async {43 do { let r = try await api.vaultReturns(agentId); returns = r.withdrawals; broadcast = r.broadcast; returnsError = nil } catch { returnsError = error }44 do { elsewhere = try await api.fundsElsewhere(agentId); elsewhereError = nil } catch { elsewhereError = error }45 if gas == nil, let n = try? await api.networks() { gas = n.networks.first { $0.id == network }?.gas }46 }4748 /** Whole balance of one asset back to the owner's own address. The answer is displayed as it is. */49 func returnToOwner(_ api: AgentsAPI, asset: String, network: String?) async {50 guard busy == nil else { return }51 let slot = Self.slot(network: network, asset: asset)52 busy = slot; error = nil53 defer { busy = nil }54 do {55 let r = try await api.returnToOwner(agentId, asset: asset, network: network, idempotencyKey: key(network: network, asset: asset))56 if r.state.isTerminal { release(network: network, asset: asset) }57 var list = returns ?? []58 if let i = list.firstIndex(where: { $0.id == r.id }) { list[i] = r } else { list.insert(r, at: 0) }59 returns = list60 } catch let e as APIError where e.isOffline {61 // the answer was lost: the key is KEPT, so that trying again answers the same return instead of a second one62 error = e63 } catch {64 // a refusal: nothing was created under this key65 release(network: network, asset: asset); self.error = error66 }67 }6869 /** Follow the open returns until the network confirms them (slowly: a return takes at least a block). */70 func track(_ api: AgentsAPI) async {71 while !Task.isCancelled {72 guard let open = returns?.filter({ $0.state.isOpen || ($0.state == .confirmed && !$0.arrived) }), !open.isEmpty else { return }73 try? await Task.sleep(for: .seconds(6))74 for r in open {75 guard let fresh = try? await api.vaultReturn(agentId, returnId: r.id), let i = returns?.firstIndex(where: { $0.id == r.id }) else { continue }76 returns?[i] = fresh77 if fresh.state.isTerminal, let a = fresh.asset { release(network: fresh.network, asset: a); release(network: nil, asset: a) }78 }79 }80 }81}8283struct AgentVaultWorkspace: View {84 @Environment(AppModel.self) private var model85 @Environment(Router.self) private var router86 let page: AgentPageModel87 let store: AgentsStore88 @State private var vault: VaultModel89 @State private var confirmation: AgentConfirmation?90 @State private var copied = false9192 init(page: AgentPageModel, store: AgentsStore) {93 self.page = page; self.store = store94 _vault = State(initialValue: VaultModel(agentId: page.id))95 }9697 private var api: AgentsAPI { AgentsAPI(model.env.client) }9899 var body: some View {100 if let a = page.agent, a.hasVault {101 let netName = a.networkName ?? model.network(a.network)?.name ?? a.network102 Notice(tone: .info, title: String(localized: "Le coffre contient de vrais fonds"), message: String(localized: "Quel que soit le mode de l’agent (simulation, papier ou réel), ce qui est envoyé à cette adresse est réel. Seul un mandat approuvé permet à l’agent de les échanger ; le retour vers ton adresse est toujours possible."))103 addressCard(a, netName)104 balancesCard(a, netName)105 fundingCard(a, netName)106 elsewhereCard(a)107 returnsCard108 .task(id: store.revision) { if model.canOperate { await vault.load(api, network: a.network) } }109 .task(id: vault.returns?.filter { $0.state.isOpen }.map(\.id).joined()) { if model.canOperate { await vault.track(api); await page.load(model, store: store) } }110 .agentConfirmation($confirmation)111 }112 }113114 private func addressCard(_ a: Agent, _ netName: String) -> some View {115 AgentCard(title: String(localized: "Adresse du coffre sur \(netName)")) {116 HStack { Spacer(); QRCodeView(content: a.vaultAddress, size: 180).accessibilityIdentifier("vault.qr"); Spacer() }117 Text(a.vaultAddress).font(.spMono).foregroundStyle(Theme.ink).textSelection(.enabled).fixedSize(horizontal: false, vertical: true).accessibilityIdentifier("vault.address")118 Button {119 UIPasteboard.general.string = a.vaultAddress; copied = true120 Task { try? await Task.sleep(for: .seconds(2)); copied = false }121 } label: { Label(copied ? String(localized: "Adresse copiée") : String(localized: "Copier l’adresse"), systemImage: copied ? "checkmark" : "doc.on.doc") }122 .buttonStyle(.spSecondary).accessibilityIdentifier("vault.copy")123 Text(String(localized: "Adresse dérivée par le signataire isolé pour cet agent (indice \(a.vaultIndex.map(String.init) ?? "?")). N’envoie que sur \(netName) : la même adresse existe sur les autres réseaux EVM, mais l’agent n’y échange pas.")).font(.spFootnote).foregroundStyle(Theme.mute)124 }125 }126127 @ViewBuilder private func balancesCard(_ a: Agent, _ netName: String) -> some View {128 AgentCard(title: String(localized: "Soldes du coffre (réels)")) {129 if case .spot(let d)? = page.detail {130 if let balances = d.vault {131 AgentRows(items: balances) { b in132 VStack(alignment: .leading, spacing: 6) {133 HStack(spacing: 10) {134 AssetIcon(symbol: b.assetSymbol, network: a.network, size: 32)135 VStack(alignment: .leading, spacing: 1) {136 Text(b.assetSymbol + " · " + (b.role == "gas" ? String(localized: "frais de réseau") : b.role == "cash" ? String(localized: "réserve") : String(localized: "actif"))).font(.system(size: 15, weight: .semibold)).foregroundStyle(Theme.ink)137 Masked(text: Money.exact(b.display) + " " + b.assetSymbol).font(.spFootnote).monospacedDigit().foregroundStyle(Theme.mute)138 }139 Spacer()140 if let u = b.usd { Masked(text: "≈ " + AgentFmt.usd(u)).font(.system(size: 14, weight: .semibold)).monospacedDigit() } else { Text(String(localized: "valeur inconnue")).font(.spFootnote).foregroundStyle(Theme.mute) }141 }142 if b.units?.isZero == false {143 Button { askReturn(a, asset: b.asset, symbol: b.assetSymbol, amount: b.display, network: nil, netName: netName) } label: {144 HStack { if vault.busy == VaultModel.slot(network: nil, asset: b.asset) { ProgressView() }; Text(String(localized: "Rapatrier tout le \(b.assetSymbol) vers mon adresse")).font(.spCallout.weight(.semibold)) }145 }.buttonStyle(.bordered).disabled(!model.canOperate || vault.busy != nil).accessibilityIdentifier("vault.return.\(b.assetSymbol)")146 }147 }.padding(.vertical, 8)148 }149 } else { Text(String(localized: "Lecture de la chaîne indisponible : soldes inconnus. Ce n’est pas un coffre vide.")).font(.spCallout).foregroundStyle(Theme.warn).accessibilityIdentifier("vault.unread") }150 } else { Text(String(localized: "Soldes indisponibles hors ligne.")).font(.spCallout).foregroundStyle(Theme.mute) }151 if let e = vault.error { ErrorNotice(error: e).accessibilityIdentifier("vault.error") }152 }153 }154155 private func askReturn(_ a: Agent, asset: String, symbol: String, amount: String, network: String?, netName: String) {156 let own = model.account(network ?? a.network)?.address157 confirmation = AgentConfirmation(title: String(localized: "Rapatrier tout le \(symbol) ?"),158 message: String(localized: "TOUT le solde de \(symbol) du coffre sur \(netName) (\(Money.exact(amount)) \(symbol) à l’instant) est renvoyé à ta propre adresse") + (own.map { " \($0)" } ?? "") + String(localized: ". Il n’y a ni montant ni destination à choisir : le signataire ne signe un paiement de coffre que vers ton adresse. Les frais de réseau sont payés par le coffre. Sur le réseau de l’agent, le mandat doit d’abord être révoqué. Aucune clé d’accès n’est demandée."),159 button: String(localized: "Rapatrier vers mon adresse")) { await vault.returnToOwner(api, asset: asset, network: network) }160 }161162 @ViewBuilder private func fundingCard(_ a: Agent, _ netName: String) -> some View {163 AgentCard(title: String(localized: "Alimenter le coffre")) {164 Text(String(localized: "1. Copie l’adresse du coffre ci-dessus.\n2. Ouvre l’envoi depuis ton portefeuille sur \(netName).\n3. Colle l’adresse comme destinataire, vérifie-la, puis approuve l’envoi avec ta clé d’accès.")).font(.spCallout).foregroundStyle(Theme.ink).fixedSize(horizontal: false, vertical: true)165 if let g = vault.gas { Text(String(localized: "Pour passer en réel, le coffre doit aussi détenir au moins \(g.reserve) de la monnaie native pour les frais (environ \(g.perOrder) par ordre).")).font(.spFootnote).foregroundStyle(Theme.mute) }166 ForEach(a.holdings ?? [], id: \.asset) { h in167 Button { router.sheet = .send(network: a.network, asset: h.asset) } label: { Label(String(localized: "Envoyer du \(h.assetSymbol) depuis le portefeuille…"), systemImage: "arrow.up.right").font(.spCallout.weight(.semibold)) }168 .buttonStyle(.bordered).disabled(!model.canOperate).accessibilityIdentifier("vault.fund.\(h.assetSymbol)")169 }170 Text(String(localized: "L’app ne remplit jamais le destinataire à ta place : c’est toi qui colles l’adresse et la vérifies.")).font(.spFootnote).foregroundStyle(Theme.mute)171 }172 }173174 @ViewBuilder private func elsewhereCard(_ a: Agent) -> some View {175 AgentCard(title: String(localized: "Fonds sur d’autres réseaux")) {176 if let e = vault.elsewhere {177 if e.holdings.isEmpty { Text(String(localized: "Rien n’a été trouvé à l’adresse du coffre sur les autres réseaux EVM.")).font(.spCallout).foregroundStyle(Theme.mute).accessibilityIdentifier("vault.elsewhere.none") }178 else { Notice(tone: .warn, title: String(localized: "Des fonds sont à cette adresse sur un autre réseau"), message: String(localized: "L’agent ne les échange pas. Tu peux les rapatrier vers ta propre adresse sur ce même réseau.")) }179 AgentRows(items: e.holdings) { h in180 VStack(alignment: .leading, spacing: 6) {181 FieldRow(label: "\(h.symbol) · \(h.networkName)", value: Money.exact(h.display) + " " + h.symbol)182 if h.gasEnough == false || !h.hasGas { Text(String(localized: "Pas assez de \(h.gas) à cette adresse pour payer les frais du retour") + (h.gasNeed.map { " (" + String(localized: "il faut environ \($0) \(h.gas)") + ")" } ?? "") + ".").font(.spFootnote).foregroundStyle(Theme.warn) }183 Button { askReturn(a, asset: h.asset, symbol: h.symbol, amount: h.display, network: h.network, netName: h.networkName) } label: { Text(String(localized: "Rapatrier vers mon adresse sur \(h.networkName)")).font(.spCallout.weight(.semibold)) }184 .buttonStyle(.bordered).disabled(!model.canOperate || vault.busy != nil)185 }.padding(.vertical, 6)186 }187 } else if let e = vault.elsewhereError { ErrorNotice(error: e) }188 else if model.canOperate { ProgressView() }189 else { Text(String(localized: "Indisponible hors ligne.")).font(.spCallout).foregroundStyle(Theme.mute) }190 }191 }192193 @ViewBuilder private var returnsCard: some View {194 AgentCard(title: String(localized: "Retours vers ton adresse")) {195 if let r = vault.returns {196 if vault.broadcast == false { Notice(tone: .warn, title: String(localized: "Ce serveur ne diffuse pas les transactions"), message: String(localized: "Un retour y est signé mais jamais envoyé au réseau.")) }197 if r.isEmpty { Text(String(localized: "Aucun retour demandé.")).font(.spCallout).foregroundStyle(Theme.mute) }198 AgentRows(items: r) { w in199 VStack(alignment: .leading, spacing: 4) {200 HStack(spacing: 8) {201 if w.state.isOpen { ProgressView() }202 Text(Money.exact(w.amount) + " " + w.symbol).font(.spBody.weight(.semibold)).monospacedDigit()203 Pill(text: w.isSettled ? String(localized: "Confirmé et arrivé à ton adresse") : w.state.label, tone: w.isSettled ? .ok : w.state == .confirmed ? .warn : w.state.tone)204 }.accessibilityIdentifier("vault.return.state")205 if w.state == .confirmed, !w.arrived { Text(String(localized: "Transaction minée, mais le paiement vers ton adresse n’a pas encore été vu : ce n’est pas compté comme arrivé.")).font(.spFootnote).foregroundStyle(Theme.warn) }206 if w.duplicate == true { Text(String(localized: "Retour déjà existant : rien de nouveau n’a été signé.")).font(.spFootnote).foregroundStyle(Theme.mute) }207 if let t = w.txid { Text(t).font(.system(size: 11.5, design: .monospaced)).foregroundStyle(Theme.mute).textSelection(.enabled) }208 if let e = w.error { Text(e).font(.spFootnote).foregroundStyle(Theme.danger).fixedSize(horizontal: false, vertical: true) }209 Text([w.network, w.createdAt.map(AgentFmt.date)].compactMap { $0 }.joined(separator: " · ")).font(.system(size: 11.5)).foregroundStyle(Theme.mute)210 if let x = w.explorer, let u = URL(string: x), u.scheme == "https" { Link(String(localized: "Ouvrir dans l’explorateur"), destination: u).font(.spFootnote.weight(.semibold)) }211 }.padding(.vertical, 8)212 }213 } else if let e = vault.returnsError { ErrorNotice(error: e) }214 else if model.canOperate { ProgressView() }215 else { Text(String(localized: "Indisponible hors ligne.")).font(.spCallout).foregroundStyle(Theme.mute) }216 }217 }218}219