SPB Git

Repository Public

README.md 34.1 KB 545 lines markdown

1<div align="center">23<img src="docs/brand/logo.svg" alt="Logo SP Wallet iOS" width="560">45<br><br>67<img src="docs/brand/icon.png" alt="Icône SP Wallet iOS" width="112" height="112">89# 🛡️ SP Wallet — iOS et iPadOS1011**Client natif (Swift 6, SwiftUI, aucune vue web) du portefeuille multichaîne [wallet.spboucher.ai](https://wallet.spboucher.ai) : l'iPhone et l'iPad consultent, préparent et autorisent ; les clés privées restent dans le signataire isolé du cluster MacLustr.**1213**Auteur : [Simon-Pierre Boucher](https://www.spboucher.ai)**1415[![wallet.spboucher.ai](https://img.shields.io/website?url=https%3A%2F%2Fwallet.spboucher.ai&label=wallet.spboucher.ai&style=for-the-badge&up_message=en%20ligne&down_message=hors%20ligne)](https://wallet.spboucher.ai)16![version](https://img.shields.io/badge/version-1.0.0%20%283%29-blue?style=for-the-badge)17![plateforme](https://img.shields.io/badge/plateforme-iOS%2026%2B%20%C2%B7%20iPadOS%2026%2B-000000?style=for-the-badge&logo=apple&logoColor=white)18![licence](https://img.shields.io/badge/licence-tous%20droits%20r%C3%A9serv%C3%A9s-lightgrey?style=for-the-badge)19![author](https://img.shields.io/badge/author-Simon--Pierre%20Boucher-0A66C2?style=for-the-badge)2021![Swift](https://img.shields.io/badge/Swift-6.0%20%C2%B7%20concurrence%20stricte-F05138?style=flat-square&logo=swift&logoColor=white)22![SwiftUI](https://img.shields.io/badge/SwiftUI-100%20%25%20natif-0D96F6?style=flat-square&logo=swift&logoColor=white)23![Xcode](https://img.shields.io/badge/Xcode-27.2-147EFB?style=flat-square&logo=xcode&logoColor=white)24![XcodeGen](https://img.shields.io/badge/XcodeGen-project.yml-8A2BE2?style=flat-square)25![SPWalletCore](https://img.shields.io/badge/SPWalletCore-paquet%20Swift%20local-34D399?style=flat-square)26![WidgetKit](https://img.shields.io/badge/WidgetKit-3%20widgets-FF9500?style=flat-square)27![App Intents](https://img.shields.io/badge/App%20Intents-4%20raccourcis-5856D6?style=flat-square)28![Swift Charts](https://img.shields.io/badge/Swift%20Charts-graphiques-FF2D55?style=flat-square)29![Passkeys](https://img.shields.io/badge/WebAuthn-passkeys%20li%C3%A9es%20%C3%A0%20l%27intention-3423A6?style=flat-square&logo=webauthn&logoColor=white)30![Swift Testing](https://img.shields.io/badge/Swift%20Testing-%40Test-6E9F18?style=flat-square)31![WebKit](https://img.shields.io/badge/WebKit-aucune%20vue%20web-lightgrey?style=flat-square)32![dépendances](https://img.shields.io/badge/d%C3%A9pendances%20tierces-0-brightgreen?style=flat-square)3334[![commits](https://git.spboucher.ai/badge/sp-wallet-ios/commits.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/commits)35[![last commit](https://git.spboucher.ai/badge/sp-wallet-ios/last-commit.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/commits)36[![activity](https://git.spboucher.ai/badge/sp-wallet-ios/activity.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/insights)37[![language](https://git.spboucher.ai/badge/sp-wallet-ios/language.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios)38[![languages](https://git.spboucher.ai/badge/sp-wallet-ios/languages.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/insights)39[![size](https://git.spboucher.ai/badge/sp-wallet-ios/size.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios)40[![branches](https://git.spboucher.ai/badge/sp-wallet-ios/branches.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/branches)41[![tags](https://git.spboucher.ai/badge/sp-wallet-ios/tags.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios/tags)42[![clones](https://git.spboucher.ai/badge/sp-wallet-ios/clones.svg?style=flat-square)](https://git.spboucher.ai/sp-wallet-ios)4344![fichiers Swift](https://img.shields.io/badge/fichiers%20Swift-121-informational?style=flat-square)45![lignes Swift](https://img.shields.io/badge/lignes%20Swift-30%20507-informational?style=flat-square)46![sections](https://img.shields.io/badge/sections-15-blue?style=flat-square)47![dossiers de fonctionnalités](https://img.shields.io/badge/dossiers%20de%20fonctionnalit%C3%A9s-18-blue?style=flat-square)48![tests unitaires](https://img.shields.io/badge/tests%20unitaires-168-brightgreen?style=flat-square)49![tests d'interface](https://img.shields.io/badge/tests%20d%27interface-38-brightgreen?style=flat-square)50![chaînes localisées](https://img.shields.io/badge/cha%C3%AEnes%20fr%20%E2%86%92%20en-4%20037-blue?style=flat-square)51![logos](https://img.shields.io/badge/logos%20embarqu%C3%A9s-96-blue?style=flat-square)52![cibles Xcode](https://img.shields.io/badge/cibles%20Xcode-4-informational?style=flat-square)5354![bundle](https://img.shields.io/badge/bundle-ai.spboucher.spwallet.ios-555555?style=flat-square&logo=apple&logoColor=white)55![signature](https://img.shields.io/badge/signature-Apple%20Distribution%20%C2%B7%20automatique-000000?style=flat-square&logo=apple&logoColor=white)56![TestFlight](https://img.shields.io/badge/TestFlight-test%20interne-0D96F6?style=flat-square&logo=testflight&logoColor=white)57![cible](https://img.shields.io/badge/cible%20de%20d%C3%A9ploiement-iOS%2026.0-informational?style=flat-square)58![appareils](https://img.shields.io/badge/appareils-iPhone%20%C2%B7%20iPad-informational?style=flat-square)59![backend](https://img.shields.io/badge/backend-M2M32c%3A8650%20%C2%B7%20signataire%20m6ma%3A8651-8A2BE2?style=flat-square)6061</div>6263---6465## Sommaire6667- [Vue d'ensemble](#-vue-densemble)68- [Fonctionnalités](#-fonctionnalités)69- [Architecture](#-architecture)70- [Pile technique](#-pile-technique)71- [Organisation du dépôt](#-organisation-du-dépôt)72- [Construction](#-construction)73- [Configuration](#-configuration)74- [Écrans et navigation](#-écrans-et-navigation)75- [Modèle de données local](#-modèle-de-données-local)76- [Sécurité et vie privée](#-sécurité-et-vie-privée)77- [Tests](#-tests)78- [Distribution](#-distribution)79- [Pièges rencontrés](#-pièges-rencontrés)80- [État et limites connues](#-état-et-limites-connues)81- [Documentation](#-documentation)82- [Auteur](#-auteur)83- [Licence](#-licence)8485---8687## 🎯 Vue d'ensemble8889**SP Wallet iOS** est l'application iPhone et iPad du portefeuille multichaîne personnel90[wallet.spboucher.ai](https://wallet.spboucher.ai) : consultation, envoi, réception, échanges, ponts, NFT, contrats à terme,91agents de trading, alertes et recherche. Elle est écrite entièrement en Swift 6 et SwiftUI, **sans aucune vue web**.9293Trois principes tiennent tout le projet :9495- **Chaque opération est approuvée par une passkey dont le défi est l'empreinte de l'objet affiché.** L'app recalcule cette96  empreinte (SHA-256 de l'objet canonique) et refuse d'approuver ce qu'elle ne sait pas vérifier. Face ID ne remplace jamais97  cette signature.98- **Aucune donnée inventée.** Un écran montre ce que le serveur a dit, ou un instantané daté. Seul l'état « confirmé »99  (`finalized`) atteste une transaction réglée.100- **Hors ligne : lecture seule.** Les dernières données synchronisées restent consultables, datées ; aucune opération101  financière n'est possible sans réseau.102103L'app ne contient **aucune clé privée, aucune phrase de récupération, aucune signature de transaction** : elle consulte, prépare104et autorise. Le signataire isolé du cluster MacLustr signe.105106### Famille SP Wallet107108| Dépôt | Rôle | Plateforme |109|---|---|---|110| [sp-wallet](https://git.spboucher.ai/sp-wallet) | API, site web, signataire isolé | web · [wallet.spboucher.ai](https://wallet.spboucher.ai) |111| [sp-wallet-core](https://git.spboucher.ai/sp-wallet-core) | `SPWalletCore`, paquet Swift partagé (client API, objets canoniques, liaison passkey, validation d'adresses) | iOS 18+ · macOS 15+ |112| [sp-wallet-macos](https://git.spboucher.ai/sp-wallet-macos) | client natif macOS | macOS |113| **sp-wallet-ios** (ce dépôt) | client natif iPhone et iPad, widgets, raccourcis | iOS 26+ · iPadOS 26+ |114115Ce projet **possède le socle** `SPWalletCore`, partagé avec SP Wallet macOS ; le backend appartient au dépôt `sp-wallet` et ne116se modifie jamais d'ici.117118## ✨ Fonctionnalités119120| Domaine | Ce que fait l'app |121|---|---|122| Connexion | passkey du portefeuille (`webcredentials:wallet.spboucher.ai`) ; verrou local facultatif Face ID / Touch ID / code de l'appareil |123| Tableau de bord | valeur, répartition, soldes par réseau (23 réseaux côté serveur), bandeau de fraîcheur |124| Portefeuille | actifs du registre vérifié, page d'actif, graphiques Swift Charts, tableau triable sur iPad |125| Recevoir | adresse, code QR, avertissements |126| Envoyer | brouillon → intention vérifiée → passkey → signataire → suivi jusqu'à `finalized` ; clé d'idempotence stable par demande |127| QR | lecture d'une adresse ou d'une URI de paiement par l'appareil photo ; le résultat ne fait que préremplir le formulaire |128| Activité | historique, filtres, export CSV / PDF |129| Échanger | échange sur un même réseau (KyberSwap), revue de l'intention, suivi de l'opération |130| Transférer entre réseaux | pont USDC CCTP, échange natif entre réseaux (THORChain), plans en plusieurs étapes (revue, suivi, reprise, réclamation) |131| NFT | galerie, page d'un NFT, marché en lecture, transfert par passkey, liste blanche de destinations, protections |132| Marchés | explorateur, comparateur, marchés privés, ordres unifiés |133| Contrats à terme | données et carnet en direct (Hyperliquid), compte papier, approbations réelles par ordre, collatéral ; GMX, dYdX, edgeX : état ou données seulement |134| Agents de trading | simulation, papier, réel au comptant sous mandat, perpétuels, espace market making (papier), coffre de l'agent |135| Risque et limites | limites, interrupteur général (levée par passkey), arrêts automatiques, mandats de trading |136| Développeur | clés API (création, rotation, révocation), webhooks |137| Alertes | centre d'alertes, réglages, état du système ; notifications locales à partir des alertes confirmées par le serveur |138| Recherche | création et annulation de travaux, résultats distingués par auteur |139| Sécurité | signataire, limites, passkeys, sessions, journal d'audit, arrêt d'urgence (sens unique) |140| Widgets | Valeur (petit), Actifs (moyen), Activité (moyen et grand) ; montants seulement si le propriétaire les autorise |141| Raccourcis | 4 App Intents (ouvrir le portefeuille, l'historique, les alertes, un actif) : navigation seulement |142| iPad | barre latérale groupée, grilles et tableaux, menus contextuels, raccourcis du clavier matériel, plusieurs scènes |143| Langues | français (langue source) et anglais : 4 037 chaînes dans `Resources/Localizable.xcstrings` |144145**Rien d'automatique** : une cotation n'exécute rien ; un QR, un lien `spwallet://`, un widget ou Siri ne préparent ni146n'approuvent rien. **Aucun paramètre de risque par défaut** : levier, budget, plafond par ordre, limite de perte, marchés et147expiration sont saisis explicitement. **Arrêter est toujours possible** : pause, arrêt, révocation et arrêt d'urgence ne148demandent jamais plus qu'une confirmation.149150## 🏗 Architecture151152```mermaid153flowchart LR154  subgraph Appareil["iPhone / iPad"]155    UI["Features/ (SwiftUI)<br/>15 sections"]156    Model["AppModel · Router<br/>AppEnvironment"]157    Core["SPWalletCore<br/>APIClient · ApprovalBinding<br/>AddressValidator · OfflineStore"]158    Sys["Core/<br/>passkey Apple · verrou local<br/>cache · alertes · rafraîchissement"]159    W["SPWalletWidgets<br/>(WidgetKit)"]160    I["App Intents<br/>spwallet://"]161    UI --> Model --> Core162    Model --> Sys163    Model -- "instantané daté<br/>(App Group)" --> W164    W -- "lien" --> Model165    I -- "lien" --> Model166  end167  Core -- "HTTPS · /api/v1<br/>cookie __Host-spw<br/>Origin + X-SPW-CSRF" --> API["API SP Wallet<br/>wallet.spboucher.ai<br/>M2M32c:8650"]168  API -- "HMAC" --> Signer["Signataire isolé<br/>m6ma:8651<br/>clés + passkeys épinglées"]169  Signer --> Chains["Réseaux<br/>(diffusion)"]170```171172Le flux d'approbation est le même pour toute opération qui signe (transfert, échange, pont, NFT, ordre, mandat, limite…) :173174```mermaid175sequenceDiagram176  autonumber177  participant P as Propriétaire178  participant A as App (SwiftUI)179  participant C as SPWalletCore180  participant S as API SP Wallet181  participant G as Signataire isolé182  P->>A: saisit l'opération (montant, destination…)183  A->>C: prepare…(demande, clé d'idempotence)184  C->>S: POST préparation185  S-->>C: objet canonique + options WebAuthn (défi)186  C->>C: ApprovalBinding.verify : défi == SHA-256(objet canonique),<br/>rpId attendu, vérification de l'utilisateur exigée,<br/>objet == demande187  C-->>A: VerifiedApproval (ou refus : rien n'est signé)188  A->>P: revue de l'objet EN ENTIER (aucune troncature)189  P->>A: approuve190  A->>P: feuille système de passkey (assertion WebAuthn)191  A->>C: approve…(VerifiedApproval, assertion)192  C->>S: POST approbation193  S->>G: objet + assertion194  G->>G: recalcule l'empreinte, vérifie l'assertion<br/>avec la clé publique épinglée, applique sa politique195  G-->>S: transaction signée196  S-->>A: état (broadcast → confirming → finalized)197  A->>P: suivi ; seul « finalized » est un succès198```199200Si le Core lève `ApprovalError.unsupported` (objet impossible à recalculer, champ inconnu), l'écran l'explique et n'offre201**aucun contournement**.202203## 🧱 Pile technique204205| Couche | Techno | Version / valeur lue dans le dépôt | Rôle |206|---|---|---|---|207| Langage | Swift | `SWIFT_VERSION` 6.0, `SWIFT_STRICT_CONCURRENCY: complete` | tout le code |208| Interface | SwiftUI, Swift Charts | iOS 26.0 minimum | écrans, graphiques |209| Projet | XcodeGen | `project.yml` (le `.xcodeproj` n'est pas versionné) | génération du projet |210| Outils | Xcode | 27.2, simulateurs iOS 26.5 (`docs/DISTRIBUTION.md`) | construction, tests |211| Socle | [`SPWalletCore`](https://git.spboucher.ai/sp-wallet-core) | paquet local `../SPWalletCore`, produits `SPWalletCore` et `SPWalletTestSupport` | client API, canoniques, liaison passkey |212| Authentification | passkeys Apple, LocalAuthentication | domaine associé `webcredentials:wallet.spboucher.ai` | connexion, approbation, verrou local |213| Extensions | WidgetKit, App Intents | cible `SPWalletWidgets`, `Intents/WalletIntents.swift` | widgets, Siri, Raccourcis, Spotlight |214| Arrière-plan | rafraîchissement en arrière-plan | identifiant `ai.spboucher.spwallet.ios.refresh`, mode `fetch` | mise à jour des données |215| Notifications | locales seulement | le serveur n'a pas de voie APNs | alertes |216| Tests | Swift Testing, XCUITest | 168 tests unitaires, 38 tests d'interface | logique et parcours |217| Dépendances tierces | — | aucune | — |218219## 📁 Organisation du dépôt220221```222project.yml                  définition XcodeGen : app, extension de widgets, tests unitaires, tests d'interface223App/                         SPWalletApp, AppModel, AppEnvironment, AppConfiguration, Router (sections, liens), RootView224Core/225  Authentication/            PlatformPasskeyAuthenticator (passkeys Apple)226  Persistence/               AppCache (instantanés hors ligne datés)227  Security/                  DeviceLock (Face ID / Touch ID / code : protège l'affichage, n'autorise rien)228  System/                    alertes, notifications locales, rafraîchissement en arrière-plan, contrôles d'adresse229Components/                  Theme, Money, Rows, StatusViews, TransactionReview, AssetIcon, QRCodeView, QRScannerView230Features/                    18 dossiers, 78 fichiers Swift231  Dashboard · Portfolio · Assets · Activity · Explore · Login · Settings232  Send · Receive · Swap · Bridge · NFTs233  DeFi (marchés) · Futures · TradingAgents · Research234  Alerts · Security (risque, mandats, clés développeur, webhooks)235Intents/                     WalletIntents (4 App Intents + AppShortcutsProvider)236Widgets/                     SPWalletWidgets (Valeur, Actifs, Activité), Info.plist, droits, manifeste de confidentialité237WidgetShared/                WidgetSnapshot : résumé daté écrit par l'app dans l'App Group238Resources/                   Info.plist, droits (appareil et simulateur), PrivacyInfo.xcprivacy,239                             Localizable.xcstrings, Assets.xcassets (icône claire / sombre / teintée, 96 logos)240Design/                      sources SVG de l'icône (AppIcon, Dark, Tinted) et de la marque241Scripts/                     build.sh, release.sh, check-release.sh, asc.py, import-logos.py, sync-strings.sh, ExportOptions.plist242Tests/                       9 fichiers Swift Testing (168 tests)243UITests/                     8 fichiers XCUITest (38 tests)244docs/                        AUDIT, PARITY_MATRIX (+ parity/ : 6 domaines), IMPLEMENTATION_STATUS, UI_CONVENTIONS,245                             DISTRIBUTION, LOGO_SOURCES (+ logo-licences.json), brand/ (logo et icône de ce README)246CLAUDE.md                    règles du projet, recettes, pièges247```248249<details>250<summary>Taille des dossiers de fonctionnalités (fichiers · lignes Swift)</summary>251252| Dossier | Fichiers | Lignes | Dossier | Fichiers | Lignes |253|---|---:|---:|---|---:|---:|254| `Futures` | 14 | 4 349 | `Alerts` | 3 | 966 |255| `NFTs` | 11 | 4 287 | `Research` | 3 | 841 |256| `TradingAgents` | 10 | 3 698 | `Send` | 1 | 331 |257| `Security` | 11 | 2 885 | `Activity` | 1 | 273 |258| `DeFi` | 7 | 1 770 | `Dashboard` | 1 | 220 |259| `Swap` | 5 | 1 687 | `Settings` | 2 | 199 |260| `Bridge` | 4 | 1 157 | `Assets` | 1 | 162 |261| `Portfolio` | 1 | 91 | `Receive` | 1 | 84 |262| `Login` | 1 | 44 | `Explore` | 1 | 43 |263264</details>265266## 🚀 Construction267268Prérequis : Xcode 27.2, [XcodeGen](https://github.com/yonaskolb/XcodeGen), et le socle cloné **à côté** de ce dépôt sous le269nom `SPWalletCore` (`project.yml` référence `../SPWalletCore`).270271```bash272git clone gitsrv:srv/git/sp-wallet-core.git SPWalletCore273git clone gitsrv:srv/git/sp-wallet-ios.git  SPWallet-iOS274cd SPWallet-iOS275276Scripts/build.sh generate      # Info-Debug.plist + xcodegen (à relancer après tout ajout de fichier)277Scripts/build.sh debug         # construction Debug sur le simulateur « SPWallet iPhone »278Scripts/build.sh release       # construction Release (simulateur générique)279Scripts/build.sh core          # tests du socle (swift test dans ../SPWalletCore)280Scripts/build.sh test          # tests unitaires de l'app281Scripts/build.sh uitest        # tests d'interface (captures exportées dans build/shots)282```283284`SPWALLET_SIM="SPWallet iPad"` choisit la tablette. La sortie de `xcodebuild` est filtrée ; le journal complet est dans285`build/logs/`.286287Les tests d'interface et le mode Debug parlent à une **pile jetable** locale, jamais à la production :288289```bash290../SPWalletCore/Scripts/dev-stack.sh up-fork    # vrai serveur, vrai signataire, clés aléatoires, Base = fork anvil local, faux ETH291../SPWalletCore/Scripts/dev-stack.sh down       # arrêt par PID de port292```293294Autres scripts : `Scripts/asc.py GET /v1/…` (client minimal de l'API App Store Connect), `Scripts/import-logos.py` (logos295du backend vers le catalogue d'images), `Scripts/sync-strings.sh` (catalogue de chaînes).296297## ⚙️ Configuration298299Aucun secret dans le dépôt. Noms seulement :300301| Où | Clé | Rôle |302|---|---|---|303| `Resources/Info.plist` | `SPWalletOrigin` | origine du portefeuille (production) |304| `Resources/Info.plist` | `SPWalletRelyingParty` | partie de confiance WebAuthn |305| `Resources/Info.plist` | `SPWalletAppGroup` | App Group partagé avec les widgets |306| environnement, **Debug seulement** | `SPWALLET_ORIGIN` | remplace l'origine ; boucle locale uniquement (`localhost` / `127.0.0.1`) |307| environnement, **Debug seulement** | `SPWALLET_DEV_DIR` | dossier de la pile jetable (jeton de mise en place, passkey logicielle) |308| environnement, **Debug seulement** | `SPWALLET_EPHEMERAL` | état vide en mémoire (tests d'interface) |309| scripts | `SPWALLET_SIM` | simulateur visé |310| tests d'interface | `TEST_RUNNER_SPWALLET_UITEST_ORIGIN`, `TEST_RUNNER_SPWALLET_UITEST_DIR` | viser une autre pile jetable |311| `Scripts/release.sh` | `ASC_KEY_ID`, `ASC_ISSUER_ID` | clé API App Store Connect (le fichier de clé reste hors dépôt) |312313En Release, l'origine ne peut être que `https://wallet.spboucher.ai` : `Scripts/check-release.sh` refuse tout autre binaire.314Le simulateur utilise des droits sans domaine associé (`Resources/SPWallet-Simulator.entitlements`) : il ne parle jamais aux315passkeys de production.316317## 🧭 Écrans et navigation318319Quinze sections (`AppSection`, `App/Router.swift`). Sur iPhone : cinq onglets (Accueil, Portefeuille, Activité, Explorer,320Réglages), le reste s'atteint depuis Explorer. Sur iPad : barre latérale en cinq groupes.321322| Groupe (iPad) | Section | Dossier |323|---|---|---|324| Portefeuille | Accueil | `Features/Dashboard` |325| Portefeuille | Portefeuille | `Features/Portfolio`, `Features/Assets` |326| Portefeuille | Activité | `Features/Activity` |327| Opérations | Échanger | `Features/Swap` |328| Opérations | Transférer entre réseaux | `Features/Bridge` |329| Opérations | NFT | `Features/NFTs` |330| Marchés | Marchés | `Features/DeFi` |331| Marchés | Contrats à terme | `Features/Futures` |332| Marchés | Agents de trading | `Features/TradingAgents` |333| Marchés | Recherche | `Features/Research` |334| Surveillance | Alertes | `Features/Alerts` |335| Surveillance | Risque et limites | `Features/Security` |336| Surveillance | Sécurité | `Features/Security` |337| App | Réglages | `Features/Settings` |338| (onglet iPhone) | Explorer | `Features/Explore` |339340Feuilles des parcours principaux : **Envoyer** (`Features/Send`) et **Recevoir** (`Features/Receive`).341342**Liens** `spwallet://home | portfolio | activity | alerts | asset/<SYMBOLE>` (widgets, App Intents) : un lien **ouvre** un343écran, rien de plus.344345**Clavier matériel (iPad)** — aucune commande n'effectue d'opération financière :346347| Raccourci | Action | Raccourci | Action |348|---|---|---|---|349| <kbd>⌘1</kbd> … <kbd>⌘9</kbd> | Accueil, Portefeuille, Activité, Échanger, Marchés, Contrats à terme, Agents, Alertes, Sécurité | <kbd>⌘,</kbd> | Réglages |350| <kbd>⌘R</kbd> | Actualiser | <kbd>⇧⌘E</kbd> | Envoyer… |351| <kbd>⇧⌘D</kbd> | Recevoir… | <kbd>⇧⌘L</kbd> | Verrouiller |352353**Widgets** (`Widgets/SPWalletWidgets.swift`) : Valeur (`systemSmall`), Actifs (`systemMedium`), Activité (`systemMedium`,354`systemLarge`).355356**App Intents** : Ouvrir le portefeuille, Afficher l'historique, Ouvrir les alertes, Consulter un actif. Aucun ne renvoie de357solde à Siri.358359## 🗃 Modèle de données local360361L'app n'a pas de base de données : la vérité est sur le serveur.362363| Donnée | Emplacement | Contenu |364|---|---|---|365| Session | Trousseau, cet appareil seulement | le cookie de session, seul secret conservé |366| Cache hors ligne | `Core/Persistence/AppCache.swift` (au-dessus d'`OfflineStore` du socle) | dernières réponses du serveur, datées : ce que les écrans montrent déjà (adresses publiques, soldes, historique, alertes). Jamais d'identifiant ni de secret |367| Instantané des widgets | fichier `widget-snapshot.json` dans l'App Group, protégé jusqu'au premier déverrouillage | total, actifs, transactions récentes, alertes non lues ; montants absents si le propriétaire ne les autorise pas ; `totalComplete` faux = borne inférieure, étiquetée comme telle |368369États d'une transaction (machine à états du serveur) :370`draft → pending_approval → approved → signed → broadcast → confirming → finalized`, avec `rejected`, `expired`, `failed`,371`replaced`, `reorged`, `not_broadcast`. Une transaction diffusée n'est pas confirmée.372373## 🔐 Sécurité et vie privée374375- **Aucune clé privée dans l'app.** Les clés n'existent que dans le signataire isolé, qui épingle lui-même les clés publiques376  des passkeys et vérifie chaque assertion indépendamment de l'API.377- **Toute approbation passe par `ApprovalBinding.verify`** du socle : défi recalculé depuis l'objet affiché, `rpId` vérifié,378  vérification de l'utilisateur exigée, objet comparé à la demande. Un champ inconnu dans un objet canonique est un refus, pas379  une omission.380- **Le verrou Face ID / Touch ID ne remplace jamais l'assertion WebAuthn** : il protège ce qui est affiché sur cet appareil.381- **Session** : cookie `__Host-spw` géré à la main, envoyé à la seule origine configurée ; toute écriture porte `Origin` et382  `X-SPW-CSRF`. Trente minutes d'inactivité, douze heures au plus (règle du serveur).383- **Réseau** : `NSAllowsArbitraryLoads` et `NSAllowsLocalNetworking` à `false` en Release.384- **Vie privée** : `PrivacyInfo.xcprivacy` déclare aucun suivi et aucune collecte. Journaux : `Logger` avec `privacy: .public`385  uniquement pour des codes ; jamais d'adresse, de montant, de jeton ni de secret.386- **Autorisations** : appareil photo (lecture du QR d'une adresse seulement), Face ID (déverrouillage local).387- **Binaire contrôlé** : `Scripts/check-release.sh` refuse un binaire qui contiendrait le code de la passkey logicielle de388  test, une origine de développement, une URL de boucle locale, une vue web, une autre origine que la production, des droits389  inattendus ou — avec `--distribution` — une signature qui n'est pas Apple Distribution.390- **Jamais de transaction réelle pour tester.** La passkey logicielle (`SPWalletTestSupport`) n'est référencée que sous391  `#if DEBUG` et refuse toute origine `spboucher.ai`.392- **Logos** : 96 logos embarqués, affichés sans appel à un tiers ; sources et licences dans `docs/LOGO_SOURCES.md` et393  `docs/logo-licences.json`.394395L'audit du backend qui fonde ces règles est dans `docs/AUDIT.md` (garde, session, intention canonique, maturité réelle par396domaine).397398## 🧪 Tests399400| Suite | Commande | Compte (lu dans le dépôt) |401|---|---|---|402| Socle `SPWalletCore` | `Scripts/build.sh core` | 312 tests unitaires + 9 tests contre la pile jetable (dépôt [sp-wallet-core](https://git.spboucher.ai/sp-wallet-core)) |403| Logique de l'app (Swift Testing) | `Scripts/build.sh test` | 168 tests, 9 fichiers |404| Interface (XCUITest), iPhone et iPad | `Scripts/build.sh uitest` | 38 tests, 8 fichiers |405| Binaire de distribution | `Scripts/check-release.sh <app> --distribution` | contrôle de l'IPA exporté |406407<details>408<summary>Détail par fichier</summary>409410| Tests unitaires | Tests | Tests d'interface | Tests |411|---|---:|---|---:|412| `MarketsRiskTests` | 31 | `NFTUITests` | 9 |413| `AlertsResearchTests` | 24 | `FuturesUITests` | 6 |414| `FuturesFlowTests` | 24 | `MarketsRiskUITests` | 5 |415| `SwapFlowTests` | 24 | `SPWalletUITests` | 5 |416| `AgentsFlowTests` | 23 | `SwapUITests` | 5 |417| `NFTFlowTests` | 23 | `AgentsUITests` | 4 |418| `WalletBaseTests` | 13 | `AlertsResearchUITests` | 3 |419| `LocalizationTests` | 4 | `AllSectionsUITests` | 1 |420| `SmokeTests` | 2 | | |421422</details>423424Les tests d'interface tournent sur la pile jetable (`dev-stack.sh up-fork` : clés aléatoires, Base = fork local avec faux425ETH, passkey logicielle). **Jamais la production, jamais de fonds réels.** Un seul simulateur par exécution (`SPWALLET_SIM`).426427Vérifié par ces tests, d'après `docs/IMPLEMENTATION_STATUS.md` : connexion, tableau de bord, sections, réception, refus d'une428adresse invalide, envoi complet jusqu'au suivi sur iPhone et iPad ; ouverture et défilement de chaque section sans plantage ;429par domaine sur iPhone : échange KyberSwap complet sur fork, interrupteur général, limites, clés API, compte papier430Hyperliquid, agent papier puis réel sous mandat, liste blanche NFT, alertes, recherche.431432## 📦 Distribution433434Distribution par **TestFlight / App Store Connect** (la notarisation ne s'applique pas à une app iOS).435436```bash437Scripts/release.sh all        # archive + contrôles + export de l'IPA (dist/export) + contrôle de l'IPA exporté438Scripts/release.sh upload     # envoi explicite à TestFlight439```440441| Élément | Valeur |442|---|---|443| Version | 1.0.0 (3) — `MARKETING_VERSION` / `CURRENT_PROJECT_VERSION` de `project.yml` |444| Identifiants | `ai.spboucher.spwallet.ios` (Associated Domains, App Groups), `ai.spboucher.spwallet.ios.widgets` (App Groups) |445| App Group | `group.ai.spboucher.spwallet.ios` |446| Domaine associé | `webcredentials:wallet.spboucher.ai` (le fichier d'association du serveur doit lister l'identifiant de l'app) |447| Fiche App Store Connect | **SP Wallet**, app `6836540531`, langue principale fr-CA |448| Signature | automatique ; archive signée avec le compte Apple configuré dans Xcode, export et envoi avec la clé API |449| État | test interne TestFlight ; rien n'est soumis à la revue de l'App Store |450451**Particularité** : les App Groups ne se provisionnent pas avec une clé API App Store Connect ; l'archive est donc signée par452le compte Xcode (`-allowProvisioningUpdates` seul), la clé API sert à l'export et à l'envoi.453454**Nouvelle version** : incrémenter `CURRENT_PROJECT_VERSION` dans `project.yml`, lancer les tests, puis455`Scripts/release.sh all` et `Scripts/release.sh upload`.456457**Avant une soumission App Store** (non fait) : captures (produites par les tests d'interface dans `build/shots`),458description, URL d'assistance et de confidentialité, questionnaire de confidentialité cohérent avec `PrivacyInfo.xcprivacy`,459classification d'âge ; la règle 3.1.5 des App Review Guidelines exige un compte d'organisation pour une app de portefeuille460crypto et les licences applicables pour l'échange et les dérivés ; un compte de démonstration serait nécessaire à la revue.461Détails : `docs/DISTRIBUTION.md`.462463## 🧯 Pièges rencontrés464465- **Contenus présentés SwiftUI** : feuilles, `fullScreenCover`, popovers, destinations de navigation, cellules de `Table` et466  menus contextuels n'héritent pas de façon fiable des objets `@Environment`. Chaque contenu présenté se termine par467  **`.wallet(model)`** (`Components/Theme.swift`) — plantage sinon. Un objet `@Observable` propre à un écran se passe toujours468  en paramètre.469- Un `accessibilityIdentifier` posé sur un `Label` s'applique à son image : `.accessibilityElement(children: .combine)`470  d'abord. Ne pas le poser sur un conteneur : il écrase ceux des enfants.471- `KeyPath` vers une propriété `@MainActor` et `inout` vers une propriété isolée dans un appel `async` : refusés en Swift 6 →472  fonctions qui renvoient la nouvelle valeur.473- Deux suites de tests qui font le « setup propriétaire » en parallèle enrôlent deux clés : une seule tâche partagée.474- Une archive est signée Development (`get-task-allow` vrai) ; c'est l'export qui signe Distribution : **contrôler l'IPA475  exporté**, pas l'archive.476- `codesign … | grep -q` sous `pipefail` : tuyau cassé → lire dans une variable.477- zsh : ne jamais nommer une variable de boucle `path` (elle est liée à `PATH`).478- `dev-stack.sh down` tue par PID de port, jamais par motif de nom de processus.479- `Scripts/build.sh generate` après tout ajout de fichier (le projet Xcode est généré).480481## 🗺 État et limites connues482483D'après `docs/IMPLEMENTATION_STATUS.md` (2026-11-18).484485**Jamais vérifié — à valider sur appareil** (rien de ceci n'est exerçable sur simulateur) :4864871. connexion par passkey Apple contre `wallet.spboucher.ai` ;4882. approbation par passkey Apple d'une intention ;4893. verrou Face ID / Touch ID, ajout de la passkey de l'appareil, lecture de QR par l'appareil photo ;4904. widgets sur l'écran d'accueil et l'écran verrouillé, raccourcis Siri, notifications locales, rafraîchissement en491   arrière-plan ;4925. comportement sur iOS 27 (simulateurs disponibles : iOS 26.5) ;4936. VoiceOver, très grandes tailles de texte, mode sombre de tous les écrans.494495**Construit mais jamais exécuté** : pont CCTP au-delà du formulaire, échanges THORChain, plans en plusieurs étapes ; toute496approbation réelle sur Hyperliquid ; transfert réel d'un NFT ; création et approbation de mandats de trading, webhooks, retour497des fonds d'un coffre d'agent ; arrêt d'urgence du signataire (irréversible depuis l'app) ; parcours hors ligne à l'écran (le498cache est testé unitairement).499500**Limites connues** :501502- **Notifications** : le serveur n'a pas de voie APNs. L'app interroge le serveur toutes les 60 s quand elle est ouverte ; en503  arrière-plan, iOS décide du moment et la session expire après 30 minutes : pas de notification fiable app fermée.504- **Session** : reconnexion par passkey fréquente (30 minutes d'inactivité, 12 heures au plus).505- **Jetons personnalisés** : non pris en charge (le serveur n'accepte que son registre vérifié).506- **Market making réel** et **mandats de cotation** : non approuvables par les clients natifs.507- **Écritures de marché NFT**, inscriptions Bitcoin : non construites côté serveur.508- **GMX, dYdX, edgeX** : état ou données seulement.509- Textes venant du serveur (raisons de refus, listes de contrôle) : affichés tels quels, en anglais.510- « Vente » a une seule traduction anglaise (« Sale ») pour l'activité NFT et le côté vendeur des ordres.511- L'IPA pèse environ 47 Mo, dont environ 20 Mo de logos.512513**Écarts volontaires par rapport au web** : aucune tolérance, vitesse de pont, route, levier ni limite n'est présélectionnée ;514l'app recalcule le défi de chaque approbation et refuse d'approuver un objet qu'elle ne sait pas vérifier ; un seul formulaire515d'ordre (terminal Contrats à terme).516517La parité fonction par fonction (Web · macOS · iPhone · iPad) est dans `docs/PARITY_MATRIX.md`.518519## 📚 Documentation520521| Document | Contenu |522|---|---|523| [`docs/AUDIT.md`](docs/AUDIT.md) | audit du backend : garde, session, intention canonique, maturité réelle par domaine |524| [`docs/PARITY_MATRIX.md`](docs/PARITY_MATRIX.md), [`docs/parity/`](docs/parity) | parité Web / macOS / iPhone / iPad, fonction par fonction (agents, contrats à terme, marchés et risque, NFT, opérations, échange) |525| [`docs/IMPLEMENTATION_STATUS.md`](docs/IMPLEMENTATION_STATUS.md) | ce qui est vérifié, ce qui reste à valider sur appareil, limites |526| [`docs/UI_CONVENTIONS.md`](docs/UI_CONVENTIONS.md) | règles d'écran et de code, briques à réutiliser |527| [`docs/DISTRIBUTION.md`](docs/DISTRIBUTION.md) | signature, TestFlight, App Store Connect |528| [`docs/LOGO_SOURCES.md`](docs/LOGO_SOURCES.md) | provenance et licence de chaque logo |529| [`CLAUDE.md`](CLAUDE.md) | règles du projet, recettes, pièges |530531## 👤 Auteur532533<div align="center">534<img src="docs/brand/icon.png" width="64" height="64" alt=""><br>535536**Simon-Pierre Boucher** — conception, développement, exploitation<br>537[www.spboucher.ai](https://www.spboucher.ai) · [git.spboucher.ai](https://git.spboucher.ai) · contact@spboucher.ai538539</div>540541## 📄 Licence542543Tous droits réservés © 2026 Simon-Pierre Boucher. Les logos d'actifs, de réseaux et de services restent les marques de leurs544propriétaires ; leurs sources et licences sont listées dans [`docs/LOGO_SOURCES.md`](docs/LOGO_SOURCES.md).545
Files main
Menu

Theme