Modes de défaillance
Comportement du système pendant les pannes et les conditions dégradées.
Philosophie de conception
Hypercall privilégie la disponibilité plutôt que la cohérence stricte. En cas de défaillance :
- Le trading continue lorsque cela est possible
- Les composants défaillants sont isolés
- Les utilisateurs reçoivent des erreurs explicites plutôt que des données obsolètes
Indisponibilité du L1
Si Hyperliquid L1 (HyperCore) devient indisponible :
| Fonction | Comportement |
|---|---|
| Appariement des ordres | Continue hors chaîne |
| Règlements | Mis en file d'attente jusqu'à la reprise du L1 |
| Dépôts | Bloqués jusqu'à la reprise du L1 |
| Retraits | Bloqués jusqu'à la reprise du L1 |
| Liquidations | Continuent sur la base des dernières positions connues |
La reprise est automatique dès que le L1 est à nouveau disponible.
Défaillances des oracles
Oracle de prix
Si l'oracle de prix devient indisponible :
| Impact | Comportement |
|---|---|
| Nouveaux ordres | Rejetés (pas de prix de référence) |
| Calculs de marge | Échouent avec une erreur |
| Vérifications de liquidation | Utilisent le dernier prix connu |
La reprise est automatique lorsque l'oracle revient.
Oracle d'IV
Si l'oracle d'IV tombe en panne :
| Impact | Comportement |
|---|---|
| Nouveaux ordres | Peuvent être rejetés selon le mode de marge |
| Valorisation des options | Revient à la valeur intrinsèque |
| Calculs de marge | Utilisent des estimations conservatrices |
Défaillances de règlement
Oracle indisponible à l'échéance
Les prix de règlement utilisent une fenêtre TWAP de 30 minutes avant l'échéance. Si les données de l'oracle sont indisponibles :
- Panne partielle : le TWAP est calculé à partir des échantillons disponibles
- Panne complète : le règlement est retardé jusqu'à la disponibilité des données ou une intervention manuelle
Le règlement peut également être retardé sans panne si le TWAP finalisé n'est pas disponible au tick exact de l'échéance. Dans ce cas, l'instrument reste en état Expired Pending Price, le trading reste désactivé, et le règlement est retenté automatiquement jusqu'à ce que le prix finalisé existe.
L'algorithme TWAP est conçu pour résister à la manipulation. Voir Oracles pour plus de détails.
Indisponibilité de l'API
Si l'API Hypercall devient indisponible :
| Composant | Statut |
|---|---|
| Trading on-chain | Fonctionnel via les appels directs aux contrats |
| Positions | En sécurité on-chain |
| Ordres ouverts | Restent dans le carnet d'ordres |
| Abonnements WebSocket | Déconnectés |
Recommandations
- Implémentez une logique de reconnexion avec backoff exponentiel
- Mettez en cache les données critiques localement
- Vérifiez
GET /healthavant de trader - Utilisez les méthodes on-chain comme solution de repli pour les opérations critiques
Point de terminaison de santé
| Point de terminaison | Objectif |
|---|---|
GET /health | Vérification de vivacité de base |
GET /ready | Vérification complète de disponibilité, y compris les dépendances |
Communication en cas d'incident
Pendant les incidents, les mises à jour sont publiées sur :
- Discord : canal #announcements
- Twitter : @synapseprotocol