SPB Git

Repository Public

README.md 34.1 KB

Logo SP Wallet iOS



Icône SP Wallet iOS

# 🛡️ 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

wallet.spboucher.ai version plateforme licence author

Swift SwiftUI Xcode XcodeGen SPWalletCore WidgetKit App Intents Swift Charts Passkeys Swift Testing WebKit dépendances

commits last commit activity language languages size branches tags clones

fichiers Swift lignes Swift sections dossiers de fonctionnalités tests unitaires tests d'interface chaînes localisées logos cibles Xcode

bundle signature TestFlight cible appareils backend


# Sommaire


# 🎯 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

text
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èges
Taille 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).

bash
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 :

bash
../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 port

Autres 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.verify du socle : défi recalculé depuis l'objet affiché, rpId vé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-spw géré à la main, envoyé à la seule origine configurée ; toute écriture porte Origin et X-SPW-CSRF. Trente minutes d'inactivité, douze heures au plus (règle du serveur).
  • Réseau : NSAllowsArbitraryLoads et NSAllowsLocalNetworking à false en Release.
  • Vie privée : PrivacyInfo.xcprivacy déclare aucun suivi et aucune collecte. Journaux : Logger avec privacy: .public uniquement 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.sh refuse 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 DEBUG et refuse toute origine spboucher.ai.
  • Logos : 96 logos embarqués, affichés sans appel à un tiers ; sources et licences dans docs/LOGO_SOURCES.md et docs/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).

bash
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 de Table et 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 @Observable propre à un écran se passe toujours en paramètre.
  • Un accessibilityIdentifier posé sur un Label s'applique à son image : .accessibilityElement(children: .combine) d'abord. Ne pas le poser sur un conteneur : il écrase ceux des enfants.
  • KeyPath vers une propriété @MainActor et inout vers une propriété isolée dans un appel async : 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-allow vrai) ; c'est l'export qui signe Distribution : contrôler l'IPA exporté, pas l'archive.
  • codesign … | grep -q sous pipefail : tuyau cassé → lire dans une variable.
  • zsh : ne jamais nommer une variable de boucle path (elle est liée à PATH).
  • dev-stack.sh down tue par PID de port, jamais par motif de nom de processus.
  • Scripts/build.sh generate aprè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) :

  1. connexion par passkey Apple contre wallet.spboucher.ai ;
  2. approbation par passkey Apple d'une intention ;
  3. verrou Face ID / Touch ID, ajout de la passkey de l'appareil, lecture de QR par l'appareil photo ;
  4. widgets sur l'écran d'accueil et l'écran verrouillé, raccourcis Siri, notifications locales, rafraîchissement en arrière-plan ;
  5. comportement sur iOS 27 (simulateurs disponibles : iOS 26.5) ;
  6. 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.

Files main
Menu

Theme