SPB Git

Repository Public

CLAUDE.md 4.1 KB

# SP Wallet — iOS / iPadOS natif

Application native (Swift 6 strict, SwiftUI, iOS 26+) de https://wallet.spboucher.ai : portefeuille multichaîne réel. Cahier des charges d'origine : brief « SP Wallet Native iOS & iPadOS » du 2026-11-18. Audit : docs/AUDIT.md ; conventions : docs/UI_CONVENTIONS.md ; parité : docs/PARITY_MATRIX.md (+ docs/parity/) ; état : docs/IMPLEMENTATION_STATUS.md ; distribution : docs/DISTRIBUTION.md.

# Règles du projet

  • Aucune vue web. Scripts/check-release.sh refuse un binaire qui référencerait WebKit.
  • Aucune clé privée dans l'app. Elle consulte, prépare et autorise ; le signataire isolé (m6ma) signe. Le seul secret conservé est le cookie de session, au Trousseau (cet appareil seulement).
  • Toute approbation passe par ApprovalBinding.verify du Core : défi recalculé depuis l'objet affiché, objet comparé à la demande. Ne jamais approuver un objet que le Core ne sait pas recalculer ; ne jamais remplacer l'assertion WebAuthn par un Face ID local.
  • Jamais de transaction réelle pour tester. Tests financiers sur la pile jetable (../SPWalletCore/Scripts/dev-stack.sh up-fork : clés aléatoires, Base = fork anvil local, passkey logicielle). La passkey logicielle (SPWalletTestSupport) n'est référencée que sous #if DEBUG et refuse toute origine spboucher.ai.
  • Le Core ../SPWalletCore est partagé avec SP Wallet macOS (../SPWallet, autre session, propriétaire du backend). Ce projet possède le Core : prévenir la session macOS avant tout changement cassant de son API publique.
  • Le backend (sp-wallet) se modifie sur son nœud par la session macOS ; ne jamais déployer ni ouvrir un verrou sans l'accord explicite du propriétaire ; ne jamais toucher policy.json du signataire.
  • Aucune donnée inventée, aucun succès déduit : seul finalized est un succès ; un pont n'est fini qu'à la confirmation de destination.
  • En-tête obligatoire en tête de fichier. Interface en français (langue source), anglais dans Resources/Localizable.xcstrings.

# Recettes

Scripts/build.sh generate|debug|release|test|uitest|core (SPWALLET_SIM="SPWallet iPad" pour la tablette) · Scripts/release.sh archive|check|export|upload|all · Scripts/asc.py GET /v1/… · Scripts/import-logos.py (logos du backend). Variables de debug : SPWALLET_ORIGIN (boucle locale seulement), SPWALLET_DEV_DIR, SPWALLET_EPHEMERAL=1. Tests d'interface sur une autre pile : TEST_RUNNER_SPWALLET_UITEST_ORIGIN=… TEST_RUNNER_SPWALLET_UITEST_DIR=… Scripts/build.sh uitest.

# Pièges rencontrés

  • zsh : ne jamais nommer une variable de boucle path (elle est liée à PATH).
  • Un accessibilityIdentifier posé sur un Label s'applique à son image : .accessibilityElement(children: .combine) d'abord.
  • 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.
  • dev-stack.sh down tue par PID de port (jamais pkill -f).
  • codesign … | grep -q sous pipefail : tuyau cassé → lire dans une variable.
  • Une archive est signée Development (get-task-allow vrai) ; c'est l'export qui signe Distribution : contrôler l'IPA exporté.
  • Limite de débit du compte : au plus 3–4 sous-agents à la fois.

# Source header policy (SP Boucher)

When creating or modifying eligible first-party source files, follow the SP Boucher Source Header Policy. Preserve existing copyright and license notices, select the correct language-specific template, and avoid adding identifying information to anonymous academic submission artifacts.

  • Repository policy: .spb-source-governance.toml (project, contact, verified rights, license).
  • Add or refresh headers with spb-header apply --repo .; verify with spb-header check --repo ..
  • Never hand-write a header, never add one to generated, vendored, third-party or data files.
Files main
Menu

Theme