Repository Public
1<!--2SP Wallet iOS3File: docs/parity/agents.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Agents de trading — parité Web / iOS et maturité réelle89État au 2026-11-18, branche `ui-agents`. « Vérifié sur la pile » = test d'interface sur la pile jetable10(`dev-stack.sh up-fork`, port 8810 : clés aléatoires, tous les verrous du réel à OFF, clé d'accès logicielle, Base = fork local avec11faux ETH). **Rien n'a été exécuté contre la production ni avec des fonds réels.** La colonne « maturité serveur » reprend ce que12le serveur de la pile annonce au démarrage (`[startup] capabilities`) et ce que disent `docs/TRADING-AGENT-ENGINE.md` §11,13`docs/TRADING-MANDATES.md` et `docs/V11-MARKET-MAKING.md` du dépôt du backend ; elle ne prouve rien sur la production.1415| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur (verrous par leur nom) | Ce qui bloque / jamais exécuté pour de vrai |16|---|---|---|---|---|17| Liste des agents, mode et état | oui (`Agents.tsx`, `agentPanel.tsx`) | oui : badge SIMULATION / PAPIER / RÉEL (TESTNET / MAINNET), « argent réel » seulement si `tradesRealMoney` du Core (un agent réel ARRÊTÉ s’affiche « RÉEL · arrêté ») ; état tel que servi ; rendement de tête lu par mode — vérifié sur la pile | lecture seule | — |18| Arrêt d'urgence global (engager) | oui | oui : une confirmation, pas de clé d'accès ; lever = section Risque — vérifié sur la pile | un seul interrupteur (moteur de risque), côté API | « The kill switch is API-side; a compromised API can ignore it » (doc §11). La levée n'est pas dans cette section |19| État du moteur (travailleurs, file, boucles) | oui | oui (carte « Moteur des agents ») — capture d'écran | `SPW_WORKERS` (in-process sur la pile) | le travailleur séparé n'a « jamais tourné sous PM2 » (doc §11) |20| Création depuis un gabarit | oui | oui : limites saisies une à une (les propositions du gabarit sont des indications), paramètres recopiables par un bouton explicite ; verdict du labo affiché — vérifié sur la pile (tenue de marché) | 7 gabarits servis ; momentum, retour à la moyenne, arbitrage statistique : `research, paper, live` ; financement et inter-plateformes : `research, paper` | verdicts du labo négatifs ou indisponibles (affichés tels quels) |21| Création sur mesure spot | oui | oui : chaque limite saisie, un actif par défaut par marché (pas de choix de représentation : voir « non fait ») — vérifié sur la pile | route `POST /agents` | choix de la représentation d'un marché (WBTC / cbBTC…) non offert sur iOS |22| Création sur mesure perp | oui | oui : chaque limite saisie ; créé en PAPIER — vérifié sur la pile | route `POST /agents` (`kind: perp`) | 24 premiers contrats admissibles seulement dans le sélecteur |23| Bibliothèque de stratégies, épinglage | oui | oui — vérifié sur la pile (`ma_trend/3`) | 18 versions spot, bibliothèque perp séparée | — |24| Backtest (rapport d'une version) | oui (`labReport.tsx`) | oui : chaque chiffre porte « simulation sur données historiques — ne garantit rien », contrôle d'anticipation tel que servi — vérifié sur la pile | laboratoire python `research/.venv` ; bac à sable `strategy_sandbox_enforced=on` | simulation, jamais une performance |25| Backtest à la demande (tâche) | oui | oui : suivi de la tâche, échec affiché tel quel — vérifié sur la pile (la tâche est créée et suivie ; son issue dépend du serveur) | file `agent-jobs` | sans version épinglée la tâche échoue côté serveur (`invalid input syntax for type uuid: ""`, vu sur la pile) : iOS envoie toujours la version |26| Approbation d'une version de stratégie | oui | oui : confirmation, pas de clé d'accès (aucune autorité sur des fonds) — vérifié sur la pile | le serveur refuse sans rapport ou si le contrôle d'anticipation échoue | — |27| Papier spot (démarrer / pause / reprendre / arrêter, livre papier) | oui | oui — vérifié sur la pile (démarrage, badge PAPIER) | moteur à barres | frais de réseau non simulés (dit par le serveur) |28| Papier perp | oui (`PerpAgent.tsx`) | oui : compte papier, clôture des positions papier ; refus `no_strategy` affiché tel quel — vérifié sur la pile | moteur papier sur carnets réels | — |29| Papier « flux » (financement, inter-plateformes) | oui | oui : démarrage, livre simulé, journal ; pas de réel (raison du serveur affichée) — non vérifié sur la pile (même parcours que la tenue de marché) | `research, paper` seulement | « une seule plateforme autorise l'exécution sous mandat » (raison servie) |30| Registres par mode (ordres, signaux, journal, performance, chronologie) | oui | oui : lectures du Core par mode ; une réponse d'un autre mode = erreur `mode_mismatch`, rien affiché — test unitaire + pile (papier) | routes `…?mode=` | performance réelle jamais observée (aucun agent réel hors fork) |31| Réel spot par mandat — Base | oui | oui : saisie de chaque limite, mandat VÉRIFIÉ relu en entier, clé d'accès, état relu chez le signataire — **vérifié sur la pile, fork local de Base, faux ETH** | mandat `SPW-MANDATE-v1`, fournisseur `kyberswap`, `SPW_BROADCAST` | jamais exécuté ici avec des fonds réels ; aucun échange réel observé (coffre du fork sans USDC) |32| Réel spot par mandat — Ethereum, Arbitrum, Polygon, Optimism, BNB, Avalanche, HyperEVM | oui | même parcours (réseau de l'agent) — **non vérifié** (pas de fork de ces réseaux sur la pile) | réseaux listés par `/agents/networks` (`enabled`) | réserve de gaz réelle exigée ; jamais exécuté ici |33| Révocation du mandat spot / arrêt d'un agent réel | oui | oui : une confirmation, pas de clé d'accès — vérifié sur la pile (arrêt d'un agent réel du fork) | révocation chez le signataire | — |34| Réel perp (Hyperliquid) testnet | oui (`PerpAgentLive.tsx`) | parcours complet écrit (liste de contrôle telle que servie, deux objets, reconnaissance, 2 demandes de clé d'accès) — **liste de contrôle vérifiée sur la pile ; préparation et approbation NON vérifiées** (aucun compte de plateforme autorisé sur la pile) | `deriv_mandate` disponible sur testnet | exige un compte Hyperliquid testnet autorisé et alimenté ; « nothing here was run on a funded account » (doc §11) |35| Réel perp (Hyperliquid) mainnet | oui | même parcours ; le verrou du serveur est affiché tel quel et termine le parcours | **OFF** : `SPW_DERIV_LIVE_MAINNET`, `SPW_DERIV_MANDATE_MAINNET` | verrous à OFF par défaut ; jamais exécuté |36| Pause / reprise / arrêt perp réel (clôture en réduction seule) | oui | oui (pause et reprise génériques, `stopPerpLive` avec la période de clôture servie) — **non vérifiable ici** | période de clôture 24 h (`windDownSeconds`) | idem réel perp |37| Tenue de marché — papier | oui (`mmPanel.tsx`) | oui : preuves négatives telles quelles, session, exécutions, attribution, retirer / clore / reprendre — preuves et indisponibilité du réel vérifiées sur la pile ; session papier longue non observée | flux en direct des carnets | une session papier d'au moins 30 minutes est exigée avant le réel |38| Tenue de marché — reconnaissances de la liste de contrôle | oui | oui (preuves, juridiction, attestation testnet), texte tel que servi + case à cocher — **non vérifié sur la pile** (étape « papier » préalable non faite) | `/mm/agents/:id/golive/ack` | — |39| Tenue de marché — mandat de cotation réel | oui | **non disponible dans cette version** : le Core n'expose pas d'approbation vérifiée du mandat de cotation ; l'écran le dit et n'offre aucun contournement | testnet **OFF** : `SPW_DERIV_MM_TESTNET`, `SPW_TRADING_API_EXECUTION` ; mainnet **OFF** : `SPW_DERIV_LIVE_MAINNET`, `SPW_DERIV_MANDATE_MAINNET`, `SPW_DERIV_MM_MAINNET`, `SPW_TRADING_API_EXECUTION` | étude du labo et simulation NÉGATIVES ; « no funded account, mainnet or testnet, was touched » (doc) |40| Arbitrage de financement / inter-plateformes — réel | non (indisponible) | non : raison du serveur affichée | indisponible (`liveReason`) | une seule plateforme sous mandat |41| Gestionnaire de risque (superviseur) | oui | création par gabarit, aperçu, limites, journal ; pas d'écran dédié | `research, paper, live` annoncés | non exercé ici |42| Coffre : adresse, QR, soldes | oui (`AgentFund.tsx`) | oui — vérifié sur la pile (adresse complète, QR) | adresse dérivée par le signataire | — |43| Coffre : alimenter | oui (envoi intégré) | ouvre le parcours Envoyer du portefeuille (réseau et actif choisis) ; le destinataire est collé par le propriétaire — capture seulement | parcours d'envoi standard | l'app ne préremplit pas le destinataire (choix délibéré) |44| Coffre : fonds sur un autre réseau | oui | oui (`fundsElsewhere`) — vérifié vide sur la pile | lecture des autres réseaux EVM | — |45| Coffre : retour vers le propriétaire + suivi | oui (`withdrawTrack.tsx`) | oui : solde entier d'un actif, clé d'idempotence réutilisée, suivi jusqu'à confirmé ET arrivé — **test unitaire (clé) ; l'opération elle-même non exécutée sur la pile** | `/agents/:id/withdraw` ; mandat à révoquer d'abord sur le réseau de l'agent | à exercer sur le fork avant toute confiance |46| Modification des limites perp en simulation (`setPerpRisk`) | oui | **non fait** | route `/perp/risk` | — |47| Modification de la configuration d'un agent flux (`updateConfig`) | oui | **non fait** (lecture des versions de configuration seulement) | route `/config` | — |48| Hors ligne | — | dernière liste (`agents-list`), dernier arrêt d'urgence (`agents-kill-switch`), dernier aperçu (`agents-overview-<id>`) ; toutes les actions désactivées | — | les registres par mode ne sont pas conservés |4950## Ce que le serveur de la pile annonce (2026-11-18)5152`deriv_live_mainnet=OFF(missing SPW_DERIV_LIVE_MAINNET)`, `deriv_mandate_mainnet=OFF(missing SPW_DERIV_LIVE_MAINNET+SPW_DERIV_MANDATE_MAINNET)`,53`trading_api_execution=OFF(missing SPW_TRADING_API_EXECUTION)`,54`deriv_mm_mainnet=OFF(missing SPW_DERIV_LIVE_MAINNET+SPW_DERIV_MANDATE_MAINNET+SPW_DERIV_MM_MAINNET+SPW_TRADING_API_EXECUTION)`,55`deriv_mm_testnet=OFF(missing SPW_DERIV_MM_TESTNET+SPW_TRADING_API_EXECUTION)`, `strategy_sandbox_enforced=on`, `broadcast=on` (fork), `workers=on`.56L'état de ces verrous en production n'a pas été lu depuis cette branche.57