SPB Git

Repository Public

swap.md 9.0 KB

# Parité — Échanger et Transférer entre réseaux (iOS, branche ui-swap)

État au 2026-11-18. Serveur de référence : backend native-clients (main 8dc85bd), déployé en production : chaque route de préparation renvoie l'objet canonique (intent, approval, request) que l'app recalcule avant de demander la clé d'accès. L'ancien cas « le serveur ne renvoie pas l'objet » reste traité comme une branche défensive (serveur antérieur) : avis explicite, proposition retirée, aucun contournement.

Colonne « Maturité réelle côté serveur » : d'après docs/V11-REMAINING-LIMITATIONS.md §7 (7.3 à 7.6), docs/V11-AUDIT.md §10 et docs/V11-TEST-RESULTS.md du backend. « Vérifié ici » = ce que cette branche a réellement exercé, et comment.

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque / reste à faire
Catalogue (actifs, fournisseurs, qui EXÉCUTE vs qui cote) oui oui : /swap/assets, /swap/providers, /swap/execution ; pastille « Exécute » / « Cotation seulement » par fournisseur, pastille d'exécution par réseau lecture, en production —
Cotations en direct (flux SSE), comparaison des routes oui oui : fournisseur, sortie attendue, minimum, frais, impact prix (si servi), chemin, âge + marque « Périmée », route exécutable signalée, réponses « sans route » des fournisseurs. Vérifié : test d'interface sur pile jetable avec les vraies API publiques lecture ; 0x et 1inch jamais appelés (pas de clé) ; LI.FI et Maya = cotation seulement ; deBridge coupé (licence) —
Tolérance de glissement 0,3 / 0,5 / 1 %, défaut 0,5 % mêmes préréglages, aucun défaut : les cotations ne démarrent qu'après un choix explicite, valeur toujours visible — différence voulue (règle 5 des conventions)
Bouton « Tout » en monnaie native solde affiché solde entier + note : le serveur ne sert pas la réserve de frais, rien n'est calculé par l'app le serveur ne sert pas ce chiffre un champ « maximum vendable » servi par le serveur
Échange même réseau — EVM (KyberSwap, 8 réseaux) oui oui, de bout en bout : route choisie par le propriétaire → prepare avec la référence de cotation → revue de l'intention vérifiée → clé d'accès → suivi. Vérifié : test d'interface complet sur fork local de Base (0,01 ETH → USDC, signataire réel de la pile, clé logicielle) exécutable ; preuve réelle : un seul échange KyberSwap réel (Ethereum) ; les autres réseaux par forks seulement petits échanges réels par le propriétaire
Échange même réseau — Solana (Jupiter) oui même parcours (rien de spécifique côté app ; le libellé « Jupiter (Metis) » est respecté). Non vérifié ici (pas de Solana sur la pile jetable) exécutable ; prouvé par simulation mainnet seulement, jamais exécuté en réel exécution réelle ; le détail Solana de la proposition (swap.detail : loyer du compte de jetons, frais de priorité) n'est pas encore affiché par cet écran
Autres familles (Bitcoin, Tron, XRPL…) en même réseau cotation quand un fournisseur la sert cotation seulement, dit comme tel par réseau pas d'exécution hors périmètre serveur
Règle du minimum garanti le serveur refuse si la sortie ferme attendue < minimum affiché (quote_moved) plus stricte : .notBelowQuote (le minimum ferme ne doit pas être sous le minimum affiché). Refus → proposition retirée, chiffres affichés côte à côte, nouvelle cotation proposée ; accepter le minimum ferme est un second choix EXPLICITE et la revue signale alors l'écart — —
quote_moved message + nouvelle cotation chiffres cotés et frais côte à côte + « Demander une nouvelle cotation ». Logique testée en unitaire ; écran non déclenché sur la pile en production —
Transaction d'approbation de jeton préalable affichée revue : dite d'après l'intention (approveGas), pour le montant exact ; suivi : état pending / sent / confirmed + identifiant. Non vérifié en interface (l'échange testé part d'ETH natif) exécutable test sur fork en vendant un jeton
Montant reçu affiché quand servi « Reçu » en vert seulement quand la transaction est finale ; tant qu'elle est seulement minée, libellé « PAS encore finale » (le serveur sert receivedDisplay dès le reçu de transaction). Vérifié sur fork — —
Pont USDC CCTP entre réseaux EVM oui oui : réseaux servis, vitesses Rapide / Standard avec frais et durée servis, aucune vitesse présélectionnée, besoin de gaz sur la destination (bloquant si non couvert), revue (réseau et adresse de destination, plafond de frais, minimum reçu, vitesse), suivi brûlage → attestation → prêt → émission → terminé avec les deux transactions. Vérifié : formulaire, cotation et blocage « gaz de destination » en test d'interface ; le brûlage n'a pas pu être exécuté sur la pile (la destination est un vrai réseau où le portefeuille jetable n'a aucun gaz : le serveur refuse, à juste titre) exécutable ; forks seulement, jamais sur réseau réel un second fork local comme destination pour tester la suite ; exécution réelle
« Terminer maintenant » (canFinish) oui oui (bouton quand servi) — non vérifié en interface idem idem
mint_failed → nouvelle signature oui oui : objet approval vérifié et affiché (transfert, message, plafond de frais, empreinte) puis clé d'accès — non vérifié en interface chaînes scriptées seulement idem
CCTP vers Solana : compte de jetons préalable oui oui : avis bloquant, demande request vérifiée et affichée (propriétaire, mint, compte, loyer, frais, plafond), clé d'accès, état « envoyée, non confirmée » — non vérifié en interface pas de test de rejeu dédié côté serveur ; jamais en réel Solana sur la pile jetable
CCTP depuis Solana : dépôt du compte d'événement et récupération oui oui : dépôt et délai annoncés avant, état de récupération dans le suivi, récupération par clé d'accès sur objet vérifié ; une opération au dépôt non récupéré reste dans « En cours » — logique de liste testée en unitaire, écran non vérifié idem idem
Liste des opérations en cours / à reprendre via Activité section « En cours » en tête de Transférer entre réseaux (propositions en attente + historique + plans ouverts) ; une proposition préparée ailleurs peut y être refusée — —
Échange natif entre réseaux (THORChain) oui oui : capacités servies, routes du flux, seule la route que le serveur déclare exécutable par THORChain est préparable, revue (coffre, mémo, minimum, expiration du coffre, routeur), suivi jusqu'à sortie / remboursement (un remboursement n'est pas un succès ; « reçu sous le minimum » signalé), « Regarder maintenant ». Non vérifié en interface au-delà du formulaire et des capacités exécutable (paires BTC / LTC / ETH épinglées) ; chaînes et opérateurs scriptés seulement, jamais sur réseau réel exécution réelle ; pile avec opérateurs scriptés pour un test d'interface
Plans multi-étapes (any-to-any) oui oui : cotation des formes (étapes, pire cas, exigences, blocages), plancher facultatif, démarrage après confirmation (rien n'est signé), une clé d'accès par étape via « Préparer l'étape suivante », pause → réessayer / replanifier / arrêter, suivi de l'étape en cours. Non vérifié en interface (aucun plan n'est exécutable avec le seul ETH du fork) exécutable ; scripts de fork non rejoués à la validation finale (fork-plan), jamais en réel idem
Changement de plancher au « réessayer », choix d'une forme précise au « replanifier » oui non : réessai à plancher inchangé, replanification vers la meilleure forme exécutable — à ajouter si utile
Détail des risques d'une route (risk.flags traduits), modes « plus rapide / équilibré » oui niveau et codes affichés tels que servis ; seul « Meilleur prix coté » est marqué — traductions des codes
Lecture seule hors ligne / sans session bannière formulaires désactivés + bannière standard ; aucune cotation demandée — —
iPad — deux volets (formulaire à gauche, routes / détails à droite). Compilé, non vérifié à l'écran — passe visuelle iPad

# Écarts volontaires avec le client web

  • Aucune tolérance ni vitesse présélectionnée ; aucune route présélectionnée (la meilleure exécutable est seulement signalée).
  • Une route CCTP du flux n'est pas préparable depuis l'échange entre réseaux : elle se prépare depuis l'outil USDC, avec la référence et le plafond de frais de l'option /bridge/quote affichée (c'est ce que le Core vérifie).
  • Le minimum ferme inférieur au minimum affiché est refusé par défaut (le web l'accepte tant que la sortie attendue le couvre).
Files main
Menu

Theme