Cette page a été traduite automatiquement. La version anglaise fait référence. Lire en anglais →
Aller au contenu principal

Runbooks

Liste complète de vérification de préparation du desk et tests de certification d'intégration.

Liste de vérification de préparation du desk​

Avant la mise en production, vérifiez :

Connectivité API​

  • Endpoints de production configurés
  • Endpoint de contrôle de santé opérationnel
  • Connexion WebSocket stable

Authentification​

  • Signature EIP-712 fonctionnelle
  • Autorisation d'agent configurée (le cas échéant)
  • Gestion des nonces implémentée
  • Vérification des signatures testée

Système de cotation​

  • Placement d'ordres groupés testé
  • Rapprochement du cycle de vie des ordres vérifié
  • Suivi des exécutions implémenté
  • Fonction d'annulation testée

Contrôles des risques​

  • MMP configuré et testé
  • Modèle de marge compris
  • Restrictions de niveau vérifiées
  • Surveillance du portefeuille implémentée

Surveillance​

  • Abonnement aux flux WebSocket effectué
  • Rapprochement ordres/exécutions automatisé
  • Contrôles de santé configurés
  • Alertes mises en place

Coupe-circuit​

  • Capacité d'annuler tous les ordres
  • Capacité de se déconnecter immédiatement
  • Procédures d'urgence documentées

Couverture​

  • Intégration avec les contrats perpétuels Hyperliquid vérifiée
  • Stratégie de couverture en delta implémentée
  • Calcul de la marge des perpétuels compris

Règlement​

  • Gestion de l'échéance testée
  • Règlement des positions vérifié
  • Source du prix de référence comprise

Tests de certification d'intégration​

Test 1 : Placement d'ordre​

Étapes :

  1. Placez un ordre unique via POST /order
  2. Vérifiez que le statut de la réponse est ACKED ou OPEN
  3. Vérifiez que l'ordre apparaît dans GET /orders?wallet=...
  4. Vérifiez la réception de order_updates sur le WebSocket

Résultat attendu : ordre placé avec succès, mises à jour de statut reçues

Test 2 : Placement d'ordres groupés​

Étapes :

  1. Placez 10 ordres via POST /bulk_order
  2. Vérifiez que tous les ordres sont acceptés
  3. Vérifiez les statuts des ordres via REST et WS
  4. Vérifiez l'absence d'erreurs de signature ou d'authentification

Résultat attendu : tous les ordres placés avec succès

Test 3 : Suivi des exécutions​

Étapes :

  1. Placez un ordre qui sera exécuté
  2. Surveillez le canal WebSocket fills
  3. Vérifiez que l'exécution est reçue avec le bon order_id
  4. Vérifiez que l'exécution apparaît dans GET /fills?wallet=...
  5. Vérifiez que le statut de l'ordre passe à FILLED

Résultat attendu : exécutions suivies correctement, statut de l'ordre mis à jour

Test 4 : Suivi des exécutions partielles​

Étapes :

  1. Placez un ordre qui sera partiellement exécuté
  2. Surveillez les canaux WebSocket fills et order_updates
  3. Vérifiez que l'exécution partielle arrive sur fills
  4. Vérifiez que order_updates indique PARTIALLY_FILLED avec un filled_size cumulé
  5. Agrégez les exécutions par order_id et vérifiez que le total est égal à filled_size

Résultat attendu : quantités par exécution sur fills, taille exécutée cumulée sur order_updates

Test 5 : Annulation d'ordre​

Étapes :

  1. Placez un ordre via POST /order
  2. Annulez l'ordre via DELETE /order
  3. Vérifiez le statut de l'ordre : CANCELED
  4. Vérifiez la réception de order_updates sur le WebSocket

Résultat attendu : ordre annulé avec succès, mises à jour de statut reçues

Test 6 : Déclenchement du MMP​

Étapes :

  1. Configurez le MMP via un POST /mmp-config signé. Envoyez X-Hypercall-Fence-Wait: 1 lorsque le client lira immédiatement la projection, et conservez la valeur X-Hypercall-Fence renvoyée.
  2. Placez des ordres avec MMP activé
  3. Déclenchez le MMP en dépassant les limites
  4. Vérifiez que les ordres sont annulés avec le motif MMP
  5. Vérifiez que les autres ordres avec MMP activé sont également annulés

Résultat attendu : le MMP se déclenche correctement, ordres annulés

La lecture de la configuration MMP nécessite également une authentification. Signez GetMmpConfig et envoyez son expiration et sa signature dans les en-têtes X-Hypercall-Expires-At-Ms et X-Hypercall-Signature. Renvoyez la valeur X-Hypercall-Fence de la réponse d'écriture sur ce GET pour attendre exactement cette configuration validée. Les écritures sans X-Hypercall-Fence-Wait: 1 ne renvoient volontairement pas d'en-tête de fence.

Test 7 : Rejet pour marge​

Étapes :

  1. Placez un ordre qui dépasse la marge disponible
  2. Vérifiez que l'ordre est rejeté avec le motif « Insufficient margin »
  3. Vérifiez que le motif de rejet inclut les valeurs requise, de capitaux propres et de déficit
  4. Vérifiez le statut de l'ordre : REJECTED

Résultat attendu : ordre rejeté avec un motif clair

Test 8 : Restriction de niveau​

Étapes :

  1. Utilisez un portefeuille dont le niveau n'autorise que les ventes couvertes (vérifiez GET /risk/limits?wallet=...)
  2. Tentez de placer un ordre de vente sans position longue
  3. Vérifiez que l'ordre est rejeté avec un motif lié au niveau
  4. Placez un ordre d'achat (doit réussir)
  5. Placez un ordre de vente pour clôturer (doit réussir)

Résultat attendu : restrictions de niveau appliquées correctement

Test 9 : Reconnexion WebSocket​

Étapes :

  1. Connectez-vous au WebSocket
  2. Abonnez-vous aux canaux
  3. Déconnectez le WebSocket
  4. Reconnectez-vous avec un backoff exponentiel
  5. Réabonnez-vous aux canaux
  6. Interrogez l'API REST pour récupérer les mises à jour manquées

Résultat attendu : la reconnexion fonctionne, l'état est récupéré

Test 10 : Rapprochement du portefeuille​

Étapes :

  1. Placez des ordres et faites-les exécuter
  2. Vérifiez le portefeuille via GET /portfolio?wallet=...
  3. Vérifiez que les positions correspondent aux exécutions
  4. Vérifiez que l'utilisation de la marge est correcte
  5. Effectuez le rapprochement avec les mises à jour WebSocket portfolio

Résultat attendu : état du portefeuille exact, rapprochement réussi

Préparation à la production​

Liste de vérification pré-production​

  • Tous les tests d'intégration réussis
  • Surveillance et alertes configurées
  • Coupe-circuit testé
  • Procédures d'urgence documentées
  • Équipe formée à la réponse aux incidents
  • Contacts de support identifiés

Liste de vérification de mise en production​

  • Tests de certification réussis en production avec une faible taille
  • Endpoints de production vérifiés
  • Tableaux de bord de surveillance prêts
  • Alertes configurées
  • Planning d'astreinte de l'équipe établi
  • Documentation relue

Références​

Dernière mise à jour le