🛡️ SP Wallet — iOS et iPadOS
Client natif (Swift 6, SwiftUI, aucune vue web) du portefeuille multichaîne 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.
Auteur : Simon-Pierre Boucher
Sommaire
- Vue d'ensemble
- Fonctionnalités
- Architecture
- Pile technique
- Organisation du dépôt
- Construction
- Configuration
- Écrans et navigation
- Modèle de données local
- Sécurité et vie privée
- Tests
- Distribution
- Pièges rencontrés
- État et limites connues
- Documentation
- Auteur
- Licence
🎯 Vue d'ensemble
SP Wallet iOS est l'application iPhone et iPad du portefeuille multichaîne personnel wallet.spboucher.ai : consultation, envoi, réception, échanges, ponts, NFT, contrats à terme, agents de trading, alertes et recherche. Elle est écrite entièrement en Swift 6 et SwiftUI, sans aucune vue web.
Trois principes tiennent tout le projet :
- Chaque opération est approuvée par une passkey dont le défi est l'empreinte de l'objet affiché. L'app recalcule cette empreinte (SHA-256 de l'objet canonique) et refuse d'approuver ce qu'elle ne sait pas vérifier. Face ID ne remplace jamais cette signature.
- Aucune donnée inventée. Un écran montre ce que le serveur a dit, ou un instantané daté. Seul l'état « confirmé »
(
finalized) atteste une transaction réglée. - Hors ligne : lecture seule. Les dernières données synchronisées restent consultables, datées ; aucune opération financière n'est possible sans réseau.
L'app ne contient aucune clé privée, aucune phrase de récupération, aucune signature de transaction : elle consulte, prépare et autorise. Le signataire isolé du cluster MacLustr signe.
Famille SP Wallet
| Dépôt | Rôle | Plateforme |
|---|---|---|
| sp-wallet | API, site web, signataire isolé | web · wallet.spboucher.ai |
| sp-wallet-core | SPWalletCore, paquet Swift partagé (client API, objets canoniques, liaison passkey, validation d'adresses) |
iOS 18+ · macOS 15+ |
| sp-wallet-macos | client natif macOS | macOS |
| sp-wallet-ios (ce dépôt) | client natif iPhone et iPad, widgets, raccourcis | iOS 26+ · iPadOS 26+ |
Ce projet possède le socle SPWalletCore, partagé avec SP Wallet macOS ; le backend appartient au dépôt sp-wallet et ne
se modifie jamais d'ici.
✨ Fonctionnalités
| Domaine | Ce que fait l'app |
|---|---|
| Connexion | passkey du portefeuille (webcredentials:wallet.spboucher.ai) ; verrou local facultatif Face ID / Touch ID / code de l'appareil |
| Tableau de bord | valeur, répartition, soldes par réseau (23 réseaux côté serveur), bandeau de fraîcheur |
| Portefeuille | actifs du registre vérifié, page d'actif, graphiques Swift Charts, tableau triable sur iPad |
| Recevoir | adresse, code QR, avertissements |
| Envoyer | brouillon → intention vérifiée → passkey → signataire → suivi jusqu'à finalized ; clé d'idempotence stable par demande |
| 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 |
| Activité | historique, filtres, export CSV / PDF |
| Échanger | échange sur un même réseau (KyberSwap), revue de l'intention, suivi de l'opération |
| Transférer entre réseaux | pont USDC CCTP, échange natif entre réseaux (THORChain), plans en plusieurs étapes (revue, suivi, reprise, réclamation) |
| NFT | galerie, page d'un NFT, marché en lecture, transfert par passkey, liste blanche de destinations, protections |
| Marchés | explorateur, comparateur, marchés privés, ordres unifiés |
| 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 |
| Agents de trading | simulation, papier, réel au comptant sous mandat, perpétuels, espace market making (papier), coffre de l'agent |
| Risque et limites | limites, interrupteur général (levée par passkey), arrêts automatiques, mandats de trading |
| Développeur | clés API (création, rotation, révocation), webhooks |
| Alertes | centre d'alertes, réglages, état du système ; notifications locales à partir des alertes confirmées par le serveur |
| Recherche | création et annulation de travaux, résultats distingués par auteur |
| Sécurité | signataire, limites, passkeys, sessions, journal d'audit, arrêt d'urgence (sens unique) |
| Widgets | Valeur (petit), Actifs (moyen), Activité (moyen et grand) ; montants seulement si le propriétaire les autorise |
| Raccourcis | 4 App Intents (ouvrir le portefeuille, l'historique, les alertes, un actif) : navigation seulement |
| iPad | barre latérale groupée, grilles et tableaux, menus contextuels, raccourcis du clavier matériel, plusieurs scènes |
| Langues | français (langue source) et anglais : 4 037 chaînes dans Resources/Localizable.xcstrings |
Rien d'automatique : une cotation n'exécute rien ; un QR, un lien spwallet://, un widget ou Siri ne préparent ni
n'approuvent rien. Aucun paramètre de risque par défaut : levier, budget, plafond par ordre, limite de perte, marchés et
expiration sont saisis explicitement. Arrêter est toujours possible : pause, arrêt, révocation et arrêt d'urgence ne
demandent jamais plus qu'une confirmation.
🏗 Architecture
flowchart LR
subgraph Appareil["iPhone / iPad"]
UI["Features/ (SwiftUI)<br/>15 sections"]
Model["AppModel · Router<br/>AppEnvironment"]
Core["SPWalletCore<br/>APIClient · ApprovalBinding<br/>AddressValidator · OfflineStore"]
Sys["Core/<br/>passkey Apple · verrou local<br/>cache · alertes · rafraîchissement"]
W["SPWalletWidgets<br/>(WidgetKit)"]
I["App Intents<br/>spwallet://"]
UI --> Model --> Core
Model --> Sys
Model -- "instantané daté<br/>(App Group)" --> W
W -- "lien" --> Model
I -- "lien" --> Model
end
Core -- "HTTPS · /api/v1<br/>cookie __Host-spw<br/>Origin + X-SPW-CSRF" --> API["API SP Wallet<br/>wallet.spboucher.ai<br/>M2M32c:8650"]
API -- "HMAC" --> Signer["Signataire isolé<br/>m6ma:8651<br/>clés + passkeys épinglées"]
Signer --> Chains["Réseaux<br/>(diffusion)"]
Le flux d'approbation est le même pour toute opération qui signe (transfert, échange, pont, NFT, ordre, mandat, limite…) :
sequenceDiagram autonumber participant P as Propriétaire participant A as App (SwiftUI) participant C as SPWalletCore participant S as API SP Wallet participant G as Signataire isolé P->>A: saisit l'opération (montant, destination…) A->>C: prepare…(demande, clé d'idempotence) C->>S: POST préparation S-->>C: objet canonique + options WebAuthn (défi) C->>C: ApprovalBinding.verify : défi == SHA-256(objet canonique),<br/>rpId attendu, vérification de l'utilisateur exigée,<br/>objet == demande C-->>A: VerifiedApproval (ou refus : rien n'est signé) A->>P: revue de l'objet EN ENTIER (aucune troncature) P->>A: approuve A->>P: feuille système de passkey (assertion WebAuthn) A->>C: approve…(VerifiedApproval, assertion) C->>S: POST approbation S->>G: objet + assertion G->>G: recalcule l'empreinte, vérifie l'assertion<br/>avec la clé publique épinglée, applique sa politique G-->>S: transaction signée S-->>A: état (broadcast → confirming → finalized) A->>P: suivi ; seul « finalized » est un succès
Si le Core lève ApprovalError.unsupported (objet impossible à recalculer, champ inconnu), l'écran l'explique et n'offre
aucun contournement.
🧱 Pile technique
| Couche | Techno | Version / valeur lue dans le dépôt | Rôle |
|---|---|---|---|
| Langage | Swift | SWIFT_VERSION 6.0, SWIFT_STRICT_CONCURRENCY: complete |
tout le code |
| Interface | SwiftUI, Swift Charts | iOS 26.0 minimum | écrans, graphiques |
| Projet | XcodeGen | project.yml (le .xcodeproj n'est pas versionné) |
génération du projet |
| Outils | Xcode | 27.2, simulateurs iOS 26.5 (docs/DISTRIBUTION.md) |
construction, tests |
| Socle | SPWalletCore |
paquet local ../SPWalletCore, produits SPWalletCore et SPWalletTestSupport |
client API, canoniques, liaison passkey |
| Authentification | passkeys Apple, LocalAuthentication | domaine associé webcredentials:wallet.spboucher.ai |
connexion, approbation, verrou local |
| Extensions | WidgetKit, App Intents | cible SPWalletWidgets, Intents/WalletIntents.swift |
widgets, Siri, Raccourcis, Spotlight |
| Arrière-plan | rafraîchissement en arrière-plan | identifiant ai.spboucher.spwallet.ios.refresh, mode fetch |
mise à jour des données |
| Notifications | locales seulement | le serveur n'a pas de voie APNs | alertes |
| Tests | Swift Testing, XCUITest | 168 tests unitaires, 38 tests d'interface | logique et parcours |
| Dépendances tierces | — | aucune | — |
📁 Organisation du dépôt
project.yml définition XcodeGen : app, extension de widgets, tests unitaires, tests d'interface
App/ SPWalletApp, AppModel, AppEnvironment, AppConfiguration, Router (sections, liens), RootView
Core/
Authentication/ PlatformPasskeyAuthenticator (passkeys Apple)
Persistence/ AppCache (instantanés hors ligne datés)
Security/ DeviceLock (Face ID / Touch ID / code : protège l'affichage, n'autorise rien)
System/ alertes, notifications locales, rafraîchissement en arrière-plan, contrôles d'adresse
Components/ Theme, Money, Rows, StatusViews, TransactionReview, AssetIcon, QRCodeView, QRScannerView
Features/ 18 dossiers, 78 fichiers Swift
Dashboard · Portfolio · Assets · Activity · Explore · Login · Settings
Send · Receive · Swap · Bridge · NFTs
DeFi (marchés) · Futures · TradingAgents · Research
Alerts · Security (risque, mandats, clés développeur, webhooks)
Intents/ WalletIntents (4 App Intents + AppShortcutsProvider)
Widgets/ SPWalletWidgets (Valeur, Actifs, Activité), Info.plist, droits, manifeste de confidentialité
WidgetShared/ WidgetSnapshot : résumé daté écrit par l'app dans l'App Group
Resources/ Info.plist, droits (appareil et simulateur), PrivacyInfo.xcprivacy,
Localizable.xcstrings, Assets.xcassets (icône claire / sombre / teintée, 96 logos)
Design/ sources SVG de l'icône (AppIcon, Dark, Tinted) et de la marque
Scripts/ build.sh, release.sh, check-release.sh, asc.py, import-logos.py, sync-strings.sh, ExportOptions.plist
Tests/ 9 fichiers Swift Testing (168 tests)
UITests/ 8 fichiers XCUITest (38 tests)
docs/ AUDIT, PARITY_MATRIX (+ parity/ : 6 domaines), IMPLEMENTATION_STATUS, UI_CONVENTIONS,
DISTRIBUTION, LOGO_SOURCES (+ logo-licences.json), brand/ (logo et icône de ce README)
CLAUDE.md règles du projet, recettes, piègesTaille des dossiers de fonctionnalités (fichiers · lignes Swift)
| Dossier | Fichiers | Lignes | Dossier | Fichiers | Lignes |
|---|---|---|---|---|---|
Futures |
14 | 4 349 | Alerts |
3 | 966 |
NFTs |
11 | 4 287 | Research |
3 | 841 |
TradingAgents |
10 | 3 698 | Send |
1 | 331 |
Security |
11 | 2 885 | Activity |
1 | 273 |
DeFi |
7 | 1 770 | Dashboard |
1 | 220 |
Swap |
5 | 1 687 | Settings |
2 | 199 |
Bridge |
4 | 1 157 | Assets |
1 | 162 |
Portfolio |
1 | 91 | Receive |
1 | 84 |
Login |
1 | 44 | Explore |
1 | 43 |
🚀 Construction
Prérequis : Xcode 27.2, XcodeGen, et le socle cloné à côté de ce dépôt sous le
nom SPWalletCore (project.yml référence ../SPWalletCore).
git clone gitsrv:srv/git/sp-wallet-core.git SPWalletCore
git clone gitsrv:srv/git/sp-wallet-ios.git SPWallet-iOS
cd SPWallet-iOS
Scripts/build.sh generate # Info-Debug.plist + xcodegen (à relancer après tout ajout de fichier)
Scripts/build.sh debug # construction Debug sur le simulateur « SPWallet iPhone »
Scripts/build.sh release # construction Release (simulateur générique)
Scripts/build.sh core # tests du socle (swift test dans ../SPWalletCore)
Scripts/build.sh test # tests unitaires de l'app
Scripts/build.sh uitest # tests d'interface (captures exportées dans build/shots)SPWALLET_SIM="SPWallet iPad" choisit la tablette. La sortie de xcodebuild est filtrée ; le journal complet est dans
build/logs/.
Les tests d'interface et le mode Debug parlent à une pile jetable locale, jamais à la production :
../SPWalletCore/Scripts/dev-stack.sh up-fork # vrai serveur, vrai signataire, clés aléatoires, Base = fork anvil local, faux ETH
../SPWalletCore/Scripts/dev-stack.sh down # arrêt par PID de portAutres scripts : Scripts/asc.py GET /v1/… (client minimal de l'API App Store Connect), Scripts/import-logos.py (logos
du backend vers le catalogue d'images), Scripts/sync-strings.sh (catalogue de chaînes).
⚙️ Configuration
Aucun secret dans le dépôt. Noms seulement :
| Où | Clé | Rôle |
|---|---|---|
Resources/Info.plist |
SPWalletOrigin |
origine du portefeuille (production) |
Resources/Info.plist |
SPWalletRelyingParty |
partie de confiance WebAuthn |
Resources/Info.plist |
SPWalletAppGroup |
App Group partagé avec les widgets |
| environnement, Debug seulement | SPWALLET_ORIGIN |
remplace l'origine ; boucle locale uniquement (localhost / 127.0.0.1) |
| environnement, Debug seulement | SPWALLET_DEV_DIR |
dossier de la pile jetable (jeton de mise en place, passkey logicielle) |
| environnement, Debug seulement | SPWALLET_EPHEMERAL |
état vide en mémoire (tests d'interface) |
| scripts | SPWALLET_SIM |
simulateur visé |
| tests d'interface | TEST_RUNNER_SPWALLET_UITEST_ORIGIN, TEST_RUNNER_SPWALLET_UITEST_DIR |
viser une autre pile jetable |
Scripts/release.sh |
ASC_KEY_ID, ASC_ISSUER_ID |
clé API App Store Connect (le fichier de clé reste hors dépôt) |
En Release, l'origine ne peut être que https://wallet.spboucher.ai : Scripts/check-release.sh refuse tout autre binaire.
Le simulateur utilise des droits sans domaine associé (Resources/SPWallet-Simulator.entitlements) : il ne parle jamais aux
passkeys de production.
🧭 Écrans et navigation
Quinze sections (AppSection, App/Router.swift). Sur iPhone : cinq onglets (Accueil, Portefeuille, Activité, Explorer,
Réglages), le reste s'atteint depuis Explorer. Sur iPad : barre latérale en cinq groupes.
| Groupe (iPad) | Section | Dossier |
|---|---|---|
| Portefeuille | Accueil | Features/Dashboard |
| Portefeuille | Portefeuille | Features/Portfolio, Features/Assets |
| Portefeuille | Activité | Features/Activity |
| Opérations | Échanger | Features/Swap |
| Opérations | Transférer entre réseaux | Features/Bridge |
| Opérations | NFT | Features/NFTs |
| Marchés | Marchés | Features/DeFi |
| Marchés | Contrats à terme | Features/Futures |
| Marchés | Agents de trading | Features/TradingAgents |
| Marchés | Recherche | Features/Research |
| Surveillance | Alertes | Features/Alerts |
| Surveillance | Risque et limites | Features/Security |
| Surveillance | Sécurité | Features/Security |
| App | Réglages | Features/Settings |
| (onglet iPhone) | Explorer | Features/Explore |
Feuilles des parcours principaux : Envoyer (Features/Send) et Recevoir (Features/Receive).
Liens spwallet://home | portfolio | activity | alerts | asset/<SYMBOLE> (widgets, App Intents) : un lien ouvre un
écran, rien de plus.
Clavier matériel (iPad) — aucune commande n'effectue d'opération financière :
| Raccourci | Action | Raccourci | Action |
|---|---|---|---|
| ⌘1 … ⌘9 | Accueil, Portefeuille, Activité, Échanger, Marchés, Contrats à terme, Agents, Alertes, Sécurité | ⌘, | Réglages |
| ⌘R | Actualiser | ⇧⌘E | Envoyer… |
| ⇧⌘D | Recevoir… | ⇧⌘L | Verrouiller |
Widgets (Widgets/SPWalletWidgets.swift) : Valeur (systemSmall), Actifs (systemMedium), Activité (systemMedium,
systemLarge).
App Intents : Ouvrir le portefeuille, Afficher l'historique, Ouvrir les alertes, Consulter un actif. Aucun ne renvoie de solde à Siri.
🗃 Modèle de données local
L'app n'a pas de base de données : la vérité est sur le serveur.
| Donnée | Emplacement | Contenu |
|---|---|---|
| Session | Trousseau, cet appareil seulement | le cookie de session, seul secret conservé |
| 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 |
| 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 |
États d'une transaction (machine à états du serveur) :
draft → pending_approval → approved → signed → broadcast → confirming → finalized, avec rejected, expired, failed,
replaced, reorged, not_broadcast. Une transaction diffusée n'est pas confirmée.
🔐 Sécurité et vie privée
- 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 publiques des passkeys et vérifie chaque assertion indépendamment de l'API.
- Toute approbation passe par
ApprovalBinding.verifydu socle : défi recalculé depuis l'objet affiché,rpIdvérifié, vérification de l'utilisateur exigée, objet comparé à la demande. Un champ inconnu dans un objet canonique est un refus, pas une omission. - Le verrou Face ID / Touch ID ne remplace jamais l'assertion WebAuthn : il protège ce qui est affiché sur cet appareil.
- Session : cookie
__Host-spwgéré à la main, envoyé à la seule origine configurée ; toute écriture porteOriginetX-SPW-CSRF. Trente minutes d'inactivité, douze heures au plus (règle du serveur). - Réseau :
NSAllowsArbitraryLoadsetNSAllowsLocalNetworkingàfalseen Release. - Vie privée :
PrivacyInfo.xcprivacydéclare aucun suivi et aucune collecte. Journaux :Loggeravecprivacy: .publicuniquement pour des codes ; jamais d'adresse, de montant, de jeton ni de secret. - Autorisations : appareil photo (lecture du QR d'une adresse seulement), Face ID (déverrouillage local).
- Binaire contrôlé :
Scripts/check-release.shrefuse un binaire qui contiendrait le code de la passkey logicielle de test, une origine de développement, une URL de boucle locale, une vue web, une autre origine que la production, des droits inattendus ou — avec--distribution— une signature qui n'est pas Apple Distribution. - Jamais de transaction réelle pour tester. La passkey logicielle (
SPWalletTestSupport) n'est référencée que sous#if DEBUGet refuse toute originespboucher.ai. - Logos : 96 logos embarqués, affichés sans appel à un tiers ; sources et licences dans
docs/LOGO_SOURCES.mdetdocs/logo-licences.json.
L'audit du backend qui fonde ces règles est dans docs/AUDIT.md (garde, session, intention canonique, maturité réelle par
domaine).
🧪 Tests
| Suite | Commande | Compte (lu dans le dépôt) |
|---|---|---|
Socle SPWalletCore |
Scripts/build.sh core |
312 tests unitaires + 9 tests contre la pile jetable (dépôt sp-wallet-core) |
| Logique de l'app (Swift Testing) | Scripts/build.sh test |
168 tests, 9 fichiers |
| Interface (XCUITest), iPhone et iPad | Scripts/build.sh uitest |
38 tests, 8 fichiers |
| Binaire de distribution | Scripts/check-release.sh <app> --distribution |
contrôle de l'IPA exporté |
Détail par fichier
| Tests unitaires | Tests | Tests d'interface | Tests |
|---|---|---|---|
MarketsRiskTests |
31 | NFTUITests |
9 |
AlertsResearchTests |
24 | FuturesUITests |
6 |
FuturesFlowTests |
24 | MarketsRiskUITests |
5 |
SwapFlowTests |
24 | SPWalletUITests |
5 |
AgentsFlowTests |
23 | SwapUITests |
5 |
NFTFlowTests |
23 | AgentsUITests |
4 |
WalletBaseTests |
13 | AlertsResearchUITests |
3 |
LocalizationTests |
4 | AllSectionsUITests |
1 |
SmokeTests |
2 |
Les tests d'interface tournent sur la pile jetable (dev-stack.sh up-fork : clés aléatoires, Base = fork local avec faux
ETH, passkey logicielle). Jamais la production, jamais de fonds réels. Un seul simulateur par exécution (SPWALLET_SIM).
Vérifié par ces tests, d'après docs/IMPLEMENTATION_STATUS.md : connexion, tableau de bord, sections, réception, refus d'une
adresse invalide, envoi complet jusqu'au suivi sur iPhone et iPad ; ouverture et défilement de chaque section sans plantage ;
par domaine sur iPhone : échange KyberSwap complet sur fork, interrupteur général, limites, clés API, compte papier
Hyperliquid, agent papier puis réel sous mandat, liste blanche NFT, alertes, recherche.
📦 Distribution
Distribution par TestFlight / App Store Connect (la notarisation ne s'applique pas à une app iOS).
Scripts/release.sh all # archive + contrôles + export de l'IPA (dist/export) + contrôle de l'IPA exporté
Scripts/release.sh upload # envoi explicite à TestFlight| Élément | Valeur |
|---|---|
| Version | 1.0.0 (3) — MARKETING_VERSION / CURRENT_PROJECT_VERSION de project.yml |
| Identifiants | ai.spboucher.spwallet.ios (Associated Domains, App Groups), ai.spboucher.spwallet.ios.widgets (App Groups) |
| App Group | group.ai.spboucher.spwallet.ios |
| Domaine associé | webcredentials:wallet.spboucher.ai (le fichier d'association du serveur doit lister l'identifiant de l'app) |
| Fiche App Store Connect | SP Wallet, app 6836540531, langue principale fr-CA |
| Signature | automatique ; archive signée avec le compte Apple configuré dans Xcode, export et envoi avec la clé API |
| État | test interne TestFlight ; rien n'est soumis à la revue de l'App Store |
Particularité : les App Groups ne se provisionnent pas avec une clé API App Store Connect ; l'archive est donc signée par
le compte Xcode (-allowProvisioningUpdates seul), la clé API sert à l'export et à l'envoi.
Nouvelle version : incrémenter CURRENT_PROJECT_VERSION dans project.yml, lancer les tests, puis
Scripts/release.sh all et Scripts/release.sh upload.
Avant une soumission App Store (non fait) : captures (produites par les tests d'interface dans build/shots),
description, URL d'assistance et de confidentialité, questionnaire de confidentialité cohérent avec PrivacyInfo.xcprivacy,
classification d'âge ; la règle 3.1.5 des App Review Guidelines exige un compte d'organisation pour une app de portefeuille
crypto et les licences applicables pour l'échange et les dérivés ; un compte de démonstration serait nécessaire à la revue.
Détails : docs/DISTRIBUTION.md.
🧯 Pièges rencontrés
- Contenus présentés SwiftUI : feuilles,
fullScreenCover, popovers, destinations de navigation, cellules deTableet menus contextuels n'héritent pas de façon fiable des objets@Environment. Chaque contenu présenté se termine par.wallet(model)(Components/Theme.swift) — plantage sinon. Un objet@Observablepropre à un écran se passe toujours en paramètre. - Un
accessibilityIdentifierposé sur unLabels'applique à son image :.accessibilityElement(children: .combine)d'abord. Ne pas le poser sur un conteneur : il écrase ceux des enfants. KeyPathvers une propriété@MainActoretinoutvers une propriété isolée dans un appelasync: refusés en Swift 6 → fonctions qui renvoient la nouvelle valeur.- Deux suites de tests qui font le « setup propriétaire » en parallèle enrôlent deux clés : une seule tâche partagée.
- Une archive est signée Development (
get-task-allowvrai) ; c'est l'export qui signe Distribution : contrôler l'IPA exporté, pas l'archive. codesign … | grep -qsouspipefail: tuyau cassé → lire dans une variable.- zsh : ne jamais nommer une variable de boucle
path(elle est liée àPATH). dev-stack.sh downtue par PID de port, jamais par motif de nom de processus.Scripts/build.sh generateaprès tout ajout de fichier (le projet Xcode est généré).
🗺 État et limites connues
D'après docs/IMPLEMENTATION_STATUS.md (2026-11-18).
Jamais vérifié — à valider sur appareil (rien de ceci n'est exerçable sur simulateur) :
- connexion par passkey Apple contre
wallet.spboucher.ai; - approbation par passkey Apple d'une intention ;
- verrou Face ID / Touch ID, ajout de la passkey de l'appareil, lecture de QR par l'appareil photo ;
- widgets sur l'écran d'accueil et l'écran verrouillé, raccourcis Siri, notifications locales, rafraîchissement en arrière-plan ;
- comportement sur iOS 27 (simulateurs disponibles : iOS 26.5) ;
- VoiceOver, très grandes tailles de texte, mode sombre de tous les écrans.
Construit mais jamais exécuté : pont CCTP au-delà du formulaire, échanges THORChain, plans en plusieurs étapes ; toute approbation réelle sur Hyperliquid ; transfert réel d'un NFT ; création et approbation de mandats de trading, webhooks, retour des fonds d'un coffre d'agent ; arrêt d'urgence du signataire (irréversible depuis l'app) ; parcours hors ligne à l'écran (le cache est testé unitairement).
Limites connues :
- Notifications : le serveur n'a pas de voie APNs. L'app interroge le serveur toutes les 60 s quand elle est ouverte ; en arrière-plan, iOS décide du moment et la session expire après 30 minutes : pas de notification fiable app fermée.
- Session : reconnexion par passkey fréquente (30 minutes d'inactivité, 12 heures au plus).
- Jetons personnalisés : non pris en charge (le serveur n'accepte que son registre vérifié).
- Market making réel et mandats de cotation : non approuvables par les clients natifs.
- Écritures de marché NFT, inscriptions Bitcoin : non construites côté serveur.
- GMX, dYdX, edgeX : état ou données seulement.
- Textes venant du serveur (raisons de refus, listes de contrôle) : affichés tels quels, en anglais.
- « Vente » a une seule traduction anglaise (« Sale ») pour l'activité NFT et le côté vendeur des ordres.
- L'IPA pèse environ 47 Mo, dont environ 20 Mo de logos.
Écarts volontaires par rapport au web : aucune tolérance, vitesse de pont, route, levier ni limite n'est présélectionnée ; l'app recalcule le défi de chaque approbation et refuse d'approuver un objet qu'elle ne sait pas vérifier ; un seul formulaire d'ordre (terminal Contrats à terme).
La parité fonction par fonction (Web · macOS · iPhone · iPad) est dans docs/PARITY_MATRIX.md.
📚 Documentation
| Document | Contenu |
|---|---|
docs/AUDIT.md |
audit du backend : garde, session, intention canonique, maturité réelle par domaine |
docs/PARITY_MATRIX.md, docs/parity/ |
parité Web / macOS / iPhone / iPad, fonction par fonction (agents, contrats à terme, marchés et risque, NFT, opérations, échange) |
docs/IMPLEMENTATION_STATUS.md |
ce qui est vérifié, ce qui reste à valider sur appareil, limites |
docs/UI_CONVENTIONS.md |
règles d'écran et de code, briques à réutiliser |
docs/DISTRIBUTION.md |
signature, TestFlight, App Store Connect |
docs/LOGO_SOURCES.md |
provenance et licence de chaque logo |
CLAUDE.md |
règles du projet, recettes, pièges |
👤 Auteur
Simon-Pierre Boucher — conception, développement, exploitation
www.spboucher.ai · git.spboucher.ai · contact@spboucher.ai
📄 Licence
Tous droits réservés © 2026 Simon-Pierre Boucher. Les logos d'actifs, de réseaux et de services restent les marques de leurs
propriétaires ; leurs sources et licences sont listées dans docs/LOGO_SOURCES.md.