Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Features/TradingAgents/GoLiveFlow.swift3// Description: Going real = approving a mandate with the passkey. Two state machines (spot vault mandate; perp venue mandate with its two prompts) built on the Core's verified approvals: the mandate is parsed strictly, compared with the limits the owner entered, and its hash must be the WebAuthn challenge before any sheet opens. After any failed submission the approval is discarded and the agent's real state is read — the same challenge is never signed twice.4import Foundation5import SPWalletCore67/// What the isolated signer bounds and what it does not, as written in the custody ADR (docs/adr/0001-custody.md of the backend).8enum CustodyFacts {9 static let spotCan = [10 "Échanger, par un seul fournisseur et sur un seul réseau, entre les actifs listés ci-dessus, sans passkey par ordre.",11 "Rester sous le plafond par ordre et le volume quotidien de chaque actif, le nombre d’ordres par jour et la garde de glissement, jusqu’à l’expiration.",12 "Renvoyer les fonds du coffre vers VOTRE propre adresse (sans limite de montant, même sous arrêt d’urgence).",13 ]14 static let spotCannot = [15 "Payer une autre adresse que la vôtre : un coffre ne paie que son propriétaire.",16 "Négocier un actif hors liste, passer par un autre fournisseur ou un autre réseau.",17 "Dépasser les plafonds du mandat, ou signer quoi que ce soit après l’expiration ou la révocation.",18 ]19 static let spotNotBounded = [20 "La perte de marché de ce que détient le coffre n’est PAS bornée par le signataire : tout ce que vous y déposez peut perdre de la valeur.",21 "La limite de perte et la part d’exposition de l’agent sont appliquées par le moteur de l’API seulement ; un écart de prix peut les dépasser et une API compromise n’y est pas tenue.",22 "L’identité de la stratégie (empreinte du code) est vérifiée par l’API seulement : le signataire ne peut pas savoir quel code demande un ordre.",23 "Une API compromise pourrait utiliser ce mandat à tout moment, jusqu’à ses bornes, tant qu’il est en vigueur (au plus 90 jours). Le gaz du coffre peut être dépensé.",24 ]25 static let perpCan = [26 "Signer des ordres, des annulations et des changements de levier sur CE compte de la plateforme, pour les instruments listés, sans passkey par ordre.",27 "Dans les bornes du mandat : notionnel par ordre, ordres par heure et par jour, rotation quotidienne, levier au plus celui du mandat, valeur du compte au moins égale au plancher (lue par le signataire lui-même).",28 "Après la fin du mandat : seulement des annulations et des ordres réducteurs, pendant 24 heures.",29 ]30 static let perpCannot = [31 "Retirer, transférer ou approuver une autre clé : la clé de trading ne peut que négocier.",32 "Négocier un instrument hors liste, ou augmenter le risque une fois la valeur du compte sous le plancher.",33 ]34 static let perpNotBounded = [35 "La taille des positions, l’exposition brute, les limites de perte, la distance de liquidation et la cadence par minute sont vérifiées par le moteur de risque de l’API : une API compromise n’y est pas tenue.",36 "L’empreinte de la stratégie et l’identité de l’agent sont vérifiées par l’API seulement.",37 "Le collatéral du compte peut être perdu, liquidation comprise. Un écart de prix peut franchir le plancher avant que le signataire ne refuse.",38 "Une API compromise pourrait utiliser ce mandat jusqu’à ses bornes tant qu’il est en vigueur (au plus 30 jours).",39 ]40}4142@MainActor @Observable final class SpotGoLiveFlow {43 enum Step: Equatable { case idle, preparing, review, approving, done }44 let model: AppModel45 let api: AgentsAPI46 private(set) var step: Step = .idle47 private(set) var approval: SpotMandateApproval?48 /// The engine-side loss limit of the agent at preparation, shown as NOT enforced by the signer.49 private(set) var risk: SpotAgentRisk?50 private(set) var result: Agent?51 var error: String?5253 init(model: AppModel) { self.model = model; api = AgentsAPI(model.client) }5455 func prepare(_ d: SpotAgentDetail) async {56 guard step == .idle, model.canOperate else { return }57 error = nil; step = .preparing58 do {59 guard let net = model.network(d.agent.network) else { throw ApprovalError.unsupported("le réseau \(d.agent.network) n’est pas dans le registre de ce portefeuille") }60 let expectation = try SpotMandateExpectation(detail: d, network: net)61 approval = try await api.prepareSpotMandate(agentId: d.agent.id, expecting: expectation)62 risk = d.agent.spotRisk63 step = .review64 } catch { self.error = model.describe(error); step = .idle }65 }6667 func approve() async {68 guard let a = approval, step == .review else { return }69 error = nil; step = .approving70 do {71 result = try await api.approveSpotMandate(a, with: model.authenticator)72 approval = nil; step = .done73 Notifier.post(title: "Mandat approuvé", body: "L’agent « \(a.mandate.label) » est en mode RÉEL sous mandat.")74 } catch PasskeyError.cancelled { step = .review }75 catch {76 // never sign the same challenge twice: read what the server says the agent is now77 let message = model.describe(error)78 if case .spot(let d)? = try? await api.detail(a.agentId), d.agent.mode == .live, d.mandateStatus?.active == true { result = d.agent; approval = nil; step = .done }79 else { approval = nil; step = .idle; self.error = "\(message) L’approbation est abandonnée : préparez un nouveau mandat pour réessayer." }80 }81 }8283 func cancel() { approval = nil; error = nil; step = .idle }84 func finish() { result = nil; step = .idle }85}8687@MainActor @Observable final class PerpGoLiveFlow {88 enum Step: Equatable { case idle, preparing, review, approving, done }89 let model: AppModel90 let api: AgentsAPI91 let agentId: String92 private(set) var readiness: PerpLiveReadiness?93 private(set) var readinessError: String?94 private(set) var loading = false95 var accountId = ""96 /// Validity asked for, typed by the owner: never the server's "longest possible".97 var daysText = ""98 private(set) var step: Step = .idle99 private(set) var approval: PerpLiveApproval?100 private(set) var result: PerpAgentDetail?101 var error: String?102103 init(model: AppModel, agentId: String) { self.model = model; self.agentId = agentId; api = AgentsAPI(model.client) }104105 var days: Int? { guard let d = Int(daysText.trimmingCharacters(in: .whitespaces)), (1...AgentVenueMandate.maxDays).contains(d) else { return nil }; if let m = readiness?.proposal?.maxDays ?? readiness?.steps.account.authorization?.maxMandateDays, d > m { return nil }; return d }106107 func load() async {108 guard !loading else { return }109 loading = true; defer { loading = false }110 do {111 let r = try await api.perpLiveReadiness(agentId, account: accountId.isEmpty ? nil : accountId, locale: "fr", days: days)112 readiness = r; readinessError = nil113 if accountId.isEmpty, let a = r.accountId { accountId = a }114 } catch { readinessError = model.describe(error) }115 }116117 func prepare(agent: Agent) async {118 guard step == .idle, model.canOperate, let days else { return }119 error = nil; step = .preparing120 do {121 // the checklist is read again for exactly this account and these days: the expectation is built from what is on screen122 let r = try await api.perpLiveReadiness(agentId, account: accountId, locale: "fr", days: days)123 readiness = r124 let expectation = try PerpLiveExpectation(agent: agent, readiness: r, days: days)125 approval = try await api.preparePerpLive(expecting: expectation, locale: "fr")126 step = .review127 } catch { self.error = model.describe(error); step = .idle }128 }129130 func approve(acknowledged: Bool) async {131 guard let a = approval, step == .review, acknowledged else { return }132 error = nil; step = .approving133 do {134 result = try await api.approvePerpLive(a, acknowledged: true, with: model.authenticator)135 approval = nil; step = .done136 Notifier.post(title: "Mandat de dérivés approuvé", body: "L’agent est en mode RÉEL sur le compte \(Fmt.short(a.mandate.account)) (\(a.mandate.network)).")137 } catch PasskeyError.cancelled { step = .review }138 catch {139 let message = model.describe(error)140 if case .perp(let d)? = try? await api.detail(a.agentId), d.agent.mode == .live, d.live?.active == true { result = d; approval = nil; step = .done }141 else { approval = nil; step = .idle; self.error = "\(message) L’approbation est abandonnée : relisez la liste de contrôle et préparez un nouveau mandat pour réessayer." }142 await load()143 }144 }145146 func cancel() { approval = nil; error = nil; step = .idle }147 func finish() { result = nil; step = .idle }148}149