SPB Git

Repository Public

GoLiveFlow.swift 9.1 KB 149 lines swift

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

Theme