Architecture
Hypercall utilise un modèle d'exécution hybride : appariement hors chaîne pour la rapidité, avec règlement et gestion des comptes on-chain pour la sécurité.
Frontières de confiance
Hors chaîne (backend Hypercall)
Responsabilités :
- Appariement et exécution des ordres
- Gestion du carnet d'ordres
- Vérifications de marge pré-négociation
- Orchestration des liquidations
- Données de marché et tarification
- Flux WebSocket
Hypothèse de confiance : les utilisateurs font confiance au backend Hypercall pour :
- Apparier les ordres équitablement (priorité prix-temps)
- Appliquer correctement les vérifications de marge
- Surveiller les comptes et déclencher les liquidations si nécessaire
- Fournir des données de marché exactes
Limitations : les opérations hors chaîne ne sont pas entièrement vérifiables cryptographiquement dans la Mainnet Alpha. Les utilisateurs doivent faire confiance à l'opérateur du backend pour l'appariement, l'ingestion des données de marché, les vérifications de marge et l'émission des commandes RSM.
Perspectives : Hypercall travaille à la décentralisation du RSM et à des garanties de minimisation de la confiance plus fortes. La feuille de route précisera comment les engagements d'état, les rôles de signataires, les mécanismes de contestation et les contrôles de l'opérateur deviendront plus vérifiables au fil du temps. La Mainnet Alpha est la première phase, volontairement contrainte, et non le modèle de confiance final.
On-chain (contrats intelligents)
Responsabilités :
- Propriété des comptes et contrôle par le gestionnaire
- Dépôts et retraits
- Enchères de liquidation (transfert de positions)
- Commandes RSM (opérations de gestion des risques)
- Publication du prix de règlement
- Intégration Hyperliquid (ordres sur perpétuels via ActionCaster)
Hypothèse de confiance : les opérations on-chain sont vérifiables cryptographiquement. Les utilisateurs peuvent vérifier le code et l'état des contrats.
Sécurité : la propriété d'un compte ne peut être modifiée sans transaction on-chain. La liquidation nécessite une enchère on-chain.
Flux d'exécution des ordres
1. Soumission de l'ordre
Action utilisateur : soumettre un ordre via POST /order avec une signature EIP-712.
Validation par le backend :
- Vérification de la signature (EIP-712)
- Vérifications de marge pré-négociation (basées sur des scénarios)
- Admission de l'ordre (palier, échéance, limites de débit)
Résultat : l'ordre est accepté (ACKED) et mis en file d'attente pour l'appariement, ou rejeté avec un motif.
2. Appariement des ordres
Processus : les ordres sont appariés dans le carnet d'ordres selon la priorité prix-temps.
Exécution : lorsque des ordres s'apparient, des exécutions sont créées et les positions sont mises à jour dans la base de données du backend.
Pas on-chain : les appariements individuels ne sont pas enregistrés on-chain. L'état des comptes est synchronisé via les mises à jour de la racine de marge.
3. Mises à jour des positions
Processus : les positions sont suivies dans la base de données du backend et mises à jour en temps réel.
Accès utilisateur : consultez vos positions via GET /portfolio ou le canal WebSocket portfolio.
Synchronisation on-chain : la racine de marge (engagement cryptographique sur l'état des comptes) est mise à jour on-chain périodiquement et lors d'événements critiques.
4. Règlement
Règlement à l'échéance : les options expirent à l'heure d'échéance du contrat et se règlent en espèces sur la base du prix de règlement. Sur le réseau principal, le SPCX expire à 16h00 ET ; sur le testnet, l'expiration a lieu actuellement à 08h00 UTC.
Prix de règlement : TWAP sur 30 minutes du prix d'indice de l'Oracle Hyperliquid, publié on-chain via SimpleOracle.setExpiryPrice().
Processus :
- L'oracle calcule le TWAP sur 30 minutes se terminant à l'échéance
- Le prix de règlement est publié on-chain
- La valeur intrinsèque est calculée pour chaque position
- Les soldes en espèces sont mis à jour
- Les positions sont clôturées
Gestion des comptes
Création de compte
Processus : les comptes sont créés lors du premier dépôt ou sur demande explicite.
On-chain : le contrat de compte est déployé en tant que BeaconProxy (schéma de proxy minimal économe en gas).
Gestionnaire : chaque compte dispose d'un gestionnaire (EOA) qui contrôle le compte et peut autoriser des agents.
Dépôts et retraits
Dépôts :
- USDC : transféré vers l'Exchange via HyperCore
- ERC20 d'options : déposés via le contrat Exchange
Retraits :
- Doivent passer les vérifications de risque hors chaîne (marge suffisante après retrait)
- Exécutés on-chain via le contrat Account
- Signature du gestionnaire requise
Frontière de confiance : les dépôts et retraits sont on-chain et vérifiables.
Liquidation
La liquidation utilise une machine à états avec un délai de grâce avant l'enchère :
| État | Description | Durée |
|---|---|---|
| Healthy | Capitaux propres > marge de maintenance requise | - |
| PreLiquidation | Capitaux propres < marge de maintenance, délai de grâce actif | 60 secondes |
| InLiquidation | Enchère hollandaise en cours | Jusqu'à exécution |
| Liquidated | Positions transférées | - |
Liquidation partielle vs totale
| Type | Condition | Comportement |
|---|---|---|
| Partielle | ≤ 5 positions | Liquider des positions spécifiques jusqu'au retour à un état sain |
| Totale | > 5 positions | Liquider l'ensemble du compte |
Mécanique de l'enchère
Enchère solvable (capitaux propres > 0) : prix de départ = capitaux propres × (1 - pénalité), décroissant dans le temps. Les liquidateurs enchérissent pour reprendre les positions.
Enchère insolvable (capitaux propres < 0) : le fonds d'assurance fournit un bonus pour inciter les liquidateurs à absorber les positions déficitaires.
On-chain : l'exécution de l'enchère et le transfert des positions se déroulent on-chain via le contrat Exchange.
Voir Liquidation pour tous les détails.
Intégration Hyperliquid
Perpétuels HIP-3
Les comptes Hypercall peuvent exécuter des ordres sur perpétuels sur Hyperliquid via ActionCaster :
Flux : contrat Account → ActionCaster → Hyperliquid L1
Cas d'usage :
- Couverture en delta des positions en options
- Marge inter-plateformes (les positions sur perpétuels sont prises en compte dans la marge de portefeuille)
Marge croisée
Les positions sur perpétuels HyperCore sont conçues pour être incluses dans les calculs de marge de portefeuille, permettant des stratégies de couverture efficaces en capital. La marge de portefeuille est désactivée pour les utilisateurs généraux dans la Mainnet Alpha.
Commandes RSM
RSM (Risk & Settlement Manager) : composant du backend qui émet des commandes on-chain pour la gestion des risques.
Les commandes incluent :
- Ordres reduce-only (clôture forcée de positions)
- Remboursement de dette (retrait forcé pour couvrir un solde négatif)
- Exécution du règlement
On-chain : les commandes RSM sont signées par le signataire RSM et exécutées via le contrat Account. Les utilisateurs peuvent vérifier l'adresse du signataire RSM et toutes les exécutions de commandes on-chain.
Feuille de route de décentralisation : le signataire RSM actuel est contrôlé par l'opérateur. Les travaux futurs de la feuille de route publieront la manière dont ce rôle sera décentralisé ou rendu autrement plus minimisé en confiance.
Ce que vous pouvez vérifier
On-chain (vérifiable)
- Propriété du compte (adresse du gestionnaire)
- Déploiement du contrat de compte
- Dépôts et retraits
- Enchères de liquidation et leurs résultats
- Prix de règlement (publiés on-chain par l'oracle)
- Ordres Hyperliquid (exécution on-chain)
- Commandes RSM (exécution on-chain)
Hors chaîne (confiance requise)
- Équité de l'appariement des ordres
- Calculs de marge
- Exactitude du suivi des positions
- Exactitude des données de marché
- Moment de déclenchement des liquidations
Modèle de sécurité
Principe clé : les opérations critiques (propriété des comptes, dépôts, liquidation, prix de règlement) sont on-chain et vérifiables. L'efficacité opérationnelle (appariement, vérifications de marge) est hors chaîne.
Compromis : l'appariement hors chaîne offre rapidité et efficacité, mais nécessite aujourd'hui de faire confiance à l'opérateur du backend. Les opérations on-chain offrent la vérifiabilité mais sont plus lentes et plus coûteuses. La feuille de route de décentralisation du RSM constitue le chemin depuis ce modèle Mainnet Alpha vers une minimisation de la confiance plus forte.
Voir aussi :
- Règlement et échéance - Processus et cycle de vie du règlement
- Liquidation - Machine à états et mécanique de la liquidation
- Contrats - Documentation des contrats intelligents