SPB Git

Repository Public

AgentVaultWorkspace.swift 16.1 KB 219 lines swift

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
Files main
Menu

Theme